SuperAPI AI 工具集

platform-compatibility

部署与运维

查看项目

更新于 10-15 23:41

技能介绍

用途:当 TUI 需要跨操作系统、终端模拟器、复用器、SSH 会话、容器、CI 或嵌入式伪终端宿主运行时,使用本技能评估与设计兼容性。

主要能力:把终端能力视为一条链——应用库、OS 控制台或 PTY、shell、复用器、SSH 传输、终端模拟器、字体、主题与用户设置;只有每一环都保留某特性,它才可靠。除非应用掌控整个环境,否则把高级协议视为可选。

支持矩阵:需记录并测试 OS(Linux、macOS、Windows Terminal、经典 conhost、WSL、容器);终端模拟器(Terminal.app、iTerm2、Kitty、Alacritty、WezTerm、foot、GNOME Terminal/VTE、Konsole、Windows Terminal);复用器(tmux、GNU screen、Zellij);远程(SSH、类 mosh 链路、串行/慢速链路、跳板机、agent 转发策略);shell 与 locale(UTF-8 locale、Windows 代码页、TERM 与 terminfo);约束(最小尺寸、颜色级别、Unicode/ASCII 模式、鼠标/粘贴支持)。

平台规则:Windows 上区分 Windows Terminal/ConPTY 与旧控制台宿主,使用底层控制台 API 时启用虚拟终端处理,优先 UTF-8,必要时测试通过 ConPTY 托管子进程。类 Unix 系统处理 PTY 语义、SIGWINCH、termios raw/cbreak 恢复、进程信号与依赖 locale 的编码。macOS 上 Terminal.app 与 iTerm2 在专有协议、option 键行为、剪贴板/图像功能及默认颜色主题上存在差异。

复用器规则:tmux/screen/Zellij 可能重写 TERM、过滤 OSC/DCS、转换鼠标事件、介入备用屏幕,并需要 passthrough 包装器来支持剪贴板、图像、真彩色或键盘协议。始终在声称支持的复用器版本内外测试。优先使用文本回退,而非硬依赖 OSC 52、OSC 8、Kitty 图形、iTerm2 图像、焦点事件或扩展键盘协议。

远程规则:在 SSH 上减少写入量与光标抖动;合并 resize 风暴与高频指标;不要假设剪贴板、本地文件路径、图像协议或 agent 转发存在或被允许;提供低带宽、无鼠标、无动画、纯文本与批处理模式。

参考文件:references/emulator-platform-matrix.md 提供 OS、模拟器、PTY 与特性兼容指导;references/multiplexer-remote.md 提供 tmux/screen/Zellij、SSH、延迟、passthrough 与 resize 实践。

限制:资料未提供具体安装命令、收费信息或平台支持清单之外的实现细节。