前言¶
DeepSeek Harness (DSH) 採用插件化架構。staavanothanh/dsh-cbm 是一個適配器插件，用於將 codebase-memory-mcp 集成到 DSH 環境中。它利用 DSH 原生的 MCP 客戶端，通過 stdio 方式連接可執行文件，並將相應的工具與生命週期鉤子暴露給 Agent。
核心功能¶
- MCP 連接：通過 stdio 連接
codebase-memory-mcp可執行文件。 - 工具暴露：提供三個 MCP 工具，命名前綴爲
mcp__codebase-memory__：
-search_graph
-trace_path
-get_code_snippet - 生命週期鉤子：註冊
agent/session-start鉤子，注入代碼探索指南（功能類似 Codex 的 SessionStart）。
配置與使用¶
可執行文件路徑¶
插件按以下順序查找 codebase-memory-mcp 可執行文件：
1. CBM_COMMAND 環境變量。
2. codebase-memory-mcp（位於系統 PATH 中）。
3. ~/.local/bin/codebase-memory-mcp 或 .exe（Windows 系統）。
若需指定絕對路徑，可通過環境變量設置：
$env:CBM_COMMAND = 'C:\path\to\codebase-memory-mcp.exe'
訪問根目錄限制¶
設置 CBM_ALLOWED_ROOT 可限制 index_repository 的訪問範圍。插件不會自動設置默認 root，因此 Agent 仍可索引 Workspace 外部的路徑。
啓動容錯¶
配置 failOnStartupError: false 可將 MCP 連接錯誤設爲非致命。在首次連接握手失敗時，DSH MCP 客戶端會等待超時後完成激活。建議在首次使用前確保可執行文件已安裝並在 PATH 中，以避免連接延遲。
開發與依賴¶
- 運行環境：Node.js >= 22.19.0
- 核心依賴：
@deepseek-ai/dsh-mcp-client(^0.1.0-rc.7) - 許可證：MIT
注意事項¶
- 插件不自動設置 root，權限控制需依賴環境變量。
- 詳細文檔請查看 docs/README.md。
