mienfong/dsh-session-mgr 是一个为 DeepSeek Harness Web 界面设计的会话管理插件,核心解决的是跨工作区、跨机器的会话搬移与整理问题。它通过改写会话日志中的 cwd(工作目录)字段,让在 A 机开始的会话能在 B 机继续,而不是简单复制文件导致无法打开。

核心功能

移动与整理:可以把任意会话(包括已归档的)移动到任意工作区,支持单条或批量操作。归档功能把会话从侧栏隐藏但保留原位置,恢复时回到原位。

可携式备份与导入:这是它最实用的功能。备份会生成一个 <sessionId>.zip 或 .tar.gz 压缩包,内含 manifest.json、完整会话日志以及会话引用的全部附件(图片、文件)。导入时,插件会把会话的 cwd 重设为你本机存在的路径,会话内容不变,从而在新机器上无缝继续。

删除:永久从磁盘删除会话,有红色二次确认弹窗,操作不可逆。

三语界面:英文、简体中文、繁体中文跟随 Harness 语言设置,插件页面内也有简繁切换。

跨机器搬移的具体流程

会话通过 header 里的 cwd 关联工作区,而 cwd 是每台机器专属的绝对路径。所以直接复制文件夹到另一台机器,会因路径不存在而无法继续。正确做法是:

  1. 在 A 机对会话点「备份」,得到可携式包。
  2. 把包复制到 B 机。
  3. 在 B 机点「汇入」,选择该包并指定会话应归属的工作区或文件夹。导入过程会把 cwd 重写为 B 机的路径。

如果包里的 DSH 版本比本机新,可能出现本机不认识的事件类型。导入时插件会用本机的事件词表逐条比对,给未知事件补上 ignorable: true 标记,只重压含该事件的那一帧,其他帧保持原字节与校验和不变。界面会提示跳过了哪些类型,避免出现“导入成功但打开会话报错”的情况。

环境要求与安装

需要 DeepSeek Harness 的 web profile(dsh web),Node.js 版本 ^22.19.0 || >=24.0.0。

推荐从 npm 安装:

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

装完后需要把 "dsh-session-mgr" 加入 web profile 的 package.json 里 dsh.profile.bundles 数组(与其他插件条目并列),然后重启 web 服务器。也可以指定版本,如 mgr@0.6.7"">`dsh-session-mgr@0.6.7`。

从本仓库安装的方式是把路径替换为实际文件夹路径:

dsh plugin --profile web add "file:<path>\dsh-session-mgr"

之后同样需要加入 dsh.profile.bundles 并重启。

安全机制

插件有一些保护措施:运行中的会话不能被移动、归档、备份或删除;已打开但闲置的会话在操作前会先从内存卸载;目标位置已有同名文件时会拒绝操作而不是覆盖;跨磁盘移动时自动降级为“复制+删除”模式。

作者:月影鹏鹏  创建时间:2026-10-23 18:45
最后编辑:月影鹏鹏  更新时间:2026-10-23 18:46