前言¶
在 DeepSeek Harness (DSH) 中，Agent 通常依賴大量 grep、glob 和 read_file 調用來重構代碼庫結構。這種方式消耗昂貴的上下文，且效率低下。dsh-simple-codegraph 旨在解決這一痛點，它爲每個 DSH Agent 提供獨立的、項目範圍的 CodeGraph MCP 連接，使 Agent 能夠通過一次集中的探索調用獲取相關的源代碼、調用層次結構和影響範圍。
插件簡介¶
dsh-simple-codegraph 是一個由 QuantumKuba 維護的 DSH 插件。它提供生產級、按代理隔離的 CodeGraph 集成，採用 MIT 許可證。
核心特性¶
- 真正的代理隔離：每個活動 Agent 都會收到一個作用域內的 CodeGraph MCP stdio 進程，並固定在各自的工作目錄中。
- 同時多項目支持：多個 Agent 可以在零跨項目泄漏的情況下在單獨的倉庫中併發工作。
- 單工具理念：默認僅暴露
codegraph_explore，以最小化模式開銷並消除工具選擇混淆。 - 零配置捆綁：通過
dsh plugin add原生安裝，並自動向上發現倉庫根目錄（.codegraph/）。 - 壓縮安全架構：保持
CODEGRAPH_EXPLORE_DEDUP禁用，確保 DSH 上下文修剪不會使後續模型查詢無效。 - 第一回合握手保證：預組裝提示工具，確保 MCP stdio 握手在第一回合提示分發前完成。
安裝與前置要求¶
在安裝插件之前，需確保已安裝 CodeGraph CLI 並對目標項目進行了索引。
- 檢查安裝
codegraph --version
- 初始化項目
cd /path/to/my-project
codegraph init
- 安裝插件
將插件添加到指定的 DSH 配置文件（例如web、coding或默認配置）：
dsh plugin --profile web add dsh-simple-codegraph
典型用法¶
安裝完成後，在已索引的倉庫中啓動 DSH。插件會自動爲每個 Agent 會話啓動 CodeGraph MCP 服務器，並在第一回閤中暴露 mcp__codegraph__codegraph_explore。
cd /path/to/my-project
dsh --profile web
注意事項¶
- 環境要求：需要先安裝 CodeGraph CLI。
- 模型優化：插件針對本地 20B–30B 模型進行了優化（例如 Qwen 2.5/3.x 27B/32B，DeepSeek 蒸餾版）。在資源受限的環境中，工具模式消耗寶貴的上下文，重複的文件讀取速度較慢，且不必要的 Agent 循環會導致漂移。
- 許可證：插件採用 MIT 許可證。
總結¶
該插件通過提供獨立的 MCP 連接和單工具接口，簡化了 Agent 對代碼庫的理解過程。開發者可以通過標準的 DSH 插件命令直接啓用，無需手動配置複雜的 MCP 連接參數。
