DeepSeek Harness 插件冲突总览：谁遮蔽了 DSH plugin 与安全模式排查

DeepSeek Harness 的插件冲突最迷惑人的地方是：它看起来像「某个插件坏了」，实际是两个插件都在、其中一个被盖住了。 判据很好抓——单装正常、合装异常、拆开又正常。冲突分三类（同名遮蔽、依赖重复、权限争用），处理只有卸载、替换、隔离三种，难的是定位谁和谁冲突。

DeepSeek Harness 的什么算冲突：三类成因与三种排查方案

一句话结论：遮蔽看「行为被替换」、依赖重复看「单装都好合装才坏」、能力争用看「权限或目录报错」——三类判据不同，别混着试。

方案 A：逐个禁用对照法（最可靠）

一句话结论：二分启用/禁用，把定位成本从指数级降到对数级——这是排查 DSH plugin 冲突的首选手段。

1. 先固定现场：记下当前已装清单与版本（用 DSH Plugin Hub 的已安装列表截图或导出），确保你随时能回到原状。
2. 禁用一半插件，观察现象：
   • 现象消失 → 问题承担者在被禁用的这一半；
   • 现象仍在 → 在被启用的那一半。
3. 对可疑的一半重复第 2 步，每次减半，通常三到四轮就能锁定到单个插件。
4. 锁定后单装验证：只装这一个 + 必定要用的那几个，确认现象是否复现——复现则找出与它成对的那个。
5. 恢复环境：按第 1 步的清单把插件装回去，避免遗留一个半残的环境。

方案 B：换 profile 隔离法（不破坏现有环境）

一句话结论：新建最小 profile 只装可疑的几个插件——既不动你日常环境，又能得到「是否能复现」这个决定性结论。

1. 新建一个干净 profile（用 --profile 指定，参数名以 dsh --help 为准）。
2. 只装两到三个可疑的 DSH plugin，数据目录也指向临时位置，彻底与日常环境隔离。
3. 观察现象：
   • 复现 → 问题限定在这几个插件内，继续用方案 A 在其中二分；
   • 不复现 → 冲突涉及你既有配置，回到日常 profile 用方案 A。
4. 结论都可用：两种结果都能把范围至少砍一半，这就是它值得做的原因。
5. 用完删掉临时 profile，避免以后混淆。

方案 C：看加载顺序与注册日志（定位遮蔽）

一句话结论：遮蔽类冲突不需要二分，看「谁先注册、谁后覆盖、有没有重复注册提示」就能直接指出关系。

1. 看启动/加载输出：插件加载顺序通常在启动日志里可见；后注册者覆盖先注册者，这条能直接解释「为什么它的行为变了」。
2. 找注册冲突提示：重复注册同名工具时通常会有警告或错误——这类日志是最硬的证据，比反复试探快得多。
3. 用最小组合复现一次：只加载这两个插件，确认单一的覆盖关系（排除第三方干扰）。
4. 把结论写下来：谁覆盖谁、影响哪个动作、表现是什么——这份记录对以后加插件很有价值。
5. 顺手看是不是版本导致：同一插件的两个版本共存也会造成类似的「重复注册」，此时锁定版本即可（见 给 DSH plugin 锁版本与回滚）。

DSH plugin 冲突的最小复现收敛方法

一句话结论：目标是得到「最小插件集合 + 稳定复现步骤」，因为不能复现的冲突无法验证修复。

1. 收敛插件集合：从全量逐步减到能复现的最小组合（通常 2-3 个）。
2. 固定复现步骤：写清「装什么 → 做什么操作 → 出现什么现象」，三步即可。
3. 排除环境变量：换一个干净数据目录再复现一次，确认不是历史配置造成的。
4. 记录版本：最小组合里每个插件的版本都记下——换版本后可能就不复现了，这也是修复思路之一。
5. 验证修复：修完后用同一份复现步骤再跑一遍，确认现象消失；只看「装回去了」不成立。

DeepSeek Harness 插件冲突的三种收场

一句话结论：问自己「是否真的同时需要这两个插件」——不需要就卸载，需要就换替代或隔离，别让冲突长期存在。

1. 卸载 / 停用一个：最省事，适合其中一个只是试用或已被替代。
2. 换替代插件：同一需求常有多份实现，用 DSH Plugin Hub 按场景找候选，避开冲突实现。
3. 隔离到不同 profile：两者都保留但不共存，使用时切换——代价是操作步骤变多。
4. 不建议的做法：靠「碰巧的加载顺序」长期共存——升级一次顺序变了就会复发。

DSH plugin 排查注意事项

一句话结论：冲突排查的核心是「控制变量」——固定清单、二分开关、最小复现，三件事做到位就没有查不出的冲突。

1. 先记录再动手：一份准确的已装清单是所有排查的起点。
2. 优先用二分而不是全量卸载，省时间且不破坏环境。
3. 注册冲突类日志比现象更可靠，能拿到就别猜。
4. 区分「冲突」与「插件故障」：单装就坏的属于后者（插件本身或环境前提问题）。
5. 版本也可能是冲突源：同一插件两个版本共存会伪装成冲突。
6. 修复状态如实：本文属方法类总结，基于官方仓库的插件注册/profile 机制与通用排障实践；三类成因的表述是归纳而非官方分类，具体冲突提示文案随版本变化，请以你环境中的实际日志为准。

二分排查时，DSH Plugin Hub 的已安装列表就是你的「控制台」——逐个停用、逐个恢复，都在同一处看清当前状态。

来源：apps/cli/README.md、docs/user/develop/basic/publish.md、插件权限边界。