@srgay/cursor-extension 1.0.0 → 1.0.2

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。
 
@@ -114,16 +115,17 @@ npm run inject
 
 - 注入到聊天框上方，样式贴合 Cursor 原生输入框。
 - 自动扫描端口 `8765–8769`，识别正在监听的 MCP 服务（连得上或返回 `4004 无 session` 即视为活跃）。
-- 端口下拉：动态填充扫描到的活跃端口，末尾提供「自定义端口…」可手动输入任意端口。
-- 下拉展开时每项显示「状态 · 项目名」（如 `Port 8766 · waiting · my-project`），收起时只显示「Port X · 状态」以贴合宽度，避免与右侧项目名重复。
-- 放大镜按钮可随时重新扫描。
+- 端口下拉（自定义浮层菜单）：**点开下拉即扫描一次**——先显示「扫描中…」，扫完用最新结果填充并展示可用端口；点选**一次即生效**（自定义菜单不依赖原生 `<select>`，不打断、不闪），末尾提供「自定义端口…」可手动输入任意端口。点空白处或按 `Esc` 关闭菜单。
+- 菜单每项显示「状态 · 项目名」（如 `Port 8766 · waiting · my-project`）便于区分；触发按钮收起时只显示「Port X · 状态」以贴合宽度，避免与右侧项目名重复。
+- 放大镜按钮可随时重新扫描（全量扫描并自动连上本窗口端口）。
+- **自动匹配当前窗口端口**：每个 Cursor 窗口会起一个独立的 mcp-feedback 实例。面板从 Cursor 原生 `window.vscode` 取当前窗口工作区路径，再借 `run_command` 读取每个端口所在实例的 `WORKSPACE_FOLDER_PATHS`（窗口真实工作区，由 Cursor 注入、**不受 AI 传入的 `project_directory` 影响**），据此连接「本窗口」对应的端口；读不到时退用 `CURSOR_WORKSPACE_LABEL`（项目名）做次级匹配。多端口同时在线（别的窗口/常驻实例）也能选对、绝不误连；本窗口端口尚未出现时降频重扫等待，出现后自动连上；取不到工作区（多根工作区/空窗口）时回退原有逻辑。
 - 持续保持为 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,12 +142,14 @@ 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`。
-- 点击放大镜按钮可手动重扫。
+- **按窗口自动选端口**：扫描时借 `run_command` 读取每个端口实例的 `WORKSPACE_FOLDER_PATHS`，优先选中与当前窗口工作区相等的端口（次级用 `CURSOR_WORKSPACE_LABEL` 项目名）；已知属于别的窗口的端口直接不连。这样即使「在 A 窗口让 AI 改 B 项目代码」（会话 `project_directory` 变成 B），也仍连回 A 窗口自己的端口。
+- **扫描时机**：只在「面板启动时」和「每次点开端口下拉时」各扫一次，不做后台轮询扫描；连上本窗口端口后只发心跳维持 WebSocket「最后连接」。本窗口端口暂未出现时，点开下拉重扫即可发现并连上。
+- 点击放大镜按钮可手动重扫（全量扫描并自动连上本窗口端口）。
 - 在端口下拉里选择「自定义端口…」，就地输入端口号回车即可连接；输入框失焦或按 `Esc` 会回退到第一个可用端口。
 
 ### 查看状态
@@ -173,7 +177,7 @@ window.__cursorMcpFollowup.uninstall()    // 卸载面板
 脚本顶部 `config` 可调整：
 
 - `scanStart` / `scanCount`：扫描起始端口与数量（默认从 `8765` 起、共 `5` 个，即 `8765–8769`）。
-- `probeTimeoutMs`：单端口探测超时（默认 `1200` ms）。
+- `probeTimeoutMs`：单端口探测超时（默认 `2500` ms；含一次 `run_command` 读取窗口工作区的往返）。
 - `reconnectMs`：自动重连间隔（默认 `3000` ms）。
 
 ### 排障
@@ -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.2",
   "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

@@ -12,14 +12,19 @@
     reconnectMs: 3000,
     scanStart: 8765,
     scanCount: 5,
-    probeTimeoutMs: 1200,
+    probeTimeoutMs: 2500,
+    // 按需扫描：仅在「启动时」和「展开端口下拉框时」各扫一次，不做后台/持续扫描。
     customValue: "__custom__",
     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 +41,10 @@
     scanning: false,
     foundPorts: [],
     portProjects: {},
+    // 端口 → 窗口真实工作区路径 / 项目名（取自 server 进程的 WORKSPACE_FOLDER_PATHS / CURSOR_WORKSPACE_LABEL，
+    // 由 Cursor 注入、不受 AI 传入的 project_directory 影响），用于把面板锁定到「本窗口」对应的端口。
+    portWorkspaces: {},
+    portLabels: {},
     portStatuses: {},
     selectedStatus: null,
     expanded: false,
@@ -57,6 +66,9 @@
     // 输入法组字（拼音/注音等）进行中：此间回车用于上屏候选词，不应触发发送。
     composing: false,
     timers: [],
+    // 自定义端口下拉的文档级监听（点空白处 / Esc 关闭菜单），uninstall 时移除。
+    onDocPointerDown: null,
+    onDocKeydown: null,
   };
 
   const SVG_NS = "http://www.w3.org/2000/svg";
@@ -170,6 +182,45 @@
       #${config.panelId} .cmf-port:focus { background-color: var(--vscode-list-hoverBackground, rgba(228, 228, 228, .07)); }
       #${config.panelId} .cmf-prompts { max-width: 170px; flex: 0 1 auto; }
 
+      /* 自定义端口下拉：触发按钮 + 浮层菜单（替代原生 <select>，以支持「点开→扫描→填充→展示」而不打断点选）。 */
+      #${config.panelId} .cmf-portwrap { position: relative; display: inline-flex; flex: 0 0 auto; }
+      #${config.panelId} .cmf-portbtn {
+        appearance: none; -webkit-appearance: none;
+        height: 22px; padding: 0 20px 0 8px;
+        border-radius: 4px;
+        border: 1px solid transparent;
+        background-color: transparent;
+        background-image: url("${chevron}");
+        background-repeat: no-repeat;
+        background-position: right 5px center;
+        color: var(--vscode-descriptionForeground, rgba(228, 228, 228, .7));
+        font-family: inherit; font-size: 11.5px; cursor: pointer; outline: none;
+        white-space: nowrap;
+        transition: background-color .12s ease;
+      }
+      #${config.panelId} .cmf-portbtn:hover { background-color: var(--vscode-list-hoverBackground, rgba(228, 228, 228, .07)); }
+      #${config.panelId} .cmf-portbtn.open { background-color: var(--vscode-list-hoverBackground, rgba(228, 228, 228, .1)); }
+      #${config.panelId} .cmf-portmenu {
+        position: absolute; top: calc(100% + 4px); right: 0; z-index: 1000;
+        min-width: 100%; max-width: 300px; max-height: 240px; overflow-y: auto;
+        padding: 4px;
+        border: 1px solid var(--vscode-input-border, rgba(228, 228, 228, .18));
+        border-radius: 8px;
+        background: var(--vscode-menu-background, var(--vscode-editorWidget-background, #252526));
+        box-shadow: 0 6px 20px rgba(0, 0, 0, .32);
+      }
+      #${config.panelId} .cmf-opt {
+        display: block; white-space: nowrap;
+        padding: 4px 8px; border-radius: 5px;
+        font-size: 11.5px; line-height: 1.5;
+        color: var(--vscode-foreground, rgba(228, 228, 228, .9));
+        cursor: pointer;
+      }
+      #${config.panelId} .cmf-opt:hover { background: var(--vscode-list-hoverBackground, rgba(228, 228, 228, .1)); }
+      #${config.panelId} .cmf-opt.sel { color: var(--vscode-foreground, #fff); background: var(--vscode-list-activeSelectionBackground, rgba(129, 161, 193, .22)); }
+      #${config.panelId} .cmf-opt-custom { margin-top: 3px; padding-top: 6px; border-top: 1px solid var(--vscode-input-border, rgba(228, 228, 228, .12)); color: var(--vscode-descriptionForeground, rgba(228, 228, 228, .7)); }
+      #${config.panelId} .cmf-menuhint { display: flex; align-items: center; gap: 7px; padding: 6px 8px; font-size: 11.5px; color: var(--vscode-descriptionForeground, rgba(228, 228, 228, .65)); }
+
       #${config.panelId} .cmf-scan {
         flex: 0 0 auto;
         width: 22px; height: 22px;
@@ -427,10 +478,35 @@
   }
 
   function buildPanel() {
-    const portSelect = h("select", { class: "cmf-port", "aria-label": "选择 MCP 前端端口" });
+    // 隐藏的原生 <select> 仅作「数据载体」：继续承载当前选中 value 与 options 列表，
+    // 让 fillPortOptions / connectSelectedPort 等既有读写逻辑（els.portSelect.value）保持不变；
+    // 用户实际看到/交互的是下面的自定义触发按钮 + 浮层菜单（portBtn / portMenu）。
+    const portSelect = h("select", { class: "cmf-port", "aria-hidden": "true", tabindex: "-1" });
+    portSelect.style.display = "none";
     els.portSelect = portSelect;
     fillPortOptions(defaultPorts(), String(config.scanStart));
 
+    const portBtnText = h("span", { class: "cmf-portbtn-text" }, "Port " + config.scanStart);
+    const portBtn = h(
+      "button",
+      {
+        class: "cmf-portbtn",
+        type: "button",
+        "aria-haspopup": "listbox",
+        "aria-expanded": "false",
+        "aria-label": "选择 MCP 前端端口",
+        title: "选择 MCP 前端端口",
+      },
+      portBtnText
+    );
+    const portMenu = h("div", { class: "cmf-portmenu", role: "listbox" });
+    portMenu.style.display = "none";
+    const portWrap = h("div", { class: "cmf-portwrap" }, portBtn, portMenu, portSelect);
+    els.portBtn = portBtn;
+    els.portBtnText = portBtnText;
+    els.portMenu = portMenu;
+    els.portWrap = portWrap;
+
     const customInput = h("input", {
       class: "cmf-custom",
       type: "text",
@@ -470,7 +546,7 @@
       status,
       h("span", { class: "cmf-spacer" }),
       scanBtn,
-      portSelect,
+      portWrap,
       customInput,
       projectName,
       gear
@@ -531,6 +607,7 @@
     // 状态文本已从面板移除；游离占位元素让现有状态写入成为无害空操作。
     els.hint = document.createElement("span");
 
+    updatePortButton();
     wireEvents();
   }
 
@@ -593,6 +670,65 @@
     );
   }
 
+  // 路径规范化：统一分隔符并去掉尾部斜杠，便于和 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;
+    }
+  }
+
+  // 在 server 进程里读「窗口真实工作区」的命令：WORKSPACE_FOLDER_PATHS / CURSOR_WORKSPACE_LABEL 由 Cursor 注入，
+  // 不受 AI 传入的 project_directory 影响。用单个 print 表达式（不含 ';'）+ chr(10) 分隔（不含 '|'），
+  // 规避服务端 _safe_parse_command 的危险子串过滤。
+  function buildWorkspaceProbeCmd() {
+    const code =
+      "print(__import__('os').environ.get('WORKSPACE_FOLDER_PATHS','')+chr(10)+__import__('os').environ.get('CURSOR_WORKSPACE_LABEL',''))";
+    return config.pyCmd + ' -c "' + code + '"';
+  }
+
+  // WORKSPACE_FOLDER_PATHS 可能含多个路径（多根工作区）；按常见分隔符拆开后看是否包含当前工作区。
+  function matchFolders(folders, ws) {
+    if (!folders || !ws) return false;
+    return String(folders)
+      .split(/[:;,\n]/)
+      .map((s) => normalizePath(s))
+      .filter(Boolean)
+      .includes(ws);
+  }
+
+  // 端口是否属于「当前窗口」：优先用 WORKSPACE_FOLDER_PATHS（完整路径），其次用 CURSOR_WORKSPACE_LABEL（项目名）。
+  function isPortMine(port, ws) {
+    if (!ws) return false;
+    if (matchFolders(state.portWorkspaces[port], ws)) return true;
+    const label = state.portLabels[port];
+    return !!(label && label === basename(ws));
+  }
+
+  // 从一轮扫描结果里挑出「属于当前窗口」的端口：主用 WORKSPACE_FOLDER_PATHS，次用 CURSOR_WORKSPACE_LABEL。
+  function pickWorkspacePort(results) {
+    const ws = getWorkspacePath();
+    if (!ws) return null;
+    const wsLabel = basename(ws);
+    let hit = results.find((r) => r.alive && matchFolders(r.workspaceFolders, ws));
+    if (hit) return String(hit.port);
+    hit = results.find((r) => r.alive && r.workspaceLabel && r.workspaceLabel === wsLabel);
+    return hit ? String(hit.port) : null;
+  }
+
   // 选项文本：Port {port}[ · 状态][ · 项目名]（状态在前、项目在后）。
   // 下拉展开时所有项都带「状态 · 项目名」，便于按项目/状态区分端口；
   // 收起时框里显示的是「选中项」，为避免与右侧项目名重复，选中项收起时不带项目名。
@@ -616,6 +752,7 @@
       const status = isSelected ? state.selectedStatus : state.portStatuses[option.value] || null;
       option.textContent = portText(option.value, status, state.expanded);
     }
+    updatePortButton();
   }
 
   function setOptionLabel(port, status) {
@@ -623,6 +760,87 @@
     refreshOptionLabels();
   }
 
+  // ———————————————————— 自定义端口下拉 ————————————————————
+  // 触发按钮文字 = 当前选中端口（带状态、不带项目名；项目名在右侧 projectName 单独显示）。
+  function updatePortButton() {
+    if (!els.portBtnText) return;
+    const cur = els.portSelect.value;
+    els.portBtnText.textContent =
+      cur === config.customValue ? "自定义端口…" : portText(cur, state.selectedStatus, false);
+  }
+
+  // 渲染浮层菜单：扫描中显示「扫描中…」，否则按最新 foundPorts 列出可用端口（带状态·项目名）+「自定义端口…」。
+  // 关键：菜单仅在「打开瞬间」与「扫描完成时」各渲染一次，渲染后保持稳定 —— 自定义 div 不会像原生 <select>
+  // 那样在用户点击瞬间因重建 DOM 而打断点选，因此点选即时生效、无打断、无闪。
+  function renderPortMenu(opts) {
+    if (!els.portMenu) return;
+    const loading = !!(opts && opts.loading) || state.scanning;
+    clear(els.portMenu);
+    if (loading) {
+      els.portMenu.appendChild(
+        h(
+          "div",
+          { class: "cmf-menuhint" },
+          h("span", { class: "cmf-spinner", "aria-hidden": "true" }),
+          h("span", null, "扫描中…")
+        )
+      );
+      return;
+    }
+    const cur = els.portSelect.value;
+    const ports = state.foundPorts.length ? state.foundPorts.map(String) : defaultPorts();
+    for (const p of ports) {
+      const status = p === cur ? state.selectedStatus : state.portStatuses[p] || null;
+      const item = h("div", { class: "cmf-opt" + (p === cur ? " sel" : ""), role: "option" }, portText(p, status, true));
+      item.addEventListener("click", () => selectPort(p));
+      els.portMenu.appendChild(item);
+    }
+    const customItem = h("div", { class: "cmf-opt cmf-opt-custom", role: "option" }, "自定义端口…");
+    customItem.addEventListener("click", selectCustom);
+    els.portMenu.appendChild(customItem);
+  }
+
+  // 打开菜单：先显示「扫描中…」，按需扫一次，扫完用最新结果填充并展示（满足「先扫描→填充→再展示」）。
+  async function openPortMenu() {
+    if (state.expanded) return;
+    state.expanded = true;
+    els.portMenu.style.display = "";
+    els.portBtn.classList.add("open");
+    els.portBtn.setAttribute("aria-expanded", "true");
+    renderPortMenu({ loading: true });
+    await scanPorts({ refreshOnly: true });
+    if (state.expanded) renderPortMenu();
+  }
+
+  function closePortMenu() {
+    state.expanded = false;
+    if (els.portMenu) els.portMenu.style.display = "none";
+    if (els.portBtn) {
+      els.portBtn.classList.remove("open");
+      els.portBtn.setAttribute("aria-expanded", "false");
+    }
+  }
+
+  function togglePortMenu() {
+    if (state.expanded) closePortMenu();
+    else openPortMenu();
+  }
+
+  // 点选某端口：写回隐藏 select 的 value，关菜单，刷新按钮，再走既有连接逻辑（onPortChange）。
+  function selectPort(port) {
+    els.portSelect.value = String(port);
+    closePortMenu();
+    updatePortButton();
+    onPortChange();
+  }
+
+  function selectCustom() {
+    els.portSelect.value = config.customValue;
+    closePortMenu();
+    updatePortButton();
+    onPortChange();
+  }
+
   function deriveStatusLabel(info) {
     if (!info) return "";
     if (info.feedback_completed === true || info.status === "feedback_submitted" || info.status === "completed") {
@@ -763,8 +981,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 +1054,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";
@@ -1213,6 +1431,10 @@
       let opened = false;
       let project = "";
       let statusLabel = "";
+      let workspaceFolders = "";
+      let workspaceLabel = "";
+      let cmdBuf = null;
+      let needCmd = false;
       let ws = null;
       const finish = (alive) => {
         if (done) return;
@@ -1226,13 +1448,24 @@
             /* noop */
           }
         }
-        resolve({ alive, project, statusLabel });
+        resolve({ alive, project, statusLabel, workspaceFolders, workspaceLabel });
       };
       const timer = window.setTimeout(() => finish(opened), timeoutMs);
       try {
         ws = new WebSocket("ws://127.0.0.1:" + port + "/ws?lang=" + config.lang);
         ws.onopen = () => {
           opened = true;
+          // 连上后用 run_command 读「窗口真实工作区」（不受 AI 传入的 project_directory 影响）。
+          // pyCmd 占位符未被注入替换时跳过，退回靠 session_info 仅识别项目名。
+          if (config.pyCmd.indexOf("__MCP_") !== 0) {
+            cmdBuf = "";
+            needCmd = true;
+            try {
+              ws.send(JSON.stringify({ type: "run_command", command: buildWorkspaceProbeCmd() }));
+            } catch (error) {
+              needCmd = false;
+            }
+          }
         };
         ws.onmessage = (event) => {
           try {
@@ -1241,6 +1474,21 @@
             if (info && info.project_directory) {
               project = info.project_directory;
               statusLabel = deriveStatusLabel(info);
+              // 没发探测命令时（占位符未替换），拿到会话即可结束。
+              if (!needCmd) finish(true);
+            }
+            if (data.type === "command_output") {
+              if (cmdBuf !== null) cmdBuf += data.output || "";
+            }
+            if (data.type === "command_complete" || data.type === "command_error") {
+              const raw = (cmdBuf || "").replace(/\r/g, "");
+              const nl = raw.indexOf("\n");
+              if (nl >= 0) {
+                workspaceFolders = raw.slice(0, nl).trim();
+                workspaceLabel = raw.slice(nl + 1).trim();
+              } else {
+                workspaceFolders = raw.trim();
+              }
               finish(true);
             }
           } catch (error) {
@@ -1255,7 +1503,8 @@
     });
   }
 
-  async function scanPorts() {
+  async function scanPorts(opts) {
+    const refreshOnly = !!(opts && opts.refreshOnly);
     if (state.scanning) return;
     state.scanning = true;
     if (els.scanBtn) {
@@ -1268,15 +1517,31 @@
     els.hint.textContent = "正在扫描端口 " + from + "–" + to + "…";
 
     const ports = defaultPorts();
+    // 跳过探测「当前已连接的健康端口」：probe 会另建连接抢占服务端的「最后连接」，从而把面板自己挤下线。
+    // 对已连端口直接用已知信息标记为活跃，保证下拉扫描/重扫不会断开当前会话。
+    const curPort =
+      state.socket && state.socket.readyState === WebSocket.OPEN ? String(state.socketPort) : null;
     const results = await Promise.all(
-      ports.map((port) =>
-        probePort(port, config.probeTimeoutMs).then((res) => ({
+      ports.map((port) => {
+        if (curPort && String(port) === curPort) {
+          return Promise.resolve({
+            port,
+            alive: true,
+            project: state.currentSession ? state.currentSession.project_directory : "",
+            statusLabel: state.portStatuses[port] || state.selectedStatus || "",
+            workspaceFolders: state.portWorkspaces[port] || "",
+            workspaceLabel: state.portLabels[port] || "",
+          });
+        }
+        return probePort(port, config.probeTimeoutMs).then((res) => ({
           port,
           alive: res.alive,
           project: res.project,
           statusLabel: res.statusLabel,
-        }))
-      )
+          workspaceFolders: res.workspaceFolders,
+          workspaceLabel: res.workspaceLabel,
+        }));
+      })
     );
     const found = [];
     for (const item of results) {
@@ -1284,19 +1549,21 @@
         found.push(item.port);
         if (item.project) state.portProjects[item.port] = basename(item.project);
         else delete state.portProjects[item.port];
+        if (item.workspaceFolders) state.portWorkspaces[item.port] = item.workspaceFolders;
+        else delete state.portWorkspaces[item.port];
+        if (item.workspaceLabel) state.portLabels[item.port] = item.workspaceLabel;
+        else delete state.portLabels[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.portWorkspaces[item.port];
+        delete state.portLabels[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;
-
     if (els.scanBtn) {
       els.scanBtn.classList.remove("scanning");
       els.scanBtn.disabled = false;
@@ -1307,6 +1574,20 @@
       ? "扫描完成：发现活跃端口 " + found.join("、") + "。"
       : "扫描完成：" + from + "–" + to + " 未发现活跃 MCP 端口。";
 
+    if (refreshOnly) {
+      // 自定义下拉：扫描结果已写入 state；菜单仍展开则用最新结果渲染一次浮层（渲染后保持稳定，
+      // 不会在用户点击瞬间重建 DOM，故点选即时生效、无打断、无闪）。
+      if (state.expanded) renderPortMenu();
+      return;
+    }
+
+    const 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.portSelect.value !== config.customValue) connectSelectedPort(false);
   }
@@ -1352,6 +1633,24 @@
   function connectSelectedPort(auto) {
     const port = els.portSelect.value;
     if (port === config.customValue) return;
+
+    // 守卫：能确定当前窗口、且该端口已知属于别的窗口时不连接，
+    // 避免误连到其它窗口的实例或常驻 feedback 实例（等本窗口端口被识别后由 refreshTick 重扫接管）。
+    const ws = getWorkspacePath();
+    const known = !!(state.portWorkspaces[port] || state.portLabels[port]);
+    if (ws && known && !isPortMine(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 window");
+      setVisualState("offline", port + " 属于其它窗口，等待本窗口的 MCP 会话…");
+      return;
+    }
+
     const seq = ++state.connectSeq;
 
     if (state.socket) {
@@ -1406,6 +1705,10 @@
 
       nextSocket.onerror = () => {
         if (seq !== state.connectSeq) return;
+        // 连接失败：端口很可能已关闭或换了端口（实例重启），清除其归属缓存，
+        // 让 refreshTick 退避重扫去发现新的本窗口端口，而不是一直重连这个死端口。
+        delete state.portWorkspaces[port];
+        delete state.portLabels[port];
         setOptionLabel(port, "offline");
         setVisualState("offline", port + " 连接失败，可能端口未启动或没有 MCP WebUI。");
       };
@@ -1436,6 +1739,23 @@
     if (els.portSelect.value === config.customValue) return;
     if (els.customInput === document.activeElement) return;
     if (els.prompt === document.activeElement && els.prompt.value.trim()) return;
+
+    // 不做后台扫描（扫描仅发生在启动时与下拉展开期间）。这里只保持连接：
+    // 已连且健康 → 发 heartbeat 维持「最后连接」；否则重连选中端口（守卫会拦掉别窗口端口；
+    // 端口已关时 onerror 会清归属并置 offline，等待用户展开下拉重新选择本窗口端口）。
+    if (
+      state.socket &&
+      state.socket.readyState === WebSocket.OPEN &&
+      state.socketPort === els.portSelect.value
+    ) {
+      try {
+        state.socket.send(JSON.stringify({ type: "heartbeat", timestamp: Date.now() }));
+      } catch (error) {
+        /* 发送失败则下个周期走重连 */
+      }
+      return;
+    }
+
     connectSelectedPort(true);
   }
 
@@ -1498,16 +1818,22 @@
   }
 
   function wireEvents() {
-    els.portSelect.addEventListener("change", onPortChange);
-    // 展开下拉前让所有项带上「状态 · 项目名」；收起后选中项去掉项目名（右侧已显示）。
-    els.portSelect.addEventListener("mousedown", () => {
-      state.expanded = true;
-      refreshOptionLabels();
-    });
-    els.portSelect.addEventListener("blur", () => {
-      state.expanded = false;
-      refreshOptionLabels();
+    // 自定义端口下拉：点按钮开/关；打开即「扫描中→填充→展示」；点选即时生效（见 selectPort / selectCustom）。
+    els.portBtn.addEventListener("click", (event) => {
+      event.stopPropagation();
+      togglePortMenu();
     });
+    // 点击按钮与浮层之外的区域、或按 Esc 关闭菜单。
+    state.onDocPointerDown = (event) => {
+      if (!state.expanded) return;
+      if (els.portWrap && els.portWrap.contains(event.target)) return;
+      closePortMenu();
+    };
+    document.addEventListener("mousedown", state.onDocPointerDown, true);
+    state.onDocKeydown = (event) => {
+      if (state.expanded && event.key === "Escape") closePortMenu();
+    };
+    document.addEventListener("keydown", state.onDocKeydown, true);
     els.scanBtn.addEventListener("click", () => {
       scanPorts();
     });
@@ -1579,6 +1905,8 @@
 
   function uninstall() {
     cancelAutoSubmit();
+    if (state.onDocPointerDown) document.removeEventListener("mousedown", state.onDocPointerDown, true);
+    if (state.onDocKeydown) document.removeEventListener("keydown", state.onDocKeydown, true);
     for (const timer of state.timers) {
       window.clearInterval(timer);
     }

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);
 
   // 输入法回车修复：无占位符，直接拷贝。