@hilariouhiss/dsh-codegraph 1.0.0 → 1.1.0

package/README.md

@@ -50,22 +50,14 @@ dsh plugin --profile web remove @hilariouhiss/dsh-codegraph
 
 ## 已知问题与限制
 
-当前实现是「MCP server 直连 + 静态引导」的最小可行集成，已知有以下问题：
+当前实现是「MCP server 直连 + 动态引导」的最小可行集成，已知有以下问题：
 
-1. **模型必须每次手动传 `projectPath`（最大痛点）**：DSH 宿主是单实例、多会话（多工作区），而 mcp-client 的 `cwd` 是宿主面静态配置（`process.cwd()`）。`codegraph_explore` 无法默认指向「当前会话工作区」，模型每次调用都要自己填 `projectPath` = 当前工作区。若漏填，会查询 server 的默认目录（通常没有 `.codegraph/` 索引），返回误导性的「无索引/请用内置工具」提示。理想做法是包装一个能自动注入会话 `cwd` 的工具，或让 server 按会话定位项目。
+1. **模型仍需手动传 `projectPath`（部分缓解）**：DSH 宿主是单实例、多会话（多工作区），而 mcp-client 的 `cwd` 是宿主面静态配置（`process.cwd()`）。`codegraph_explore` 无法默认指向「当前会话工作区」，模型每次调用仍要自己填 `projectPath`。引导文本现已**动态注入当前会话工作区的绝对路径**，降低漏填/填错概率；但工具本身仍未自动注入。理想做法是包装一个能自动注入会话 `cwd` 的工具，或让 server 按会话定位项目。
 
 2. **自动同步只覆盖 server 默认目录的项目**：codegraph 的文件 watcher 只持续监视 MCP server 启动 `cwd` 对应的项目；经 `projectPath` 查询的其它项目没有持续 watcher，索引不会随编辑自动刷新，需手动 `codegraph sync` 保持最新（本插件未做任何同步封装）。
 
 3. **不自动建索引**：每个项目必须手动 `codegraph init` 一次；插件不代建。未初始化时工具返回「无索引」引导而非真实结果。
 
-4. **依赖全局 `codegraph` CLI**：插件只负责连 MCP，不安装、不校验 `codegraph`。若未全局安装，mcp-client 启动失败并重试后静默注销工具，模型看不到原因（只能查 DSH 日志）。
-
-5. **引导是静态文本**：`systemPrompt.section` 只能写死「传 `projectPath` = 你的工作区」，无法把当前工作区的绝对路径动态注入提示词。
-
-6. **未端到端验证**：尚未在真实 profile 里走完 `dsh plugin add` → 重启 → 实际调用 `mcp__codegraph__codegraph_explore` 的闭环（当前仅单元测试 + 按 codegraph 官方 stdio 配置对齐）。
-
-7. **遥测默认开启**：codegraph 的匿名遥测默认开（不采集代码/路径/查询内容）；本插件未关闭。可用 `codegraph telemetry off` 或环境变量 `CODEGRAPH_TELEMETRY=0` 关闭。
-
 ## 开发
 
 ```powershell
@@ -97,4 +89,4 @@ npm publish     # publishConfig.access 已设为 public
 
 本插件为 MIT 许可。它只通过 MCP 连接外部的 `codegraph` CLI，未内置 codegraph 源码；codegraph 本身来自 [colbymchenry/codegraph](https://github.com/colbymchenry/codegraph)（© Colby McHenry，MIT，其自身许可见上游仓库）。
 
-> 提示：若日后升级 dsh 后 `@deepseek-ai/dsh-mcp-client` 的公开 API 发生变化，需同步更新本插件的依赖版本。
+> `@deepseek-ai/dsh-mcp-client` 由**正在运行的 dsh 安装**提供，本包只在 `peerDependencies` 里声明（`devDependencies` 供本仓测试）。**不要**把它写进 `dependencies` —— 那会让 pnpm 往 profile 里塞一份自己的副本，遮蔽安装目录里的同名包，两代混装会让整棵插件树启动失败。升级 dsh 后先跑 `node ../scripts/smoke-profile.mjs` 再发版。

package/lib/index.js

@@ -9,9 +9,14 @@ const GUIDANCE = [
 	"call `mcp__codegraph__codegraph_explore` directly instead of grepping or reading files one by one; ",
 	"it returns the relevant symbols' source, call paths, and impact in one call. ",
 	"Always pass `projectPath` as the workspace directory you are working in (or a subdirectory that has a `.codegraph/` index). ",
-	"If the tool reports no index, tell the user to run `codegraph init` in that project first.",
+	"If the tool reports no index, tell the user to run `codegraph init` in that project first. ",
+	"If the `mcp__codegraph__*` tool is not listed, the codegraph CLI is not installed or failed to start — check the DSH host logs.",
 ].join("");
 
+function guidanceFor(cwd) {
+	return `${GUIDANCE} Current workspace: ${cwd}; pass it as \`projectPath\`.`;
+}
+
 /**
  * Stdio config for the CodeGraph MCP server. `command` resolves `codegraph`
  * from the DSH host process's PATH (installed globally), and `cwd` is only the
@@ -36,10 +41,15 @@ export function codegraphConfig(cwd = process.cwd()) {
 
 /**
  * DSH plugin entry point. Loads the DSH MCP client bridge for the CodeGraph
- * server (registering `mcp__codegraph__*` tools globally) and injects a small
- * usage guidance section so agents prefer it and pass `projectPath`.
+ * server (registering `mcp__codegraph__*` tools globally) and injects usage
+ * guidance whose text carries the current session's workspace path, so agents
+ * prefer it and pass the right `projectPath`.
  */
 export function apply(ctx) {
 	ctx.plugin({ inject: mcpClientInject, apply: mcpClientApply }, codegraphConfig());
-	ctx.systemPrompt.section({ name: "codegraph:guidance", order: 100, text: GUIDANCE });
+	ctx.systemPrompt.section({
+		name: "codegraph:guidance",
+		order: 100,
+		text: (context) => guidanceFor(context.scope?.session?.header?.cwd ?? process.cwd()),
+	});
 }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@hilariouhiss/dsh-codegraph",
-  "version": "1.0.0",
+  "version": "1.1.0",
   "description": "CodeGraph — semantic code intelligence (MCP) for DeepSeek Harness. Adds codegraph_explore so agents answer structural code questions from a pre-built code graph.",
   "keywords": [
     "dsh",
@@ -36,8 +36,11 @@
     "README.md",
     "LICENSE"
   ],
-  "dependencies": {
-    "@deepseek-ai/dsh-mcp-client": "0.1.1-rc.2"
+  "peerDependencies": {
+    "@deepseek-ai/dsh-mcp-client": "^0.1.5-rc.2"
+  },
+  "devDependencies": {
+    "@deepseek-ai/dsh-mcp-client": "0.1.5-rc.2"
   },
   "dsh": {
     "bundle": {