工作区会话归档 WindFromKadath/dsh-plugin-workspace-archive

dsh-plugin-workspace-archive

DSH（DeepSeek Harness）插件：工作区文件夹被删除或移走时，把它名下的会话归档；同一个文件夹放回来时，再把这些会话带回该工作区 —— 只走官方 API。

English entry: README.md。

它补的是哪条缝

DSH 有意把"目录缺失"和"归档"分开：

- 目录无法校验的工作区（被移动、被删除、从未记录）无法加入新会话，其中的会话会散成「无项目」；
- 「移除项目」保留文件夹与会话历史，但重新添加同一目录会从空项目开始：旧会话不会自动回来。

本插件补上这条缺失的联动。它不改 app.asar、不写官方 storages/ 与 sessions/ 文件，自己的记账放在 DSH 主目录下的 sidecar 里。

它做什么

| 触发 | 结果 |
| 已登记的工作区目录被删除或移走 | 把该路径下由本插件登记过的会话归档（侧栏默认视图不再显示，在"全部对话"里仍可见） |
| 工作区登记被移除（菜单里的「删除工作区」，文件夹还在） | 同样视为消失并归档 —— 否则那些对话会散成「无项目」 |
| 目录或登记回来 | 本插件归档过的那批会话取消归档；并且台账里记过的全部成员都会被挂回该路径的工作区 —— 包括在消失之前就已经归档的会话（典型是你自己手动归档的） |

两条永不违反的规则：

- 你自己归档的会话永远不会被取消归档：它们只是回到自己的分组里，仍然隐藏，直到你手动取消归档；
- 只处理它记过账的会话：台账是插件运行期间、工作区健康时写下的；插件绝不按工作目录反查、把你故意留在「无项目」的会话塞回去。

环境要求

- DSH（DeepSeek Harness）桌面版或 CLI；开发与验证基线是 0.2.0-rc.2。
- Node.js 22.5+（由宿主提供）。
- 零运行时依赖：插件不 import 标准库以外的任何东西 —— 这是刻意的：通过目录联接装载的插件按真实路径解析嵌套 import，够不到宿主自带的包。

安装

本插件尚未发布到 npm。两种方式：

1. 从本地检出安装（本仓库验证的就是这条）：把目录联接进 profile 的 node_modules，并把包名写进 profile 清单。本机用 .verify/install-desktop.mjs 一次完成这四步，--uninstall 可回滚。
2. 从本仓库安装（已写入文档，本仓库尚未实测）：官方插件管理器接受 GitHub 规格，例如 dsh plugin add github:WindFromKadath/dsh-plugin-workspace-archive#<commit>。由于插件没有依赖，装进去的副本与联接版行为一致。

必须重启宿主/应用：插件行与 bundle 在启动时固定，HMR 从不热装载。配置默认值在 src/index.js 的 resolveConfig；profile 的 patch 行可以覆盖 dryRun、confirmDelayMs、pollIntervalMs、watch。

验证

- npm test —— 41 项离线断言（工具行为、决策层、台账、真 Cordis 装载，以及"插件源码不得 import 宿主包"的回归）。
- npm run rm-test —— 22 项针对真 DSH 运行时（一次性 DSH_HOME）的断言：建工作区 → 建两个真会话 → 删目录 → 断言只归档该归档的那个 → 放回目录 → 断言它被恢复并挂回工作区，而"用户手动归档"的那个保持归档。
- npm run check —— 语法。

两套都可在本仓库一键重跑，且不碰真实 profile、不碰真实工作区目录。设计约束、已采纳决策与证据线索见 MAINTAINER.md。

已知限制

- 只认它记过账的会话：若"删除 → 重新添加"发生在插件没运行的时候，它只认得台账里最后一次快照 —— 快照里有的成员会被挂回，更早散掉的不会。
- 挂回分组 ≠ 取消归档：attach 只动工作区成员表，从不碰归档集合。
- 不做会话删除、不删文件夹、不做跨机器同步。
- 目录被改名等于换了一个路径：挂回时官方会校验 cwd === 工作区路径，对不上时插件只记日志、不改数据。

许可证

MIT —— 见 LICENSE。