在開發基於 DeepSeek Harness (DSH) 的智能體應用時，插件間的依賴關係往往隱藏在運行時調用中。當服務調用鏈路變得複雜，或者出現未預期的循環依賴時，排查問題會變得非常困難。下面介紹一個能夠實時檢查這些依賴關係的工具。
這是什麼¶
sleetdrop/dsh-plugin-topology 是 DeepSeek Harness 的插件依賴關係檢查器。它將實時的 Cordis 插件 fiber 樹快照爲一個插件/服務二部圖，計算圖論指標，並以多種格式渲染。該插件維護者獨立於 DeepSeek 官方，但遵循 MIT 許可證。
安裝¶
使用官方安裝命令將插件添加到指定 profile：
dsh plugin --profile <name> add @sleetdrop/dsh-plugin-topology
核心功能¶
該插件包含三個主要部分：
- 快照與指標：快照實時的 Cordis 插件 fiber 樹，並計算圖論指標，包括入度/出度、度中心性、介數中心性、特徵向量中心性以及 PageRank。
- 導出能力：支持將依賴關係導出爲 JSON（兼容 NetworkX）、Graphviz DOT 或 SVG 格式。
- 瀏覽器面板：提供可視化的瀏覽器面板，渲染可縮放圖，包含指標、圖例和未解決依賴表。
使用方法¶
打開瀏覽器面板¶
瀏覽器面板通過 sidebar.footer.action 觸發，無需選中特定會話即可查看運行時全局拓撲。面板默認最大化顯示。
導出與序列化¶
在模型側，使用 graph.render 工具將當前運行實例的插件依賴關係序列化爲文檔：
* json：生成 NetworkX 兼容的節點鏈接圖，節點攜帶圖論指標，圖對象攜帶全局指標（密度、強連通分量等）。
* dot / svg：生成 Graphviz 源碼或渲染後的 SVG，用於分享或使用外部工具分析。
交互操作¶
- 查看詳情：鼠標懸停在節點上，可查看 fiber 狀態、模塊源代碼和繪製的入/出度。
- 方向高亮：使用
deg+或deg-膠囊切換按鈕，可以高亮特定方向的依賴邊和目標節點，其餘部分會淡化。該功能在依賴度爲 0 時禁用。
注意事項¶
- 版本獨立：該插件擁有獨立的語義版本（當前爲 0.5.0），不鏡像 DeepSeek Harness 的版本。當前版本目標爲 DSH 0.2.0-rc.2。
- 內部依賴：插件需要訪問 Cordis 內部結構（如
root.registry、root.reflect.store），這些不在穩定公共 API 中。使用前需確保 Harness 版本滿足 peerDependencies 要求。 - 同名實例：在顯示圖中，同名插件實例會合併爲一個節點，但節點標籤會顯示實例創建序號（如
timer [1,9,23]）。在 JSON 和 DOT 導出中，實例保持唯一。 - 瀏覽器面板要求：瀏覽器面板需要 web profile 支持，且
--patch覆蓋僅作用於節點側。
總結¶
dsh-plugin-topology 提供了從宏觀拓撲到微觀 fiber 狀態的完整視圖，適合在調試複雜依賴關係時使用。
- GitHub: https://github.com/sleetdrop/dsh-plugin-topology
- 目錄: https://www.skillhub.cn/plugins/sleetdrop/dsh-plugin-topology
