figmar/apes-sidebar
1
0
Fork 0
Code Issues 1 Pull Requests 1 Actions Packages Projects Releases Wiki Activity
765 Commits 6 Branches 43 Tags
73dead127f79b032e7ff29b6eb8eae1f8ec03cd2
Commit Graph
8 Commits
Author SHA1 Message Date
figmar 23ca3daac3 chore(sync): re-base the fork onto upstream dsh-better-sidebar v0.24.1 (rename only) 2026-10-04 00:46:18 +08:00
Menghuan1918 0ac62b3a49 Merge origin/main (v0.22.1 与三个热修 PR) into feat/files-changes-uiux 
冲突面 11 个文件，逐项裁决如下：

1. src/client/native/index.ts —— **取 main 版**。main 的 v0.22.1 在同一处做了更强的修复
   （清理循环同样跳过 FILES_KIND，另加 `disposeSafely` 与「注册失败必须回滚已占用 id /
   已建槽位」），是我们那行守卫的超集。
   ⚠️ 但 main 分支从来没有过我们 task-19 的 `records.attachStore(store)` 调用，整文件
   采用会**静默丢掉**它（records 拿不到 store → `toggleExpanded` 直接 return → 点目录
   树毫无反应），且 jsdom 单测看不见（它们自己绑 records）。已按原注释恢复该调用，并在
   注释里记下这次合并教训。真实宿主 lane 证明：恢复前 `zz-expand-refresh` 红（请求为
   空、`big` 不展开），恢复后 9/9 全绿。
2. package.json / dsh.plugin.json / src/client/service.ts —— 版本相关冲突取我们的
   0.24.1（支持线 ^0.2.0-rc.1 不变）。
3. CHANGELOG / README（中英各一）—— 双方版本节全部保留：我们的 v0.24.1 / v0.24.0 +
   **新增缺失的 v0.23.0 节**（开发线，内容随 v0.24.1 发布）+ main 的 v0.22.1。
   同时修正两处事实错误：① 「0.1.7 线请固定 v0.23.0」→ **v0.22.1**（0.23.0 从未发布）；
   ② 安装对照表里 0.1.7 行的安装命令同改。README 并补上 v0.23.0 摘要（含 ⚠️ 删除工作区
   路径检测这一安全相关的行为变更）。
4. docs/external-plugin-guide.md —— 版本行取我们的（0.2.0 线）。

验证（合并后的树）：pnpm typecheck / lint / test = **137 文件 / 1491 通过 / 9 跳过**
（含 main 新增的 native-registration.spec.ts）；pnpm build ✓；
DSH_CMD='npx -y --package @deepseek-ai/dsh@0.2.0-rc.1 dsh' pnpm test:mount = **9/9**
（mount 5 + perf 2 + main 的 native-reload 1 + 我们的 zz-expand-refresh 1）。
 2026-09-28 23:13:36 +08:00
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 b91675ae61 feat(dsh): 适配 DSH 0.2.0-rc.1（单线支持）+ v0.24.0 
支持线从 ^0.1.7-rc.1 整体前移到 ^0.2.0-rc.1；0.1.7 线（含 npm latest 的
0.1.7-rc.2）停留在 v0.23.0。适配前实测确认这是纯增量，故本版无运行时兼容分支。

必改项（否则装不上/不加载）
- 14 条 DSH peer → ^0.2.0-rc.1。实测 caret 跨 minor 不成立：`^0.1.7-rc.1`
  展开为 >=0.1.7-rc.1 <0.2.0-0，对 0.2.0-rc.1 判定 false（includePrerelease
  也救不了）。判别性验证：把 peer 回退成 ^0.1.7-rc.1 后，在 0.2.0-rc.1 宿主上
  `dsh plugin add` 直接拒绝并回滚包树——
  "installation rejected: Plugin dsh-better-sidebar@0.24.0 is incompatible with
   dsh 0.2.0-rc.1: peerDependencies {…^0.1.7-rc.1…}"；恢复 ^0.2.0-rc.1 后安装通过
- 28 个 @deepseek-ai/* devDependencies 精确钉 0.2.0-rc.1（cordis 4.0.4 /
  cordis-plugin-group 1.0.4 / cordis-plugin-include 1.0.9 不变）
- 新增 @deepseek-ai/dsh-util-code-language@0.2.0-rc.1：0.2.0 的 ui-primitives
  产物裸 import 它（0.1.7 的产物同样 import，只是旧树里恰好被传递提供），
  不补则所有加载 ui-primitives 的 20 个 spec 在收集期失败

实测证据（写进 docs/plans/2026-09-28-dsh-0.2.0-rc.1-adaptation.md）
- 本插件消费的 19 个宿主包零值导出删除（对比 export {} / exports.x=）
- 类型面仅 3 处且全为增量：ui-primitives（DisclosureRow/TextShimmer/Tooltip
  新增可选 prop、overlay 顶部内距）、dsh-session（新增 ToolCallRecovery）、
  dsh-api-remotes（新增 product-analytics remote）
- 会话格式仍 v4、SUBAGENT_DESCRIPTOR_VERSION 仍 3、dsh/lib/bin.js 与
  dsh-client-modules 运行时逐字节相同、web profile 客户端 inject 列表相同、
  ui-primitives 裸 import 集合不变、agent-team 四包类型逐字相同
- 宿主 web profile：新增 desktop-only product-analytics/telemetry（web 上
  disabled）；time-context/schedule/ui-schedule（本就 disabled）移入可选
  dsh-experimental-schedule-bundle；插件不依赖宿主 schedule

其余同步
- CI 与挂载 lane 钉 @deepseek-ai/dsh@0.2.0-rc.1（scripts/e2e-common.sh 的
  DSH_NPX_SPEC/DSH_EXPECT_VERSION、ci.yml），注释记下「0.2.0 首个候选版只挂
  next」与「caret 跨 minor 必失效」两条教训
- tests/market-manifest.spec.ts 的 peer 形状断言钉当前基线 tuple
- dsh.plugin.json engines.dsh → >=0.2.0-rc.1；SIDEBAR_SERVICE_VERSION → 0.24.0
- README/README_EN、CHANGELOG/CHANGELOG_EN、AGENTS.md（§2 钉版句 + §3 改为
  「DSH 版本适配要点」并新增 §3.0 当前基线，0.1.7 内容降为历史分节）、
  docs/external-plugin-guide.md 全部同步

验证：pnpm peers check 仅剩上游 better-locale 的 5 条 unmet（非本插件 peer）；
typecheck / lint / test（136 文件 1484 通过 9 跳过）/ build 全绿；
DSH_CMD='npx -y --package @deepseek-ai/dsh@0.2.0-rc.1 dsh' pnpm test:mount = 7/7；
pnpm test:mount:aggregate 通过（聚合双挂载退让）
 2026-09-28 21:21:45 +08:00
Menghuan1918 a18e0f000d docs(release): 修正 v0.22.1 条目里的测试计数与「3/3」措辞（独立 review 发现） 
- 单测计数：`122 files / 1292 passed / 9 skipped` → **1293**。1292 是 #785 当时的数字，
  本 commit 自己的 `make check` 两次都报 1293（`tests/` 与 main 逐字相同，122 个 spec +
  `it.each` 展开 = 1293）。涉及 CHANGELOG.md / CHANGELOG_EN.md / README.md / README_EN.md
  与事故文档。
- 「3/3 红 / 3/3 绿」措辞改为「连续 3 次运行全红 / 全绿」并注明该 lane 里只有 1 个用例、
  是重复跑三次——原措辞会被读成「3 个用例各红一次」。涉及上述四份发布文档 + 事故文档
  + AGENTS.md §2（同一句话在那边也有）。
- 其余 review 结论均已满足：版本三处锁步 + 两个守护用例绿、无遗留 0.22.0 引用、
  zh/en 段落一一对应、「最近更新」保持两条并把指针下移为 v0.21.1 → v0.12.3、
  release.yml 的 tag 校验与 `latest` dist-tag 都能过、lockfile 无需改动。
 2026-09-28 11:30:29 +08:00
Menghuan1918 2e94b56c36 chore(release): v0.22.1——修复 files 接管 id 孤儿化与 macOS 拖拽失效 
- package.json / dsh.plugin.json / SIDEBAR_SERVICE_VERSION → 0.22.1（三者锁步由
  tests/service.spec.ts 与 tests/manifest-consistency.spec.ts 断言）
- README / README_EN：新增 v0.22.1 条目、同步三处徽章与 latest/支持线表格、
  切回 npm 通道的示例版本号；「最近更新」保持两条（v0.22.1 + v0.22.0），
  更早版本指针区间随之下移为 v0.21.1 → v0.12.3
- docs/external-plugin-guide.md：当前版本行 → v0.22.1
- CHANGELOG / CHANGELOG_EN：补 v0.22.1 条目（两个缺陷的根因链、真机证据、
  修复要点与守卫清单）

支持线**不变**：仅 DSH 0.1.7-rc.1+（peer 下限 ^0.1.7-rc.1，CI 钉 0.1.7-rc.1）；
0.21.1 / 0.22.0 用户直接升级；0.1.6-alpha.2 及更早仍固定 v0.19.1。

内容提要：① 修复客户端条目替换后 `dsh-better-sidebar:files` id 被孤儿化
（#777 + #785：清理循环跳过 FILES_KIND + 注册失败回滚已占用的 id 与槽位，
并新增部署级回归门 tests/e2e/native-reload.e2e.ts）；② 修复 macOS 桌面版
窗口拖拽/双击缩放失效（#773 + #786：视口层用 initial !important 退出
app-region 计算，补齐放大视图，探针改用真实级联计算值）。

验证：make check 全绿（typecheck / lint / build / test 122 files 1293 passed
9 skipped / check:consumer-types）；此外本地 pnpm test:mount 与
pnpm test:mount:aggregate 绿，npm 0.22.0 与修复版在 scratch profile 上的
红→绿对照见 PR #785 / #786。
 2026-09-28 11:23:48 +08:00
Menghuan1918 606339f81e chore(release): v0.22.0——任务管理页重做（工作流图）+ DSH 0.1.7 团队/后台任务数据面 
版本号 bump 到 0.22.0（含 dsh.plugin.json 与 SIDEBAR_SERVICE_VERSION 两处镜像，
tests/manifest-consistency.spec.ts 与 tests/service.spec.ts 就是守这两处的），
README / README_EN 的版本徽章、支持线表格、npm 通道说明与「最近更新」段落同步，
CHANGELOG / CHANGELOG_EN 补 v0.22.0 条目正文。

支持线**不变**：仅 DSH 0.1.7-rc.1+（peer 下限 ^0.1.7-rc.1），0.21.1 用户可直接升级。
主内容是任务管理页从「子代理拓扑」重做为工作流图（图/树双视图、双段式节点卡、
主 Agent 同款合并活动行、扫光、两组折叠聚合、两个常驻浮动窗），以及随后按真机反馈
打磨的四轮修正；团队与后台任务两个数据面按 0.1.7 删掉的 Remote 方法/自建路由改写。

验证：typecheck / lint 通过；pnpm test 1288 passed / 9 skipped；build + pack 产出
dsh-better-sidebar-0.22.0.tgz。
 2026-09-27 22:33:57 +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