前言¶

DeepSeek Harness (DSH) 的 Web 界面支持通过插件进行功能扩展。dsh-session-mgr 是一个由用户 mienfong 维护的客户端插件，旨在解决 Web 界面下会话管理不便的问题。它允许在设置页面直接对会话进行移动、归档、恢复、备份与删除，并支持跨工作区操作。

核心功能¶

该插件提供以下能力：

1. 移动会话：支持将任意会话（含已归档会话）移动到任意工作区。
2. 归档与恢复：将会话从侧栏隐藏（归档）或取消隐藏（恢复），原位置与排序保留。
3. 备份与汇入：
   • 备份：生成可携式压缩档（.zip 或 .tar.gz），包含 manifest.json、完整日志及所有附件。
   • 汇入：将便携式包安装到指定工作区，并重设会话的 cwd（当前工作目录），使其在另一台机器上无缝继续。
4. 删除会话：带红色二次确认弹窗的永久删除。
5. 界面与操作：支持英文/简体中文/繁体中文三语界面，提供批量操作功能以及标题栏快捷操作按钮。

安装与启用¶

需要在使用 Web profile 的环境中安装。执行以下命令：

dsh plugin --profile web add dsh-session-mgr

安装完成后，需在 profile 的配置中将插件加入启动列表（具体配置项名称需参考官方文档），并重启 Web 服务器使插件生效。

使用方法¶

1. 打开「设置 → 会话管理」。
2. 会话按工作区分组，已归档会话带有标记。
3. 使用工具栏按钮进行单条或批量操作（移动、归档、恢复、备份、删除）。
4. 在打开的会话标题栏，点击「移动到工作区」按钮可快速操作当前会话。
5. 切换语言时，可使用工具栏的简体/繁体按钮（仅当 Harness 语言设为中文时显示）。

技术细节与限制¶

• 跨机器迁移原理：会话通过 header 中的 cwd 关联工作区，但 cwd 是机器专属的绝对路径。因此，备份后需在目标机器上执行「汇入」，将 cwd 重设为该机器存在的路径，才能继续使用。
• 版本兼容性：如果备份包的 DSH 版本高于本机，汇入时会自动将本机不认识的事件标记为 ignorable: true，以确保会话正常加载。
• 性能与内存：备份和汇入操作在内存中完成，大附件会增加内存占用。会话清单需遍历所有会话，但标题读取已通过缓存优化。
• 安全限制：运行中的会话不可移动、归档或删除。已打开但闲置的会话在操作前会先卸载。删除操作不可恢复。

总结¶

dsh-session-mgr 为 DSH Web 用户提供了对会话的精细化控制能力。通过备份与汇入机制，它解决了跨设备数据迁移的痛点。安装并启用后，开发者可以在设置页面直接管理所有会话，提升工作流效率。