前言¶
DeepSeek Harness 采用“一切皆插件”的架构，插件生态在短时间内迅速扩张。随之而来的是插件间的冲突、隐形故障，以及 Creator 模式下插件重启即丢失的问题。dsh-plugin-guardian 旨在解决这些运维痛点，为插件安装前提供诊断、跨插件冲突扫描，以及将临时插件转换为持久资产的能力。
核心功能¶
该插件提供四个核心工具，覆盖插件从诊断到落地的完整生命周期：
-
plugin_doctor
对单个插件目录进行健康检查。它通过读取文件内容，提供带有置信度等级（confirmed/inferred/unknown）的诊断报告，用于评估插件配置是否完整、依赖是否合规。 -
plugin_profile_scan
扫描已安装的插件集，检测跨插件的工具名称冲突、重复项或版本偏差。这有助于在插件投入使用前发现潜在的系统崩溃风险。 -
plugin_promote
将处于 Creator 模式或临时状态的插件提升为持久化、可版本控制的资产。该过程会将插件复制到受管理的暂存目录，并生成源地址和哈希标记。 -
plugin_install
引导式安装流程。默认处于“审计优先”模式，在执行安装前会先进行安全检查，确认无误后（通过approve=true）再执行实际安装命令。
安装与启用¶
在 DeepSeek Harness 的 Web Profile 下安装该插件：
dsh plugin --profile web add github:Nico0713520/dsh-plugin-guardian
安装完成后，重启 Harness 服务即可在会话中调用上述工具。
典型用法¶
以下为各工具的基本调用示例：
# 诊断指定插件目录
plugin_doctor target="/path/to/my-plugin"
# 扫描当前 Profile 下所有已装插件的冲突
plugin_profile_scan
# 将临时插件提升为持久资产
plugin_promote source="/path/to/my-plugin"
# 审计式安装（不实际执行）
plugin_install spec="npm:some-plugin"
# 审计通过后执行安装
plugin_install spec="npm:some-plugin" approve=true
适用场景与注意事项¶
- 适用对象：需要进行插件治理、解决冲突或确保 Creator 模式插件持久化的 Harness 管理员。
- 安全性：
plugin_doctor和plugin_profile_scan是只读操作，不会触发网络请求、执行源码或修改文件。plugin_promote仅写入受控的暂存目录（$DSH_HOME/.guardian-plugins），默认情况下不会直接修改您的 Live Profile，除非显式指定参数。
- 运行环境：需要 Node.js >= 20 且 DeepSeek Harness 版本为 0.1.0-rc.x。
总结¶
dsh-plugin-guardian 为 DeepSeek Harness 的插件生态提供了一个基础的治理层。通过分级置信度的诊断和严格的读写边界控制，它帮助开发者在插件生态快速膨胀的背景下，保持系统的稳定性与可控性。
- 插件目录：https://www.skillhub.cn/plugins/Nico0713520/dsh-plugin-guardian
- 源码仓库：https://github.com/Nico0713520/dsh-plugin-guardian
