dsh-state-sync

给 DeepSeek Harness（dsh）提供一键状态打包与同步：把可移植的 dsh 状态导出为一个 .tar.gz，在新机器上恢复并按 profile 重装插件。

• 设置页 — 设置 → DSH 状态打包与同步：导出、导入、浏览历史备份。
• 斜杠命令 — /dsh-state export|import|list|home，可在输入框直接使用。
• 独立脚本 — scripts/dsh-state-export.sh / scripts/dsh-state-restore.sh，不装插件也能用。

打包内容

路径	是否打包	说明
settings.yaml	✅	偏好设置（主题 / 语言 / 模型 / 各插件设置）
profiles/*/package.json	✅	插件依赖 + dsh.profile.bundles 激活列表
profiles/*/cordis.patch.yml	✅	每个 profile 的用户覆盖层
profiles/*/pnpm-lock.yaml	✅	依赖锁文件
profiles/*/pnpm-workspace.yaml	✅	profile 的 pnpm 配置
全局 cordis.patch.yml	✅	存在时打包
skills/	✅	自定义技能
sessions/	可选	--with-sessions 或设置页勾选
.credentials.yaml	❌	永不打包 — 请单独、加密复制
profiles/*/node_modules/	❌	恢复时用 dsh plugin install 重建
storages/	❌	派生数据（索引、缓存），可重建

安装

与本仓库其他插件一样走 npm / bundle 通道：

dsh plugin --profile web add dsh-state-sync
# 本地 checkout：
dsh plugin --profile web add ./plugins/dsh-state-sync

下次启动 dsh 生效。卸载：dsh plugin --profile web remove dsh-state-sync。

设置页

打开 设置 → DSH 状态打包与同步。

• 导出并打包 — 生成 $DSH_HOME/backups/dsh-state-<timestamp>.tar.gz。需要完整会话历史时勾选“同时打包 sessions/”（体积较大）。
• 导入并恢复 — 输入备份包路径或从“历史备份”列表选择，确认后执行：先校验包内条目（拒绝绝对路径与 .. 穿越），再解包到 $DSH_HOME，最后对包内每个 profile 运行 dsh plugin --profile <name> install。只想解包不重装时，取消勾选“导入后立即重装各 profile 插件”。

凭据不会被包含。请手动复制 $DSH_HOME/.credentials.yaml，或单独加密：

tar -C "$DSH_HOME" -czf - .credentials.yaml | gpg -c > dsh-credentials.tar.gz.gpg

斜杠命令

在输入框使用：

/dsh-state export [--with-sessions] [target.tar.gz]
/dsh-state import [--no-install] [archive.tar.gz]
/dsh-state list
/dsh-state home

import 不带路径时使用 $DSH_HOME/backups 下最新的备份。

独立脚本

与插件行为一致，适合无 UI 环境或尚未安装 dsh 时使用：

# 导出到 $DSH_HOME/backups/
scripts/dsh-state-export.sh --with-sessions

# 恢复并重装插件
scripts/dsh-state-restore.sh ~/.dsh/backups/dsh-state-20250816-120000.tar.gz

# 只解包、不重装
scripts/dsh-state-restore.sh --no-install ~/.dsh/backups/dsh-state-20250816-120000.tar.gz

配置

bundle 行支持两个可选配置键（profile cordis.patch.yml，id 为 state-sync）：

- insert:
    - id: state-sync
      name: dsh-state-sync
      config:
        backupDir: /Volumes/Backup/dsh-state   # 默认：$DSH_HOME/backups
        includeSessions: true                   # 默认：false

安全说明

• JSON API 仅接受同源 POST，且 Host 地址必须是本机回环（或 web runtime 的 trustedHosts 列表内）；跨站请求会被拒绝。
• 解包前会检查归档条目，绝对路径与包含 .. 的条目会被拒绝。
• 导入会按设计覆盖 $DSH_HOME 下的同名文件。只导入本插件自己创建的备份包。

License

MIT — 见 LICENSE。