前言¶
在开发 DeepSeek Harness（DSH）插件时，依赖拓扑冲突常导致运行时崩溃。这类问题通常源于核心包的重复副本或版本漂移，最终引发 Symbol 键冲突。dsh-depguard 旨在通过预测和检测手段，帮助开发者规避此类风险。
这是什么¶
dsh-depguard 是一个由 DeLightor 维护的 DSH 插件。它专注于装前预测与装后检测，用于识别依赖拓扑冲突，防止因依赖问题导致的崩溃。
核心功能¶
本插件提供以下能力：
dsh_depguard_predict：装前预测。在安装新插件前，静态拉取其 manifest，并与当前 runtime 的@deepseek-ai/dsh-*基准进行比对。dsh_depguard_check：装后检测。扫描落盘依赖拓扑，检查是否存在问题。- 检测重复核心包副本：识别同一核心包的多份物理副本。
- 检测版本漂移：检查副本版本是否与 runtime 基准不一致。
- 检测私有包：发现私有包引用。
- 零运行时依赖：自身不引入运行时依赖。
- 只读操作：不修改配置文件，不自动执行构建命令。
- 提供修复建议：针对发现的问题给出修复方案。
安装与启用¶
使用官方安装命令添加插件：
dsh plugin --profile web add dsh-depguard
安装后，插件将随进程启动。
典型用法¶
开发者可以通过以下方式使用该插件：
- 装前预测：在安装新插件之前，静态拉取其 manifest 并与当前 runtime 的
@deepseek-ai/dsh-*基准比对，提前发现风险。 - 会话指令：在 DSH 会话中输入指令，例如“检查一下我的插件依赖”或“装 X 之前预测一下冲突”，触发检测功能。
适用场景与注意¶
该插件适用于所有需要管理 DSH 依赖拓扑的开发者。需要注意：
- 只读模式：插件仅执行检测并提供建议，绝不自动修复问题，也不会写入任何 profile 文件或修改配置。
- 权限要求：插件以当前 DSH 进程的权限运行。
总结¶
dsh-depguard 提供了从预测到检测的全链路依赖检查能力，帮助开发者在不修改配置的前提下发现潜在风险。
