前言¶
DeepSeek Harness（DSH）采用插件化架构，环境数据和持久化通常需要依赖特定的配置或数据库。在迁移工作环境或备份会话记录时，这种分离式的存储方式往往带来不便。dsh-vault 旨在解决这个问题，它通过将所有对话和日志直接写入工作区文件夹内部，使该文件夹成为一个自包含、可移植的存档。
核心功能¶
该插件由 XiaoWind 维护，专注于为 DSH 提供本地化的记忆存储能力。其主要功能包括：
- 自包含存档：将所有对话和日志保存在工作区文件夹内部。
- 实时镜像：在
dsh-session-vault/目录下实时镜像会话日志到sessions/<id>.l文件。 - 标题缓存：工作区标题被缓存在
workspace.json中。 - 自动恢复：启动时或打开工作区时自动恢复 DSH 持久化中的会话。
- 路径可便携：导入时重新绑定会话的
cwd到当前绝对路径。 - 幂等操作：无需变更时不会产生写入。
- 自动补全：记录会自动补全，支持
/vault export强制重写。 - 斜杠命令：提供
/vault斜杠命令用于查看状态、恢复和导出。 - 零依赖：无第三方依赖，无需构建步骤。
安装与启用¶
安装时必须使用 github:owner/repo 格式，因为该插件未发布到 npm registry。
DeepSeek Harness 桌面版¶
- 在桌面版的插件管理中添加插件。
- 输入规格：
github:XiaoWind/dsh-vault。 - 安装完成后，必须重启桌面应用才能生效。
CLI / Web 版¶
# 安装插件
dsh plugin --profile web add github:XiaoWind/dsh-vault
安装后，请重启 Web 应用。该插件依赖 dsh-app-boot 版本（例如 0.2.0-rc.2）及相关的 peerDependencies，不兼容的版本会被拒绝安装。
典型用法¶
插件提供 /vault 斜杠命令进行管理：
/vault status：查看已保险的工作区及每个工作区的会话数量。/vault restore：立即为已知工作区导入保险库中的会话和标题。/vault export：立即把当前持久化数据（重新）写入保险库文件。
新电脑迁移流程¶
- 在原电脑上，复制整个工作区文件夹（包括
dsh-session-vault/）。 - 将文件夹复制到新电脑。
- 在新电脑上打开该文件夹作为工作区。
- 插件会自动检测并恢复保险库中的会话和标题。
注意事项¶
- 重启生效：桌面版安装后必须重启桌面应用，CLI/Web 版安装后请重启 Web 应用。
- 记录完整性：DSH 的持久化日志要求
seq从 0 开始且连续。不完整的记录（如 seq 不连续）会被跳过，并在日志中注明原因。 - 运行时捕获：插件只在自己运行期间镜像事件。如果会话在插件未加载时继续追加事件，这段记录不会进入保险库文件。会话再次打开时，插件会比对并补全文件。
- 幂等性：已存在于持久化中的会话不会被重复导入。
