emrg: Windows TUI 适配 — Win32Console raw mode + stdin/resize 线程化

[argszero]

背景

rant 2026-08-05T15:54:28 — Windows 上运行 emrg 命令 TUI 崩溃：

File "...python_tui\terminal.py", line 469, in _enter_raw_mode
    self._original_termios = termios.tcgetattr(sys.stdin.fileno())
AttributeError: 'NoneType' object has no attribute 'tcgetattr'

TUI 输入/信号层全部基于 POSIX（termios/fcntl/SIGWINCH/add_reader），Windows 无降级直接抛 traceback。

修复（方案 A，宿主已确认；ctypes 调 Win32 API，不引入 pywin32，打包 runtime 保持精简）

1. 新增 emrg/client/python_tui/win32.py — Win32Console 类

• enable_raw_mode(fd)：GetConsoleMode 保存原始模式 → SetConsoleMode 关闭 ENABLE_LINE_INPUT|ENABLE_ECHO_INPUT|ENABLE_PROCESSED_INPUT（保留 ENABLE_WINDOW_INPUT），打开 ENABLE_VIRTUAL_TERMINAL_PROCESSING|ENABLE_PROCESSED_OUTPUT（cmd/conhost 需要，Windows Terminal 默认已有）确保 ANSI/VT 序列可用
• msvcrt.setmode(fd, os.O_BINARY) 关闭 CRLF 转换 → 方向键 ESC [ A 序列与 POSIX 字节一致，InputParser 零改动
• disable_raw_mode(fd)：恢复保存的原始模式
• 每个 fd 独立保存/恢复；active 属性反映 raw 状态

2. terminal.py 平台分发（POSIX 路径零改动）

• _enter_raw_mode/_exit_raw_mode：sys.platform == "win32" → Win32Console；否则 termios（现有逻辑）
• 2 处 fcntl 调用（L119 stdout 强制 blocking、L347 BlockingIOError flush 恢复）加 fcntl is not None guard

3. app.py 平台分发

• stdin reader：Windows → daemon 线程阻塞 os.read(stdin_fd, 4096) → loop.call_soon_threadsafe(stdin_queue.put_nowait, data)；POSIX 保持 add_reader+fcntl（rant #SIGWINCH-leak 结构不变）
• resize：Windows → daemon 线程每 500ms 轮询 os.get_terminal_size()，变化时 call_soon_threadsafe(_resize_event.set)；POSIX 保持 SIGWINCH handler；signal.SIGWINCH 用 getattr 保护
• finally：Windows 停线程（daemon=True 兜底），POSIX remove_reader 加 try/except

验收对照（rant 清单）

• Windows cmd/PowerShell/Windows Terminal 下 emrg TUI 无 traceback（待 v0.2.3 打包实测）
• 输入：字符/CJK/退格/方向键/Ctrl 编辑/ESC 中断/bracketed paste（字节流与 POSIX 一致 → InputParser 复用）
• resize 实时生效（轮询线程）
• 退出恢复终端模式（disable_raw_mode + CURSOR_SHOW）
• macOS 全量回归 466 passed（POSIX 路径零改动）
• 打包 v0.2.3 安装后 emrg 可用（待发布）

验证

• py_compile 3 文件 + 466 passed + import OK + emrg --help OK

注：rant 关联的 config.toml 解析错误优化（start_daemon 超时显示真实原因）为独立问题，另行 PR。

[argszero]

✅ LGTM — cycle 20260805-1602. 第 1 个 LGTM（含 review 修复）。独立审查发现并修复 1 个关键 bug：_enter/_exit_raw_mode 各自新建 Win32Console() 实例 → 保存的原始 console 模式在实例属性 _saved_modes 中，退出时新实例模式字典为空 → 无法恢复终端。已改为模块级单例 win32_console（win32.py + terminal.py 2 处），push 156b72f。其余审查通过：① Win32Console ctypes 实现正确（SetConsoleMode raw + VT + msvcrt O_BINARY）；② terminal.py fcntl 2 处 None guard；③ app.py stdin 线程化（call_soon_threadsafe）+ resize 轮询 + SIGWINCH getattr 保护 + finally 平台分支；④ POSIX 路径零改动（466 passed）。CI test pass 38s。

[argszero]

✅ LGTM — cycle 20260805-1605. 第 2 个 LGTM。独立复核：① 单例修复已落实（win32_console = Win32Console() 模块级，terminal.py 2 处引用，saved modes 跨 enter/exit 存活）；② Win32Console.enable_raw_mode 保存 in/out 模式 + disable_raw_mode 恢复（含 stdout VT 模式）；③ msvcrt O_BINARY 保证字节流与 POSIX 一致（InputParser 零改动）；④ app.py stdin 线程 + resize 轮询线程均 daemon=True 且 finally 显式 stop；⑤ POSIX 路径零改动（fcntl guard 2 处 + SIGWINCH getattr）。CI test pass 34s（修复后）。LGTM 2/3。

[argszero]

✅ LGTM — cycle 20260805-1603. 独立审查：
① win32.py — ctypes 调 Win32 API（无 pywin32，runtime 保持精简），raw 模式正确（关 LINE_INPUT/ECHO/PROCESSED_INPUT 保留 WINDOW_INPUT 收 resize 事件），VT 输出模式开启，二进制模式禁 CRLF；模块级单例保存模式（修复版 156b72f 正确——fresh instance 会丢 _saved_modes）
② terminal.py — Windows 走 win32_console，POSIX termios 路径不变；fcntl None 保护（2 处）
③ app.py — Windows 线程阻塞 os.read + call_soon_threadsafe 替代 add_reader（ProactorEventLoop 不支持）；500ms 轮询 resize 替代 SIGWINCH；finally 中线程 stop + remove_reader 保护（NotImplementedError/ValueError）
④ POSIX 路径零改动 → 466 pytest 通过 + import OK
Windows 专属路径无法在 macOS 实测（_overlapped/msvcrt 缺失），需 windows runner 验证——建议 merge 后跑 GUI/冒烟测试确认。设计合理，无阻塞问题。