@ia-ccun/idea-plugin-share 0.0.21 → 0.0.23

package/package.json

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

package/plugins/kylin-v10-zh-font-fix.md

@@ -1,290 +0,0 @@
-# 麒麟 V10 终端中文方框（豆腐块）乱码解决方案
-
-> 适用：内网环境、银河麒麟 V10、终端或 Java GUI 出现 `□□□` 方块字
-> 根因：locale 非 UTF-8 + 工具/子进程未透传 LANG（**字体本身通常没问题**）
->
-> **关键现象判别**：
-> - 终端最终态正常 + 渲染过程中方块 → 字体没问题，是流式输出/字符宽度问题，看 §1
-> - 全程都方块（甚至最终态）→ 真没字体，看 §3
-
----
-
-## 0. 现象分支判别（30 秒定位）
-
-| 现象 | 真因 | 跳到 |
-|------|------|------|
-| **流式输出阶段方块 / 最终态正常** | 工具/子进程 LANG 未设，或流式字符宽度 fallback | **§1**（locale 优先） |
-| 全程方块 / 静态也是方块 | 系统确实缺中文字体 | §3 |
-| IDEA 编辑器正常 / Markdown 工具窗口方块 | JBR `file.encoding` 不是 UTF-8 | §6 |
-| SSH 远程侧方块 / 本地正常 | sshd 未透传 LANG | §5 |
-| VS Code 终端方块 / 系统终端正常 | VS Code 终端字体单独配 | §8 |
-
----
-
-## 1. 流式阶段方块 — 工具/子进程 locale 缺失（最高频）
-
-### 1.1 真因
-
-AI Agent / IDE 插件 / 任何带 markdown 流式渲染的工具，**渲染前**会执行：
-- bash 子进程（`git log`、`cat`、构建命令）
-- 工具调用（`read_file`、`grep`）
-- 字节流解码
-
-如果当前环境 `LANG=POSIX` / `C` / 空：
-- bash 子进程按 `C` 编码处理 stdout
-- 字节流被错认为 ASCII/GBK
-- UTF-8 多字节序列在内存里被切成 1 字节/格 → 渲染时占位 `□`
-
-**最终态正常** → 字体没问题；问题仅在"工具输出回灌到 markdown 渲染器"这一段。
-
-### 1.2 立即验证
-
-```bash
-locale
-# 期望输出含 zh_CN.UTF-8；若是 POSIX / C / 空 → 命中
-
-echo $LANG
-echo $LC_ALL
-# 期望 LANG=zh_CN.UTF-8
-```
-
-### 1.3 修复（必做，3 条命令）
-
-```bash
-# 1.3.1 系统级
-sudo localectl set-locale LANG=zh_CN.UTF-8
-
-# 1.3.2 装 UTF-8 locale 数据（如果系统没生成）
-sudo yum install -y glibc-langpack-zh
-sudo localedef -i zh_CN -f UTF-8 zh_CN.UTF-8
-
-# 1.3.3 用户级兜底（关键 — 覆盖 IDE 启动的子 shell）
-echo 'export LANG=zh_CN.UTF-8'  >> ~/.bashrc
-echo 'export LC_ALL=zh_CN.UTF-8' >> ~/.bashrc
-source ~/.bashrc
-```
-
-重新登录后再观察。如果还方块 → 工具自身在 spawn 子进程时硬清空 env（看 §6.3）。
-
----
-
-## 2. 终端自身编码设置
-
-打开终端（gnome-terminal / mate-terminal / 麒麟自带）：
-
-- 编辑 → 配置文件偏好设置 → 文字
-- 勾选"自定义字体"，选 **WenQuanYi Micro Hei** 或 **Noto Sans CJK SC, Regular**
-- **编码选 UTF-8**（不是 GB18030 / GBK）
-
-> 注意：编码 ≠ 字体。字体只管"显示得好看不好看"，编码管"字节如何解为字符"。编码错就一定方块。
-
----
-
-## 3. 真缺字体 — 离线安装（仅当 §0 判定"全程都方块"才做）
-
-### 3.1 内网离线（推荐）
-
-找一台能上网的机器，下载任一字体包：
-- `wqy-microhei.ttc`（文泉驿微米黑，体积小、覆盖全）
-- `NotoSansCJK-Regular.ttc`（Google Noto，效果最好）
-
-拷到麒麟 V10 本机后：
-
-```bash
-sudo mkdir -p /usr/share/fonts/cjk
-sudo cp *.ttc /usr/share/fonts/cjk/
-sudo fc-cache -fv
-
-# 验证
-fc-list :lang=zh | wc -l
-# 应 > 0
-```
-
-### 3.2 有外网 yum 源
-
-```bash
-sudo yum install -y \
-  wqy-microhei-fonts \
-  wqy-zenhei-fonts \
-  google-noto-sans-cjk-sc-fonts
-sudo fc-cache -fv
-```
-
----
-
-## 4. 永久化 locale
-
-```bash
-# 方式 A：systemd 系统
-sudo localectl set-locale LANG=zh_CN.UTF-8
-
-# 方式 B：直接写文件
-echo 'LANG=zh_CN.UTF-8'  | sudo tee /etc/locale.conf
-echo 'LC_ALL=zh_CN.UTF-8' | sudo tee -a /etc/locale.conf
-```
-
-**关键点**：`/etc/locale.conf` 只对登录 shell 生效。**IDE 启动的子进程**不会读它，必须 §1.3.3 + §6 一起配。
-
----
-
-## 5. SSH 透传 LANG
-
-### 5.1 sshd 端（被连接机器）
-
-`/etc/ssh/sshd_config`：
-
-```
-AcceptEnv LANG LC_ALL LC_CTYPE
-```
-
-```bash
-sudo systemctl restart sshd
-```
-
-### 5.2 客户端
-
-`~/.ssh/config`：
-
-```
-Host *
-    SendEnv LANG LC_ALL
-```
-
----
-
-## 6. Java 程序（IDEA / JBR / Swing GUI / 插件）专项
-
-### 6.1 启动器追加（必加）
-
-编辑 `idea64.vmoptions`（或 IDE 启动 vmoptions 文件），追加：
-
-```
--Dfile.encoding=UTF-8
--Dconsole.encoding=UTF-8
--Dsun.jnu.encoding=UTF-8
--Dawt.useSystemAAFontSettings=on
--Dsun.java2d.fontconfig=/etc/fonts/fonts.conf
-```
-
-> **关键**：`file.encoding=UTF-8` 是流式渲染阶段字节流解码的依据。**没这一行**，JBR 会按平台默认（麒麟常为 GB18030）解码 UTF-8 字节 → 渲染过程中方块。
-
-### 6.2 JBR 内置字体回退
-
-即使 §3 装了字体，JBR 仍可能用自带 fallback 链。把系统字体目录显式注入：
-
-```
--Djdk.fontconfig.path=/usr/share/fonts/cjk
-```
-
-或直接拷贝字体到 JBR 的 `lib/fonts/fallback/`：
-
-```bash
-JBR_FONTS=$(find ~/.local/share/JetBrains -name 'jbr' -type d 2>/dev/null | head -1)/lib/fonts/fallback
-[ -d "$JBR_FONTS" ] || sudo mkdir -p "$JBR_FONTS"
-sudo cp /usr/share/fonts/cjk/*.ttc "$JBR_FONTS/"
-```
-
-### 6.3 工具/插件 spawn 子进程时强制带 LANG
-
-如果插件/工具源码可改，spawn 子进程时：
-
-```kotlin
-// Kotlin — Swing / IDEA 插件
-val pb = ProcessBuilder(cmd)
-pb.environment()["LANG"] = "zh_CN.UTF-8"
-pb.environment()["LC_ALL"] = "zh_CN.UTF-8"
-pb.environment()["LC_CTYPE"] = "zh_CN.UTF-8"
-pb.environment()["PYTHONIOENCODING"] = "utf-8"
-```
-
-或更稳：在进程启动前 `setlocale(LC_ALL, "zh_CN.UTF-8")`（Java 用 `Locale.setDefault(Locale.SIMPLIFIED_CHINESE)`）。
-
----
-
-## 7. 一键脚本
-
-保存为 `fix-kylin-font.sh`：
-
-```bash
-#!/usr/bin/env bash
-set -e
-
-if [ "$(id -u)" -ne 0 ]; then
-  echo "请用 root 执行：sudo $0"
-  exit 1
-fi
-
-echo "[1/4] 写入 UTF-8 locale"
-yum install -y glibc-langpack-zh
-localedef -i zh_CN -f UTF-8 zh_CN.UTF-8 || true
-localectl set-locale LANG=zh_CN.UTF-8
-echo 'LANG=zh_CN.UTF-8'  > /etc/locale.conf
-echo 'LC_ALL=zh_CN.UTF-8' >> /etc/locale.conf
-
-echo "[2/4] 安装中文字体"
-yum install -y wqy-microhei-fonts wqy-zenhei-fonts google-noto-sans-cjk-sc-fonts
-
-echo "[3/4] 刷新字体缓存"
-fc-cache -fv
-
-echo "[4/4] 用户级 bashrc 兜底（覆盖 IDE 子进程）"
-BASHRC="$HOME/.bashrc"
-grep -q 'LANG=zh_CN.UTF-8' "$BASHRC" 2>/dev/null || cat >> "$BASHRC" <<'EOF'
-
-# UTF-8 locale (kylin-v10 fix)
-export LANG=zh_CN.UTF-8
-export LC_ALL=zh_CN.UTF-8
-export LC_CTYPE=zh_CN.UTF-8
-export PYTHONIOENCODING=utf-8
-EOF
-
-echo "[验证]"
-fc-list :lang=zh | wc -l
-locale
-
-echo "完成。请重新登录或重启 IDE。"
-```
-
-```bash
-chmod +x fix-kylin-font.sh
-sudo ./fix-kylin-font.sh
-```
-
----
-
-## 8. 常见坑速查
-
-| 现象 | 真因 | 修法 |
-|------|------|------|
-| **流式阶段方块 / 最终态正常** | 工具/子进程 LANG 未传 | §1.3 + §6.3 |
-| `locale: Cannot set LC_ALL` | 没生成 `zh_CN.UTF-8` | `yum install glibc-langpack-zh && localedef` |
-| 装了字体终端仍方块 | 终端自指定了缺失字体 | §2 改字体 |
-| Java Swing / 插件 UI 仍方块 | JRE 没用系统字体目录 | §6.1 加 `-Dsun.java2d.fontconfig` |
-| SSH 远程过去方块 | 远程 LANG 未传 | §5 |
-| 麒麟自带终端正常 / VS Code 终端方块 | VS Code 终端字体单独配 | VS Code 设置 `terminal.integrated.fontFamily: "WenQuanYi Micro Hei"` |
-| 改了 locale 还方块 | IDE 启动时已 cache 旧 env | 重启 IDE（kill -9 再启动） |
-
----
-
-## 9. 验证清单
-
-- [ ] `locale` 输出 `zh_CN.UTF-8`
-- [ ] `fc-list :lang=zh` 至少 1 条
-- [ ] 终端 `git log` 中文正常
-- [ ] **工具/插件流式输出阶段**中文也正常（关键）
-- [ ] IDEA 编辑器中文正常
-- [ ] IDEA 控制台中文正常
-- [ ] 插件 Swing UI 中文正常
-
----
-
-## TL;DR
-
-**你的现象是流式阶段方块 / 最终态正常 → 99% 是工具/子进程没拿到 `LANG=zh_CN.UTF-8`，不是字体问题。**
-
-1. 跑 `locale` 看是不是 `POSIX/C` → 是就先 `export LANG=zh_CN.UTF-8 && source ~/.bashrc`
-2. **重启 IDE**（缓存了旧 env）
-3. IDEA 的 `idea64.vmoptions` 加 `-Dfile.encoding=UTF-8 -Dconsole.encoding=UTF-8 -Dsun.jnu.encoding=UTF-8`
-4. 插件 spawn 子进程时显式塞 `LANG` 进 environment
-
-字体一般不用动。