3.7 KiB

Raw Permalink Blame History Unescape Escape

01 Windows 中文输入方案

结论（已拍板：方案 C）

主界面是 TUI。启动时检测终端：

Windows Terminal / VS Code / Cursor 等可用宿主 → 进入自研 TUI
经典 cmd（conhost）→ 不进入 Textual，打印如何用 WT 启动，并 自动回退 REPL

不把「在 cmd 里用 Textual 打中文」列为验收。TUI 在 WT 里若中文仍偶发失败，用 /edit 外开编辑器写长提示。

根因

你在 Qoze 的 cmd 里打不了中文，不是没设 UTF-8。

Textual 在 Windows 上走 WindowsDriver：ReadConsoleInputW + Raw VT + Kitty Keyboard Protocol（\x1b[>1u）。应用一旦 raw 读键，控制台宿主无法完成 IME 组字（拼音 → 汉字）。PYTHONUTF8 只影响 Python 输出编码，不修复组字。

Qoze 里 utils/iterm_driver.py 用拦截 Kitty 协议修 iTerm 中文，但从未接到主程序；Windows 侧没有对应处理。安装脚本生成 qoze.cmd，更容易落到 conhost。

当前机器是 Windows 10 1903（build 18362）时，conhost / 早期 ConPTY 的 IME 更差。只在 README 写「请用 Windows Terminal」不够，必须启动时探测并降级。

flowchart TD
  keyPress[按键] --> host{谁拥有输入}
  host -->|熟模式 cooked REPL| ime[系统 IME 组字]
  ime --> appStdin[应用读到完整汉字]
  host -->|生模式 raw TUI| skipIme[应用直接吃按键]
  skipIme --> fail[拼音散开或无法上屏]

业内对照（为何选 C）

方案	含义	G-CODE
A. 永远 REPL	输入权归终端，cmd 也能打中文	仅作 conhost 回退，不是主界面
B. `/edit` 外开编辑器	类似 git commit	TUI 下的第二兜底
C. 检测终端再决定	Claude Code / Gemini CLI 一类「请用 WT」的工程化	已选：能开 TUI 就开，不能开就回退
D. 自研 Windows Driver 关 Kitty	Qoze 的 iTerm 思路	TUI 路径建议做，cmd 仍救不了
E/F. Web 窗 / Win32 悬浮输入框	浏览器 IME 完美，或极重	不做

没有银弹。Cursor、Claude Code、Textual 系 TUI 在 Windows 中文输入上至今都有缺口。稳妥做法是：不在不支持的宿主里硬开 raw TUI。

REPL 是什么

Read-Eval-Print Loop：读一行 → 执行 → 打印 → 再等下一行。不进全屏交替缓冲区，IME 归终端。G-CODE 里它不是产品脸，只是逃生口：

gcode> 请总结 README
[think] ...
[tool] read_file README.md
[final] ...

主界面仍是 TUI：顶栏、消息气泡、思考区、工具状态、底部输入框。自己写 widget 与样式。

探测规则

允许 TUI（满足任一即可，实现时以代码为准并记日志）：

环境变量 WT_SESSION 存在
TERM_PROGRAM 为 vscode 等已知 PTY
父进程名为 WindowsTerminal.exe

否则视为 conhost：

打印：当前是传统 CMD，中文输入在全屏界面不可用；请用 Windows Terminal 打开本目录后执行 gcode
进入 REPL，功能可用（HITL 用 y/N 文本确认）
gcode --ui tui 在 conhost 上应失败并提示，禁止硬开
gcode --ui repl 任意终端都可强制熟模式

TUI 启动后仍建议拦截 / 关闭 Kitty 协议（\x1b[>1u），降低 WT 下 IME 失败概率。

验收

在 Windows Terminal 中：gcode 进入 TUI，能完成一轮「提问 → 工具 → 回复」
在经典 cmd 中：不进入 TUI；有引导文案；REPL 能打中文并完成同一轮任务
--ui tui 在 cmd 中非零退出或明确拒绝，不黑屏假死
/edit 能打开 %EDITOR% 或记事本，保存后把内容当作用户输入
不验收：cmd 内 Textual 输入框打中文

3.7 KiB Raw Permalink Blame History Unescape Escape