前言¶
DeepSeek Harness（DSH）采用“一切皆插件”的架构，允许开发者通过安装各种插件扩展功能。然而，插件生态中的不稳定因素可能引发连锁反应：一个插件的不良配置可能导致整个工具层崩溃，或者干扰其他插件的正常工作。在部署或维护 DSH 环境时，识别这些潜在风险至关重要。
dsh-stability-audit 是为此设计的审计工具。它通过静态分析扫描已安装的插件，评估其稳定性风险（包括钩子面、启动任务、预检健康度及依赖关系），并提供修复建议。这避免了在插件真正破坏 Harness 前进行被动排查。
什么是 dsh-stability-audit¶
dsh-stability-audit 是一个运行在 DSH 环境中的审计插件，由社区开发者 chunfenxiazhi-collab 维护。它通过静态代码分析和可选的隔离安装验证，对插件进行稳定性分级（🔴/🟡/🟢），并给出具体的修复建议。该工具旨在帮助开发者在安装新插件或升级现有插件前，评估其可能带来的风险。
核心功能¶
该插件提供以下核心能力：
- 静态稳定性分析：扫描插件的钩子面、启动任务、预检（preflight）以及依赖项，识别潜在的结构性问题。
- 可选的隔离安装验证：在隔离环境中测试插件，验证其能否独立安装并正常启动。
- 风险分级与修复建议：根据分析结果给出 🔴（高风险）、🟡（中风险）或 🟢（低风险）的评级，并提供具体的修复命令或操作指引。
- 远程预审能力：支持对在线仓库（如
owner/repo）的插件进行远程预审，无需本地安装即可评估风险。 - 批量测试支持：支持对多个在线插件进行批量稳定性测试。
- 机器可读输出：提供 JSON 格式的输出，便于其他 Agent 或脚本直接调用和处理。
- 零副作用：以只读模式运行，绝不执行被审计的插件代码，确保环境安全。
安装与启用¶
在终端中执行以下命令安装该插件：
dsh plugin --profile web add dsh-stability-audit
安装完成后，需要重启 DSH Web 服务。重启后，Agent 可以通过自然语言指令“run the plugin stability audit”来调用该工具进行审计。
典型用法¶
除了通过 Web 界面指令调用外，该工具也提供了命令行接口（CLI），支持不同的审计模式。
本地扫描¶
扫描当前 Web Profile 中已安装插件的稳定性：
node cli.mjs
机器可读输出¶
获取结构化的 JSON 数据，便于自动化脚本处理：
node cli.mjs --
远程预审（完整流程）¶
克隆远程仓库并进行静态分析及隔离安装测试：
node cli.mjs --remote owner/repo --dynamic
远程预审（JSON 输出）¶
仅对远程插件进行静态分析并输出 JSON：
node cli.mjs --remote owner/repo --
适用场景与注意¶
适用场景¶
- 插件引入前评估：在安装未知来源的社区插件前，先进行远程预审。
- 现有环境排查：定期扫描已安装的插件，发现潜在的不稳定性隐患。
- 批量维护：在更新多个插件时，使用批量测试功能快速筛选出有问题的包。
注意事项¶
- 静态分析的局限性：静态分析无法完全模拟运行时行为（如某些 Hook 在特定上下文下的抛出）。🔴 级别通常表示“需要人工介入检查”，而非绝对确定插件已损坏。
- 隔离环境的限制：隔离测试使用的是无头（headless）Profile。如果插件依赖于 Web 独占服务（如
storageDomain），在隔离环境下可能会显示假阴性（❌），但这仅作为环境依赖的提示。 - 运行时探测：目前尚不支持事件循环延迟等运行时性能探测，相关功能在 v2 路线图中。
- 修复建议性质：工具提供的修复建议仅为提示，并非自动应用。由于环境差异，建议在执行修复前由人工确认。
- 只读模式：该工具全程以只读模式运行，不会执行被审计的插件代码，不会对 DSH 环境产生副作用。
总结¶
dsh-stability-audit 是一个务实的安全审计工具，它通过静态规则和隔离测试，将插件生态中的潜在风险显性化。开发者可以利用它建立插件准入机制，减少因插件故障导致的 Harness 崩溃。
目录页：chunfenxiazhi-collab/dsh-stability-audit
源码仓库：chunfenxiazhi-collab/dsh-stability-audit
