dsh-simple-codegraph
面向 DeepSeek Harness (DSH) 的生产级按 Agent CodeGraph 集成
插件会安装到这里；不确定时保持 web。
npx -y @deepseek-ai/dsh plugin --profile web add github:QuantumKuba/dsh-simple-codegraph#a0c56e356ce6b5ca118585b5e108402be2d50c9eSimple Codegraph 以 dsh-simple-codegraph 发布，当前版本为 0.1.0。Plugin Hub 会校验它的 manifest，并保存精确安装来源，便于复现安装结果。
dsh-simple-codegraph)Production-grade DeepSeek Harness (DSH) integration for CodeGraph.
Provides each DSH Agent with an isolated, project-scoped CodeGraph MCP connection. Instead of spending dozens of costly grep, glob, and read_file calls attempting to reconstruct a codebase AST, agents retrieve relevant verbatim source, call hierarchies, and blast-radius impact in a single focused exploration call.
Particularly optimized for local 20B–30B models (e.g., Qwen 2.5/3.x 27B/32B, DeepSeek local distillations) running in resource-constrained environments where tool schemas consume precious context, repeated file reads are slow, and unnecessary agent loops cause drift.
agent.session.header.cwd./repo-a and Agent B working in /repo-b operate simultaneously with zero cross-project leakage or global config mutation.dsh plugin add with zero manual YAML editing, no manual projectPath maintenance, and no background daemons to manage.mcp__codegraph__codegraph_explore by default. Minimizes schema tokens and eliminates tool-selection ambiguity for local models.CODEGRAPH_EXPLORE_DEDUP disabled so DSH context pruning does not invalidate subsequent model queries.Ensure CodeGraph CLI is installed on your system:
codegraph --version
Index your project repository (one-time setup):
cd /path/to/my-project
codegraph init
Add the bundle to your desired DSH profile (e.g., web, headless, coding):
dsh plugin --profile web add dsh-simple-codegraph
Run DSH inside your indexed repository:
cd /path/to/my-project
dsh --profile web
That is all. The CodeGraph MCP server boots automatically for each agent session, attaches to the repository root, and exposes the exploration tool to the agent.
Unlike implementations that mount a single global MCP process and rewrite cordis.patch.yml whenever the active UI tab changes, dsh-simple-codegraph establishes genuine agent-level encapsulation:
DeepSeek Harness Core
│
├── Agent A (cwd: /project-a)
│ └── Agent-Scoped Cordis Scope
│ └── @deepseek-ai/dsh-mcp-client
│ └── codegraph serve --mcp (pid: 1042, cwd: /project-a)
│
├── Agent B (cwd: /project-b)
│ └── Agent-Scoped Cordis Scope
│ └── @deepseek-ai/dsh-mcp-client
│ └── codegraph serve --mcp (pid: 1043, cwd: /project-b)
│
└── Agent C (unindexed or no cwd)
└── CodeGraph MCP skipped cleanly (no hallucinated / wrong-codebase context)
createScope(ctx, agent)). If agent.session.header.cwd contains a valid .codegraph index, the MCP client spawns codegraph serve --mcp with that cwd.system-prompt/assemble waterfall listener blocks prompt assembly until the MCP handshake completes (~300ms), ensuring mcp__codegraph__codegraph_explore is immediately visible on Step 1.Local 20B–30B models have constrained attention and higher susceptibility to tool-selection confusion. When presented with 8+ overlapping tools (node, callers, callees, impact, files, status, etc.), small models often:
node or files when they need AST call paths).grep, read_file) because the schema space is cluttered.dsh-simple-codegraph preserves CodeGraph's upstream design by exposing only codegraph_explore (namespace mcp__codegraph__codegraph_explore). A single query yields AST relationships, blast radius, and verbatim line-numbered source.
CodeGraph provides an optional CODEGRAPH_EXPLORE_DEDUP flag. However, in DeepSeek Harness, compaction plugins (dsh-compaction-tool-result-pruner and dsh-compaction-basic) aggressively prune or summarize earlier tool results when the context window fills up.
If dedup were enabled, CodeGraph would reply with "Already sent earlier", but the model would no longer have the source in its pruned context! Therefore, CODEGRAPH_EXPLORE_DEDUP is intentionally kept disabled. Correctness is strictly prioritized over marginal token savings.
Rather than injecting thousands of tokens of duplicate CodeGraph documentation into every turn's system prompt, dsh-simple-codegraph injects a microscopic 1-sentence routing hint only when working in an indexed repository:
"CodeGraph is active for this repository. For code discovery, architecture, call flows, symbol locations, and blast-radius exploration, prefer
mcp__codegraph__codegraph_exploreover raw grep or file reads. Verbatim line-numbered source returned by CodeGraph is already read."
In most cases, default configuration is ideal. If needed, settings can be customized in your profile's cordis.patch.yml:
- id: dsh-simple-codegraph
config:
# Command to run CodeGraph (default: 'codegraph')
command: codegraph
# Tool execution timeout in milliseconds (default: 60000)
toolCallTimeoutMs: 60000
# Whether to fail startup if CodeGraph fails to launch (default: false)
failOnStartupError: false
# Inject microscopic routing hint into system prompt (default: true)
routingHint: true
If you previously added a global CodeGraph MCP entry to ~/.dsh/cordis.patch.yml or ~/.dsh/profiles/<profile>/cordis.patch.yml:
cordis.patch.yml:
- - id: mcp-client-codegraph
- name: '@deepseek-ai/dsh-mcp-client'
- config:
- serverName: codegraph
- command: codegraph
- args: ['serve', '--mcp']
dsh-simple-codegraph:
dsh plugin --profile <profile> add dsh-simple-codegraph
@hyzyn/dsh-codegraph@hyzyn/dsh-codegraph managed a shared global MCP process and modified configuration on project switches.
To migrate:
@hyzyn/dsh-codegraph:
dsh plugin --profile <profile> remove @hyzyn/dsh-codegraph
dsh-simple-codegraph:
dsh plugin --profile <profile> add dsh-simple-codegraph
jiangzhenguo/dsh-codegraphjiangzhenguo/dsh-codegraph reimplemented CodeGraph CLI commands as 13 native DSH tools.
To migrate:
jiangzhenguo/dsh-codegraph:
dsh plugin --profile <profile> remove dsh-codegraph
dsh-simple-codegraph:
dsh plugin --profile <profile> add dsh-simple-codegraph
codegraph Not Found on PATHmcp__codegraph__codegraph_explore is not available.which codegraph works in your shell. If installed in a non-standard path, configure command: "/full/path/to/codegraph" in cordis.patch.yml.codegraph init in that repository. The plugin requires a valid .codegraph directory to avoid silently running against an unindexed or wrong directory.[dsh-simple-codegraph] Warning: Pre-existing global CodeGraph MCP tool detected...cordis.patch.yml to enable per-agent isolation.# Install dependencies
pnpm install
# Compile TypeScript
pnpm run build
# Run unit and lifecycle tests
pnpm test
# Run benchmark suite
pnpm run bench
MIT © 2026 DeepSeek Harness Community