前言¶
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。
