前言¶
在開發 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 提供了從預測到檢測的全鏈路依賴檢查能力，幫助開發者在不修改配置的前提下發現潛在風險。
