前言¶
在 DeepSeek Harness(DSH)里长期跑智能体或接多个工作区时,侧边栏会积累大量历史会话。DSH 本身支持把会话归档、置顶,但没有提供删除会话的 API;若只在 UI 里「藏起来」,磁盘上的会话目录和投影缓存仍会占空间。需要真正从磁盘清掉、又希望归档/置顶会话能按工作区集中管理时,就要靠社区插件补这一层能力。
下面介绍 Motues 维护的 dsh-session-curator:在 DSH 现有归档能力之上,做文件级的永久删除,并在设置里提供归档与会话的集中管理界面。
这是什么¶
dsh-session-curator 是一个 DSH 插件,定位是 会话删除 与 归档管理。维护者为 Motues,源码与说明见 GitHub 仓库,社区目录页为 SkillHub:Motues/dsh-session-curator。
插件自行完成磁盘上的删除操作:删除后会话目录及其投影缓存从磁盘移除,不可恢复。若以后还可能要用该会话,应使用 DSH 自带的 归档(Archive)——归档同样会从侧边栏隐藏,且可完全撤销。
核心功能¶
能力均来自插件 README 中的功能说明,按入口归纳如下。
| 入口 | 作用 |
|---|---|
会话行 ⋯ 菜单 |
Delete session:确认后永久从磁盘删除 |
| 设置 → Session manager | 两个标签页 archived / pinned,按会话原始工作区文件夹分组,支持单行与批量操作 |
| Session manager → Settings | 基础项(默认标签、分组、侧边栏是否显示已归档、行详情、排序)、已安装版本,以及当 npm 有更新版本时的升级提示与具体命令 |
| 确认对话框 | 强调永久删除、建议改用 Archive,并需勾选「I cannot undo this」 |
| Disk usage 标签 | 只读统计总占用,以及最大 / 最久未打开的会话,可在原位归档 |
补充约束(README 明确写出):
- 删除是永久的;不会对正在运行中的会话或当前正在使用的会话动手。
- 想保留的内容应归档,而不是删除。
安装与启用¶
安装命令以仓库 README 为准。npm 包名为 dsh-session-curator(当前发布版本 0.3.1,见 package.json)。
Desktop profile:
dsh plugin --profile desktop add dsh-session-curator
Web profile:
dsh plugin --profile web add dsh-session-curator
若要从 GitHub 安装而非 npm:
dsh plugin --profile desktop add github:Motues/dsh-session-curator
说明:上述命令会在对应 profile 内执行 pnpm,并把包写入 dependencies 与 dsh.profile.bundles。Host 端需重启 DSH 后生效;Client 端刷新页面即可。发布包无额外依赖、无需构建,可直接使用 lib/ 下的 ESM(lib/index.js 为 host,lib/client.js 为 client bundle)。
环境要求(package.json):Node >= 20;DSH 版本需满足 engines.dsh 声明的范围(>=0.2.0-rc.2 <0.2.2-0)。许可证为 MIT。
典型用法¶
-
永久删掉一个不再需要的会话
在侧边栏目标会话行的⋯菜单中选择 Delete session,阅读警告(不可撤销、建议先 Archive),勾选确认项后执行。插件从磁盘移除该会话目录及投影缓存。 -
批量整理归档或置顶会话
打开 Settings → Session manager,在 archived 或 pinned 标签下按原始工作区文件夹查看列表,对单行或使用批量操作处理。 -
按占用与活跃度决定归档
在 Session manager 的 Disk usage 标签查看总占用与「最大 / 最久未打开」会话,对选定项就地归档,避免误删仍可能有用的历史。 -
调整侧边栏与列表行为
进入 Session manager 的 Settings,配置默认标签、分组方式、是否在侧边栏显示已归档会话、行上展示的信息与排序等;若有新版本,界面会给出与 README 一致的升级命令提示。
适用场景与注意¶
适合谁: 长期在 DSH 中保留大量会话、需要真正释放磁盘空间,或希望按工作区文件夹统一查看、操作归档与置顶会话的开发者。
使用前请注意:
- 插件以 当前 DSH 进程的权限 读写会话相关文件;安装前建议阅读 源码 与 MIT 许可证,确认行为符合你的安全与合规要求。
- 删除不可恢复;不确定是否还要用的会话,优先 Archive。
- DSH 生态强调「一切皆插件」;SkillHub 等社区目录为独立站点,与 DeepSeek / 幻方无官方从属关系,本文介绍的是社区插件而非官方内置功能。
结尾¶
dsh-session-curator 补上了 DSH 缺失的会话永久删除能力,并把归档、置顶与磁盘占用视图收进 Session manager,适合需要主动清理会话目录、又希望归档仍可逆的场景。进一步了解可访问 SkillHub 目录页 与 GitHub:Motues/dsh-session-curator。