Skip to content

fix(terminal): restore control characters in Win32 input records - #3

Draft
JoyElliot wants to merge 1 commit into
mainfrom
issue-213-ctrl-c
Draft

JoyElliot wants to merge 1 commit into
mainfrom
issue-213-ctrl-c

Conversation

@JoyElliot

@JoyElliot JoyElliot commented Sep 26, 2026 •

Copy link
Copy Markdown
Owner

Result / 用户结果

修复 Windows GPUI 终端在 Win32 输入模式下丢失 Ctrl+C 控制字符的问题。GPUI 会把 ETX 从 key_char 中过滤掉,原编码器因此发送 Uc=0;现在按 Windows 原生翻译恢复 Uc=3,让 adb 等读取字节流的程序收到中断字符。

Design / 设计边界

  • 仅修改 Win32 按键适配器及已有的 Windows 字符恢复函数:将 Enter 的 ToUnicode helper 泛化并复用。
  • 只在文本缺失、Ctrl 已按下、没有 Alt/platform/function 修饰且已有 VK 属于 A–Z 时恢复 C0。保留显式文本、AltGr、IME 分流、命名控制键及传统 VT/Kitty 模式选择。
  • 保留 ToUnicode 的无组合状态修改标志与单 UTF-16 单元限制。没有新增依赖、持久化、线程或协议格式。
  • 既有单字母 f 回落到传统 VT 的解析行为不在本次改动范围内;本 PR 不宣称所有字母都已进入 Win32 编码路径。

Evidence / 验证依据

  • 临时回归探针直接编译这两个生产源码模块,只为 GPUI 类型提供最小结构:修复前 Ctrl+C 的 down/up 字符字段断言失败(实际 0,期望 3);修复后 10 项测试通过,包含 Ctrl/Shift、显式文本、AltGr、IME 分流、命名键、数字及功能键的边界。探针位于本地忽略的 tmp/issue213-tests,未加入产品提交。
  • 独立 Windows ConPTY 的 ReadConsoleInputW 接收验证通过:down/up 均收到 VK=67、scan=46、UnicodeChar=3、ControlKeyState=8、Repeat=1。
  • USB Android 15 真机基础验证:独立 ConPTY 中运行 adb shell -tt ping -c 20 127.0.0.1,发送与修复后编码器输出一致的记录,显示 ^C 并在 16 次后提前结束。没有操作手机屏幕。此前相同路径中 Uc=0 的对照不能中断有限次 ping。
  • python scripts/check_architecture.py --base c70073b770785b0bf7d962d1048739cff19b6fce、python scripts/check_platform_cfg.py、git diff --check 均通过。
  • 三组架构检查器单元测试共 53 项,50 项通过、3 项按平台跳过。
  • cargo test --manifest-path tools/i18n-contract/Cargo.toml --locked --offline:22 项通过、1 项忽略。
  • cargo fmt --all -- --check 在已提交源码的 LF 快照上通过。Windows checkout 的 CRLF 导致原始本地检查报换行差异,因此以禁用自动换行转换的 Git archive 快照运行原有检查,未修改仓库格式规则。
  • 增量成本为命中该恢复分支的每条记录一次栈缓冲 ToUnicode 调用。当前机器 release 探针编码 10,000 对 Ctrl+C down/up 共 12,177 µs;这只是本机完整编码耗时,不是前后性能差值或通用性能保证。
  • 尚未完成修复版 Pebrel 实际窗口按键验收、其他键盘布局验收或本地全产品构建;完整原生测试与 Windows 包构建交由本分支 CI。独立 ConPTY 结果不等于产品 GUI 验收。

Required Review / 必须确认

  • 已遵循 CONTRIBUTING.md、架构及项目约束,变更局限于现有职责。
  • 复用既有原生翻译实现,没有新增重复规则来源。
  • 基于实际 PR base 的架构检查通过,未提高预算。
  • 已运行故障回归与兼容边界检查,未运行的平台/产品路径已明确列出。
  • 不涉及新增 UI 文案或国际化资源。
  • 不涉及治理规则修改。

@JoyElliot
JoyElliot marked this pull request as draft September 26, 2026 15:59
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant