前言¶
在 DeepSeek Harness（DSH）開發中，面對複雜的單體項目或微服務架構，快速理解項目結構、依賴關係和分層設計是常態。傳統方式依賴手動閱讀代碼，效率較低。dsh-kgraph-plugin 是一款組合包插件，專注於只讀掃描項目目錄，自動生成模塊級與文件級知識圖譜，輔助理解架構。
插件定位¶
這是一個 DSH 組合包插件，由開發者 lzhphantom 維護。它通過只讀方式分析項目，自動構建模塊級和文件級知識圖譜，爲後續的代碼優化、重構提供依據。
核心功能¶
- 只讀分析：全程使用 DSH 的
fs服務，絕不修改被掃描項目。 - 多模塊識別：根據 manifest 文件（如
pom.xml、package.json、go.mod、requirements.txt、pyproject.toml等）自動拆分模塊。 - 多語言依賴解析：支持 Java/Kotlin（類索引）、TS/JS/Vue（別名與相對路徑）、Python（點路徑）、Go（根相對路徑）。
- 分層分類：自動識別 controller、service、mapper、entity、dto、config、pages、components、router、store、api、util 等層級。
- 圖譜輸出：生成模塊依賴圖、文件級依賴圖、技術棧信息、入口點及關鍵文件。
- 使用入口：頁面右下角可視化面板 +
project_kgraph模型工具。
安裝與啓用¶
安裝該插件，使用官方提供的安裝命令：
dsh plugin --profile web add dsh-kgraph-plugin@0.3.0
安裝完成後，插件會自動加載。
典型用法¶
安裝並啓動後，頁面右下角會出現「項目知識圖譜」浮動面板。
- 掃描項目：在面板中輸入項目路徑（如
X:/xxx/xxx），點擊「掃描」。 - 查看總覽：掃描完成後，界面展示模塊卡片、技術棧、模塊依賴圖以及架構觀察。
- 查看文件級圖譜：點擊任意模塊，進入文件級分層圖譜（如 controller → service → mapper），點擊節點可查看代碼詳情。支持
⛶全屏瀏覽和—摺疊面板。 - Agent 調用：在 Agent 側調用
project_kgraph工具，傳入路徑參數，即可獲取完整的圖譜 JSON 數據。該工具與面板共享掃描緩存。
適用場景與注意¶
該插件適用於需要快速理解項目整體架構與設計思路的開發者或架構師。
注意事項：
* 插件以只讀模式運行，不會修改被掃描的項目源碼。
* 當前版本爲 0.3.0，移除了 /kgraph 命令，統一使用右下角面板和 project_kgraph 工具。
瞭解更多或查看源碼，請訪問插件目錄或 GitHub 倉庫。
