@ia-ccun/idea-plugin-share 0.0.9 → 0.0.10

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@ia-ccun/idea-plugin-share",
-  "version": "0.0.9",
+  "version": "0.0.10",
   "description": "IntelliJ IDEA 插件分发包：把 zip 放进 plugins/ 目录，npm publish 后内网 npm i 即可获取",
   "bin": {
     "idea-plugin": "bin/idea-plugin.js"

package/plugins/aicode-jcef-kylin-input-method-fix.md

@@ -0,0 +1,182 @@
+# AICode 插件 · 麒麟 Linux 中文输入法 & 焦点问题解决方案
+
+> 适用：内网麒麟 V10 (UKUI 桌面) + fcitx 输入法 + IntelliJ IDEA 2022.3 (JBR 17.0.6) + AICode 插件 (JCEF 聊天面板)
+>
+> 症状：打开 AICode 聊天面板后，中文无法上屏；面板之外的 IDE 编辑区 / 项目树键盘失灵
+
+---
+
+## 根因（按确认度排序）
+
+1. **环境变量未传进 IDEA 进程** — 国产 Linux 桌面（麒麟 UKUI / UOS DDE）默认把 `GTK_IM_MODULE=fcitx` 等隐式配置在 `.pam_environment` / `.xinputrc` 里，JetBrains 启动脚本 (idea.sh) 偶发不继承这些环境变量，JCEF 容器内的 Chromium 进程拿不到 IME context，**commit 不进**
+2. **JBR 默认 XToolkit 后端对 fcitx 桥接不完整** — JBR 17 在 Linux 上默认走 `XToolkit`（非 GTK），fcitx 经 XIM 协议转发到 JCEF 时事件被吞；强制 `AWT_TOOLKIT=GTK` 后 Java AWT 用 GTK event loop 透传 IME，commit 正常
+3. **JCEF heavyweight 容器跟 Swing lightweight 混排** — AWT 默认 mixing 允许 heavyweight (CEF) 与 lightweight (Swing) 组件共享 z-order，CEF grab 焦点后不回交，编辑区 / 项目树键盘失灵
+4. ~~JDK 1.8 不支持 JCEF~~ — **已排除**：内网 IDEA Runtime version 实测 17.0.6+，不是 JDK 1.8
+
+---
+
+## 验证三步（动手前先确认）
+
+```bash
+# 1. 确认 IDEA 真的是 JBR 17（不是 JDK 1.8）
+#    IDEA → Help → About → "Runtime version:" 一行
+#    应该是 "17.0.6+1-b653.34" 或类似，开头是 17/21
+
+# 2. 确认 fcitx 在普通应用里能正常输中文
+#    起个 xterm / gnome-terminal，切到中文，看状态栏是否跟着光标走
+fcitx5-remote -c       # fcitx5
+# 或：fcitx-remote -c   # 老版 fcitx 4
+
+# 3. 确认补丁已生效（你应该在 idea.log 里看到）
+grep "JCEF off-screen rendering disabled" ~/.cache/JetBrains/IdeaIC2022.3/log/idea.log 2>/dev/null
+grep "JCEF off-screen rendering disabled" ~/.config/JetBrains/IdeaIC2022.3/log/idea.log 2>/dev/null
+# 或直接：Help → Show Log in Explorer → 搜 "JCEF off-screen rendering disabled"
+```
+
+---
+
+## 方案 A（最快，2 分钟验证）
+
+在启动 IDEA 的终端**手动 export 环境变量**然后启 IDEA：
+
+```bash
+export GTK_IM_MODULE=fcitx
+export QT_IM_MODULE=fcitx
+export XMODIFIERS=@im=fcitx
+export SDL_IM_MODULE=fcitx
+export AWT_TOOLKIT=GTK                # 关键：强制 JBR 走 GTK 后端，吃 fcitx 事件
+export LC_ALL=zh_CN.UTF-8             # 顺手修中文字符集
+
+/opt/idea-IC-2022.3.3/bin/idea.sh
+```
+
+**AWT_TOOLKIT=GTK** 是关键一招——JBR 17 在 Linux 默认 XToolkit 对 fcitx 桥接残缺，强制 GTK 后端后 IME 事件从 GTK event loop 直接透传到 JCEF Chromium 进程。
+
+如果这一步中文就能输了，跳到「方案 B」做持久化。
+
+---
+
+## 方案 B（持久化，重启免配）
+
+写入 `~/.pam_environment`，**重新登录**（不是重启 shell，是 logout/login）让 PAM 生效：
+
+```bash
+cat >> ~/.pam_environment <<'EOF'
+GTK_IM_MODULE=fcitx
+QT_IM_MODULE=fcitx
+XMODIFIERS=@im=fcitx
+SDL_IM_MODULE=fcitx
+AWT_TOOLKIT=GTK
+LC_ALL=zh_CN.UTF-8
+EOF
+
+# 验证写入
+cat ~/.pam_environment
+
+# 然后 **注销重新登录**
+```
+
+> 注意：麒麟 UKUI 部分版本不读 `~/.pam_environment`，fallback 用 `~/.xprofile`：
+>
+> ```bash
+> cat > ~/.xprofile <<'EOF'
+> export GTK_IM_MODULE=fcitx
+> export QT_IM_MODULE=fcitx
+> export XMODIFIERS=@im=fcitx
+> export AWT_TOOLKIT=GTK
+> export LC_ALL=zh_CN.UTF-8
+> EOF
+> # 同样重新登录
+> ```
+
+---
+
+## 方案 C（环境变量还救不了，叠 JCEF 启动参数）
+
+如果方案 A/B 后**中文能输但焦点仍被面板拦截**，打开 `Help → Edit Custom VM Options`，加：
+
+```
+-Dawt.useSystemAAFontSettings=on
+-Dsun.awt.disableMixing=true              # 关键：阻止 AWT 把 heavyweight CEF 与 lightweight Swing 混排
+-Didea.browser.jcef.gpu.disable=true       # 禁 GPU 加速，少一个焦点抢占源
+-Dide.browser.jcef.osr.enabled=false       # 跟代码里的 JcefRenderMode 等价
+```
+
+`-Dsun.awt.disableMixing=true` 是治「焦点被面板拦截」的关键——默认 AWT 允许 CEF 容器 grab 焦点不放，混排关闭后 CEF 与 Swing 各管各的 z-order，IDE 编辑区焦点不丢。
+
+保存后 **重启 IDEA**。
+
+---
+
+## 方案 D（终极保底：换 JBR 17 + 重打插件）
+
+如果上面都失效——理论上极少见——说明当前 JBR 17.0.6 跟 fcitx 5 有版本不兼容（极个别 fcitx 5 commit 协议版本与 JBR 17.0.6 不匹配），可换更新的 JBR 17：
+
+```bash
+# 1. 下 JBR 17 (放到 ../idea-plugin-transform/plugins/ 下做归档)
+#    URL: https://github.com/JetBrains/JetBrainsRuntime/releases
+#    找 jdk-17+xxx 系列稳定 release，下 jbr-*-linux-x64.tar.gz (~200MB)
+
+# 2. 解压
+mkdir -p ~/jbr17
+tar -xzf jbr-17.0.13-linux-x64.tar.gz -C ~/jbr17 --strip-components=1
+
+# 3. IDEA 启动前 export
+export IDEA_JDK=$HOME/jbr17
+
+# 4. 启 IDEA，Help → About 验证 Runtime version 换了
+/opt/idea-IC-2022.3.3/bin/idea.sh
+```
+
+---
+
+## 快速决策树
+
+```
+fcitx 在普通应用里能输中文吗？
+├─ 不能 → 修 fcitx 本身（chkconfig / fcitx5-diagnose），跟 AICode 无关
+└─ 能
+   │
+   IDEA Runtime version 是 17+ 吗？
+   ├─ 不是 (JDK 8) → 切 JBR 17，参考方案 D
+   └─ 是
+      │
+   idea.log 有 "JCEF off-screen rendering disabled" 吗？
+   ├─ 没有 → 重新装 aicode-agent-0.1.0-223.zip，确保 plugin 真的加载
+   └─ 有
+      │
+   手动 export GTK_IM_MODULE=fcitx + AWT_TOOLKIT=GTK 后启 IDEA？
+   ├─ 还不行 → 叠方案 C 的 vmoptions（disableMixing）
+   └─ 行了 → 写入 ~/.pam_environment 或 ~/.xprofile 持久化
+```
+
+---
+
+## 与代码 / 插件包的关系
+
+本问题**不需要改 Kotlin 代码**。`JcefRenderMode` 已正确在 Linux 上关掉 OSR，问题在 IDE 进程外部的环境配置。
+
+但建议在 `AicodeChatPanel` 启动时打一条诊断日志，方便用户排查时确认自己走到了正确分支：
+
+```kotlin
+// 建议加在 initJcefChat() 里，浏览器构建之后
+log.info("""
+  AICode chat panel initialized:
+    JBR version: ${System.getProperty("java.runtime.version")}
+    OS: ${System.getProperty("os.name")} ${System.getProperty("os.version")}
+    AWT_TOOLKIT: ${System.getProperty("awt.toolkit")}
+    GTK_IM_MODULE: ${System.getenv("GTK_IM_MODULE")}
+""".trimIndent())
+```
+
+用户报问题时把这段日志贴回来能立刻定位是哪一环缺失。
+
+---
+
+## 相关文档
+
+- JcefRenderMode.kt — Linux OSR 关闭实现（已编入 0.1.0-223）
+- JetBrains Forum: JCEF Chinese IME on Wayland/X11 — 多方案对比
+- fcitx5 官方文档: `man fcitx5` / `fcitx5-diagnose`
+
+最后更新：2026-08-28