前言¶
DeepSeek Harness (DSH) 的核心設計是“一切皆插件”。隨着項目規模擴大，環境依賴複雜化、版本混亂以及安裝前的靜態檢查缺失，往往會導致環境故障。官方插件管理器處理了基礎的組合包與配置頁託管，但在安裝前質量門、深度環境診斷以及插件市場等環節存在缺口。
dsh-plugin-manager-companion 作爲官方插件管理器的補充工具，旨在填補這些缺口，提供安裝前的質量門控、五層環境診斷、插件市場與技能預設管理，以及安全可靠的升級流程。
插件簡介¶
- 名稱：
dsh-plugin-manager-companion - 維護者：LX2000WASD
- 核心價值：安裝前質量門、環境診斷、插件市場與技能預設、升級
- 定位：官方插件管理器的補充工具，通過官方通道執行寫操作，不直接調用 pnpm 或修改
cordis.patch.yml。
核心能力¶
安裝前質量門¶
在官方 installBundle 流程中增加靜態檢查步驟：
1. 掃描候選包的 spec，確認指向。
2. 官方執行安裝但不激活（enabled: false）。
3. 檢測未聲明的 import、聲明瞭但未安裝、把官方包聲明爲普通 dependencies 導致重複副本、入口解析失敗等問題。
4. 合格則激活，不合格則回滾。
試裝默認關閉。開啓後，候選包會先裝進 <環境名>-dpmc 測試環境並啓動，通過後才裝進真實環境。測試環境默認保留 14 天。
環境控制台¶
通過設置頁入口提供三個子頁：
- 體檢：五層診斷（L1 依賴、L2 組合、L3 運行時、L4 一致性、L5 生態）。L5 生態層不聯網、不判定，顯示“未查”。每條發現帶證據與處置建議。
- 環境：管理本機所有 profile（啓動、停止、重命名、刪除、跨環境複製、備份導出）。
- 設置：本插件自身的配置。
插件市場與技能預設¶
- 展示社區索引，支持按名稱、倉庫、主題與描述搜索，按星數、更新時間排序。
- 卡片標出風險等級與可裝性。
- 詳情展示校驗結論與風險明細。
- 管理 SKILL.md 與 agent 預設，支持查看安裝記錄與重新拉取。
升級¶
- 在“關於”頁查看官方運行時、實驗包與本插件版本狀態。
- 支持手動或按需檢查更新。
- 升級前在測試環境驗證，未通過驗證的版本不會進入真實環境。
安裝與啓用¶
該插件要求 DSH 版本大於等於 0.1.6-alpha.2。
安裝命令如下：
dsh plugin --profile <name> add dsh-plugin-manager-companion@latest
安裝完成後，需在插件管理頁啓用該插件，並重啓對應的 profile。
命令行操作¶
插件提供命令行工具 dshpmc，用於腳本、CI 流水線或界面不可用時執行操作。
- 五層體檢：
dshpmc analyze --profile <name>
對環境進行全量體檢，發現問題時退出碼爲 1。
- 列出組件：
dshpmc list --profile <name>
顯示組合包、依賴、已安裝的技能與預設。
- 常用操作：
dshpmc install | remove | update | mount | uninstall-kind
注意事項¶
- 權限與安全：插件以當前 DSH 進程的權限運行。安裝前請務必檢查源碼與許可證，避免在不受信的環境下執行安裝。
- 已知限制：
- 質量門回滾可能失敗（例如官方拒絕移除被保護的組合包），需手工處理殘留。
- 安裝守衛僅攔截 agent 的工具調用，無法攔截終端中手動敲擊的命令。
- 環境變量敏感鍵過濾按形態匹配，並非全集，敏感鍵仍可能傳給子進程。
- L5 生態層不聯網、不判定。
- L3 層的註冊名衝突只覆蓋 profile 本地包，不掃描官方 scope。
- 端口只在實例命令行帶
--port時可知，默認端口顯示“未知”。
總結¶
dsh-plugin-manager-companion 通過質量門與五層診斷，降低了 DSH 環境維護的故障率；通過插件市場與升級機制，規範了插件的獲取與更新流程。適合需要嚴格環境管理或構建自動化 CI 流程的開發者使用。
