前言¶

DeepSeek Harness (DSH) 的核心設計理念是插件化。在構建智能體或進行代碼審查等任務時，經常需要將本地的知識圖譜或代碼記憶服務接入到 DSH 的上下文中。dsh-codebase-memory-mcp 插件解決了這一需求，它利用 DSH 內置的 @deepseek-ai/dsh-mcp-client 橋接層，將本地的 codebase-memory-mcp 知識圖譜服務器直接連接到 DSH 環境中，無需開發者自行實現 MCP 傳輸層。

插件介紹¶

這是一個 DeepSeek Harness 插件，旨在將本地的 codebase-memory-mcp 知識圖譜 MCP 服務器橋接到 DSH。它通過複用 DSH 內置的 @deepseek-ai/dsh-mcp-client，讓模型能夠直接調用代碼庫記憶相關的工具。

基本信息
* 項目名稱：dsh-codebase-memory-mcp
* 作者：princeofdream
* 分類：記憶
* 許可證：MIT

核心功能¶

該插件提供以下核心能力：

1. 服務器橋接：將本地的 codebase-memory-mcp 知識圖譜服務連接到 DSH。
2. 工具註冊：
   • MCP 工具：註冊了 14 個 mcp__codebase-memory__* 開頭的 MCP 工具（如 index_repository, search_graph, trace_path, query_graph, detect_changes 等），供模型調用。
   • 宿主工具：註冊了兩個宿主級工具，用於監控和重啓服務：
     • codebase_memory_status：查詢服務狀態。
     • codebase_memory_restart：重啓服務。
3. 配置管理：提供 codebase-memory-mcp 命名空間，支持配置服務器可執行文件路徑、工作目錄、額外參數、環境變量及啓用開關。

安裝與啓用¶

通過命令行安裝插件：

dsh plugin --profile web add dsh-codebase-memory-mcp

安裝完成後，需要重新加載 DSH Web 主機（重啓應用或在應用內重載）以使插件生效。如果是本地開發環境，也可以使用 link: 協議指定本地路徑進行安裝。

配置與使用¶

檢查服務狀態¶

安裝後，首先需要確認橋接是否正常工作。通過模型調用宿主工具 codebase_memory_status 查看狀態。

codebase_memory_status

修復配置與重啓¶

如果狀態顯示爲 error，通常是因爲可執行文件路徑配置錯誤或環境問題。該插件不會因爲二進制文件錯誤而崩潰，而是會記錄日誌。

請按以下步驟修復：

1. 進入 DSH 的設置文檔，找到 codebase-memory-mcp 命名空間。
2. 檢查並修正 exePath、cwd 或 env 配置項。
3. 保存設置（支持熱重載，無需重啓 DSH）。
4. 再次調用 codebase_memory_restart 重啓橋接。

驗證連接¶

當 codebase_memory_status 返回 state: "ready" 且 toolCount > 0 時，表示橋接成功，模型可以開始使用 mcp__codebase-memory__* 相關工具。

注意事項¶

1. 依賴要求：該插件依賴 DSH 內置的 @deepseek-ai/dsh-mcp-client 包。如果安裝失敗，請檢查該依賴是否已正確引入。
2. GUI 卡片限制：配置界面的 GUI 卡片爲盡力而爲的特性，可能不會出現在所有的 DSH 構建版本中。如果在設置中找不到該卡片，仍可通過通用設置文檔編輯器或直接修改配置文件來管理 codebase-memory-mcp 命名空間。
3. 錯誤處理：如果二進制文件不可用，插件不會崩潰，而是通過控制台日誌記錄錯誤，並允許通過宿主工具繼續嘗試修復。
4. 啓動狀態觀察：可以通過控制台插件加載報告或 codebase_memory_status 工具觀察啓動狀態。

總結¶

dsh-codebase-memory-mcp 爲 DSH 提供了連接本地知識圖譜的能力。通過內置的橋接邏輯和配置管理，開發者可以方便地將代碼記憶服務集成到工作流中。在使用前，建議檢查源碼與許可證，並確保依賴已滿足。

• GitHub 倉庫：https://github.com/princeofdream/dsh-codebase-memory-mcp
• 社區目錄：https://www.skillhub.cn/plugins/princeofdream/dsh-codebase-memory-mcp