@roarpeng/graphflow 1.9.4 → 1.9.12

package/dist/integrations/agent-mcp-installer.js

@@ -8,11 +8,17 @@ exports.isEphemeralNodePath = isEphemeralNodePath;
 exports.isIdeBundledNode = isIdeBundledNode;
 exports.resolveSystemNodeCommand = resolveSystemNodeCommand;
 exports.resolveMcpNodeLaunch = resolveMcpNodeLaunch;
+exports.toWindowsPathFromWsl = toWindowsPathFromWsl;
+exports.toWslPathFromWindows = toWslPathFromWindows;
 exports.getWindowsShortPath = getWindowsShortPath;
 exports.preferSpaceFreeWindowsPath = preferSpaceFreeWindowsPath;
 exports.sanitizeMcpServerNodeForWindowsClients = sanitizeMcpServerNodeForWindowsClients;
 exports.mcpNodeNeedsWindowsSpaceRepair = mcpNodeNeedsWindowsSpaceRepair;
 exports.repairUnsafeWindowsMcpCommands = repairUnsafeWindowsMcpCommands;
+exports.isGraphFlowMcpLauncherPath = isGraphFlowMcpLauncherPath;
+exports.findMissingGraphFlowMcpLauncher = findMissingGraphFlowMcpLauncher;
+exports.repairStaleGraphFlowMcpLaunchers = repairStaleGraphFlowMcpLaunchers;
+exports.resolveWindowsNpxLaunch = resolveWindowsNpxLaunch;
 exports.buildMcpServerNode = buildMcpServerNode;
 exports.removeMcpEntry = removeMcpEntry;
 exports.removeCodexMcpEntry = removeCodexMcpEntry;
@@ -467,7 +473,11 @@ function buildAgentProfiles() {
             name: "Qoder",
             markerPaths: [
                 (0, node_path_1.join)(home, ".qoder"),
+                (0, node_path_1.join)(home, ".qoder-cn"),
+                (0, node_path_1.join)(home, ".config", "Qoder"),
+                (0, node_path_1.join)(home, ".config", "QoderCN"),
                 (0, node_path_1.join)(appData, "Qoder"),
+                (0, node_path_1.join)(appData, "QoderCN"),
                 (0, node_path_1.join)(localAppData, "Programs", "qoder"),
             ],
             userTargets: [
@@ -476,9 +486,17 @@ function buildAgentProfiles() {
                     serversKey: "mcpServers",
                 },
                 {
+                    // Qoder 实际读取的用户级 MCP 配置（国际版，已实测生效）
                     configPath: isWindows()
-                        ? (0, node_path_1.join)(appData, "Qoder", "User", "mcp.json")
-                        : (0, node_path_1.join)(home, ".config", "Qoder", "User", "mcp.json"),
+                        ? (0, node_path_1.join)(appData, "Qoder", "SharedClientCache", "mcp.json")
+                        : (0, node_path_1.join)(home, ".config", "Qoder", "SharedClientCache", "mcp.json"),
+                    serversKey: "mcpServers",
+                },
+                {
+                    // Qoder CN 版实际读取的用户级 MCP 配置（已实测生效）
+                    configPath: isWindows()
+                        ? (0, node_path_1.join)(appData, "QoderCN", "SharedClientCache", "mcp.json")
+                        : (0, node_path_1.join)(home, ".config", "QoderCN", "SharedClientCache", "mcp.json"),
                     serversKey: "mcpServers",
                 },
             ],
@@ -681,19 +699,54 @@ function resolveMcpNodeLaunch(options) {
     // 4. Last resort: bare "node" (relies on PATH resolution at MCP launch time)
     return { command: "node", env: { ...MCP_STDIO_ENV } };
 }
+/** Convert `/mnt/c/foo` ↔ `C:\foo` for WSL ↔ Windows path bridging. */
+function toWindowsPathFromWsl(pathValue) {
+    const normalized = pathValue.replace(/\//g, "\\");
+    const mnt = normalized.match(/^\\mnt\\([A-Za-z])\\(.*)$/);
+    if (mnt?.[1] && mnt[2] !== undefined) {
+        return `${mnt[1].toUpperCase()}:\\${mnt[2]}`;
+    }
+    return pathValue.includes("/") ? pathValue.replace(/\//g, "\\") : pathValue;
+}
+function toWslPathFromWindows(pathValue) {
+    const match = pathValue.replace(/\//g, "\\").match(/^([A-Za-z]):\\(.*)$/);
+    if (match?.[1] && match[2] !== undefined) {
+        return `/mnt/${match[1].toLowerCase()}/${match[2].replace(/\\/g, "/")}`;
+    }
+    return pathValue;
+}
+function pathExistsOnWindowsHost(windowsPath) {
+    if (isWindows()) {
+        return (0, node_fs_1.existsSync)(windowsPath);
+    }
+    if (isWsl()) {
+        return (0, node_fs_1.existsSync)(toWslPathFromWindows(windowsPath));
+    }
+    return false;
+}
 /**
- * On Windows, convert a long path containing spaces to its 8.3 short form.
- * Many MCP clients (e.g., TRAE) spawn the `command` field via cmd.exe without
- * quoting, so paths like "C:\Program Files\..." break with "'C:\Program' is not
- * recognized". The 8.3 short name (e.g., "C:\PROGRA~1\...") avoids this entirely.
+ * On Windows (or via cmd.exe from WSL), convert a long path containing spaces
+ * to its 8.3 short form. Many MCP clients (e.g., TRAE / Codex) spawn `command`
+ * without reliable quoting, so "C:\Program Files\..." breaks. Short names like
+ * "C:\PROGRA~1\..." avoid this. Codex on Windows also needs NODE/NPX_CLI env
+ * pointing at these short paths for npx-cli registration to succeed.
  */
 function getWindowsShortPath(longPath) {
-    if (!isWindows() || !longPath || !longPath.includes(" ")) {
+    if (!longPath) {
         return longPath;
     }
-    // Try cmd.exe first (faster, available on all Windows)
+    const windowsPath = isWsl() && longPath.startsWith("/mnt/")
+        ? toWindowsPathFromWsl(longPath)
+        : longPath;
+    if (!windowsPath.includes(" ")) {
+        return windowsPath;
+    }
+    if (!isWindows() && !isWsl()) {
+        return undefined;
+    }
+    // Try cmd.exe first (works on native Windows and from WSL)
     try {
-        const result = (0, node_child_process_1.execSync)(`for %A in ("${longPath}") do @echo %~sA`, {
+        const result = (0, node_child_process_1.execSync)(`for %A in ("${windowsPath}") do @echo %~sA`, {
             encoding: "utf8",
             stdio: ["ignore", "pipe", "ignore"],
             timeout: 3000,
@@ -701,34 +754,36 @@ function getWindowsShortPath(longPath) {
         }).trim();
         const lines = result.split(/\r?\n/).filter((l) => l.trim());
         const shortPath = lines[lines.length - 1]?.trim();
-        if (shortPath && !shortPath.includes(" ") && (0, node_fs_1.existsSync)(shortPath)) {
+        if (shortPath && !shortPath.includes(" ") && pathExistsOnWindowsHost(shortPath)) {
             return shortPath;
         }
     }
     catch {
         // fall through to PowerShell
     }
-    // Fallback: PowerShell with FileSystemObject COM
-    try {
-        const escaped = longPath.replace(/'/g, "''");
-        const result = (0, node_child_process_1.execSync)(`$fso = New-Object -ComObject Scripting.FileSystemObject; if (Test-Path -LiteralPath '${escaped}') { if ((Get-Item -LiteralPath '${escaped}') -is [System.IO.DirectoryInfo]) { $fso.GetFolder('${escaped}').ShortPath } else { $fso.GetFile('${escaped}').ShortPath } }`, {
-            encoding: "utf8",
-            stdio: ["ignore", "pipe", "ignore"],
-            timeout: 5000,
-            shell: "powershell.exe",
-        }).trim();
-        if (result && !result.includes(" ") && (0, node_fs_1.existsSync)(result)) {
-            return result;
+    // Fallback: PowerShell with FileSystemObject COM (native Windows only)
+    if (isWindows()) {
+        try {
+            const escaped = windowsPath.replace(/'/g, "''");
+            const result = (0, node_child_process_1.execSync)(`$fso = New-Object -ComObject Scripting.FileSystemObject; if (Test-Path -LiteralPath '${escaped}') { if ((Get-Item -LiteralPath '${escaped}') -is [System.IO.DirectoryInfo]) { $fso.GetFolder('${escaped}').ShortPath } else { $fso.GetFile('${escaped}').ShortPath } }`, {
+                encoding: "utf8",
+                stdio: ["ignore", "pipe", "ignore"],
+                timeout: 5000,
+                shell: "powershell.exe",
+            }).trim();
+            if (result && !result.includes(" ") && (0, node_fs_1.existsSync)(result)) {
+                return result;
+            }
+        }
+        catch {
+            // 8.3 name generation may be disabled on some volumes
         }
-    }
-    catch {
-        // 8.3 name generation may be disabled on some volumes
     }
     return undefined;
 }
 /** Prefer 8.3 short path on Windows when the input contains spaces; otherwise keep as-is. */
 function preferSpaceFreeWindowsPath(pathValue) {
-    if (!isWindows() || !pathValue.includes(" ")) {
+    if ((!isWindows() && !isWsl()) || !pathValue.includes(" ")) {
         return pathValue;
     }
     return getWindowsShortPath(pathValue) ?? pathValue;
@@ -848,32 +903,270 @@ function repairUnsafeWindowsMcpCommands(serverName = "graphflow", options) {
     }
     return results;
 }
-function resolveWindowsNpxLaunch() {
-    const node = resolveSystemNodeCommand();
+/** True when a path looks like GraphFlow's extension mcp-launcher script. */
+function isGraphFlowMcpLauncherPath(filePath) {
+    const normalized = filePath.replace(/\\/g, "/");
+    const base = (0, node_path_1.basename)(normalized).toLowerCase();
+    return base === "mcp-launcher.cjs" || base === "mcp-launcher.cmd";
+}
+/**
+ * Find a missing GraphFlow mcp-launcher path referenced by an MCP server node.
+ * Returns the stale path when the node points at a launcher that is not on disk.
+ */
+function findMissingGraphFlowMcpLauncher(node) {
+    const candidates = [];
+    if (typeof node.command === "string" && isGraphFlowMcpLauncherPath(node.command)) {
+        candidates.push(node.command);
+    }
+    if (Array.isArray(node.args)) {
+        for (const arg of node.args) {
+            if (typeof arg === "string" && isGraphFlowMcpLauncherPath(arg)) {
+                candidates.push(arg);
+            }
+        }
+    }
+    for (const candidate of candidates) {
+        if (!(0, node_fs_1.existsSync)(candidate)) {
+            return candidate;
+        }
+    }
+    return undefined;
+}
+/**
+ * After VSIX upgrades, user/workspace MCP configs often still point at the previous
+ * extension folder (`…/roarpeng.graphflow-1.9.6/mcp-launcher.cjs`). Cursor Agents
+ * Window prefers project MCP and fails hard when that file is gone, while the IDE
+ * may still work via a newer user-level entry. Rewrite missing launcher refs to the
+ * active extension launcher on activate (and when Install MCP runs).
+ */
+function repairStaleGraphFlowMcpLaunchers(options) {
+    const launcherPath = options.launcherPath?.trim();
+    if (!launcherPath || !(0, node_fs_1.existsSync)(launcherPath)) {
+        return [];
+    }
+    const serverName = options.serverName ?? "graphflow";
+    const results = [];
+    const seen = new Set();
+    const targets = options.targets ??
+        buildAgentProfiles().flatMap((profile) => {
+            const user = profile.userTargets
+                .filter((t) => (t.configFormat ?? "json") !== "codex-toml" && (t.configFormat ?? "json") !== "opencode")
+                .map((t) => ({
+                agentId: profile.id,
+                agentName: profile.name,
+                configPath: t.configPath,
+                serversKey: t.serversKey,
+            }));
+            const workspace = options.workspaceRoot && profile.workspaceRelativePaths
+                ? profile.workspaceRelativePaths
+                    .filter((t) => (t.configFormat ?? "json") !== "codex-toml" && (t.configFormat ?? "json") !== "opencode")
+                    .map((t) => ({
+                    agentId: profile.id,
+                    agentName: `${profile.name} (workspace)`,
+                    configPath: (0, node_path_1.join)(options.workspaceRoot, t.relativePath),
+                    serversKey: t.serversKey,
+                }))
+                : [];
+            return [...user, ...workspace];
+        });
+    for (const target of targets) {
+        const key = `${target.configPath}::${target.serversKey}`;
+        if (seen.has(key) || !(0, node_fs_1.existsSync)(target.configPath)) {
+            continue;
+        }
+        seen.add(key);
+        try {
+            const json = readJsonConfig(target.configPath);
+            const servers = json[target.serversKey] ?? {};
+            const previous = servers[serverName];
+            if (!previous || typeof previous.command !== "string") {
+                continue;
+            }
+            const missingLauncher = findMissingGraphFlowMcpLauncher({
+                ...previous,
+                args: Array.isArray(previous.args) ? previous.args : [],
+            });
+            if (!missingLauncher) {
+                const existingLauncher = Array.isArray(previous.args)
+                    ? previous.args.find((a) => typeof a === "string" && isGraphFlowMcpLauncherPath(a))
+                    : undefined;
+                const unrepaired = {
+                    agentId: target.agentId,
+                    agentName: target.agentName,
+                    configPath: target.configPath,
+                    repaired: false,
+                    beforeCommand: previous.command,
+                    afterCommand: previous.command,
+                };
+                if (existingLauncher) {
+                    unrepaired.beforeLauncher = existingLauncher;
+                    unrepaired.afterLauncher = existingLauncher;
+                }
+                results.push(unrepaired);
+                continue;
+            }
+            const explicitCommand = options.command?.trim();
+            const nextCommand = explicitCommand ||
+                (previous.command && !isGraphFlowMcpLauncherPath(previous.command)
+                    ? previous.command
+                    : "node");
+            const nextCwd = options.cwd ?? previous.cwd;
+            const next = {
+                command: nextCommand,
+                args: [launcherPath],
+                ...(nextCwd ? { cwd: nextCwd } : {}),
+                ...(previous.env ? { env: { ...previous.env } } : {}),
+            };
+            servers[serverName] = next;
+            json[target.serversKey] = servers;
+            writeJsonConfig(target.configPath, json);
+            results.push({
+                agentId: target.agentId,
+                agentName: target.agentName,
+                configPath: target.configPath,
+                repaired: true,
+                beforeCommand: previous.command,
+                afterCommand: next.command,
+                beforeLauncher: missingLauncher,
+                afterLauncher: launcherPath,
+            });
+        }
+        catch {
+            // Config may be malformed; skip — install path will recreate.
+        }
+    }
+    return results;
+}
+function windowsDirname(windowsPath) {
+    const normalized = windowsPath.replace(/\//g, "\\");
+    const idx = normalized.lastIndexOf("\\");
+    return idx >= 0 ? normalized.slice(0, idx) : ".";
+}
+function windowsJoin(...parts) {
+    return parts
+        .map((p, i) => {
+        const n = p.replace(/\//g, "\\");
+        if (i === 0) {
+            return n.replace(/\\+$/g, "");
+        }
+        return n.replace(/^\\+|\\+$/g, "");
+    })
+        .filter((p) => p.length > 0)
+        .join("\\");
+}
+function resolveWindowsNodeCandidates(options) {
+    const candidates = [];
+    if (options?.windowsNodePath?.trim()) {
+        candidates.push(options.windowsNodePath.trim());
+    }
+    const wantWindows = Boolean(options?.windowsHost) || isWindows();
+    if (!wantWindows) {
+        return candidates;
+    }
+    if (isWindows()) {
+        const system = resolveSystemNodeCommand();
+        if (system) {
+            candidates.push(system);
+        }
+        const programFiles = process.env.ProgramFiles ?? "C:\\Program Files";
+        candidates.push(windowsJoin(programFiles, "nodejs", "node.exe"));
+        candidates.push("C:\\PROGRA~1\\nodejs\\node.exe");
+        return candidates;
+    }
+    // WSL → Windows host: resolve via cmd.exe, then common mount points.
+    try {
+        const output = (0, node_child_process_1.execFileSync)("cmd.exe", ["/c", "where node"], {
+            encoding: "utf8",
+            stdio: ["ignore", "pipe", "ignore"],
+            timeout: 3000,
+        }).trim();
+        for (const line of output.split(/\r?\n/).map((l) => l.trim()).filter(Boolean)) {
+            if (/^[A-Za-z]:\\/.test(line) && !isIdeBundledNode(line)) {
+                candidates.push(line);
+            }
+        }
+    }
+    catch {
+        // ignore
+    }
+    candidates.push("C:\\Program Files\\nodejs\\node.exe", "C:\\PROGRA~1\\nodejs\\node.exe", "/mnt/c/Program Files/nodejs/node.exe", "/mnt/c/PROGRA~1/nodejs/node.exe");
+    return candidates;
+}
+/**
+ * Resolve `node.exe` + `npx-cli.js` with space-free (8.3) Windows paths and
+ * NODE/NPX_CLI env — required for Codex MCP registration on Windows.
+ */
+function resolveWindowsNpxLaunch(options) {
+    const wantWindows = Boolean(options?.windowsHost) || isWindows();
+    if (!wantWindows) {
+        return undefined;
+    }
+    const explicitNode = options?.windowsNodePath?.trim();
+    const explicitNpxCli = options?.windowsNpxCliPath?.trim();
+    // Test / forced injection: trust caller paths (already short-form recommended).
+    if (explicitNode && explicitNpxCli) {
+        const node = explicitNode.startsWith("/mnt/")
+            ? toWindowsPathFromWsl(explicitNode)
+            : explicitNode.replace(/\//g, "\\");
+        const npxCli = explicitNpxCli.startsWith("/mnt/")
+            ? toWindowsPathFromWsl(explicitNpxCli)
+            : explicitNpxCli.replace(/\//g, "\\");
+        const shortNode = getWindowsShortPath(node) ?? node;
+        const shortNpxCli = getWindowsShortPath(npxCli) ?? npxCli;
+        if (shortNode.includes(" ") || shortNpxCli.includes(" ")) {
+            return undefined;
+        }
+        return {
+            command: shortNode,
+            args: [shortNpxCli, "-y", "--package=@roarpeng/graphflow", "graphflow-mcp"],
+            env: {
+                NODE: shortNode,
+                NPX_CLI: shortNpxCli,
+            },
+        };
+    }
+    const nodeCandidates = resolveWindowsNodeCandidates(options);
+    let node;
+    for (const candidate of nodeCandidates) {
+        const windowsStyle = candidate.startsWith("/mnt/")
+            ? toWindowsPathFromWsl(candidate)
+            : candidate;
+        if (pathExistsOnWindowsHost(windowsStyle) || pathExistsOnWindowsHost(candidate)) {
+            node = windowsStyle;
+            break;
+        }
+    }
     if (!node) {
         return undefined;
     }
-    const nodeDir = (0, node_path_1.dirname)(node);
-    const candidates = [
-        (0, node_path_1.join)(nodeDir, "node_modules", "npm", "bin", "npx-cli.js"),
-        (0, node_path_1.join)(nodeDir, "..", "lib", "node_modules", "npm", "bin", "npx-cli.js"),
+    const nodeDir = windowsDirname(node);
+    const npxCandidates = [
+        windowsJoin(nodeDir, "node_modules", "npm", "bin", "npx-cli.js"),
+        // Some installs put npm next to node under Program Files
+        windowsJoin(windowsDirname(nodeDir), "node_modules", "npm", "bin", "npx-cli.js"),
     ];
-    for (const npxCli of candidates) {
-        if ((0, node_fs_1.existsSync)(npxCli)) {
-            // If paths contain spaces, try 8.3 short format to avoid quoting issues
-            // with MCP clients that don't properly quote the command (e.g., TRAE).
-            const shortNode = getWindowsShortPath(node) ?? node;
-            const shortNpxCli = getWindowsShortPath(npxCli) ?? npxCli;
-            if (shortNode.includes(" ") || shortNpxCli.includes(" ")) {
-                // Can't resolve to a space-free path; fall back to npx.cmd which
-                // relies on PATH resolution and handles quoting internally.
-                return undefined;
-            }
-            return {
-                command: shortNode,
-                args: [shortNpxCli, "-y", "--package=@roarpeng/graphflow", "graphflow-mcp"],
-            };
+    for (const npxCliRaw of npxCandidates) {
+        const npxCli = npxCliRaw.startsWith("/mnt/")
+            ? toWindowsPathFromWsl(npxCliRaw)
+            : npxCliRaw.replace(/\//g, "\\");
+        if (!pathExistsOnWindowsHost(npxCli) && !pathExistsOnWindowsHost(npxCliRaw)) {
+            continue;
         }
+        const shortNode = getWindowsShortPath(node) ?? node;
+        const shortNpxCli = getWindowsShortPath(npxCli) ?? npxCli;
+        if (shortNode.includes(" ") || shortNpxCli.includes(" ")) {
+            // Can't resolve to a space-free path; fall back to npx.cmd which
+            // relies on PATH resolution and handles quoting internally.
+            return undefined;
+        }
+        return {
+            command: shortNode,
+            args: [shortNpxCli, "-y", "--package=@roarpeng/graphflow", "graphflow-mcp"],
+            env: {
+                NODE: shortNode,
+                NPX_CLI: shortNpxCli,
+            },
+        };
     }
     return undefined;
 }
@@ -947,21 +1240,26 @@ function buildMcpServerNodeRaw(options) {
     // 写入 Cursor/VS Code 可展开的 ${workspaceFolder}，让 MCP 子进程拿到真实项目根。
     // 不支持插值的宿主会留下字面量；discover-workspace 会忽略 unresolved placeholder
     // 并回退到 WORKSPACE_FOLDER_PATHS / rootDir。
+    // Codex 不支持 ${workspaceFolder}，由 omitWorkspaceFolderPlaceholder 跳过。
     const npxEnv = {
         ...MCP_STDIO_ENV,
-        GRAPHFLOW_WORKSPACE_ROOT: "${workspaceFolder}",
     };
-    if (isWindows()) {
-        const winNpx = resolveWindowsNpxLaunch();
-        if (winNpx) {
-            return {
-                command: winNpx.command,
-                args: winNpx.args,
-                env: npxEnv,
-            };
-        }
+    if (!options.omitWorkspaceFolderPlaceholder) {
+        npxEnv.GRAPHFLOW_WORKSPACE_ROOT = "${workspaceFolder}";
+    }
+    const winNpx = resolveWindowsNpxLaunch({
+        ...(options.windowsHost !== undefined ? { windowsHost: options.windowsHost } : {}),
+        ...(options.windowsNodePath !== undefined ? { windowsNodePath: options.windowsNodePath } : {}),
+        ...(options.windowsNpxCliPath !== undefined ? { windowsNpxCliPath: options.windowsNpxCliPath } : {}),
+    });
+    if (winNpx) {
+        return {
+            command: winNpx.command,
+            args: winNpx.args,
+            env: { ...npxEnv, ...winNpx.env },
+        };
     }
-    const npxCmd = isWindows() ? "npx.cmd" : "npx";
+    const npxCmd = isWindows() || options.windowsHost ? "npx.cmd" : "npx";
     return {
         command: npxCmd,
         args: ["-y", "--package=@roarpeng/graphflow", "graphflow-mcp"],
@@ -1255,9 +1553,22 @@ function installMcpToDetectedAgents(options) {
     for (const target of targets) {
         try {
             const { workspaceRoot, ...restOptions } = options;
+            const windowsHost = Boolean(restOptions.windowsHost) ||
+                isWindows() ||
+                target.agentId.endsWith("-windows");
+            const isCodex = target.configFormat === "codex-toml";
             const node = buildMcpServerNode(target.scope === "workspace" && workspaceRoot
-                ? { ...restOptions, workspaceRoot }
-                : restOptions);
+                ? {
+                    ...restOptions,
+                    workspaceRoot,
+                    windowsHost,
+                    omitWorkspaceFolderPlaceholder: Boolean(restOptions.omitWorkspaceFolderPlaceholder) || isCodex,
+                }
+                : {
+                    ...restOptions,
+                    windowsHost,
+                    omitWorkspaceFolderPlaceholder: Boolean(restOptions.omitWorkspaceFolderPlaceholder) || isCodex,
+                });
             const status = injectIntoAgentConfig(target.configPath, target.serversKey, target.configFormat, serverName, node);
             results.push({
                 agentId: target.agentId,
@@ -1280,12 +1591,13 @@ function installMcpToDetectedAgents(options) {
     }
     return results;
 }
-/** 从所有检测到的 agent 中移除 GraphFlow MCP 配置 */
+/** 从所有检测到的 agent 中移除 GraphFlow MCP 配置（user + optional workspace） */
 function uninstallMcpFromDetectedAgents(options) {
     const profiles = buildAgentProfiles();
     const detectedIds = new Set(detectInstalledAgents().map((agent) => agent.id));
     const serverName = options?.serverName ?? "graphflow";
     const targetAgentId = options?.agentId;
+    const workspaceRoot = options?.workspaceRoot?.trim() || process.cwd();
     const results = [];
     for (const profile of profiles) {
         // 如果指定了 agent，则仅处理该 agent
@@ -1318,6 +1630,7 @@ function uninstallMcpFromDetectedAgents(options) {
                     agentName: profile.name,
                     configPath: userTarget.configPath,
                     removed,
+                    scope: "user",
                     message: removed ? "已移除" : "未找到配置（可能已移除）",
                 });
             }
@@ -1327,10 +1640,54 @@ function uninstallMcpFromDetectedAgents(options) {
                     agentName: profile.name,
                     configPath: userTarget.configPath,
                     removed: false,
+                    scope: "user",
                     message: error instanceof Error ? error.message : String(error),
                 });
             }
         }
+        if (workspaceRoot && profile.workspaceRelativePaths) {
+            for (const workspaceTarget of profile.workspaceRelativePaths) {
+                const configPath = (0, node_path_1.join)(workspaceRoot, workspaceTarget.relativePath);
+                const key = `${configPath}::${workspaceTarget.serversKey}::${workspaceTarget.configFormat ?? "json"}`;
+                if (seen.has(key)) {
+                    continue;
+                }
+                seen.add(key);
+                if (!(0, node_fs_1.existsSync)(configPath)) {
+                    continue;
+                }
+                try {
+                    let removed = false;
+                    if (workspaceTarget.configFormat === "codex-toml") {
+                        removed = removeCodexMcpEntry(configPath, serverName);
+                    }
+                    else if (workspaceTarget.configFormat === "opencode") {
+                        removed = removeOpencodeMcpEntry(configPath, serverName);
+                    }
+                    else {
+                        removed = removeMcpEntry(configPath, workspaceTarget.serversKey, serverName);
+                    }
+                    results.push({
+                        agentId: profile.id,
+                        agentName: `${profile.name} (workspace)`,
+                        configPath,
+                        removed,
+                        scope: "workspace",
+                        message: removed ? "已移除" : "未找到配置（可能已移除）",
+                    });
+                }
+                catch (error) {
+                    results.push({
+                        agentId: profile.id,
+                        agentName: `${profile.name} (workspace)`,
+                        configPath,
+                        removed: false,
+                        scope: "workspace",
+                        message: error instanceof Error ? error.message : String(error),
+                    });
+                }
+            }
+        }
     }
     return results;
 }
@@ -1361,6 +1718,7 @@ function formatModelConfigGuide(workspaceRoot) {
         '> "使用 graphflow 预览当前项目的 orchestrator 相关上下文"',
         "",
         "Codex 配置写入 `~/.codex/config.toml` 的 `[mcp_servers.graphflow]`；Trae 写入 `User/mcp.json`。",
+        "Windows 上 Codex 使用 node.exe + npx-cli.js，并写入 NODE / NPX_CLI（优先 8.3 短路径，如 C:\\PROGRA~1\\nodejs\\...）。",
         "",
         "## 6. 验证路由",
         "运行 `GraphFlow: Settings` 保存后，在 Chat 输入 `@graphflow /diagnose` 查看 provider 健康状态。",