关于 pty-capture
用于捕获终端对特定按键实际发出的字节序列的技能,适用于验证终端输入编码,而非检查界面外观。它说明 Linux、Windows 和 macOS 的捕获方式,并将结果用于 CLI 兼容性测试。
主要功能
- 01捕获终端按键输出的字节
- 02支持 Linux、Windows 和 macOS
- 03提供各平台捕获说明
- 04将捕获结果用于回放测试
适用场景
- 01核实终端发送的按键序列
- 02构建终端兼容性测试样例
- 03调试 CLI 的按键处理
安装
复制下面的命令,在终端中运行。
$
npx skills add https:/ / github.com/ factory-ai/ factory-plugins --skill pty-capture安装后在 Claude Code 中输入/pty-capture确认已加载。
包含的文件
除 SKILL.md 外,安装时一起下载的参考资料和脚本。
platforms/linux.mdmacos.mdwindows.md详细介绍
PTY 字节捕获
编排器已将你引导至此处。使用以下机制执行计划。
捕获真实终端针对给定按键输出的确切字节。当问题是“终端 X 按下按键 Y 时会发送什么序列?”而不是“界面看起来是否正确?”时,请使用此方法。
平台支持
| 平台 | 状态 | 阅读 |
|---|---|---|
| Linux / Wayland | 已实现 | platforms/linux.md |
| Windows (KVM) | 已实现 | platforms/windows.md |
| macOS (QEMU) | 已实现 | platforms/macos.md |
请阅读目标操作系统对应的平台文件。 每个文件都包含捕获架构、先决条件、使用模式和平台专属说明。
已知行不通的方法
- Xvfb + xdotool:完全绕过真实的键盘处理
- uinput + Xvfb:Xvfb 不会读取内核输入设备
- 用于注入按键的 SSH PTY:会扭曲输入编码;SSH 仅用于捕获输出或部署
后续步骤
将捕获的字节输入终端兼容性夹具和 apps/cli 中的重放测试。
评论
支持 Markdown