DeepSeek Harness 插件安装兼容性预检守卫 (dsh-install-guard)

DSH 的核心理念是「一切皆插件」。在引入社区插件时，版本不匹配（如 Node 版本、peer 依赖）或清单缺失可能导致服务崩溃或无法启动。dsh-install-guard 插件用于在安装前拦截此类风险。

这是什么¶

这是 DeepSeek Harness 的一个安装前兼容性预检守卫。它由用户 618527 维护，通过静态检查和运行时验证，确保待安装的插件能与当前 DSH 环境兼容。

核心功能¶

该插件提供以下检查与验证能力：

1. engines.node 检查：比对插件在 package.json 中声明的 engines.node 要求与当前 Node 环境版本。
2. @deepseek-ai/* peers 检查：比对 peer/dependency 范围与已解析的版本，防止核心包版本冲突。
3. dsh manifest 检查：检查插件清单中是否声明了 dsh.bundle.patch 或 dsh.client 等必要字段。
4. 隔离试启动：通过 trial=true 参数，将插件安装到临时配置中并执行 apply，捕获运行时或加载时的崩溃。

安装与启用¶

使用以下命令将插件添加到 web 配置文件中：

dsh plugin --profile web add dsh-install-guard

安装完成后，重启 dsh web 使插件生效。

典型用法¶

该插件注册了一个名为 plugin_install_guard 的工具，可通过对话指令调用。通常分为两步：

1. 检查兼容性：

    plugin_install_guard { spec: "plugin-name", action: "check" }

如需运行隔离试启动，在参数中添加 `trial: true`。

2. 确认后执行安装：

    plugin_install_guard { spec: "plugin-name", action: "install", resolution: { spec: "plugin-name@compatible" } }

适用场景与注意¶

• 适用场景：需要严格控制环境兼容性的 DSH 插件开发者和管理员。
• 触发方式：该工具为主动触发，非市场安装按钮的自动钩子。
• 风险提示：静态检查与隔离试启动虽能减少但无法消除所有第三方代码风险。安装前应检查源码与许可证。
• 生态配合：可与 dsh-doctor（环境健康）和 dsh-poison-guard（安全/审计）配合使用，构建完整的安装前检查链路。

总结¶

dsh-install-guard 提供了从依赖版本到运行时行为的全方位预检能力，是降低 DSH 插件引入风险、提升系统稳定性的实用工具。