mcp-probe-kit 3.6.2 → 3.6.5

package/README.md

@@ -421,7 +421,7 @@ No installation needed, use the latest version directly.
 }
 ```
 
-> **Skill 自动安装**：任意 MCP 工具调用会在用户项目写入 `.agents/skills/mcp-probe-kit/SKILL.md`。工作区根目录**自动识别**（Cursor 注入 `WORKSPACE_FOLDER_PATHS`；OpenCode 等项目级 `opencode.json` 会设置进程 cwd），**无需**在每台客户端配置 `MCP_PROJECT_ROOT`。仅全局 MCP 且无法识别工作区时，可选手动设置 `MCP_PROJECT_ROOT` 或在工具参数传 `project_root`。需 **v3.6.2+**。
+> **Skill 自动安装**：任意 MCP 工具调用会在用户项目写入 `.agents/skills/mcp-probe-kit/SKILL.md`。工作区根目录**自动识别**（Cursor 注入 `WORKSPACE_FOLDER_PATHS`；OpenCode 等项目级 `opencode.json` 会设置进程 cwd），**无需**在每台客户端配置 `MCP_PROJECT_ROOT`。仅全局 MCP 且无法识别工作区时，可选手动设置 `MCP_PROJECT_ROOT` 或在工具参数传 `project_root`。需 **v3.6.3+**。
 
 #### Claude Desktop Configuration
 
@@ -712,7 +712,7 @@ This is a known [Cursor-side issue](https://forum.cursor.com/t/mcp-server-connec
 | `latched shared-process MCP routing disabled` + `ipcReady` timeout | Windows `mcpProcess` utility failed; legacy fallback discovers tools but Agent lease stays empty |
 | Settings green dot, Agent `No MCP servers available` | Renderer ↔ shared-process MCP routing not wired for this session |
 
-**What we do (v3.6.2+):**  `tools/list` **omits `outputSchema` by default** (~50 KB → ~23 KB). Structured output still works via `structuredContent` on `tools/call`. To restore full schemas: `MCP_INCLUDE_OUTPUT_SCHEMA=1`.
+**What we do (v3.6.3+):**  `tools/list` **omits `outputSchema` by default** (~50 KB → ~23 KB). Structured output still works via `structuredContent` on `tools/call`. To restore full schemas: `MCP_INCLUDE_OUTPUT_SCHEMA=1`.
 
 **What you can try:**
 

package/build/lib/__tests__/gitnexus-bridge.unit.test.js

@@ -116,7 +116,7 @@ describe("gitnexus-bridge workspace preparation", () => {
         expect(result.code).toBe(0);
         expect(result.stdout.trim().length).toBeGreaterThan(0);
     });
-    test("Windows 下 git.exe 直接启动，不走 git.cmd 壳层", () => {
+    test.runIf(process.platform === "win32")("Windows 下 git.exe 直接启动，不走 git.cmd 壳层", () => {
         const resolved = resolveExecutableCommand("git", "win32").toLowerCase();
         const spawned = resolveSpawnCommand("git", ["init", "-q"], "win32");
         expect(resolved).toContain("git");

package/build/lib/__tests__/project-context-writer.unit.test.d.ts

@@ -0,0 +1 @@
+export {};

package/build/lib/__tests__/project-context-writer.unit.test.js

@@ -0,0 +1,28 @@
+import fs from "node:fs";
+import os from "node:os";
+import path from "node:path";
+import { describe, expect, test } from "vitest";
+import { resolveProjectContextLayout } from "../project-context-layout.js";
+import { writeProjectContextArtifacts } from "../project-context-writer.js";
+describe("project-context-writer", () => {
+    test("写入 AGENTS.md 与 modular 骨架", () => {
+        const projectRoot = fs.mkdtempSync(path.join(os.tmpdir(), "mcp-probe-writer-"));
+        const layout = resolveProjectContextLayout(projectRoot, { docs_dir: "docs" });
+        const docs = [
+            { file: "tech-stack.md", title: "技术栈", purpose: "技术栈说明" },
+            { file: "architecture.md", title: "架构设计", purpose: "架构说明" },
+        ];
+        const result = writeProjectContextArtifacts({
+            layout,
+            mergedAgentsContent: "# AGENTS\n",
+            skipModularDocs: false,
+            projectInfo: { name: "demo", version: "1.0.0", description: "test" },
+            detection: { language: "TypeScript", framework: "node", category: "library" },
+            docs,
+        });
+        expect(result.agentsMd.action).toBe("created");
+        expect(fs.existsSync(path.join(projectRoot, "AGENTS.md"))).toBe(true);
+        expect(fs.existsSync(path.join(projectRoot, "docs", "project-context.md"))).toBe(true);
+        expect(fs.existsSync(path.join(projectRoot, "docs", "project-context", "tech-stack.md"))).toBe(true);
+    });
+});

package/build/lib/__tests__/workspace-root.unit.test.js

@@ -60,4 +60,20 @@ describe("workspace-root explicit project_root", () => {
         expect(resolution.explicitHonored).toBe(false);
         expect(resolution.warning).toMatch(/未能采用传入的 project_root/);
     });
+    test("不把盘符根目录当作工作区", () => {
+        const original = process.env.INIT_CWD;
+        process.env.INIT_CWD = "D:\\";
+        try {
+            const resolution = resolveWorkspaceRootWithMeta("");
+            expect(resolution.root).not.toBe("D:\\");
+        }
+        finally {
+            if (original === undefined) {
+                delete process.env.INIT_CWD;
+            }
+            else {
+                process.env.INIT_CWD = original;
+            }
+        }
+    });
 });

package/build/lib/feature-spec-writer.d.ts

@@ -0,0 +1,12 @@
+import { type FileDeliveryReport } from "./file-delivery.js";
+export interface FeatureSpecTemplates {
+    requirements: string;
+    design: string;
+    tasks: string;
+}
+export declare function writeFeatureSpecFiles(input: {
+    projectRoot: string;
+    docsDir: string;
+    featureName: string;
+    templates: FeatureSpecTemplates;
+}): FileDeliveryReport;

package/build/lib/feature-spec-writer.js

@@ -0,0 +1,14 @@
+import { mergeDeliveryReports, writeProjectFile, } from "./file-delivery.js";
+export function writeFeatureSpecFiles(input) {
+    const base = `${input.docsDir}/specs/${input.featureName}`;
+    const root = input.projectRoot;
+    const report = mergeDeliveryReports({
+        writtenFiles: [
+            writeProjectFile(root, `${base}/requirements.md`, input.templates.requirements, "ifMissing"),
+            writeProjectFile(root, `${base}/design.md`, input.templates.design, "ifMissing"),
+            writeProjectFile(root, `${base}/tasks.md`, input.templates.tasks, "ifMissing"),
+        ],
+        pendingFiles: [],
+    });
+    return report;
+}

package/build/lib/file-delivery.d.ts

@@ -0,0 +1,17 @@
+export type FileWriteAction = "created" | "updated" | "skipped";
+export interface DeliveredFile {
+    path: string;
+    action: FileWriteAction;
+}
+export interface PendingFile {
+    path: string;
+    reason: string;
+}
+export interface FileDeliveryReport {
+    writtenFiles: DeliveredFile[];
+    pendingFiles: PendingFile[];
+}
+export declare function toPosixRel(relPath: string): string;
+export declare function writeProjectFile(projectRoot: string, relPath: string, content: string, policy: "ifMissing" | "always"): DeliveredFile;
+export declare function mergeDeliveryReports(...reports: FileDeliveryReport[]): FileDeliveryReport;
+export declare function formatFileDeliverySection(report: FileDeliveryReport): string;

package/build/lib/file-delivery.js

@@ -0,0 +1,42 @@
+import * as fs from "node:fs";
+import * as path from "node:path";
+export function toPosixRel(relPath) {
+    return relPath.replace(/\\/g, "/");
+}
+export function writeProjectFile(projectRoot, relPath, content, policy) {
+    const posixPath = toPosixRel(relPath);
+    const absPath = path.join(path.resolve(projectRoot), ...posixPath.split("/"));
+    const existed = fs.existsSync(absPath);
+    if (policy === "ifMissing" && existed) {
+        return { path: posixPath, action: "skipped" };
+    }
+    fs.mkdirSync(path.dirname(absPath), { recursive: true });
+    fs.writeFileSync(absPath, content, "utf8");
+    return { path: posixPath, action: existed ? "updated" : "created" };
+}
+export function mergeDeliveryReports(...reports) {
+    return {
+        writtenFiles: reports.flatMap((report) => report.writtenFiles),
+        pendingFiles: reports.flatMap((report) => report.pendingFiles),
+    };
+}
+export function formatFileDeliverySection(report) {
+    const lines = ["## 文件落盘状态"];
+    if (report.writtenFiles.length > 0) {
+        lines.push("", "### 已写入（MCP 服务端）");
+        for (const file of report.writtenFiles) {
+            const verb = file.action === "created" ? "已创建" : file.action === "updated" ? "已更新" : "已跳过（已存在）";
+            lines.push(`- \`${file.path}\` — ${verb}`);
+        }
+    }
+    if (report.pendingFiles.length > 0) {
+        lines.push("", "### 尚未创建（仅规划 / 待后续步骤）");
+        for (const file of report.pendingFiles) {
+            lines.push(`- \`${file.path}\` — ${file.reason}`);
+        }
+    }
+    if (report.writtenFiles.length === 0 && report.pendingFiles.length === 0) {
+        lines.push("", "- 无文件变更");
+    }
+    return lines.join("\n");
+}

package/build/lib/graph-insights-writer.d.ts

@@ -0,0 +1,10 @@
+import type { CodeInsightBridgeResult } from "./gitnexus-bridge.js";
+import { type ProjectContextLayout } from "./project-context-layout.js";
+import { type FileDeliveryReport } from "./file-delivery.js";
+export declare function buildGraphInsightMarkdown(result: CodeInsightBridgeResult, structured: Record<string, unknown>): string;
+export declare function persistGraphInsightsDocs(input: {
+    projectRoot: string;
+    layout: ProjectContextLayout;
+    result: CodeInsightBridgeResult;
+    structured: Record<string, unknown>;
+}): FileDeliveryReport;

package/build/lib/graph-insights-writer.js

@@ -0,0 +1,65 @@
+import * as fs from "node:fs";
+import * as path from "node:path";
+import { layoutAbsPath } from "./project-context-layout.js";
+import { mergeDeliveryReports, toPosixRel, writeProjectFile, } from "./file-delivery.js";
+function makeSafeSegment(value) {
+    return (value || "code-insight")
+        .toLowerCase()
+        .replace(/[^a-z0-9._-]+/g, "-")
+        .replace(/-+/g, "-")
+        .replace(/^-|-$/g, "")
+        .slice(0, 48) || "code-insight";
+}
+export function buildGraphInsightMarkdown(result, structured) {
+    const mode = structured.mode;
+    const executionLines = result.executions
+        .map((item) => {
+        if (item.ok) {
+            return `- **${item.tool}**${item.status ? ` [${item.status}]` : ""}: ${(item.text || "已返回结果").replace(/\s+/g, " ").slice(0, 500)}`;
+        }
+        return `- **${item.tool}** ⚠️: ${(item.error || "调用失败").replace(/\s+/g, " ").slice(0, 300)}`;
+    })
+        .join("\n");
+    return `# 代码图谱洞察
+
+> 由 mcp-probe-kit \`code_insight\` 自动生成
+
+| 字段 | 值 |
+|------|-----|
+| 状态 | ${String(structured.status ?? "ok")} |
+| 模式 | ${mode?.requested ?? "auto"} → ${mode?.resolved ?? "auto"} |
+| 来源 | ${result.provider} |
+| 工作区 | ${result.workspaceMode} |
+| 生成时间 | ${new Date().toISOString()} |
+
+## 摘要
+
+${result.summary}
+
+## 执行记录
+
+${executionLines || "- 无执行记录"}
+
+${result.warnings.length > 0 ? `\n## 警告\n\n${result.warnings.map((w) => `- ${w}`).join("\n")}\n` : ""}`;
+}
+export function persistGraphInsightsDocs(input) {
+    const markdown = buildGraphInsightMarkdown(input.result, input.structured);
+    const json = JSON.stringify(input.structured, null, 2);
+    const root = path.resolve(input.projectRoot);
+    const latestMd = writeProjectFile(root, input.layout.latestMarkdownPath, markdown, "always");
+    const latestJson = writeProjectFile(root, input.layout.latestJsonPath, json, "always");
+    const graphAbs = layoutAbsPath(input.layout, input.layout.graphDir);
+    fs.mkdirSync(graphAbs, { recursive: true });
+    const timestamp = new Date().toISOString().replace(/[:.]/g, "-");
+    const suffix = makeSafeSegment(input.result.summary || String(input.structured.status ?? "ok"));
+    const mode = input.structured.mode?.resolved ?? "auto";
+    const archiveBase = `${timestamp}-${mode}-${suffix}`;
+    const archiveMdRel = toPosixRel(path.join(input.layout.graphDir, `${archiveBase}.md`));
+    const archiveJsonRel = toPosixRel(path.join(input.layout.graphDir, `${archiveBase}.json`));
+    const archiveMd = writeProjectFile(root, archiveMdRel, markdown, "always");
+    const archiveJson = writeProjectFile(root, archiveJsonRel, json, "always");
+    return mergeDeliveryReports({
+        writtenFiles: [latestMd, latestJson, archiveMd, archiveJson],
+        pendingFiles: [],
+    });
+}

package/build/lib/init-project-writer.d.ts

@@ -0,0 +1,7 @@
+import { type FileDeliveryReport } from "./file-delivery.js";
+export declare function writeInitProjectSkeletons(input: {
+    projectRoot: string;
+    projectName: string;
+    featureSlug: string;
+    requirement: string;
+}): FileDeliveryReport;

package/build/lib/init-project-writer.js

@@ -0,0 +1,161 @@
+import { mergeDeliveryReports, writeProjectFile, } from "./file-delivery.js";
+export function writeInitProjectSkeletons(input) {
+    const { projectRoot, projectName, featureSlug, requirement } = input;
+    const specBase = `docs/specs/${featureSlug}`;
+    const projectContext = `# ${projectName} - 项目上下文
+
+> 由 init_project 自动生成的骨架，请根据仓库实际情况补充。
+
+## 项目概览
+
+| 属性 | 值 |
+|------|-----|
+| 项目名称 | ${projectName} |
+| 描述 | ${requirement || "待补充"} |
+
+## 技术栈
+
+- 待补充
+
+## 架构
+
+- 待补充
+
+## 开发流程
+
+- 待补充
+
+---
+*生成工具: mcp-probe-kit init_project*
+`;
+    const constitution = `# ${projectName} - 项目宪法
+
+> 定义项目核心原则与约束。
+
+## 代码风格
+
+- 待补充
+
+## 架构原则
+
+- 待补充
+
+## 安全准则
+
+- 待补充
+
+## 测试要求
+
+- 待补充
+
+## 文档标准
+
+- 待补充
+
+---
+*生成工具: mcp-probe-kit init_project*
+`;
+    const requirements = `# 需求文档：${projectName}
+
+## 功能概述
+
+${requirement || "待补充"}
+
+## 术语定义
+
+- 待补充
+
+## 需求列表（EARS）
+
+### 用户故事
+
+- As a ... I want ... So that ...
+
+### 验收标准
+
+- WHEN ... THEN THE system SHALL ...
+
+## 非功能需求
+
+- 性能、安全、兼容性：待补充
+
+---
+*生成工具: mcp-probe-kit init_project*
+`;
+    const design = `# 设计文档：${projectName}
+
+## 技术方案
+
+- 待补充
+
+## 架构设计
+
+- 待补充
+
+## 数据模型
+
+- 待补充
+
+## API 设计
+
+- 待补充
+
+---
+*生成工具: mcp-probe-kit init_project*
+`;
+    const tasks = `# 任务清单：${projectName}
+
+## 概述
+
+实现 ${projectName} 的任务分解。
+
+## 任务列表
+
+### 阶段 1: 项目初始化
+
+- [ ] 1.1 搭建项目骨架
+
+### 阶段 2: 核心功能
+
+- [ ] 2.1 实现核心逻辑
+
+### 阶段 3: 测试
+
+- [ ] 3.1 编写测试
+
+---
+*生成工具: mcp-probe-kit init_project*
+`;
+    const research = `# 技术调研：${projectName}
+
+## 技术栈调研
+
+- 待补充
+
+## 版本兼容性
+
+- 待补充
+
+## 风险与最佳实践
+
+- 待补充
+
+---
+*生成工具: mcp-probe-kit init_project*
+`;
+    return mergeDeliveryReports({
+        writtenFiles: [
+            writeProjectFile(projectRoot, "docs/project-context.md", projectContext, "ifMissing"),
+            writeProjectFile(projectRoot, "docs/constitution.md", constitution, "ifMissing"),
+            writeProjectFile(projectRoot, `${specBase}/requirements.md`, requirements, "ifMissing"),
+            writeProjectFile(projectRoot, `${specBase}/design.md`, design, "ifMissing"),
+            writeProjectFile(projectRoot, `${specBase}/tasks.md`, tasks, "ifMissing"),
+            writeProjectFile(projectRoot, `${specBase}/research.md`, research, "ifMissing"),
+        ],
+        pendingFiles: [
+            { path: "scripts/check-prerequisites.sh", reason: "需 Agent 按指南创建辅助脚本" },
+            { path: "scripts/setup.sh", reason: "需 Agent 按指南创建辅助脚本" },
+            { path: "src/", reason: "源代码目录需按项目类型创建" },
+        ],
+    });
+}

package/build/lib/project-context-writer.d.ts

@@ -0,0 +1,41 @@
+import type { ProjectContextLayout } from "./project-context-layout.js";
+export interface WrittenFileRecord {
+    path: string;
+    action: "created" | "updated" | "skipped";
+}
+export interface ProjectContextWriteResult {
+    agentsMd: WrittenFileRecord;
+    projectContextIndex: WrittenFileRecord | null;
+    modularDocs: WrittenFileRecord[];
+}
+type DocEntry = {
+    file: string;
+    title: string;
+    purpose: string;
+};
+type ProjectInfo = {
+    name: string;
+    version: string;
+    description: string;
+};
+type Detection = {
+    language: string;
+    framework?: string;
+    category: string;
+    confidence?: number;
+};
+export declare function buildProjectContextIndexMarkdown(projectInfo: ProjectInfo, detection: Detection, docs: DocEntry[], docsDir: string): string;
+export declare function buildModularDocSkeleton(doc: DocEntry, projectInfo: ProjectInfo, detection: Detection): string;
+/**
+ * 由 init_project_context 服务端直接落盘（勿依赖 Agent fsWrite）。
+ */
+export declare function writeProjectContextArtifacts(input: {
+    layout: ProjectContextLayout;
+    mergedAgentsContent: string;
+    skipModularDocs: boolean;
+    projectInfo: ProjectInfo;
+    detection: Detection;
+    docs: DocEntry[];
+}): ProjectContextWriteResult;
+export declare function formatWriteSummary(result: ProjectContextWriteResult): string;
+export {};

package/build/lib/project-context-writer.js

@@ -0,0 +1,120 @@
+import * as fs from "node:fs";
+import * as path from "node:path";
+import { layoutAbsPath } from "./project-context-layout.js";
+function writeFileEnsuringDir(absPath, content) {
+    fs.mkdirSync(path.dirname(absPath), { recursive: true });
+    fs.writeFileSync(absPath, content, "utf8");
+}
+function writeIfMissing(layout, relPath, content) {
+    const absPath = layoutAbsPath(layout, relPath);
+    if (fs.existsSync(absPath)) {
+        return { path: relPath, action: "skipped" };
+    }
+    writeFileEnsuringDir(absPath, content);
+    return { path: relPath, action: "created" };
+}
+function writeAlways(layout, relPath, content) {
+    const absPath = layoutAbsPath(layout, relPath);
+    const existed = fs.existsSync(absPath);
+    writeFileEnsuringDir(absPath, content);
+    return { path: relPath, action: existed ? "updated" : "created" };
+}
+export function buildProjectContextIndexMarkdown(projectInfo, detection, docs, docsDir) {
+    const timestamp = new Date().toISOString();
+    const docNav = docs
+        .map((doc) => `### [${doc.title}](./project-context/${doc.file})
+${doc.purpose}
+`)
+        .join("\n");
+    return `# ${projectInfo.name} - 项目上下文
+
+> 本文档是项目上下文的索引文件，提供项目概览和文档导航。
+
+## 📊 项目概览
+
+| 属性 | 值 |
+|------|-----|
+| 项目名称 | ${projectInfo.name} |
+| 版本 | ${projectInfo.version} |
+| 语言 | ${detection.language} |
+| 框架 | ${detection.framework || "无"} |
+| 类型 | ${detection.category} |
+| 描述 | ${projectInfo.description || "待补充"} |
+
+## 📚 文档导航
+
+${docNav}
+### [代码图谱洞察](./graph-insights/latest.md)
+最近一次 code_insight 分析结果，包含模块依赖、调用链和影响面摘要
+
+## 🚀 快速开始
+
+1. 阅读 [技术栈](./project-context/tech-stack.md) 了解项目使用的技术
+2. 阅读 [架构设计](./project-context/architecture.md) 了解项目结构
+3. 阅读 [代码图谱洞察](./graph-insights/latest.md) 快速理解模块依赖与调用链
+4. 根据需要查看具体的操作指南
+
+---
+*生成时间: ${timestamp}*  
+*生成工具: mcp-probe-kit init_project_context*
+`;
+}
+export function buildModularDocSkeleton(doc, projectInfo, detection) {
+    return `# ${doc.title}
+
+> ${doc.purpose}
+
+## 概述
+
+本文档描述 **${projectInfo.name}** 的${doc.title}。请根据仓库实际代码补充下方各节（勿留空占位）。
+
+## 项目信息
+
+| 属性 | 值 |
+|------|-----|
+| 语言 | ${detection.language} |
+| 框架 | ${detection.framework || "无"} |
+| 类型 | ${detection.category} |
+
+## 待补充
+
+- 从项目中提取真实路径与代码示例
+- 步骤需具体可操作
+
+---
+*返回索引: [../project-context.md](../project-context.md)*
+`;
+}
+/**
+ * 由 init_project_context 服务端直接落盘（勿依赖 Agent fsWrite）。
+ */
+export function writeProjectContextArtifacts(input) {
+    const { layout, mergedAgentsContent, skipModularDocs, projectInfo, detection, docs } = input;
+    const docsDir = layout.contextRoot;
+    const agentsMd = writeAlways(layout, layout.indexPath, mergedAgentsContent);
+    let projectContextIndex = null;
+    const modularDocs = [];
+    if (!skipModularDocs) {
+        projectContextIndex = writeIfMissing(layout, layout.legacyIndexPath, buildProjectContextIndexMarkdown(projectInfo, detection, docs, docsDir));
+        for (const doc of docs) {
+            const rel = `${layout.modularDir}/${doc.file}`;
+            modularDocs.push(writeIfMissing(layout, rel, buildModularDocSkeleton(doc, projectInfo, detection)));
+        }
+    }
+    return { agentsMd, projectContextIndex, modularDocs };
+}
+export function formatWriteSummary(result) {
+    const lines = ["## 已写入磁盘（MCP 服务端）"];
+    const push = (record) => {
+        const verb = record.action === "created" ? "已创建" : record.action === "updated" ? "已更新" : "已跳过（已存在）";
+        lines.push(`- \`${record.path}\` — ${verb}`);
+    };
+    push(result.agentsMd);
+    if (result.projectContextIndex) {
+        push(result.projectContextIndex);
+    }
+    for (const doc of result.modularDocs) {
+        push(doc);
+    }
+    return lines.join("\n");
+}

package/build/lib/tool-annotations.js

@@ -14,7 +14,7 @@
  */
 export const TOOL_ANNOTATIONS = {
     // —— 只读指南型（可安全自动放行）——
-    init_project: { title: '初始化项目', readOnlyHint: true, idempotentHint: true, openWorldHint: false },
+    init_project: { title: '初始化项目', readOnlyHint: false, idempotentHint: true, openWorldHint: false }, // 仅写 Skill + AGENTS.md
     workflow: { title: '开发工作流路由', readOnlyHint: true, idempotentHint: true, openWorldHint: false },
     gencommit: { title: '生成提交信息', readOnlyHint: true, idempotentHint: true, openWorldHint: false },
     code_review: { title: '代码审查', readOnlyHint: true, idempotentHint: true, openWorldHint: false },
@@ -43,7 +43,7 @@ export const TOOL_ANNOTATIONS = {
     start_feature: { title: '新功能开发编排', readOnlyHint: true, idempotentHint: false, openWorldHint: true },
     start_bugfix: { title: 'Bug 修复编排', readOnlyHint: true, idempotentHint: false, openWorldHint: true },
     // —— 写型（工具自身落盘 / 写记忆 / 写缓存，非破坏）——
-    init_project_context: { title: '生成项目上下文', readOnlyHint: false, destructiveHint: false, idempotentHint: true, openWorldHint: false }, // 自己写 docs/.mcp-probe/layout.json（其余为指令）
+    init_project_context: { title: '生成项目上下文', readOnlyHint: false, destructiveHint: false, idempotentHint: true, openWorldHint: false }, // 仅写 AGENTS.md + layout.json
     memorize_asset: { title: '沉淀记忆资产', readOnlyHint: false, destructiveHint: false, idempotentHint: true, openWorldHint: true }, // 写 Qdrant
     delete_memory_asset: { title: '删除记忆资产', readOnlyHint: false, destructiveHint: true, idempotentHint: true, openWorldHint: true }, // 删 Qdrant
     update_memory_asset: { title: '更新记忆资产', readOnlyHint: false, destructiveHint: false, idempotentHint: true, openWorldHint: true }, // 写 Qdrant

package/build/lib/workspace-root.js

@@ -126,7 +126,9 @@ function findWorkspaceAncestor(start, packageRoot) {
     }
     let current = start;
     while (true) {
-        if (current !== packageRoot && looksLikeWorkspaceRoot(current)) {
+        if (current !== packageRoot &&
+            !isFilesystemRoot(current) &&
+            looksLikeWorkspaceRoot(current)) {
             return current;
         }
         const parent = path.dirname(current);
@@ -146,6 +148,19 @@ function resolveTrustedClientWorkspace(clientPath, packageRoot) {
     }
     return findWorkspaceAncestor(clientPath, packageRoot) ?? clientPath;
 }
+function isFilesystemRoot(target) {
+    const normalized = path.resolve(target);
+    return normalized === path.parse(normalized).root;
+}
+function isUsableWorkspaceCandidate(target, packageRoot) {
+    if (!isExistingDirectory(target)) {
+        return false;
+    }
+    if (target === packageRoot || isFilesystemRoot(target)) {
+        return false;
+    }
+    return true;
+}
 function resolveFromEnvKeys(keys, packageRoot) {
     for (const key of keys) {
         const candidate = safeResolve(process.env[key] || "");
@@ -153,7 +168,7 @@ function resolveFromEnvKeys(keys, packageRoot) {
         if (resolved) {
             return resolved;
         }
-        if (isExistingDirectory(candidate) && candidate !== packageRoot) {
+        if (isUsableWorkspaceCandidate(candidate, packageRoot)) {
             return candidate;
         }
     }
@@ -219,7 +234,7 @@ function resolveAutoWorkspaceRoot(packageRoot) {
         };
     }
     const cwd = safeResolve(process.cwd());
-    if (isExistingDirectory(cwd) && cwd !== packageRoot) {
+    if (isUsableWorkspaceCandidate(cwd, packageRoot)) {
         if (looksLikeWorkspaceRoot(cwd)) {
             return { root: cwd, source: "cwd", explicitHonored: false };
         }