opencode-idea 0.0.24 → 0.0.26

package/README.md

@@ -274,7 +274,7 @@ IDE 内置的 MCP Server 只能 **启动已有**的 run configuration (`execute_
 那个文件,字段名拼错则静默用默认值)。所以「照着模板手写」这条路已经封了,模板 (`assets/types/*.md`)降级为 **字段参考**。
 
 配置名有自己的文法:**`[os@]base[@env]`** —— os 段 (`win` = Windows,缺省 = macOS / Linux)、base 段 (配置本体)、env 段 (环境名,
-缺省 = 所有环境通用这一套)。`win@base` 与 `base@env` 都是同一个 base 的 **变体**,档案里只登记 base。解析 **交给工具**:
+缺省 = 默认环境 —— 起一批时逐条解析:有 `@<env>` 用它,没有就用默认)。`win@base` 与 `base@env` 都是同一个 base 的 **变体**,档案里只登记 base。解析 **交给工具**:
 `ide_inspect_run_configuration` 的 `naming` 字段把名字拆成 platform / base / env,规则是从两头往中间收 (末段是环境;首段只有
 恰好是 `win` 才算平台,不是就并进 base),所以 `a@b@c` 会解析成 base=`a@b`、env=`c`,不会丢段。
 

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "opencode-idea",
-  "version": "0.0.24",
+  "version": "0.0.26",
   "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/skills/idea-run-config-manager/SKILL.md

@@ -14,9 +14,8 @@ IDE (或那个 IDE 没装 `idea-mcp-enhance`)—— 让用户执行 `/open-in-id
 
 ## 流程
 
-1. **读**:项目根 `AGENTS.md` —— 有没有 `<!-- idea-run-config-manager:begin -->` … `<!-- idea-run-config-manager:end -->`
-   标记块 (有则更新,没有就在文件末尾追加);同时读同文件里 `idea-standalone` 的标记块。 **服务化 / 常驻应用的配置一律不进
-   本块**(不管那边有没有块);有那个块时,把它登记过的名字一并排除。
+1. **读**:项目根 `AGENTS.md` 里 `<!-- idea-run-config-manager:begin -->` … `<!-- idea-run-config-manager:end -->` 标记块
+   (有则更新,没有就在文件末尾追加),以及同文件里 `idea-standalone` 的块;过滤规则在模板的生成提示里。
 2. **枚举**:逐个项目用 **它自己那个前缀**的 `<前缀>_get_run_configurations` 直接调用,不传参数 —— 本项目的工具前缀跟着接入时的名字走
    (root 是 `ide`,子项目是它的目录名)。
 3. **建 / 删 / 改**(**直接动手**):
@@ -32,8 +31,8 @@ IDE (或那个 IDE 没装 `idea-mcp-enhance`)—— 让用户执行 `/open-in-id
         - **看一眼**:`<前缀>_inspect_run_configuration` —— 定义、命名解析、活实例、历史日志路径全在里面;
           构建 patch 之前先用它拿到当前值 (尤其 `configurationXml`)。
         - **模板是字段参考**:`assets/types/*.md` 用来查类型 id、看这个类型有哪些字段、`configurationXml` 该长什么样。
-        - **建带平台 / 环境变体的配置** → 名字按第 5 条的文法拼 (`win@base` / `base@env`)。**这个环境具体怎么接上,
-          问用户或照项目里现成的同类配置来**。
+        - **建带平台 / 环境变体的配置** → 名字文法见 IDE 引导的「运行配置」(`win@base` / `base@env`);环境具体怎么接上问
+          用户,或照项目里现成的同类配置来。
         - **没有模板**(矩阵之外)→ **走 `cloneFrom`**:复制一个同类型的现成配置再 patch 它的字段。
           字段名不确定时,这是 **唯一可靠**的路子 (照猜字段名 = 静默用默认值)。连一个同类型的现成配置都没有,
           才 **交给用户**:讲清要配什么 (配置名、干什么、什么时候跑),请他在 IDE 里配好,你只负责把档案补上。
@@ -41,9 +40,8 @@ IDE (或那个 IDE 没装 `idea-mcp-enhance`)—— 让用户执行 `/open-in-id
        字段名拼错了)、`storagePath` 文件落在哪。再用 `<前缀>_get_run_configurations` 二次确认它已被 IDE 认到 —— **看不到就是没被
        IDE 认**。
     4. **不要手搓启动命令**代替配置,也 **不要写模板里没有的字段**(多余字段被忽略、名字写错静默用默认值,都不会报错)。
-4. **同步文档**:按 [assets/AGENTS.template.md](assets/AGENTS.template.md) 逐段填,写在标记块内 ——
-   **条目怎么写、五项分别写什么、枚举与过滤的要求,都在那份模板的生成提示里**,动手前先读它;生成提示是给生成过程的说明,
-   **产物里整块删掉**,块外一字不动 (尤其 **不要触碰**其他 skill 的标记块)。
+4. **同步文档**:按 [assets/AGENTS.template.md](assets/AGENTS.template.md) 的生成提示逐段填,写在标记块内 —— 条目怎么写、
+   五项分别写什么、枚举与过滤的要求,都在那份模板的生成提示里,动手前先读它。 **块外一字不动**(尤其不要触碰其他 skill 的标记块)。
 5. **核对**:块里每个名字项目里都还在,项目里每个配置块里都有。
 
 ## 支持矩阵 (一个类型一份模板)
@@ -67,21 +65,11 @@ IDE (或那个 IDE 没装 `idea-mcp-enhance`)—— 让用户执行 `/open-in-id
 ## 硬性契约 (所有类型都一样)
 
 1. **落地位置不用管**:配置落在哪由工具决定 (项目级配置随项目共享);子项目的配置用 **子项目前缀**的工具建与查。
-2. **`configurationXml` 的信封照类型模板抄**(`assets/types/*.md` 每份都是完整的):外层
-   `<component name="ProjectRunConfigurationManager">`,里面一个
-   `<configuration default="false" name="<配置名>" type="<类型ID>">` + 该类型自己的字段 + `<method v="2" />`。
-   `factoryName` 可写可不写 —— IDE 认的是 `type`。
-
-3. **`type` 写错 = 整个文件被静默忽略,日志里也不报任何东西。** 有模板就照模板的 `type` 抄,没有模板就 `cloneFrom`
-   复制一个同类型的现成配置 —— 别照猜;工具的 `typeKnown` / `typeDisplayName` 会告诉你这台 IDE 认不认这个类型 (缺插件时是
-   `Unknown`)。
-4. **路径宏**:`$PROJECT_DIR$` = 该项目根。 **项目内的路径一律用它**(`$PROJECT_DIR$/子目录/...`),不要写本机绝对路径 ——
+2. **`type` 与字段照类型模板抄**(`assets/types/*.md`,每份都带完整的 `configurationXml`) —— 没有模板就 `cloneFrom` 复制
+   同类型的现成配置,别照猜:`type` 写错 = 整个文件被静默忽略、日志里也不报。工具的 `typeKnown` / `typeDisplayName` 会告诉你
+   这台 IDE 认不认这个类型 (缺插件时是 `Unknown`)。
+3. **路径宏**:`$PROJECT_DIR$` = 该项目根。 **项目内的路径一律用它**(`$PROJECT_DIR$/子目录/...`),不要写本机绝对路径 ——
    写死了别人 clone 下来就指到不存在的目录。
-5. **命名文法:`[os@]base[@env]`,`@` 分割、最多三段** —— `os` 段(`win` = Windows,缺省 = macOS / Linux)、`base` 段(配置本体,必填)、
-   `env` 段(环境名,缺省 = 所有环境通用这一套)。`win@base`(换平台)与 `base@env`(换环境)都是**同一个 base 的变体**;
-   **档案只登记 base**,变体写进 base 的 `desc`。
-    - 名字怎么解析**交给工具**(`<前缀>_inspect_run_configuration` 的 `naming`),别自己猜。
-    - **一个环境具体怎么接上,是项目自己的事**(启动参数 / 环境变量 / 配置文件都常见):照项目里现成的同类变体来,或问用户。
-6. **选环境问一次,别反复打扰**:`base` 与 `base@<env>` 同时存在 = 两套环境 → **启动前问一次用户走哪套**(问的是"走哪个环境",
-   不是"要不要启动");**用户选定后本会话内默认走这一套**,用户不说改就不改 —— 改代码 → 自己重启 → 同一套变体,AI 干活的链路上
-   不打扰用户。
+
+名字怎么读、变体怎么选 —— 见 IDE 引导的「运行配置」(每次请求都在);每条登记什么,见
+[assets/AGENTS.template.md](assets/AGENTS.template.md) 的生成提示。两处都不在本文件重复。

package/skills/idea-run-config-manager/assets/AGENTS.template.md

@@ -21,8 +21,6 @@
 
 ## run configuration 一览
 
-**「怎么读配置名」与「怎么选变体」两节是固定文本,照抄,不要改写、不要删条目** —— 它们是读名字与选变体的规则,下面那个列表靠它们才成立。
-
 <!-- 生成提示:begin -->
 
 **先过滤**:服务化 / 常驻应用的配置 **一律不进本块**(它们归 `idea-standalone`,端口与热重载写在那边)。有
@@ -32,12 +30,9 @@
 目录的那些 —— 翻文件看不到)。 **项目与各子项目里真正存在的、过滤后剩下的都要有。**
 **项目写在条目开头的括号里**(那套工具的前缀:root 写 `ide`,子项目写它的目录名):一条配置属于谁、该用哪套工具去看和跑,
 由它决定。条目里的配置名必须是该前缀下 **真实存在的名字**,不凭印象写;块里有、项目里已经没有的 **整个条目删掉**。 **只登记
-base,变体不另起条目**:run configuration 的名字是 `[os@]base[@env]`,`@` 分割、最多三段 —— os 段 (`win` = Windows,缺省 =
-macOS/Linux)、
-base 段 (配置本体)、env 段 (环境名,缺省 = 所有环境通用这一套)。`win@base` 与 `base@env` 都是 **同一个 base 的变体**:
-平台不同 / 环境不同,事情是同一件。 **本块只登记 base**(`{配置名}` 不带任何 `@` 段),变体不另起条目 ——
-把"有哪些变体"写进 base 的 `desc` 一条即可;判断某个变体在哪个平台成立 **看命令与脚本内容本身**(有 `\` 路径、调用
-`.bat`、依赖 Windows 专属工具的,就是 Windows), **判断不了就问用户**,不猜。
+base,变体不另起条目**:`{配置名}` 不带任何 `@` 段 —— 名字文法与变体怎么选见 IDE 引导的「运行配置」;有哪些变体写进 base 的
+`desc` 一条即可。判断某个变体在哪个平台成立 **看命令与脚本内容本身**(有 `\` 路径、调用 `.bat`、依赖 Windows 专属工具的,
+就是 Windows), **判断不了就问用户**,不猜。
 
 **when** 只写两种,先把是哪一种写明:**用户授权触发** → 用户开口 (或在本会话里授权) 之后 AI 才跑,后面写用户通常在
 什么情况下会要它跑 (发版前 / 出安装包 / 回归);**AI 自己触发** → AI 判断到场景就自己跑, **必须把场景写具体**(改完某类代码要
@@ -94,19 +89,6 @@ base 段 (配置本体)、env 段 (环境名,缺省 = 所有环境通用这一
 `应用` / `端口` / `热重载`。 **五项始终都在**:真没有内容就写 **`无`** —— 不省略,也不写 `-` / `N/A`。
 <!-- 生成提示:end -->
 
-### 怎么读配置名
-
-run configuration 的名字是 `[os@]base[@env]`,`@` 分割、最多三段:`os` = `win`(缺省表示:macOS / Linux)、`base` = 配置本体
-(必填)、`env` = 环境名(缺省表示:所有环境通用)。`win@base`(换平台)与 `base@env`(换环境)都是 `base` 的 **变种**:
-同一件事,平台 / 环境不同。 **只登记 base**,变体不另起条目 —— 有哪些变体写进 base 的 `desc`。
-
-### 怎么选变体
-
-- **平台**:macOS / Linux 用 `base`,Windows 用 `win@base` —— `win@base` 不存在就 **交回用户**,别拿 base 顶替。
-- **环境**:`base` 与 `base@<env>` 同时存在 → **启动前问一次用户走哪套**,选定后本会话默认走这套,别反复问 ——
-  改代码 → 自己重启 → 同一套变体。
-- 一个环境怎么接上 (启动参数 / 环境变量 / 配置文件) 是项目自己的事:照现成的同类变体来,或问用户。
-
 ### base 登记
 
 - {配置名} (项目 {前缀})

package/skills/idea-standalone/SKILL.md

@@ -24,28 +24,22 @@ description: "为项目固化 standalone(启动收口只有 IDEA run configurati
 - 读 `<项目根>/AGENTS.md`:有没有 `idea-standalone` 标记块 (有则更新,没有就在文件末尾追加)。
 - 枚举:该项目的 `<前缀>_get_run_configurations` 直接调用,不传任何参数 —— 它给出 IDE 真正认的配置,连同启动细节 (程序参数、
   工作目录、环境变量、能否启动时覆盖)。 **条目里的 base 名与端口只能来自这里**,不用再去项目目录逐个翻配置文件。
-- 只登记 base:名字是 `[os@]base[@env]` (`@` 分割、最多三段),带 `@` 段的一律 **取 base 部分登记**;平台 / 环境由名字里的
-  段决定,不逐个列 —— 文法与选法见模板的「怎么读配置名」与「怎么选变体」。 **一条配置一个条目**:服务化 / 常驻的都算,
-  同一个应用有多条就写多条。
+- **一条配置一个条目**:带 `@` 段的配置一律 **取 base 部分登记**,变体不另起一条 —— 文法与选变体见 IDE 引导的「运行配置」,
+  每一项怎么写见模板的生成提示。
 
-**缺口** (逐条向用户确认,不猜)
+**缺口**(端口、热重载、`应用` 各自怎么定,模板的生成提示里写了;拿不准就 **问用户**,不猜)
 
-- 端口:启动细节里没有、项目自身配置里也读不到 → **问用户**。
-- 热重载:看运行方式 (项目类型 `package.json` / `pom.xml` / `go.mod` / `pyproject.toml` / `Cargo.toml` 决定有没有 HMR),
-  不确定就问用户。
 - 缺配置:`run configuration` 列表里没有某个应用 → **先问用户要不要建**,再用 `<前缀>_create_run_configuration` 建 (建配置是
   **项目资产**:把"配置名、干什么、为什么值得留"摊开给用户看,同意才建);工具列表里没有它时,请用户自己在 IDE 里建。建完
   **重新查一次**,再登记。不要手搓启动命令,也不要自己写配置文件。
-- 归属:哪些配置进 standalone、`应用` 那一项填什么 (同一个应用可以有多条配置)、哪些配置名对不上 → 问用户。
+- 归属:哪些配置进 standalone、哪些配置名对不上 → 问用户。
 
 **写之前**先读 [assets/AGENTS.template.md](assets/AGENTS.template.md)。
 
 ## 生成与更新
 
 1. 归属判断:属于这两段的内容写进 `idea-standalone` 标记块;不属于的 (项目自己的其它纪律)留在标记外,本 skill 不写。
-2. 先读 [assets/AGENTS.template.md](assets/AGENTS.template.md),按其中的生成提示逐段填充。 **
-   `<!-- 生成提示:begin -->…<!-- 生成提示:end -->` 是给生成过程的说明,产物里整块删掉** —— 产物是给 AI 当规则读的,里面不该留指令。
-   同时:**未涉及的条目与小节整块删掉**,不留空标题、不留 `{...}`。
+2. 按 [assets/AGENTS.template.md](assets/AGENTS.template.md) 的生成提示逐段填充。
 3. **新增**(文件里还没有标记块):在 `AGENTS.md` **末尾追加**标记块,文件既有内容原样保留;文件不存在则创建它。
    只替换标记内内容、不动标记外 —— 尤其 **不要触碰**其他 skill 的标记块 (例如 `project-scaffold`)。
 4. **更新**(已有标记块):只替换 `<!-- idea-standalone:begin -->` 与 `<!-- idea-standalone:end -->` 之间的内容,块外一字不动。

package/skills/idea-standalone/assets/AGENTS.template.md

@@ -38,15 +38,12 @@ skill 一律不动。
 
 ## 二、standalone 下启动哪些应用 (必须经 IDEA run configuration)
 
-**「怎么读配置名」与「怎么选变体」两节是固定文本,照抄,不要改写、不要删条目** —— 它们是读名字与选变体的规则,下面那个列表靠它们才成立。
-
 <!-- 生成提示:begin -->
 
 一条一个 **run configuration**(服务化 / 常驻的那种)—— **应用只是它的一个属性**:同一个应用有多条配置 (前端 dev server +
 后端服务)就写多条,别合并成一条。 **括号里的项目是这条配置的归属**(root 写 `ide`,子项目写它的目录名):配置可能住在子项目
-里,跑它就用 **那个前缀**的工具 —— 拿不准就问用户。 **条目开头的名字填真实 base 名**(不带任何 `@` 段),平台与环境由名字里
-的段决定,见上面「怎么读配置名」。
-**变体不另起一条**:`win@base`(换平台)、`base@env`(换环境)都是同一个 base 的变种,写一条就够,怎么选走「怎么选变体」那节。
+里,跑它就用 **那个前缀**的工具 —— 拿不准就问用户。 **条目开头的名字填真实 base 名**(不带任何 `@` 段)—— 名字文法与变体怎么选
+见 IDE 引导的「运行配置」。 **只登记 base,变体不另起一条**:写一条 base 就够,有哪些变体写进 `desc`。
 
 **下面是两个示例**,照这个形状写 —— 一条把长的地方展开,一条全是短句 (生成产物时把示例删掉):
 
@@ -62,7 +59,7 @@ skill 一律不动。
 - `platform-server`(项目 ide)
     - 应用:platform
     - before run:
-        - 确认 Tailscale 已连到 yutao-mac
+        - 确认 Tailscale 已连到 dev-mac
         - 确认 apps/platform/.env 存在
     - run:ide_rerun_run_configuration
     - 端口:8080,被占用即启动失败
@@ -88,25 +85,12 @@ skill 一律不动。
 **没有热重载的应用改完之后,不得在没有提示的情况下宣称"改动完成 / 可以去验证了"** —— 重启动作由用户做。
 **desc** 写剩下的坑与依赖关系 (依赖谁、跟别的应用什么先后),以及例外 (**只在联调 / 某个流程之前才需要起**之类)。
 **目录**这类配置里本来就有的字段不要单开一项 —— 会跟配置变旧而对不上。 **有 `@` 变体就在这里补一句**:有哪些变体 (如
-`console-web@yutao`)。 **项名与顺序**与 `idea-run-config-manager` 那个块 **同名同序**(`before run` / `run` /
+`console-web@dev`)。 **项名与顺序**与 `idea-run-config-manager` 那个块 **同名同序**(`before run` / `run` /
 `after run` / `desc`);
 本块多 `应用` / `端口` / `热重载`,少一项 `when` —— 服务化配置就是"改完代码要起它来测"的时候起,没有别的时机可写。两个块住在同一份
 `AGENTS.md` 里,名字与顺序对上了才看得出哪些是服务、哪些是固定流程。 **某项确实没有内容就写 `无`**(不省略、也不写 `-`)。
 <!-- 生成提示:end -->
 
-### 怎么读配置名
-
-run configuration 的名字是 `[os@]base[@env]`,`@` 分割、最多三段:`os` = `win`(缺省表示:macOS / Linux)、`base` = 配置本体
-(必填)、`env` = 环境名(缺省表示:所有环境通用)。`win@base`(换平台)与 `base@env`(换环境)都是 `base` 的 **变种**:
-同一件事,平台 / 环境不同。 **只登记 base**,变体不另起条目 —— 有哪些变体写进 base 的 `desc`。
-
-### 怎么选变体
-
-- **平台**:macOS / Linux 用 `base`,Windows 用 `win@base` —— `win@base` 不存在就 **交回用户**,别拿 base 顶替。
-- **环境**:`base` 与 `base@<env>` 同时存在 → **启动前问一次用户走哪套**,选定后本会话默认走这套,别反复问 ——
-  改代码 → 自己重启 → 同一套变体。
-- 一个环境怎么接上 (启动参数 / 环境变量 / 配置文件) 是项目自己的事:照现成的同类变体来,或问用户。
-
 ### 服务化配置
 
 一条一个 run configuration;`应用` 是它的属性 —— 同一个应用可以有多条配置。括号里的项目是它的归属:跑这条配置,用那个项目

package/src/ide-guidance.template.md

@@ -158,6 +158,15 @@
   有没有热重载都一样;读 `started` 判断新进程是否真的起来了。这次运行的输出在 `output`,完整日志文件路径在
   `fullOutputPath`。不要用 `pkill` / `kill` / `shell` 代替。
   {{/if}}
+
+**配置名怎么读**:`[os@]base[@env]`,`@` 分割、最多三段 —— `os` = `win`(缺省 macOS / Linux)、`base` = 配置本体(必填)、
+`env` = 环境名(缺省 = 默认环境)。`win@base`(换平台)与 `base@env`(换环境)都是 `base` 的 **变体**,跑哪一个:
+
+- **平台**:macOS / Linux 用 `base`,Windows 用 `win@base` —— `win@base` 不存在就 **交回用户**,别拿 base 顶替。
+- **环境**:不带 `@` 的就是 **默认环境**。一批一起起时 **逐条解析**:有 `base@<要的环境>` 就用它,没有就用默认;只有 `@env`
+  变体、没有默认版的,就用它自己那个 —— "10 个服务"可以是"3 个 `@dev` + 7 个默认",不必逐条问。
+- 一条配置同时有 `base` 与 `base@<env>`、又没说走哪个环境 → **问一次走哪个环境**,选定后本会话默认走这套,别反复问。
+- 一个环境怎么接上(启动参数 / 环境变量 / 配置文件)是项目自己的事:照现成的同类变体来,或问用户。
   {{#if canListDeploymentServers}}
 
 ### 服务器文件同步

package/src/mcp/idea.js

@@ -127,7 +127,7 @@ export async function callTool(port, projectPath, name, args = {}, options = {})
       params: {
         protocolVersion: PROTOCOL_VERSION,
         capabilities: {},
-        clientInfo: { name: 'opencode-idea', version: '0.0.24' },
+        clientInfo: { name: 'opencode-idea', version: '0.0.26' },
       },
     });
     // The IDE's Streamable-HTTP endpoint binds follow-up requests to the session