前言¶
DeepSeek Harness 采用插件化架构，旨在通过组件化扩展提升开发与使用效率。随着会话数量的累积，管理长对话历史、整理标签体系以及处理归档数据往往变得繁琐且容易出错。DSH Session Manager 旨在为 DeepSeek Harness Web 提供一套标准化的会话治理方案，解决会话组织混乱、历史记录缺失和误删风险等问题。
插件概览¶
这是一个面向 DeepSeek Harness Web 的会话治理插件：以标签组织 Session，管理归档生命周期，并让长对话折叠与轮次跳转保持完整。
- 维护者：6jeffr3y
- 许可证：MIT
核心功能¶
会话生命周期管理¶
提供统一的归档、归档视图、恢复、收藏和标题跳转功能。通过集中管理这些状态，可以显著减少在长会话列表中重复查找历史记录的时间。
多标签组织¶
支持为一个 Session 添加多个标签，并允许复用已有的标签体系。用户可以按标题、路径或标签进行检索，从而更灵活地组织知识库。
严格标签关系图¶
构建“标签—会话”的严格关系图。仅以完全相同的标签建立连接，归档和无标签的会话不会进入图谱，避免了无依据的关系推断。图谱支持缩放、拖动画布、重置视图以及点击会话节点直接跳转。
安全删除¶
实现了严格的删除逻辑。永久删除要求会话必须已经归档、停止运行，并经过二次确认。删除范围明确，仅清理 Session JSONL、对应的投影缓存、Workspace 成员关系、归档记录以及本插件保存的标签和收藏。插件不会删除 MemOS 数据库、Agent 记忆与 Skill、其他 Session、插件与模型配置或跨 Session 共享的附件对象。
完整长对话导航¶
通过调用 DSH 公开的 Session.loadOlder() 方法，串行加载当前会话的更早历史页。补全的历史窗口让原生“工具调用 · 消息”过程区块能够稳定折叠，并使右侧的用户输入轮次标记能够准确定位到对应的输入。
多模型自然标题¶
针对 GLM 等非 DeepSeek 辅助模型，当标题 Token 预算受限时容易只输出推理过程而缺少正文的问题，插件提供了配置选项来改善标题生成效果。
安装与启用¶
使用本插件前，请确保已安装 DeepSeek Harness，且运行环境为 Node.js ^22.19.0 || >=24。
- 安装插件：
dsh plugin --profile web add github:6jeffr3y/dsh-session-manager#v0.1.0
- 重启 Web profile：安装后需重启 Web profile 才能生效。
dsh web
- 卸载插件：
dsh plugin --profile web remove dsh-plugin-session-manager
- 安装本地 checkout：如果需要调试或使用本地修改，可直接安装当前目录。
dsh plugin --profile web add link:$PWD
配置¶
插件的默认配置位于 cordis.patch.yml 文件中：
| 配置项 | 默认值 | 说明 |
|---|---|---|
stateDir |
'' |
插件状态目录。留空时将使用 $DSH_HOME/session-manager 作为默认路径。 |
improveNonDeepSeekTitles |
true |
为支持该能力的标题模型关闭推理输出，以获得更自然的标题正文。 |
autoLoadFullHistory |
true |
自动加载当前会话的更早历史页，以补全导航能力。 |
数据与删除范围¶
关于永久删除会话的范围，请务必注意以下细节：
- 前置条件：永久删除仅支持已经归档、当前未运行且使用独立 JSONL 制品的 Session。仍由 Host 挂载但已经停止的会话会进入待删除队列，并在下次 DSH 启动、恢复该会话之前完成删除。正在生成回复的会话会被明确拒绝删除。
- 将被删除的内容：Session JSONL、对应的投影缓存、Workspace 成员关系、归档记录以及本插件保存的标签和收藏。
- 不会被删除的内容：
- MemOS 数据库或
~/.dsh/memos-plugin/ - Agent 记忆与 Skill
- 其他 Session
- 插件与模型配置
- 跨 Session 共享的附件对象
- MemOS 数据库或
注意事项¶
- 版本兼容性：当前版本针对 DeepSeek Harness
0.1.2-alpha.1开发和测试。由于 DSH 处于预发布阶段，Workspace 或 Session 内部接口可能会发生变化。如果发生未知格式的数据修改，插件会明确失败，不会静默处理。 - 供应链安全：通过 GitHub 安装时，插件直接使用 Release 中提交的
lib/目录，不执行安装期的构建脚本。如果需要固定供应链内容，可以将版本标签替换为具体的 commit SHA。
结语¶
DSH Session Manager 提供了一套从标签组织到安全删除的完整会话治理流程，适合需要维护大量历史对话记录的用户。更多技术细节与源码可参考 GitHub 仓库。
