dsh-config-sync

DeepSeek Harness 配置同步插件:一键把 DSH 的 API 设置、凭据、profile 插件补丁和用户 agent presets 导出为可移植的备份包,或单个口令加密文件(AES-256-GCM),在新机器上解密恢复。

A DeepSeek Harness plugin for backing up and restoring your DSH configuration — settings, API credentials, profile plugin patches and user agent presets — as portable bundles or a single password-encrypted file.

功能 / Features

注册 5 个模型工具 / registers 5 model-facing tools:

工具 / Tool	作用 / Purpose
dsh_config_export	导出为目录包(manifest.json + 文件)
dsh_config_export_encrypted	导出为单个口令加密文件 .dshsync
dsh_config_import	从目录包恢复(先预览,覆盖前自动备份)
dsh_config_import_encrypted	从 .dshsync 解密恢复
dsh_config_status	查看配置与备份清单(绝不显示密钥内容)

同步内容 / What gets synced:

• settings.yaml — 默认模型等设置
• .credentials.yaml — API 密钥(内容永不出现在工具结果里)
• profiles/<name>/** — cordis.patch.yml、package.json、pnpm-workspace.yaml 等(不含 node_modules)
• .agent-presets/** — 用户 agent presets

安全设计 / Safety:

• 导入只接受白名单路径,拒绝路径穿越(..)、绝对路径与 node_modules
• 导入默认 dry_run 预览;实际覆盖前把旧文件备份到 <DSH_HOME>\config-backups\pre-import-<时间戳>
• 加密文件:PBKDF2-SHA256(60 万次迭代)+ AES-256-GCM,口令错误明确报错;加密文件放网盘 / 微信 / U 盘都安全

安装 / Install

# 方式一:npm(推荐)
dsh plugin --profile web add dsh-config-sync

# 方式二:GitHub
dsh plugin --profile web add github:muyifc/dsh-config-sync

# 方式三:本地路径
dsh plugin --profile web add E:\path\to\dsh-config-sync

安装后重启 DSH 即生效。

使用 / Usage

在对话里直接说,或让模型调用工具:

导出我的配置到 D:\backup
把我的配置加密导出到 D:\backup          # 生成 .dshsync,留空口令则自动生成短语
从 D:\backup\dsh-config-<ts>.dshsync 恢复配置,口令 xxx
查看我的 DSH 配置同步状态

加密文件格式 / Encrypted format

.dshsync 是一个 JSON 信封(dsh-config-encrypted v1):

kdf    : PBKDF2-SHA256, 600000 次迭代, 随机 16 字节 salt
cipher : AES-256-GCM, 随机 12 字节 nonce, 16 字节认证 tag

解密后的载荷是 dsh-config-bundle-json v1 文档。口令是唯一防线:丢失口令文件即作废。

开发 / Development

pnpm install
node test/smoke.mjs

冒烟测试覆盖:明文导出、加密导出、错误口令拒绝、加密恢复、覆盖前备份、凭据跳过、状态查询,以及与旧版动态插件产物的跨版本解密兼容。

License

MIT