SuperAPI AI 工具集

ai-coding-agents-surfaces

编程与开发

查看项目

更新于 10-16 07:17

技能介绍

用途:设计或评审编码智能体运行时与用户接触的界面层,即本地 CLI/终端 UI 与其背后可能远程执行的运行时之间的桥接、传输与审批路由。核心观点是终端 UI 与远程运行时属于同一设计问题:UI 渲染并控制它并不拥有的运行时状态,两者之间的线路必须承载带类型的控制流量。

主要能力:覆盖远程会话、桥接传输、仅查看客户端、SSH 式“本地 UI、远程工具”流程、REPL 结构、提示输入、消息渲染、命令队列、虚拟化历史、中断、通知与后台任务导航。提供远程运行时模型、桥接传输与权限桥接、传输选择(WebSocket/SSE/HTTP POST/ACP stdio)、带序列号重连、ACP 编辑器传输与智能体委派、Codex app-server 生命周期与协议代码生成、REPL 消息输入与历史、后台工作通知与虚拟化、输入状态机、ToolSearch 渲染、TUI 快照模式等参考文件。

使用方式:先定义共享会话契约、运行时模式与宿主拥有的 REPL 状态机;将带类型控制消息与转录消息分开实现;搭建读写传输;加入带稳定 ID 与取消的权限请求路由;加入重连与恢复;加入后台任务导航与通知;为长历史加入虚拟化;为远程专属工具加入本地合成渲染及远程、无头、仅查看的降级规则。

适用场景:设计带本地 CLI 前端的远程编码智能体会话;构建桥接或直连传输、仅查看客户端或编辑器 ACP 集成;将远程执行的权限请求路由回本地 UI;设计终端优先的 REPL、提示输入、历史、搜索、中断与通知;添加后台任务界面、队友导航或任务详情对话框;用虚拟化或延迟更新改善大会话渲染;将交互式 UI 行为与无头、远程或 SDK 行为分离。

限制:不涉及通用桌面应用 UX;会话持久化、恢复与后台任务运行时设计应使用 ai-coding-agents-state;工具审批系统设计使用 ai-coding-agents-safety-envelope;插件架构使用 ai-coding-agents-plugins;云沙箱隔离使用 ai-coding-agents-cloud-sandboxes;通用 UI/UX 设计使用 software-ui-ux-design。远程控制功能可能被组织策略关闭或在零数据保留安排下不可用,依赖前需查阅厂商当前文档。内部运行时模式(REPL 所有权、虚拟滚动)为示意性设计指导,非已记录的产品行为。