SuperAPI AI 工具集

true-input

办公与效率

查看项目

更新于 10-16 05:07

技能介绍

用途:true-input 是 droid-control 工作流的后台知识机制,用于驱动真实终端模拟器,通过平台原生 HID 输入路径注入按键,证明终端实际发出的字节序列,避免合成注入与 PTY 失真。适合验证终端是否真的发送预期序列(如 Ghostty 的 Shift+Enter)、录制反映真实终端渲染的演示,以及在特定终端中端到端验证 Droid 对按键的处理。若不需要真实终端证据,应改用 terminal-use 中的 tuistory 后端,它更快、更确定。

主要能力与平台支持:Linux/Wayland 已实现,驱动为 cage + wtype + 任意 Wayland 终端;macOS(QEMU)已实现,通过 QEMU monitor sendkey 向 macOS 虚拟机发送;Windows(KVM)已实现,通过 virsh send-key 向 KVM/QEMU 虚拟机发送。各平台有对应的 platform 文件,包含前置条件、核心模式、命令参考、编码参考、录制、排障与恢复。

与 tuistory 的关键差异:快照来源上,tuistory 用虚拟屏幕缓冲区,true-input 在 Linux 用清洗后的 PTY 日志、在虚拟机平台用截图;等待机制上,tuistory 事件驱动(屏幕重绘),true-input 在 Linux 轮询日志、在虚拟机平台基于 sleep;录制上,tuistory 必须包裹启动(--record),true-input 可随时开始/停止;键盘编码上,tuistory 为合成编码(绕过终端),true-input 走真实终端编码路径。

已知死路:Xvfb + xdotool 会完全绕过真实键盘处理;uinput + Xvfb 中 Xvfb 不消费内核输入设备;SSH 用于 TUI 测试会因 PTY 层扭曲输入编码,SSH 仅用于部署;直接调用 asciinema rec 无意义,true-input 通过 wf-recorder(Wayland 屏幕捕获)录制,应使用 tctl --record 或 tctl record start/stop。

使用方式与限制:该技能不是直接调用的工具,而是由编排器路由后按其机制执行计划;使用前需阅读目标操作系统的 platform 文件。资料未提供安装命令、价格与更多限制细节,暂未提供。