@srgay/cursor-extension 1.0.0 → 1.0.1

package/README.md

@@ -3,7 +3,7 @@
 一组本机 Cursor workbench 增强脚本，包含三部分：
 
 1. **MAX Mode 守护**：保持 `MAX Mode` 关闭，并在彩色 `MAX` 标记出现且聊天框有内容时阻止发送。
-2. **MCP Follow-up 面板**：在 Cursor 聊天框上方注入一个 MCP 反馈面板，连接 `mcp-feedback-enhanced` 的 WebSocket，让你直接在 Cursor 里回复 `interactive_feedback`，并支持端口自动扫描与自定义。
+2. **MCP Follow-up 面板**：在 Cursor 聊天框上方注入一个 MCP 反馈面板，连接 `mcp-feedback-enhanced` 的 WebSocket，让你直接在 Cursor 里回复 `interactive_feedback`，支持端口自动扫描/自定义，并能按当前项目自动匹配对应端口（多项目、多端口同时在线时也不误连）。
 3. **输入法回车修复**：修复用中文输入法（拼音/注音等）组字时，按回车上屏候选词会被 Cursor 误当成「提交」的问题（含自带的 AskQuestion「Other」输入框）。
 
 ## 安装与使用（npx）
@@ -29,6 +29,7 @@ npx @srgay/cursor-extension help
 - Cursor 更新可能覆盖 `workbench.html`，功能失效时重新执行 `install`。
 - 自定义 Cursor 安装目录：设置环境变量 `CURSOR_WORKBENCH_DIR`。
 - `inject` 自定义调试端口：设置环境变量 `CURSOR_DEBUG_PORT`（默认 `9222`）。
+- MCP 面板配置读写所用的 python 命令：默认按平台自动探测（`python` / `py` / `python3`），可用环境变量 `CURSOR_MCP_PYTHON` 强制指定（某些 Windows 环境用得上）。
 
 > 说明：下文「推荐方式 / 备用方式」里的 `npm run patch`、`npm run inject` 等是**本仓库源码开发**用法；最终用户用上面的 `npx` 命令即可，二者等价。
 
@@ -52,10 +53,10 @@ npm run patch
 Patch 行为：
 
 - 注入 `<script src="./cursor-max-mode-guard.js">`、`<script src="./cursor-mcp-followup.js">`、`<script src="./cursor-ime-enter-fix.js">` 到 `workbench.html`（各自带注释标记，便于幂等与回退）。
-- 把 `cursor-mcp-followup.js` 拷入 workbench 目录时，将其中的 `__MCP_SETTINGS_PATH__` 占位符替换为本机真实路径 `~/.config/mcp-feedback-enhanced/ui_settings.json`（面板借 WS `run_command` 读写该文件，实现常用提示词与自动提交配置的查看/编辑）。
+- 把 `cursor-mcp-followup.js` 拷入 workbench 目录时，按当前系统替换其中的路径/命令占位符：配置路径 `~/.config/mcp-feedback-enhanced/ui_settings.json`（Windows 为 `C:/Users/<你>/.config/...`，统一用正斜杠），以及读取命令（Mac/Linux 用 `cat`、Windows 用 `python -X utf8` 读取）与写入用的 python 命令名（面板借 WS `run_command` 读写该文件，实现常用提示词与自动提交配置的查看/编辑）。
 - 同步更新 Cursor `product.json` 里的 `workbench.html` checksum，避免 Cursor 把这次修改识别为安装损坏。
 
-> 注意：占位符在 patch 时按当前用户主目录写死。若更换用户/主目录，重新执行 `npm run patch`。
+> 注意：占位符在 patch 时按当前用户主目录与操作系统写死。若更换用户/主目录或操作系统，重新执行 `npm run patch`。
 
 然后完整退出 Cursor，再重新打开 Cursor。
 
@@ -117,13 +118,14 @@ npm run inject
 - 端口下拉：动态填充扫描到的活跃端口，末尾提供「自定义端口…」可手动输入任意端口。
 - 下拉展开时每项显示「状态 · 项目名」（如 `Port 8766 · waiting · my-project`），收起时只显示「Port X · 状态」以贴合宽度，避免与右侧项目名重复。
 - 放大镜按钮可随时重新扫描。
+- **自动匹配当前项目端口**：从 Cursor 原生 `window.vscode` 取当前窗口的工作区路径，优先连接 `project_directory` 与之相等的 MCP 端口；多个端口同时在线（如别的项目窗口或常驻实例）时也能选对本项目，绝不误连。本项目端口尚未出现时持续重扫等待，出现后自动连上；取不到工作区（多根工作区/空窗口）时回退为原有的端口选择逻辑。
 - 持续保持为 WebSocket「最后连接」（每 3 秒重连 + 输入框聚焦时重连），确保始终能收到当前会话并成功提交反馈。
 - 底部「常用提示词」下拉：一键把 `ui_settings.json` 里的提示词追加到输入框；旁边刷新按钮可重新拉取配置。
 - 齿轮按钮展开**配置抽屉**：
   - **常用提示词**增删改（写回 `ui_settings.json`，删除带二次确认）。
   - **自动提交**配置：启用开关、超时（秒）、选择提示词，状态实时回显。
   - **自动提交运行时**：仅在「等待反馈」时倒计时，输入框右侧显示 `自动提交 m:ss` 小标签；到点自动以所选提示词发送（走与手动一致的重连抢占）。用户输入/手动插入提示词/手动发送/点击倒计时/会话离开等待态，本轮即取消自动提交。
-- 配置读写均借现有 WebSocket 的 `run_command` 完成（读 `cat`、写 `python3` base64 解码落盘），不依赖本地文件系统访问或 CORS。
+- 配置读写均借现有 WebSocket 的 `run_command` 完成（Mac/Linux 读用 `cat`，Windows 读用 `python -X utf8`；写入两平台都用 python base64 解码落盘），不依赖本地文件系统访问或 CORS。服务端以 `shell=False` + `shlex.split` 执行命令，故 Windows 路径统一用正斜杠以规避转义。
 
 ### 加载方式
 
@@ -140,11 +142,13 @@ open -na /Applications/Cursor.app --args --remote-debugging-port=9222
 npm run inject:followup
 ```
 
-> CDP 注入是临时的，**重启 Cursor 后需要重新执行**；`install-cursor-mcp-followup.mjs` 会在注入时替换 `__MCP_SETTINGS_PATH__` 占位符。
+> CDP 注入是临时的，**重启 Cursor 后需要重新执行**；`install-cursor-mcp-followup.mjs` 会在注入时按平台替换路径/命令占位符（详见 `src/shared/mcp-settings.mjs`）。
 
 ### 端口扫描与自定义
 
 - 面板安装时自动扫描一次 `8765–8769`。
+- **按项目自动选端口**：扫描后优先选中 `project_directory` 等于当前窗口工作区路径的端口；若当前选中端口已知属于别的项目则不连接，避免误连到其它项目或常驻 feedback 实例。
+- 本项目端口还没出现时，每 3 秒重扫一次去发现它；连上本项目端口后改为定期重连以保持「最后连接」。
 - 点击放大镜按钮可手动重扫。
 - 在端口下拉里选择「自定义端口…」，就地输入端口号回车即可连接；输入框失焦或按 `Esc` 会回退到第一个可用端口。
 
@@ -220,6 +224,7 @@ window.__cursorImeEnterFix.uninstall() // 卸载
   - `install-cursor-ime-enter-fix.mjs`: 通过 CDP 临时注入输入法回车修复。
 - `src/shared/` — 共享工具
   - `cursor-workbench-paths.mjs`: macOS/Windows workbench 路径解析。
+  - `mcp-settings.mjs`: 按平台生成 MCP 面板的配置路径与读/写命令（探测 python，Windows 用正斜杠）。
   - `patch-cursor-workbench.mjs`: patch Cursor 的 `workbench.html`（注入全部三个脚本）。
   - `unpatch-cursor-workbench.mjs`: 恢复 patch。
 

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@srgay/cursor-extension",
-  "version": "1.0.0",
+  "version": "1.0.1",
   "description": "本机 Cursor workbench 增强：MAX Mode 守护、MCP Follow-up 面板、输入法回车修复（支持随 Cursor 启动持久加载，或 CDP 临时注入）。",
   "type": "module",
   "bin": {
@@ -16,7 +16,7 @@
     "node": ">=20"
   },
   "scripts": {
-    "check": "node --check src/max-mode-guard/cursor-max-mode-guard.js && node --check src/mcp-followup/cursor-mcp-followup.js && node --check src/ime-enter-fix/cursor-ime-enter-fix.js && node --check src/shared/cursor-workbench-paths.mjs && node --check src/max-mode-guard/install-cursor-max-mode-guard.mjs && node --check src/mcp-followup/install-cursor-mcp-followup.mjs && node --check src/ime-enter-fix/install-cursor-ime-enter-fix.mjs && node --check src/shared/patch-cursor-workbench.mjs && node --check src/shared/unpatch-cursor-workbench.mjs && node --check bin/cli.mjs",
+    "check": "node --check src/max-mode-guard/cursor-max-mode-guard.js && node --check src/mcp-followup/cursor-mcp-followup.js && node --check src/ime-enter-fix/cursor-ime-enter-fix.js && node --check src/shared/cursor-workbench-paths.mjs && node --check src/shared/mcp-settings.mjs && node --check src/max-mode-guard/install-cursor-max-mode-guard.mjs && node --check src/mcp-followup/install-cursor-mcp-followup.mjs && node --check src/ime-enter-fix/install-cursor-ime-enter-fix.mjs && node --check src/shared/patch-cursor-workbench.mjs && node --check src/shared/unpatch-cursor-workbench.mjs && node --check bin/cli.mjs",
     "inject": "node src/max-mode-guard/install-cursor-max-mode-guard.mjs",
     "inject:followup": "node src/mcp-followup/install-cursor-mcp-followup.mjs",
     "inject:ime": "node src/ime-enter-fix/install-cursor-ime-enter-fix.mjs",

package/src/mcp-followup/cursor-mcp-followup.js

@@ -17,9 +17,13 @@
     lang: "zh-CN",
     // 发送场景重连成功（onopen）后，若服务端未及时推送会话状态，则等待此毫秒数后兜底直接发送。
     sendAfterOpenMs: 350,
-    // 常用提示词所在 ui_settings.json 的绝对路径；注入脚本会用真实 home 路径替换此占位符。
-    // 面板借道现有 WS 的 run_command（cat 该文件）拉取提示词，不读本地 fs、不依赖 CORS。
+    // 常用提示词所在 ui_settings.json 的绝对路径；注入脚本会按平台替换此占位符（Windows 用正斜杠）。
+    // 面板借道现有 WS 的 run_command 读写该文件，不读本地 fs、不依赖 CORS。
     settingsPath: "__MCP_SETTINGS_PATH__",
+    // 读取配置的完整命令：Mac/Linux 为 `cat <path>`，Windows 为 python UTF-8 读取（注入时按平台生成）。
+    readCmd: "__MCP_READ_CMD__",
+    // 写回配置时使用的 python 命令名（注入时探测：python / py / python3）。
+    pyCmd: "__MCP_PY__",
     // run_command 拉取提示词的兜底超时（毫秒）。
     promptLoadTimeoutMs: 4000,
   };
@@ -36,6 +40,8 @@
     scanning: false,
     foundPorts: [],
     portProjects: {},
+    // 端口 → 完整 project_directory（扫描/会话时记录），用于把面板锁定到当前窗口项目对应的端口。
+    portPaths: {},
     portStatuses: {},
     selectedStatus: null,
     expanded: false,
@@ -593,6 +599,37 @@
     );
   }
 
+  // 路径规范化：统一分隔符并去掉尾部斜杠，便于和 session 的 project_directory 精确比较。
+  function normalizePath(dir) {
+    return String(dir || "")
+      .replace(/\\/g, "/")
+      .replace(/\/+$/, "");
+  }
+
+  // 当前 Cursor 窗口的工作区绝对路径，取自原生 window.vscode（无需额外注入信息）。
+  // 取不到（多根工作区 / 空窗口 / 接口缺失）时返回 null，调用方据此降级为原有端口选择逻辑。
+  function getWorkspacePath() {
+    try {
+      const ctx = window.vscode && window.vscode.context;
+      const cfg = ctx && typeof ctx.configuration === "function" ? ctx.configuration() : null;
+      const uri = cfg && cfg.workspace && cfg.workspace.uri;
+      const p = uri && (uri.path || uri.fsPath || uri._fsPath);
+      return p ? normalizePath(p) : null;
+    } catch (error) {
+      return null;
+    }
+  }
+
+  // 从一轮扫描结果里挑出 project_directory 与当前窗口工作区相等的端口（按项目锁定端口的核心优先级）。
+  function pickWorkspacePort(results) {
+    const ws = getWorkspacePath();
+    if (!ws) return null;
+    const hit = results.find(
+      (item) => item.alive && item.project && normalizePath(item.project) === ws
+    );
+    return hit ? String(hit.port) : null;
+  }
+
   // 选项文本：Port {port}[ · 状态][ · 项目名]（状态在前、项目在后）。
   // 下拉展开时所有项都带「状态 · 项目名」，便于按项目/状态区分端口；
   // 收起时框里显示的是「选中项」，为避免与右侧项目名重复，选中项收起时不带项目名。
@@ -685,6 +722,7 @@
 
     const project = basename(info && info.project_directory);
     if (project) state.portProjects[state.socketPort] = project;
+    if (info && info.project_directory) state.portPaths[state.socketPort] = info.project_directory;
     state.portStatuses[state.socketPort] = deriveStatusLabel(info);
 
     const status = info && info.status;
@@ -763,8 +801,8 @@
     state.cmdBuffer = "";
     if (els.promptRefresh) els.promptRefresh.classList.add("scanning");
     try {
-      // shell=False，路径无空格，直接传绝对路径即可（~ 不会被展开）。
-      state.socket.send(JSON.stringify({ type: "run_command", command: "cat " + config.settingsPath }));
+      // 读取命令由注入脚本按平台生成（Mac/Linux: cat；Windows: python -X utf8 读取）。
+      state.socket.send(JSON.stringify({ type: "run_command", command: config.readCmd }));
     } catch (error) {
       state.loadingPrompts = false;
       state.cmdBuffer = null;
@@ -836,7 +874,7 @@
         "').write_bytes(__import__('base64').b64decode('" +
         b64 +
         "'))";
-      command = 'python3 -c "' + py + '"';
+      command = config.pyCmd + ' -c "' + py + '"';
       const lower = command.toLowerCase();
       safe = dangerous.every((p) => lower.indexOf(p) === -1);
       if (!safe) payload += "\n";
@@ -1282,20 +1320,29 @@
     for (const item of results) {
       if (item.alive) {
         found.push(item.port);
-        if (item.project) state.portProjects[item.port] = basename(item.project);
-        else delete state.portProjects[item.port];
+        if (item.project) {
+          state.portProjects[item.port] = basename(item.project);
+          state.portPaths[item.port] = item.project;
+        } else {
+          delete state.portProjects[item.port];
+          delete state.portPaths[item.port];
+        }
         if (item.statusLabel) state.portStatuses[item.port] = item.statusLabel;
         else delete state.portStatuses[item.port];
       } else {
         delete state.portProjects[item.port];
+        delete state.portPaths[item.port];
         delete state.portStatuses[item.port];
       }
     }
     state.foundPorts = found;
 
     const wasCustom = els.portSelect.value === config.customValue;
-    fillPortOptions(found, wasCustom ? null : els.portSelect.value);
-    if (wasCustom) els.portSelect.value = config.customValue;
+    // 优先选中 project_directory 与当前窗口工作区相等的端口；取不到工作区或无匹配端口时维持原有选择
+    //（combo 降级），连接层再由 connectSelectedPort 守卫兜底，避免连到别的项目。
+    const preferred = pickWorkspacePort(results);
+    fillPortOptions(found, preferred || (wasCustom ? null : els.portSelect.value));
+    if (wasCustom && !preferred) els.portSelect.value = config.customValue;
 
     if (els.scanBtn) {
       els.scanBtn.classList.remove("scanning");
@@ -1352,6 +1399,23 @@
   function connectSelectedPort(auto) {
     const port = els.portSelect.value;
     if (port === config.customValue) return;
+
+    // 守卫：能确定当前窗口项目、且该端口已知属于别的项目时不连接，
+    // 避免误连到其它项目或常驻 feedback 实例（等本项目端口出现后由 refreshTick 重扫接管）。
+    const ws = getWorkspacePath();
+    if (ws && state.portPaths[port] && normalizePath(state.portPaths[port]) !== ws) {
+      if (state.socket) {
+        state.socket.onclose = null;
+        state.socket.onerror = null;
+        state.socket.onmessage = null;
+        state.socket.close();
+        state.socket = null;
+      }
+      setOptionLabel(port, "other project");
+      setVisualState("offline", port + " 属于其它项目，等待本项目的 MCP 会话…");
+      return;
+    }
+
     const seq = ++state.connectSeq;
 
     if (state.socket) {
@@ -1436,6 +1500,18 @@
     if (els.portSelect.value === config.customValue) return;
     if (els.customInput === document.activeElement) return;
     if (els.prompt === document.activeElement && els.prompt.value.trim()) return;
+
+    // 还没连到「本项目」端口时，定期重扫去发现它（scanPorts 会优先选中并连上）；
+    // 已在本项目端口（或取不到工作区时）则维持原有重连，持续保持「最后连接」。
+    const ws = getWorkspacePath();
+    if (ws) {
+      const cur = els.portSelect.value;
+      const onWorkspacePort = !!state.portPaths[cur] && normalizePath(state.portPaths[cur]) === ws;
+      if (!onWorkspacePort) {
+        scanPorts();
+        return;
+      }
+    }
     connectSelectedPort(true);
   }
 

package/src/mcp-followup/install-cursor-mcp-followup.mjs

@@ -1,7 +1,7 @@
 import { readFile } from "node:fs/promises";
-import { homedir } from "node:os";
-import { dirname, join, resolve } from "node:path";
+import { dirname, resolve } from "node:path";
 import { fileURLToPath } from "node:url";
+import { applyMcpFollowupReplacements } from "../shared/mcp-settings.mjs";
 
 const __dirname = dirname(fileURLToPath(import.meta.url));
 const port = Number(process.env.CURSOR_DEBUG_PORT || "9222");
@@ -69,10 +69,9 @@ if (!target) {
   );
 }
 
-// 面板运行在浏览器环境（无 fs），改用 WS run_command 读取常用提示词；
-// 这里在 Node 侧把占位符替换成 ui_settings.json 的真实绝对路径（shell=False 下 ~ 不展开）。
-const settingsPath = join(homedir(), ".config", "mcp-feedback-enhanced", "ui_settings.json");
-const source = (await readFile(sourcePath, "utf8")).replace("__MCP_SETTINGS_PATH__", settingsPath);
+// 面板运行在浏览器环境（无 fs），改用 WS run_command 读写 ui_settings.json；
+// 这里在 Node 侧按平台把占位符替换成真实路径与命令（Windows 用正斜杠 + python，详见 shared/mcp-settings.mjs）。
+const source = applyMcpFollowupReplacements(await readFile(sourcePath, "utf8"));
 const client = connect(target.webSocketDebuggerUrl);
 
 await client.opened;

package/src/shared/mcp-settings.mjs

@@ -0,0 +1,54 @@
+import { spawnSync } from "node:child_process";
+import { homedir } from "node:os";
+import { join } from "node:path";
+
+// MCP Follow-up 面板运行在浏览器环境（无 fs），通过现有 WS 的 run_command 读/写 ui_settings.json。
+// 服务端（mcp-feedback-enhanced）以 shell=False + shlex.split(POSIX) 执行命令，因此：
+//   - 路径里的反斜杠会被 shlex 与 Python 字面量双重转义 → Windows 统一改用正斜杠；
+//   - Windows 没有 cat / 不一定有 python3 → 读取改用探测到的 python，并用 -X utf8 规避编码问题。
+// 这里在注入脚本（Node 侧、与 Cursor/MCP 同机）按平台生成真实路径与命令，替换面板里的占位符。
+
+// 探测可用的 python 命令名：优先环境变量 CURSOR_MCP_PYTHON，其次按平台候选逐一 `--version` 验证。
+function detectPython() {
+  const override = process.env.CURSOR_MCP_PYTHON;
+  if (override && override.trim()) return override.trim();
+
+  const isWin = process.platform === "win32";
+  const candidates = isWin ? ["python", "py", "python3"] : ["python3", "python"];
+  for (const cmd of candidates) {
+    try {
+      const result = spawnSync(cmd, ["--version"], { stdio: "ignore" });
+      if (!result.error && result.status === 0) return cmd;
+    } catch {
+      // 忽略，尝试下一个候选
+    }
+  }
+  return isWin ? "python" : "python3";
+}
+
+// 生成面板占位符的真实取值：配置文件绝对路径、python 命令名、完整读取命令。
+export function buildMcpFollowupReplacements() {
+  const isWin = process.platform === "win32";
+
+  // 与 mcp-feedback-enhanced 一致：~/.config/mcp-feedback-enhanced/ui_settings.json（无平台分支）。
+  let settingsPath = join(homedir(), ".config", "mcp-feedback-enhanced", "ui_settings.json");
+  if (isWin) settingsPath = settingsPath.replace(/\\/g, "/");
+
+  const pyCmd = detectPython();
+
+  // 读取命令：Mac/Linux 用现成的 cat；Windows 无 cat，用 python 的 UTF-8 模式读取。
+  const readCmd = isWin
+    ? `${pyCmd} -X utf8 -c "print(open('${settingsPath}').read())"`
+    : `cat ${settingsPath}`;
+
+  return { settingsPath, pyCmd, readCmd };
+}
+
+// 把面板源码里的占位符替换为真实取值。用函数式替换以避免 $ 等特殊字符被当作替换模式。
+export function applyMcpFollowupReplacements(code) {
+  const { settingsPath, pyCmd, readCmd } = buildMcpFollowupReplacements();
+  return code
+    .replace("__MCP_SETTINGS_PATH__", () => settingsPath)
+    .replace("__MCP_READ_CMD__", () => readCmd)
+    .replace("__MCP_PY__", () => pyCmd);
+}

package/src/shared/patch-cursor-workbench.mjs

@@ -1,8 +1,8 @@
 import { createHash } from "node:crypto";
 import { copyFile, readFile, stat, writeFile } from "node:fs/promises";
-import { homedir } from "node:os";
-import { dirname, join, resolve } from "node:path";
+import { dirname, resolve } from "node:path";
 import { fileURLToPath } from "node:url";
+import { applyMcpFollowupReplacements, buildMcpFollowupReplacements } from "./mcp-settings.mjs";
 import { resolveWorkbenchPaths } from "./cursor-workbench-paths.mjs";
 
 const __dirname = dirname(fileURLToPath(import.meta.url));
@@ -10,8 +10,8 @@ const __dirname = dirname(fileURLToPath(import.meta.url));
 const guardSource = resolve(__dirname, "../max-mode-guard/cursor-max-mode-guard.js");
 const followupSource = resolve(__dirname, "../mcp-followup/cursor-mcp-followup.js");
 const imeFixSource = resolve(__dirname, "../ime-enter-fix/cursor-ime-enter-fix.js");
-// 面板在浏览器环境无 fs，靠 WS run_command 读取 ui_settings.json；patch 时把占位符替换成真实绝对路径。
-const settingsPath = join(homedir(), ".config", "mcp-feedback-enhanced", "ui_settings.json");
+// 面板在浏览器环境无 fs，靠 WS run_command 读写 ui_settings.json；settingsPath 仅用于下方日志输出。
+const { settingsPath } = buildMcpFollowupReplacements();
 const {
   workbenchDir,
   workbenchHtml,
@@ -113,8 +113,8 @@ async function main() {
 
   await copyFile(guardSource, guardTarget);
 
-  // MCP 面板：不是单纯拷贝，需把 __MCP_SETTINGS_PATH__ 占位符替换成真实路径后再写入。
-  const followupCode = (await readFile(followupSource, "utf8")).replace("__MCP_SETTINGS_PATH__", settingsPath);
+  // MCP 面板：不是单纯拷贝，需按平台把占位符（路径/命令）替换后再写入。
+  const followupCode = applyMcpFollowupReplacements(await readFile(followupSource, "utf8"));
   await writeFile(followupTarget, followupCode);
 
   // 输入法回车修复：无占位符，直接拷贝。