前言¶
在 DeepSeek Harness (DSH) 生态中，通过插件扩展能力是主要手段。但直接安装插件时，环境配置冲突或运行时错误常导致系统无法启动，排查过程往往对初学者不友好。dsh-plugin-safe-install 是一个插件，它将一套标准化的“安全安装技能”封装为内置流程，覆盖审计、逐个安装、五级验证、依赖处理和干净卸载等环节，解决上述痛点。
插件简介¶
该插件由用户 rouyiemei 维护，采用 MIT 许可证。它的核心价值在于将安装过程“工程化”，避免因一次性安装多个插件或配置错误导致的系统崩溃。
核心功能¶
安装该插件后，DSH Agent 会获得 dsh-plugin-safe-install 技能。执行时，Agent 会按以下流程操作：
- 安全审计：在安装前检查插件来源与内容，规避风险。
- 逐个安装与五级验证：装一个、验证一个，防止错误累积。
- 原生依赖处理：解决 node-pty、sharp 等常见的构建问题。
- 干净卸载/回滚：提供清理与回退机制，确保环境整洁。
- 收尾检查：安装完成后进行综合验证。
安装与启用¶
在终端执行以下命令添加插件。插件通过 dsh.bundle.patch 声明自动挂载，无需手动编辑配置文件。
dsh plugin --profile web add github:rouyiemei/dsh-plugin-safe-install
安装完成后，必须重启 dsh web 进程，技能才会生效。
使用方法与注意事项¶
安装成功后，Agent 会在识别到相关指令时自动执行流程。典型的触发方式为自然语言对话，例如“帮我安装 XX 插件”。
在验证安装结果时，必须使用 dsh-doctor boot 命令。该命令执行完毕后会自动退出，用于判断系统启动是否正常。
注意：
* 不要使用 dsh web --port 0 做测试，该命令会启动常驻服务，不会自动退出，容易导致超时误判。
* 如需卸载该插件，执行：
dsh plugin --profile web remove dsh-plugin-safe-install
技术特性¶
该插件在实现上保持了极简与安全：
* 零运行时依赖：不依赖外部库。
* 无生命周期脚本：安装时不执行任意代码，无网络访问权限，仅读取本地文件。
* 可读性：技能全文存储在 skills/dsh-plugin-safe-install/SKILL.md，内容 100% 可读。
结语¶
dsh-plugin-safe-install 专注于提供稳定、可预期的插件安装体验。对于希望在 DSH 环境中保持系统稳定性的开发者，这是一个值得纳入工具箱的插件。更多细节可参考 GitHub 仓库。
