在使用 DeepSeek Harness (DSH) 进行智能体开发时,API 设置、凭据、profile 插件补丁和用户 agent presets 往往分散在不同文件中。手动迁移这些配置既繁琐又容易出错。dsh-config-sync 插件提供了一套将 DSH 配置导出为可移植备份包或加密文件的工具集,支持在新环境下的快速恢复。
插件概况¶
- 名称:
muyifc/dsh-config-sync - 分类:工作流
- 许可证:MIT
核心功能¶
该插件注册了 5 个模型工具,用于配置的备份、恢复与状态查看:
- dsh_config_export:将配置导出为目录包,包含
manifest.json和对应文件。 - dsh_config_export_encrypted:将配置导出为单个口令加密文件 (
.dshsync)。 - dsh_config_import:从目录包恢复配置。导入前支持预览,实际覆盖前会自动备份。
- dsh_config_import_encrypted:从
.dshsync文件解密并恢复配置。 - dsh_config_status:查看配置与备份清单。该工具会过滤掉凭据内容,确保安全。
安装与启用¶
在终端中执行以下命令即可安装插件:
dsh plugin --profile web add dsh-config-sync
安装完成后,重启 DeepSeek Harness 服务即可生效。
典型用法¶
在对话中直接下达指令,或让模型调用上述工具:
- 导出为目录包:
“导出我的配置到 D:\backup” - 导出为加密文件:
“把我的配置加密导出到 D:\backup” - 从加密文件恢复:
“从 D:\backup\dsh-config-.dshsync 恢复配置,口令 xxx” - 查看状态:
“查看我的 DSH 配置同步状态”
安全与注意事项¶
- 路径限制:导入操作仅接受白名单路径,明确拒绝路径穿越 (
..)、绝对路径以及node_modules目录。 - 自动备份:导入默认执行
dry_run预览。若确认覆盖,旧文件会自动备份到<DSH_HOME>\config-backups\pre-import-<时间戳>。 - 隐私保护:凭据内容绝不会出现在任何工具的执行结果中。
- 加密标准:加密文件采用 PBKDF2-SHA256 (600,000 次迭代) + AES-256-GCM 算法。口令是唯一防线,丢失口令将导致文件无法恢复。
该插件适用于需要在多台机器间同步 DSH 配置,或希望对敏感凭据进行加密存储的开发者。安装前建议检查源码与许可证。