前言¶

在 DeepSeek Harness（DSH）的 Web UI 中，会话管理会涉及归档、删除、移动工作区，以及单条 Agent preset 迁移。dsh-session-manager 是一个 DSH plugin，把这些操作放到 Web UI 中，并对不可逆操作增加确认。

这是什么¶

hkkz9522/dsh-session-manager 由 hkkz9522 维护，是一个用于从 Web UI 安全管理会话的 DeepSeek Harness (DSH) plugin。

它采用 MIT license，package.json 声明版本为 0.4.1。该插件是 Cordis plugin，声明 cordis >=4.0.0-rc <5 为 peer dependency。

核心功能¶

下面介绍已核实的几项能力。

• 归档和取消归档会话。
• 删除会话，并要求显式确认不可逆操作。
• 将会话移动到目标工作区，同时保留会话历史、标题、归档状态和派生会话关系。
• 按单条会话迁移 Agent preset。
• 在侧边栏提供 Session manager，可浏览 active 和 archived conversations；每行支持 Open、Archive/Unarchive、Move、Delete 和 Migrate preset。
• 在当前会话头部提供 Archive/Unarchive、Move to workspace 和 Delete conversation 操作。

移动会话¶

移动会话会改变其存储的 cwd；后续工具调用会运行在目标工作区。

如果移动的是一个正在运行的会话，插件会先中断并关闭该会话，然后自动刷新侧边栏。

删除会话¶

删除会话是永久性的。删除动作需要显式确认。

预设迁移¶

预设迁移只改变会话元数据，不改变消息历史、文件或已选择的工作区。

该功能一次只处理一个会话，没有批量迁移操作。Subagent 和 transient blank-session placeholders 会被排除在破坏性或迁移操作之外。

安装与启用¶

下面介绍安装命令。可以从 npm 安装，也可以从 GitHub 安装。

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

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

安装后，重启 DSH Web。如果浏览器仍加载旧的 client bundle，执行硬刷新：

Ctrl+Shift+R

典型用法¶

在 UI 中迁移预设¶

1、打开 Session manager。
2、定位目标会话，选择 Migrate preset。
3、选择一个当前可用的目标 preset，并确认。

调用本机接口迁移预设¶

下面是迁移一条会话到 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"}'

示例中的 sessionId 应替换为实际会话标识。

适用场景与注意¶

适合需要在 DSH Web UI 中管理会话的开发者。如果你需要归档、删除、跨工作区移动，或只想迁移某一条会话的 Agent preset，可以使用这个插件。

使用前注意：

• 删除会话是永久性的，操作前确认目标会话。
• 移动会话会改变存储的 cwd；后续工具调用会运行在目标工作区。
• 移动正在运行的会话会先中断并关闭它，然后刷新侧边栏。
• 预设迁移只改变会话元数据，不会改变消息历史、文件或已选择的工作区。
• Subagent 和 transient blank-session placeholders 不在破坏性或迁移操作范围内。
• 该插件没有批量迁移操作。
• 插件会以当前 dsh 进程权限运行。安装前建议检查源码与 MIT license。

结尾¶

经过上面的步骤，dsh-session-manager 可以将会话管理操作集中到 DSH Web UI：归档、删除、移动和单条预设迁移都有明确入口。

仓库地址：

https://github.com/hkkz9522/dsh-session-manager