opencode-idea 0.0.15 → 0.0.16

package/README.md

@@ -64,6 +64,9 @@ setup(启动, 每项目一次):
 
 在会话里输入 `/open-in-idea`:
 
+> **非 macOS**:第 1、3 步的自动打开被跳过(没有对应的启动命令),请**先手动打开 IDE 和当前项目**,再执行本命令 ——
+> 端口在监听就会正常接入,并同样等到 `idea_*` 工具就绪才返回。
+
 1. **让运行中的 IDEA 实例打开/激活当前项目**:`open -a "IntelliJ IDEA" <项目目录>` —— **复用已运行的实例**(不会重复开新实例),
    项目已打开时只把它切到前台。**无论 MCP 是否已就绪都会执行这一步**:端点能应答只说明 IDEA 在运行(可能开的是**别的**项目),
    不代表当前项目已打开;
@@ -325,6 +328,10 @@ export { default } from "/Users/yutao/Projects/opencode-idea/src/index.js";
   (`get_project_modules`,带 `IJ_MCP_SERVER_PROJECT_PATH`):返回模块 = 已打开 → 跳过 `open -a`;报
   `Unable to determine the target project` = 未打开 → `open -a` 打开。MCP 关闭时会用一次短探测并立即给出设置提示。
   项目刚打开时的短暂"项目未就绪"由工具失败分类兜底(「IDE 在、但项目没打开」→ 重新打开并让模型重试)。
+- **项目路径按 IDE 的写法归一化**:IDE 收的是系统无关形式(正斜杠),其自带配置示例在 Windows 上也是
+  `"E:/gitea/secondev-demo"`。OpenCode 的 `location` 在 Windows 上是原生反斜杠,所以 `src/mcp/idea.js` 的
+  `ideProjectPath()` 把它转成正斜杠,**注册与探测走同一个函数**,两者必须一致,否则会用一种写法注册、又用另一种
+  写法去问,永远匹配不上。macOS 上是原样透传。
 - IDE **2026.2+** 提供 Streamable HTTP 端点 `/stream`,这是插件**唯一**使用的传输(`type: "remote"`)。注册本身不启动任何子进程,
   所以没有"桥进程被 IDE 拖死后变成僵尸"这一类问题。`/open-in-idea` 仍要求 IDE MCP 已在监听(冷启动约数十秒),因此会先等就绪再注册。
 - **空闲驱逐(已实测)**:OpenCode 把一个 Location 的服务缓存在 `LayerMap` 里,`idleTimeToLive` = **60 分钟**;空闲到期即整体驱逐,
@@ -339,7 +346,9 @@ export { default } from "/Users/yutao/Projects/opencode-idea/src/index.js";
 - `/close-in-idea` 会**注销 IDE MCP** 并删标记 + 清空注入的环境。
 - 插件**完全不再检查 `.idea` 目录**:是否是 IDEA 项目只由项目标记(`/open-in-idea` 设置、`/close-in-idea` 清除)决定。
   (`/open-in-idea` 会让 IDEA 打开并导入该项目,`.idea` 由 IDEA 自己生成,插件无需也不应据此判断。)
-- 打开 IDE 仅实现 macOS (`open -a`);首次打开若弹 Trust 对话框,需确认后重试。
+- **自动拉起 IDE 仅实现 macOS** (`open -a`)。其他平台(包括 Windows)没有对应的启动命令,**请手动打开 IDE 和项目**,再执行
+  `/open-in-idea` —— 端口在监听就会正常接入,其余能力(注册、探测、自愈、工具暴露)与 macOS 完全一致。
+  IDE 里打开 MCP 服务(2026.2+)并启用 Brave Mode;首次打开若弹 Trust 对话框,需确认后重试。
 - IDE MCP 没有「打开项目」工具,因此打开动作走 OS/CLI,而非 MCP。
 - 插件热重载会断开 IDE 连接,需重跑 `/open-in-idea`。
 - 插件不修改任何工具的定义、描述或可用性;IDE MCP 工具以 `idea_*` 直接暴露给模型 (`codemode: false`),不用 `execute` 包裹。

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "opencode-idea",
-  "version": "0.0.15",
+  "version": "0.0.16",
   "description": "OpenCode plugin that connects to JetBrains IDE MCP servers and prefers IDE tools when the current project is open in the IDE",
   "main": "src/index.js",
   "type": "module",

package/src/ide-launcher.js

@@ -16,6 +16,23 @@ import { spawn } from 'node:child_process';
 /** Default macOS app name for IntelliJ IDEA. */
 export const DEFAULT_IDE_APP = 'IntelliJ IDEA';
 
+/**
+ * Can this platform launch the IDE at all?
+ *
+ * Launching goes through macOS `open -a`, which is the only launcher this
+ * plugin implements. On Windows there is no `open` command, so a spawn there
+ * fails with ENOENT — silently, as a rejected promise that resolves `false`.
+ * Rather than pretend, other platforms resolve no app at all and the caller
+ * asks the user to open the IDE by hand.
+ *
+ * A function, not a constant: the answer is read when a command runs, so tests
+ * can simulate another platform by replacing it. A constant would be bound at
+ * import time and never re-read.
+ */
+export function autoLaunchSupported() {
+  return process.platform === 'darwin';
+}
+
 /** Aliases accepted by the `openInIde` option. */
 export const IDE_APPS = {
   idea: 'IntelliJ IDEA',
@@ -26,10 +43,16 @@ export const IDE_APPS = {
 /**
  * Resolve the `openInIde` option to a macOS app name, or `undefined` to disable.
  *
+ * `undefined` covers two distinct reasons, and the caller tells them apart via
+ * `autoLaunchSupported()`: the user turned launching off, or this platform has
+ * no launcher. They deserve different user-facing wording.
+ *
  * @param {boolean | string | undefined} value
+ * @param {{ platform?: string }} [options]
  * @returns {string | undefined}
  */
-export function resolveIdeApp(value) {
+export function resolveIdeApp(value, { platform = process.platform } = {}) {
+  if (platform !== 'darwin') return undefined;
   if (value === false) return undefined;
   if (typeof value !== 'string') return DEFAULT_IDE_APP;
   return IDE_APPS[value.toLowerCase()] ?? value;

package/src/mcp/idea.js

@@ -18,6 +18,25 @@
 
 export const PROJECT_HEADER = 'IJ_MCP_SERVER_PROJECT_PATH';
 
+/**
+ * The project path in the form the IDE matches against.
+ *
+ * The IDE takes the project selector in system-independent form (forward
+ * slashes) — its own MCP client configuration ships
+ * `IJ_MCP_SERVER_PROJECT_PATH: "E:/gitea/secondev-demo"`, even on Windows.
+ * OpenCode's `location` is the platform-native path, so on Windows it carries
+ * backslashes (`E:\gitea\secondev-demo`) that the IDE does not necessarily
+ * match. Normalizing here keeps one spelling on the wire for BOTH senders
+ * below; they must agree, or the plugin asks about the project with one path
+ * and registers it with another and never matches. On macOS this is a no-op.
+ *
+ * @param {string} projectPath
+ * @returns {string}
+ */
+export function ideProjectPath(projectPath) {
+  return projectPath.replace(/\\/g, '/');
+}
+
 /** OpenCode MCP server name registered for the IDE. */
 export const IDEA_SERVER_NAME = 'idea';
 
@@ -51,7 +70,7 @@ export function serverConfig(port, projectPath, options = {}) {
   const config = {
     type: 'remote',
     url: `http://127.0.0.1:${port}${MCP_STREAM_PATH}`,
-    headers: { [PROJECT_HEADER]: projectPath },
+    headers: { [PROJECT_HEADER]: ideProjectPath(projectPath) },
     codemode: false,
   };
   return withExecutionTimeout(config, options);
@@ -103,7 +122,7 @@ export async function probePort(port, options = {}) {
         params: {
           protocolVersion: PROTOCOL_VERSION,
           capabilities: {},
-          clientInfo: { name: 'opencode-idea', version: '0.0.15' },
+          clientInfo: { name: 'opencode-idea', version: '0.0.16' },
         },
       }),
       signal: controller.signal,
@@ -160,7 +179,7 @@ export async function callTool(port, projectPath, name, args = {}, options = {})
       headers: {
         'Content-Type': 'application/json',
         Accept: 'application/json, text/event-stream',
-        [PROJECT_HEADER]: projectPath,
+        [PROJECT_HEADER]: ideProjectPath(projectPath),
         ...(sessionId ? { 'Mcp-Session-Id': sessionId } : {}),
       },
       body: JSON.stringify(payload),
@@ -174,7 +193,7 @@ export async function callTool(port, projectPath, name, args = {}, options = {})
       params: {
         protocolVersion: PROTOCOL_VERSION,
         capabilities: {},
-        clientInfo: { name: 'opencode-idea', version: '0.0.15' },
+        clientInfo: { name: 'opencode-idea', version: '0.0.16' },
       },
     });
     // The IDE's Streamable-HTTP endpoint binds follow-up requests to the session

package/src/plugin.js

@@ -53,6 +53,7 @@ import {
 } from './mcp/idea.js';
 import { currentProjectPath } from './project.js';
 import {
+  autoLaunchSupported,
   createLaunchGuard,
   openInIde,
   resolveIdeApp,
@@ -296,7 +297,17 @@ function rewriteToolError(event, message) {
 
 /**
  * @typedef {{
- *   status: 'connected' | 'tools-loading' | 'mcp-unavailable' | 'launch-failed' | 'disabled' | 'closed',
+ *   status:
+ *     | 'connected'
+ *     | 'tools-loading'
+ *     | 'mcp-unavailable'
+ *     | 'launch-failed'
+ *     | 'disabled'
+ *     | 'manual-launch'
+ *     | 'closed',
+ *   // `manual-launch` = this platform has no launcher at all (the user must
+ *   // open the IDE by hand); `disabled` = the user turned launching off. Both
+ *   // mean "no app to open", so only `autoLaunchSupported()` tells them apart.
  *   port?: number,
  *   opened?: boolean,
  *   unavailableNoticeSent?: boolean
@@ -332,6 +343,8 @@ export function ideFeedback(result) {
       return '无法拉起 IntelliJ IDEA(未找到应用或启动失败)。请确认已安装 IDEA,或手动打开后重试 /open-in-idea。';
     case 'disabled':
       return '插件已通过 openInIde: false 关闭 IDE 启动。请手动打开 IntelliJ IDEA,在 Settings → MCP Server 开启 MCP 服务并启用 Brave Mode,然后重试 /open-in-idea。';
+    case 'manual-launch':
+      return '当前系统不支持自动打开 IDE(仅 macOS 实现了启动)。请手动打开 IntelliJ IDEA,在 Settings → MCP Server 开启 MCP 服务并启用 Brave Mode,然后再次执行 /open-in-idea。';
     case 'closed':
       return '已关闭当前项目的 IDEA 接入:已注销 IDE MCP 并清除项目标记。如需重新接入,请再次执行 /open-in-idea。';
     default:
@@ -692,7 +705,11 @@ export default {
           }
           return { status: 'connected', port: serving, unavailableNoticeSent: false };
         }
-        if (!ideApp) return { status: 'disabled' };
+        // No app to open. Either the user turned launching off, or this platform
+        // has no launcher — say which, so the notice is actionable.
+        if (!ideApp) {
+          return { status: autoLaunchSupported() ? 'disabled' : 'manual-launch' };
+        }
         if (guard.exhausted()) {
           await reportUnavailable(false);
           return { status: 'mcp-unavailable', opened: false, unavailableNoticeSent: launchNoticeSent };
@@ -983,9 +1000,14 @@ export default {
           if (!(await readMark())) return;
           const kind = classifyIdeaFailure(event.error);
           if (kind === 'none') return;
-          if (kind === 'project' && ideApp) {
-            // The IDE is up; the project simply is not open in it. Ask the IDE
-            // to open the project again, and tell the model to retry.
+          if (kind === 'project') {
+            // The IDE is up and answering; only the PROJECT is missing. That is
+            // never a connection problem, so this must never fall through to
+            // the reconnect below — on a platform with no launcher there is
+            // nothing to call, and falling through would report "reconnected"
+            // and send the model round after round after a call that can only
+            // fail. Leave the IDE's own message, which names the real cause.
+            if (!ideApp) return;
             await openInIde(projectPath, { app: ideApp });
             rewriteToolError(event, '该项目已在 IDEA 中重新打开,请重试刚才的操作。');
             return;