dsh-session-manager

English | 中文

一个可直接安装的 DeepSeek Harness 会话管理插件。它列出本机全部已物化会话，包括运行中、空闲和已归档会话，并提供继续、大纲和永久删除。

关键说明

不需要修改 deepseek-harness 源码。

从 0.2.0 起，包内同时包含：

• 浏览器端会话管理面板；
• Host 端 session.delete RPC；
• 实时 Agent 停止与 Session 脱离兼容逻辑；
• JSONL 和 SQLite 持久化删除实现；
• loopback、Host、Origin 和 Fetch Metadata 安全校验。

用户只需安装本插件并重启 dsh web。不需要复制代码到 harness，不需要修改 SessionsApi、AgentLoop、SessionPersistence 或任何 harness 文件。

功能

• 完整会话列表：实时、冷会话、已归档或未归档会话，按更新时间展示标题、状态、工作目录等信息。
• 继续会话：通过浏览器 sessions 服务打开已有对话。
• 大纲预览：在浏览器内折叠 session.history 尾部窗口，展示轮次、用户/助手消息数及工具调用统计。
• 永久删除：先停止并等待实时 Agent 静默、脱离 Agent/Session 注册表、等待最终持久化排空，再删除存储数据。
• JSONL：删除该会话拥有的整个目录，包括日志和同目录快照。
• SQLite：在当前后端连接中执行事务删除，事件行通过外键级联清理。
• 未来兼容：若后续 harness 原生提供 AgentLoop.stop 或 SessionPersistence.delete，插件优先调用原生能力。

普通 fork 可以删除。origin: subagent 的子会话仍由父 Agent 管理，界面不提供删除按钮，直接请求会返回 agent-busy。

兼容范围

• 目标版本：DeepSeek Harness 0.1.0-rc.8。
• 已支持官方持久化后端：session-persistence-jsonl、session-persistence-sqlite。
• 自定义持久化后端必须自行提供 delete(id)，否则插件会明确拒绝，不会猜测或直接删除未知存储。
• 删除端点仅允许 loopback authority，例如 localhost、127.0.0.0/8、[::1]；通过局域网地址打开页面时只显示继续和大纲。

Host 实现针对 rc.8 缺失的三处能力做兼容补齐，并使用 rc.8 的内部 lifecycle/coordinator 结构。因此升级 harness 后应先运行本仓库测试；当上游提供原生接口时，插件会优先走原生接口，减少对兼容层的依赖。

安装

先在插件仓库构建 tarball：

pnpm install
pnpm pack

再将生成的 dsh-session-manager-0.2.0.tgz 安装到 web profile：

dsh plugin --profile web add -w ./dsh-session-manager-0.2.0.tgz

安装后重启 dsh web。

-w 是必须的：profile 目录带有 pnpm-workspace.yaml，裸 add 会触发 ERR_PNPM_ADDING_TO_ROOT。建议发布构建后的 tarball；从 git URL 安装拿到的是源码，目标机器还需要完成构建，容易缺少 lib/ 产物。

本包的 dsh.bundle.patch 自动插入一个 dsh-session-manager Loader 行。该行同时激活 Host 插件和 dsh.client 浏览器插件，peer 依赖从 dsh 应用闭包解析。安装者不需要手工编辑 profile 的 cordis.patch.yml。

使用

打开 设置 -> 会话：

• “继续”进入已有对话；
• “大纲”查看近期活动统计；
• “删除”打开确认框并永久删除会话。

删除不可恢复。正在打开的实时会话删除后会从 Host 注册表移除，其他界面会按现有 host/session-removed 生命周期更新。

工作原理

1. 浏览器读取 session.list 和 workspace.list，得到完整会话语料及归档状态。
2. 删除请求通过 Connection 通用 RPC caller 发送到 /api/session.delete。
3. 插件 Host 端先执行与 harness 相同的 loopback/同源安全检查。
4. 若会话实时运行，插件调用原生 AgentLoop.stop，或定位 rc.8 的精确 agentLoop.lifecycle(<id>) disposer，并等待完整 teardown。
5. 插件等待 persistence retirement，在 coordinator 的同一 session-id 串行链中删除 JSONL/SQLite 数据，并清理缓存与状态。
6. 客户端重新读取列表，确保最终展示与 Host 实际状态一致。

开发与验证

pnpm typecheck
pnpm test
pnpm build
pnpm pack

测试覆盖控制器竞态、loopback/Origin 拒绝、实时 lifecycle teardown、JSONL 目录删除、SQLite 事务删除、subagent 拒绝和同 id 并发去重。

已知限制

• 大纲来自 session.history 的近期窗口，不是完整日志统计。
• 删除已归档会话不会清理 workspace 中过期的 archivedSessionIds；该条目是惰性的，不会让会话数据复活。
• 会话列表没有跨标签页实时推送，页面会在删除和重连后刷新。
• 非 loopback 页面不显示删除能力。

License

MIT