Menghuan1918
98a446bbfc
fix(sidebar): 点击展开时文件树整体重建（两处根因）+ v0.24.1
...
用户报告：「点击展开的时候，文件树会频繁整体刷新，看起来非常难受」。
根因 1（主）：src/client/native/index.ts 的 sync() 把 files 接管项当成多余注册。
它按 KIND 记账、永远不在 wanted 里，于是每次 sync 都被 dispose + 重建；而
disposeSubscriptions 同时订阅了 service 与 store，**任何会话状态写入**（展开/收起、
切 tab、拖底部工作台、选中…）都会跑一遍 sync。替换 slot 注册 = 宿主换 slot entry →
插件 tab body 被 unmount/remount → 文件树丢失层缓存、滚动位置与目录 watcher，并重新
fs.trees([root, ...expanded]) 重列整棵可见树。机械证明（临时插桩，已回退）：
[probe-sync] enter live=[editor,git,subagent,sidechat,diff,files]
[probe-registerSlots] slot inject ran for dsh-better-sidebar:files
[probe-body] unmount tab3 kind=files
[probe-body] mount tab3 kind=files
修法：wantsFiles 提前，删除循环里对 files 接管项 skip（禁用 editor 时仍照旧释放）。
根因 2（次）：FileTree.tsx 的 retryDir 先把该层缓存删掉再请求，行被「Loading…」
占位替换后重建——目录有外部写入（构建 / 格式化 / 模型跑 bash）时整层闪空。
修法：复用既有 force 路径 loadLevels([dir], { force: true })，保留旧行直到新答案到达
（与 refreshTick 的强制刷新路径行为一致）。
判别性证据（回退任一修复即红）
- tests/native-surface.spec.ts：三次 store 写入不得产生任何注册/注销 → 回退后
registered 6 → 12、disposed 全是 dsh-better-sidebar:files
- tests/file-tree-batch-load.spec.tsx：重列期间旧行仍在屏 → 回退后层被删空
- 新增真实宿主 lane tests/e2e/zz-expand-refresh.e2e.ts（quiescence 判据，无固定 sleep；
zz- 前缀保证它最后跑，因为它会自建 workspace + session）：A1 展开只请求被展开那一层、
A2 tab body 存活（不重开 watch socket）、A3 屏上行数不归零；回退修复 1 后退出码 1
（Error: expanding a folder must ask for that folder, not the whole visible set）
修复后实测（40 子项目录，同一探针/机器/工作区）
| 阶段 | fs.trees payload | 新开 ws | DOM +/- | 被删行 | body 替换 | 层内最小行数 |
| 展开 big | [big]（原 [root, big]） | 0（原 1） | +41/-1 | 0（原 45） | 0（原是） | 40（原 40） |
| 外部写入 big | [big] | 0 | +1/-0（原 +41/-40） | 0 | 0 | 40（原 0） |
| 展开 bravo | [bravo] | 0 | +2/-1 | 0（原 45） | 0（原是） | 41 |
证伪记录：新建 fs.watch(dir,{persistent:false}) 在 macOS 上无改动时 0 事件（Node 微
探针两遍 + 8 轮真实时序 + 浏览器侧从未收到 {dir} 陈旧帧）→ src/fs-watch.ts 与
use-dir-watch.ts 一行未改。
验证：pnpm typecheck / lint / test（136 文件 1486 通过 9 跳过，基线 1484 + 新增 2）/ build
全绿；DSH_CMD='npx -y --package @deepseek-ai/dsh@0.2.0-rc.1 dsh' pnpm test:mount = 8/8。
版本 0.24.0 → 0.24.1（package.json / dsh.plugin.json / SIDEBAR_SERVICE_VERSION /
README×2 / CHANGELOG×2 同步）。
2026-09-28 22:33:30 +08:00
Menghuan1918
b69912b32e
docs(readme): slim down and highlight improvements over the stock sidebar
...
- Rewrite the feature list as comparison bullets (editable editor,
enhanced file tree, Changes / Background Tasks / Side Chat / bottom
workbench — none of which the stock sidebar has)
- Split the full release history into CHANGELOG.md / CHANGELOG_EN.md;
READMEs keep only v0.21.1 and link out
- Drop Star History; move the ecosystem section after Community
- Fix stale claims: v0.21.1 is the npm latest stable (not the alpha
channel); drop the untruthful 'built-in browser' hero badge; pin
'^0.21.1' in update / source-install notes
- Condense the install prose and the top IMPORTANT block
2026-09-27 11:08:09 +08:00
Menghuan1918