dsh-archive-manage

简体中文 | English | GitHub

归档会话管理 —— DeepSeek Harness（DSH）Web 插件（dsh-sparrow 合集成员）。

与官方归档互补。官方归档标记只把会话从侧边栏藏起来——@ 提及列表不会按归档标记过滤，已归档会话会一直挤占 @ 候选。本插件在侧边栏底部加「归档」入口：归档会话可以取消归档（回到会话列表）、移入回收站（会话目录移出持久化，可逆）或彻底删除（不可逆），回收站中的会话可随时还原——移入回收站或彻底删除后的会话才会真正离开 @ 列表。

安装

dsh plugin --profile web add @dsh-sparrow/dsh-archive-manage

适配 dsh 0.1.5-rc.2（本版构建与验证所对齐的确切官方版本线；更新的版本线、尤其是预发布版本不在承诺范围内），并需要可用的 pnpm（dsh plugin 会把安装操作转发给 pnpm）。

不要直接执行 npm install @dsh-sparrow/dsh-archive-manage：那只会把包下载到某个 node_modules，不会注册进 DSH 的 web profile。请使用上面的 dsh plugin 命令安装，并在安装后重启 DSH。

使用

• 入口：侧边栏底部「归档」按钮，弹窗分「归档区 / 回收站」两个区块
• 归档区：对已归档会话「取消归档」「移入回收站」或「彻底删除」；彻底删除需输入完整会话标题强确认
• 子会话树：subagent 子会话缩进挂在父会话下（只读行），默认收起——父行显示子会话数量，点 ▸ 展开查看；归档 / 取消归档 / 移入回收站 / 彻底删除 / 还原始终以父为单位、子随父走
• 游离会话：不属于任何工作区、也未归档的会话——官方界面无法清理，会一直挤占 @ 候选。面板单独列出，可「归档 / 移入回收站 / 彻底删除」；空白会话（0 轮）带角标、删除确认从简
• 未释放会话：本次 dsh 运行中打开过的会话无法移动文件，会在归档区内分组置灰，下次启动 dsh 后才可移入回收站 / 彻底删除；「取消归档」不移动文件，可立即执行。锁来自子会话（而非该行自己）时，行内会标明「子会话未释放」
• 回收站：单个 / 全部还原、单个 / 全部彻底删除；条目按父子层级展示（与归档区同款缩进，多层子会话不再平铺），同样默认收起；回收站中的会话不再出现在 @ 列表
• 回收站位置：回收站区内显示，点击即可复制完整路径

截图

回收站位置与还原

• 默认回收站：$DSH_HOME/.sessions-trash/；每个条目目录内含 dsh-archive-manage.json 记录原始位置与工作区归属，还原时按它移回
• 记录文件同时记载父会话的 subagent 子会话：还原时全家一起移回
• 无记录文件的旧格式目录按「旧格式」列出：只能彻底删除、不能还原

卸载与残留

卸载不会自动恢复任何会话：插件从 DSH 卸载后代码不再加载，没有执行时机——这是 DSH 插件机制的固有约束。卸载前请先在面板里决定内容的去留：

• 回收站中的会话：会话目录与记录文件留在回收站，重装本插件即可继续「还原」或「彻底删除」

• 已彻底删除的会话：不可逆，卸载与否都无法找回

• 已取消归档的会话：文件从未移动，卸载后即官方原生列表状态，无残留

• 卸载前收尾：在回收站「全部还原」或「全部彻底删除」一步处理完，再卸载插件（回收站非空时面板内也有提示）

• 已卸载后才想起：重新安装本插件即可继续操作回收站（记录文件在，还原能力就在） 更新日志：CHANGELOG.zh-CN.md