dsh-startup-check：DeepSeek Harness 插件树启动前检查工具

在 DeepSeek Harness 的插件开发流程中，安装插件后直接重启往往伴随着“开箱即废”的风险。一旦 harness 无法打开，排查代码错误变得非常困难，因为此时负责读取代码的智能体可能已经失效。dsh-startup-check 将错误发现的时间点提前到重启之前。它通过静态检查和可选的隔离真机启动及浏览器冒烟测试，在插件真正生效前发现并修复问题，避免因插件错误导致 harness 启动失败。

工具定位¶

这是一个为 DeepSeek Harness profile 插件树提供启动前检查的工具。它包含静态检查以及可选的隔离真机启动和 headless 浏览器冒烟测试，支持实例关闭确认和残留实例审计。它提供 plugin_check 命令行工具，并捆绑了 plugin-fault-diagnosis 诊断技能。

核心功能¶

工具覆盖了插件开发中的多个关键环节：

静态检查：包括语法检查、包结构检查、补丁引用检查和配置树组装。
真机启动冒烟测试：启动一个隔离的实例验证插件树是否能正常加载。
页面侧冒烟测试：通过 CDP 连接浏览器，检查页面是否报错或渲染异常。
实例管理：确认隔离实例是否正常关闭，以及审计残留实例。
诊断技能：捆绑 plugin-fault-diagnosis 技能，能够根据检查结果定位文件并分类错误。

安装与启用¶

安装插件需要使用 DeepSeek Harness 的 CLI，安装后需重启 harness 以使插件生效。

dsh plugin --profile web add @cningan/dsh-startup-check

典型用法¶

安装完成后，可以使用 plugin_check 命令进行不同级别的检查。如果不指定参数，默认执行静态检查。

plugin_check                          # 静态检查
plugin_check { live: true }           # 包含真机启动冒烟测试
plugin_check { page: true }           # 包含页面侧冒烟测试（需安装浏览器）
plugin_check { sweep: true }          # 包含残留实例审计
plugin_check { live: true, killStray: true }   # 启动检查并清理本次残留实例

适用场景与限制¶

运行环境：插件仅支持 Windows 平台，使用 PowerShell 和 WMI 进行实例审计。运行环境需要 Node.js >= 22。
浏览器要求：如果需要进行页面侧检查，需要安装 Edge 或 Chrome 浏览器。
Profile 支持：当前固定到 web profile，其他 profile 为开放工作。
安全性：设计为只读模式，不会重启或触碰正在使用的 harness。

总结¶

通过在重启前进行全面的检查和修复，dsh-startup-check 能够帮助开发者避免因插件语法错误或结构问题导致 harness 无法启动的情况。更多技术细节、源码及文档请参考：GitHub。