mcpField
P
pty-capture

pty-capture

github.com/factory-ai测试与质量11785 次安装3 天前更新
代码仓库

关于 pty-capture

用于捕获终端对特定按键实际发出的字节序列的技能,适用于验证终端输入编码,而非检查界面外观。它说明 Linux、Windows 和 macOS 的捕获方式,并将结果用于 CLI 兼容性测试。

主要功能

  1. 01捕获终端按键输出的字节
  2. 02支持 Linux、Windows 和 macOS
  3. 03提供各平台捕获说明
  4. 04将捕获结果用于回放测试

适用场景

  1. 01核实终端发送的按键序列
  2. 02构建终端兼容性测试样例
  3. 03调试 CLI 的按键处理

安装

复制下面的命令,在终端中运行。

$npx skills add https://github.com/factory-ai/factory-plugins --skill pty-capture

安装后在 Claude Code 中输入/pty-capture确认已加载。

包含的文件

除 SKILL.md 外,安装时一起下载的参考资料和脚本。

platforms/
linux.md
macos.md
windows.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