概览

dsh-session-manager

Session manager for the DeepSeek Harness Web UI: delete sessions, archive sessions, move sessions across workspaces, and migrate a session’s Agent preset. Suggestions are welcome on GitHub. 在 DeepSeek Harness Web 中进行会话管理，包括：删除会话、归档会话、跨工作区移动会话、迁移会话的 Agent 预设。欢迎至GitHub提意见。

README / ZH

插件文档

dsh-session-manager — DeepSeek Harness 会话管理器

English | 中文

用于在 DeepSeek Harness（DSH）Web 中进行会话管理，包括：删除会话、归档会话、跨工作区移动会话、迁移会话的 Agent 预设。欢迎至 GitHub 提意见。

功能

归档 / 移出归档会话。
删除会话：带不可逆操作的二次确认。
移动至工作区：保留历史、标题、归档状态和派生会话关系，同时把会话的工作目录更新为目标工作区。
迁移 Agent 预设：可按需修改。典型工况：当原预设被改名或删除，导致会话无法恢复时，可修复该会话。
会话管理窗口：在侧边栏中浏览未归档和已归档会话，并对每一行执行打开、归档 / 移出归档、移动、删除、迁移预设。
当前会话标题区域提供归档 / 移出归档、移动至工作区和红色的删除会话按钮。

UI 入口

会话标题右侧：归档 / 移出归档、移动至工作区、删除会话。
侧边栏底部 → 会话管理：查看全部会话（含归档会话）并操作每一条会话。

Agent 预设迁移

打开会话管理。
找到目标会话，点击迁移预设。
从当前可用的预设中选择目标预设并确认。

例如：当会话无法恢复，报错表明原 Agent 预设不存在时（例如删掉了 router-standard），可以使用迁移功能。

插件会优先读取最后一条 agent-preset/selected 事件中的有效预设；若不存在该事件，则读取会话 header 中的预设。迁移时会安全改写对应的持久化记录、释放可能残留的 live persistence owner，并刷新会话列表。若该会话当前打开，请在迁移后重新打开再继续会话。

迁移预设只会修改会话元数据，不会改写历史消息、文件或当前工作区。

安装

本插件已收录于 dsh-market 和 awesome-dsh-plugin，可以通过 DSH 应用内的插件市场直接搜索安装。

从 dsh-market 安装

dsh plugin --profile web add npm:dsh-session-manager

从 GitHub 安装

dsh plugin --profile web add github:hkkz9522/dsh-session-manager

安装后重启 DSH Web。若浏览器仍加载旧的客户端代码，请使用 Ctrl+Shift+R 强制刷新。

本地开发 / 运行时注入

dev_inject_plugin {"dir": "<本仓库的绝对路径>"}

HTTP API

以下本地接口供 Web UI 使用，也可用于集成和排查：

POST /session-manager/api/delete         { sessionId }
POST /session-manager/api/unarchive      { sessionId }
GET  /session-manager/api/workspaces
POST /session-manager/api/move           { sessionId, targetWorkspaceId }
GET  /session-manager/api/preset-scan?sessionId=<sessionId>
POST /session-manager/api/preset-migrate { sessionId, toPreset }

示例：将会话迁移到 standard 预设。

curl -s -X POST http://127.0.0.1:3080/session-manager/api/preset-migrate \
  -H 'content-type: application/json' \
  -d '{"sessionId":"session-...","toPreset":"standard"}'

安全与行为说明

删除不可恢复，因此界面始终要求确认。
移动正在运行的会话时，插件会先中断并关闭该会话，然后自动刷新侧边栏；请在目标工作区重新打开会话后继续。
移动会改写会话保存的 cwd，之后的工具调用将在目标工作区执行。
subagent 会话和临时空白会话占位不会参与删除、移动或预设迁移。
文件改写使用临时文件和原子替换（环境支持时），避免产生部分写入的会话工件。

兼容性与开发

本插件是 Cordis 插件，声明的 peer dependency 为 cordis >=4.0.0-rc <5。
lib/index.js 是 host 端 ESM 插件，lib/client.js 是 Web 客户端 bundle，无需构建步骤。
提交修改前请运行：

node --check lib/client.js
node --check lib/index.js
git diff --check
node scripts/smoke-test.mjs
npm pack --dry-run

发布记录见 CHANGELOG.md。

致谢

感谢每一位安装和使用 dsh-session-manager 的用户，也感谢提交 Issue 与 Pull Request 帮助改进本插件的朋友们。

本插件已被 dsh-market 和 awesome-dsh-plugin 收录。欢迎提出修改意见。

开源许可

MIT

dsh-session-manager