前言¶
在 DeepSeek Harness(DSH)里日常开发时,侧边栏会堆满历史会话。官方默认只能把会话归档(从列表里隐藏,日志仍在磁盘上),查看已归档条目也要从「视图选项」里找,恢复或彻底清理都不够顺手。若你希望从菜单里真正删掉会话日志,并在一个面板里集中处理已归档会话,chymzxs/dsh-archive-workbench(归档工作台)是针对这一类需求的客户端插件。
这是什么¶
dsh-archive-workbench 由维护者 CHYMZXS 发布,在 SkillHub 社区目录中归类为客户端插件;目录页标注当前版本为 v1.1.2(2026-10-22 更新)。插件在 Host 端注册删除逻辑,在 Web 客户端扩展侧边栏菜单与主区域面板,不改变 DSH 核心源码。
一句话:在会话「…」菜单中提供永久删除,并提供归档会话面板,对已归档会话可一键恢复或再次删除。
核心功能¶
下面介绍已在对照 SkillHub 插件详情与仓库 README 后可确认的能力。
侧边栏:永久删除会话¶
在任一会话行的「…」菜单底部(「复制 Session ID」之后,带分隔线)增加 删除会话。确认后会:
- 删除该会话在
~/.dsh/sessions/<项目>/<会话ID>/下的日志目录; - 清理投影缓存
~/.dsh/storages/session_projcache/sessions/<会话ID>.json; - 从归档/置顶集合及工作区会话顺序中移除该 id;
- 通知前端立即去掉该行;若删除的是当前打开会话,主区域会回到新会话页。
已归档会话同样可从菜单删除。
归档会话面板¶
侧边栏底部图标栏增加归档入口,在主区域展示已归档会话列表。每行显示标题、会话 ID、所属工作区,并提供 恢复归档(调用官方 unarchiveSession)与 删除(复用同一确认框)。列表按最近归档在上排序;归档超过 6 条时可按标题、ID、路径或工作区搜索。
Host 配置(可选)¶
插件在 Host 端提供配置 schema,均有默认值。常见项包括:idleTimeoutMs(默认 8000)、settleAttempts(默认 6)、settleDelayMs(默认 250)、maxBodyBytes(默认 4096)、sessionsRoot(留空则使用 DSH_HOME/sessions 或 ~/.dsh/sessions)。用于控制删除驻留会话时的等待与复查行为。
安装与启用¶
SkillHub 为插件生成带精确 commit 的安装计划(installability: verified)。若你使用 web profile,可按目录页安装计划执行:
dsh plugin --profile web add github:chymzxs/dsh-archive-workbench#8760b15daf68142cde9e54d2dabf732fc2e3de82
安装完成后按安装计划建议重启:
dsh --profile web
README 还写明:也可在 DSH 设置 → 插件 中搜索 dsh-archive-workbench 安装;或使用 dsh plugin add dsh-archive-workbench / 指定 GitHub 仓库地址。插件含 Host 端代码,首次安装后需重启 DSH 才能生效。
package.json 中声明 DSH 引擎范围为 >=0.2.1-0 <0.3.0,Node 需 >=20。许可证为 MIT。
典型用法¶
经过上面的安装与重启,可按下面流程操作。
- 清理单个会话:在侧边栏目标会话的「…」菜单中选择「删除会话」,在确认弹窗中确认。适用于归档或活跃列表中的任意会话。
- 批量整理归档:点击侧边栏底部归档图标,打开「已归档会话」面板;对需要继续用的会话点「恢复归档」,对确定不再需要的点「删除」。
- 搜索:当归档条目超过 6 条时,使用面板顶部搜索框按标题、会话 ID 或工作区过滤。
若删除的是本次运行中仍驻留在内存的会话,插件会先尝试 archiveSession({ stopActivity: true }) 并等待空闲再删文件;若日志仍被重建,会报错并回滚归档状态。README 建议:对「刚用过」的会话,先重启应用再删更稳妥。
适用场景与注意¶
适合谁:长期在 DSH 里跑智能体、会话数量多、需要真正释放磁盘而不是只隐藏历史的开发者。
权限与安全:插件以当前 dsh 进程权限运行,删除操作会写本地会话目录与存储。安装前应在 GitHub 仓库 核对源码、dsh.bundle.patch(cordis.patch.yml)及 MIT 许可证;删除路由经 Host 的 connection.requestRejection 与 JSON 校验,但仍会不可逆删除会话日志。
其他限制(来自 README):~/.dsh/attachments/ 中的共享附件不会随会话删除;子智能体会话不出现在侧边栏,无法从 UI 删除。GitHub 星标数为 0(以 SkillHub 同步数据为准)。
延伸阅读¶
归档工作台把「删盘」和「管归档」收到侧边栏两处入口,补上了官方归档模型里不方便直接操作的部分。更多说明与截图见社区目录与仓库:
- SkillHub 目录页:https://www.skillhub.cn/plugins/CHYMZXS/dsh-archive-workbench
- GitHub:https://github.com/CHYMZXS/dsh-archive-workbench
SkillHub 为独立社区站点,与 DeepSeek / 幻方无官方从属关系;DSH 生态本身遵循「一切皆插件」的扩展方式,可按需从目录选用客户端插件。