DeepSeek Harness (DSH) 的归档机制会将会话从主列表中过滤,且官方没有提供取消归档的入口。dsh-archive-browser 插件补上了这块能力,允许你浏览已归档会话、查看其影响面、恢复到侧边栏、引入当前对话或岔出新会话。
功能¶
- 侧边栏入口:侧边栏底部会出现「已归档」按钮,用于打开归档面板。
- 查看内容:在面板内渲染对话转录,按角色上色(你-蓝,助手-绿,工具-灰)。
- 影响面体检:只读模式下查看会话修改过的文件、执行过的命令和派生出的会话。
- 恢复到侧边栏:将归档会话从归档集合移除,重新显示在左侧列表,无需刷新页面。
- 引入当前对话:将归档内容整理成摘要写入当前输入框。
- 岔出继续对话:从归档会话 fork 出一个新的活会话。
- 轻量载入:面板默认加载仅读投影缓存(标题、首条消息、时间)和一次文件状态检查,不解压转录内容。
- 排序功能:支持按最近活动、归档顺序或标题排序,顺序会被记住。
安装与启用¶
官方 CLI¶
dsh plugin --profile desktop add dsh-archive-browser
注意:该插件尚未发布到 npm,上述命令目前可能无法直接执行。
手动安装¶
- 下载并解压插件 ZIP 包。
- 将顶层目录放入
<DSH_HOME>\profiles\desktop\node_modules\dsh-archive-browser\。 - 在该 profile 的
cordis.patch.yml中追加插件挂载声明:
- insert:
- id: archive-browser
name: 'dsh-archive-browser'
- 重启 DSH。侧边栏底部将出现「已归档」按钮。
典型用法¶
- 点击侧边栏底部的「已归档」按钮打开面板。
- 在列表中选择一个会话,点击「恢复到侧边栏」将其放回主列表。
- 点击「岔出继续对话」从该归档会话创建新会话。
- 点击「影响面」查看该会话修改了哪些文件或执行了哪些命令。
注意事项¶
- 岔出限制:岔出新会话需要会话中包含已完成的助手回合。
- 引入限制:「引入当前对话」是尽力而为的操作,在最差情况下会退化为复制到剪贴板。
- 依赖管理:插件不会自动卸载已安装的依赖,面板只列出内容,清理需手动处理。
- 权限保护:Host 路由受 DSH 的令牌/来源守卫保护,跨源访问会被拒绝。
- 重启要求:首次安装后必须重启 DSH 才能正常加载 Host 路由。
总结¶
该插件通过侧边栏扩展了 DSH 的归档管理能力,提供了轻量级的列表浏览、只读的影响面分析以及恢复和 fork 会话的功能。适合需要回顾过往会话、分析 Agent 行为或从历史记录中继续开发的场景。