前言¶
DeepSeek Harness（DSH）在啓動時會加載 profile 中的插件 bundle。新增第三方插件後，如果組合裏出現重複工具註冊、entry id 衝突、peer 版本不一致、多個 memory 插件同時啓用，或 telegram/lark/IM 風格渠道插件缺少 token/app id，可能影響啓動。
下面介紹 dsh-plugin-auditor。它在新插件加入 profile 前，對當前插件組合做只讀兼容性預檢，輸出風險報告，用於降低新增插件後的啓動風險。
插件定位¶
倉庫路徑爲：
HYY-King/dsh-plugin-auditor
許可證爲：
MIT
它面向 DSH 插件組合審覈，工作方式是以只讀檢查爲主，不執行被審計插件代碼。資料說明其零依賴，使用內置迷你 YAML 解析器處理：
cordis.patch.yml
peerDependencies 聲明爲：
@deepseek-ai/cordis ^4.0.1
@deepseek-ai/dsh-tools ^0.1.0-rc.6
核心檢查項¶
下面介紹這些檢查項。
1、重複工具註冊：檢查兩個插件是否註冊相同工具名。
2、entry-id 衝突：檢查多個 bundle 是否在：
cordis.patch.yml
中掛載相同 entry id。
3、peer 版本不一致：檢查插件要求的：
@deepseek-ai/*
peer 版本是否與已安裝版本不一致。
4、memory 插件唯一性：檢查是否同時啓用多個 memory 插件。
5、渠道插件憑據：檢查 telegram/lark/IM 風格渠道插件啓用時是否缺少 token/app id。
工作方式¶
該插件只讀檢查 profile 的以下文件：
package.json
cordis.patch.yml
node_modules
其中：
node_modules
用於查看已安裝包。檢查過程不執行被審計插件代碼。
安裝與啓用¶
以下安裝命令來自資料示例：
--profile web
是示例使用的 profile；實際 profile 名稱需按當前 DSH 配置確認。
安裝命令：
dsh plugin --profile web add github:HYY-King/dsh-plugin-auditor
安裝完成後，重啓 dsh web 以激活插件：
# restart dsh web to activate
典型用法¶
插件激活後，調用工具：
audit_plugins
完整審計：不帶參數調用：
audit_plugins
掃描當前 profile 的所有 bundle。
新插件預覽：調用：
audit_plugins
並傳：
newPlugins: ["package-name"]
做名稱級衝突預覽。
適用場景與注意¶
適合在 DSH profile 中維護多個插件、希望在新增插件前先看組合風險的開發者或使用者。
需要注意：
- 審計結果是靜態啓發式信號，不是兼容性保證。
- 插件以當前 dsh 進程權限運行，安裝第三方插件前應審查其源碼、權限和許可證。
- 資料中的安裝示例使用：
--profile web
未說明該 profile 是否爲通用安裝要求。
- 目錄頁線索來自資料，獨立站點，不與 DeepSeek 或幻方構成官方從屬關係。
鏈接¶
GitHub：
https://github.com/HYY-King/dsh-plugin-auditor
目錄頁線索：
https://www.skillhub.cn/plugins/HYY-King/dsh-plugin-auditor
