前言¶
DeepSeek Harness (DSH) 插件系统允许扩展功能。dsh-plugin-oss-backup 是一个联网工具类插件，由 KAIROSLLL 维护，用于将工作区文件备份到对象存储。
它支持 RustFS / MinIO 等自建 S3 兼容服务，以及阿里云 OSS、AWS S3。一次配置后，可以在设置界面操作将整个文件夹传上云。
核心功能¶
该插件提供以下能力：
- 手动备份整个文件夹：在设置页的「备份目录」填入目标目录并保存，然后回到「手动备份」块点击「立即备份」，即可递归备份整个文件夹。
- 定期全量备份：按时间表自动将整个目录完整上传。
- 文件改动自动备份：打开开关后，每次保存文件都会在 2 秒后自动上传。
- 让模型上传单个文件：模型可以直接调用工具，将一个本地文件传到指定的对象路径。
- 《接数据》：趣味功能，在「上传状态」框里玩一局节奏小游戏，通关才真正开始备份，不想要可以在设置里关掉。
安装¶
插件支持通过包管理器安装：
cd <你的插件目录>
pnpm add dsh-plugin-oss-backup
（或者把打好的 .tgz 装进 DSH profile）
安装完成后重启 dsh web，设置页里就会出现「对象存储备份」选项。
配置与使用¶
凭证与安全¶
插件只从环境变量读取凭证，不落盘、不回显、不进日志。支持 .env 文件（只读不写），适合本地临时使用，务必确认在 .gitignore 里。也支持通过密钥管理器（如 1Password、Vault）注入环境变量。重启 dsh web 才能生效新环境变量。
使用步骤¶
- 在设置页的「备份目录」里填入要备份的目录。
- 点击保存。
- 回到「手动备份」块，点击「立即备份」。
- 系统会递归备份整个文件夹，并显示成功/失败的数量与总大小。
注意事项¶
- 凭证仅通过环境变量传递，界面只显示”已设置 / 未设置”。
- 支持通过密钥管理器（如 1Password、Vault）注入环境变量。
- 已实测通过：RustFS 真实上传（本机）、阿里云连通性。
结语¶
该插件为 DSH 提供了标准化的云端备份能力，通过环境变量管理凭证保证了安全性。更多详情可查阅插件目录或源码仓库。
