用途:设计或评审编码智能体运行时的终端优先用户体验,包括 REPL 结构、提示输入、消息渲染、命令队列、虚拟化历史、中断行为、通知和后台任务导航。它面向终端交互模式,而非通用桌面应用 UX。
主要能力:提供 REPL 与提示/历史设计参考、后台任务与通知及虚拟化参考、输入状态机(含转移表与键位规则)、ToolSearch 延迟工具结果的渲染配方,以及 OpenAI Codex TUI 状态面与快照模式参考。状态机区分 idle、editing、running、search、overlay、teammate view、remote/viewer 等状态,动作含 submit、interrupt、前台化任务、终止任务、搜索、回退、恢复。
使用方式:将 REPL 作为宿主持有的状态机,提示输入、消息历史、后台任务与浮层共用同一会话模型;分离转录数据与渲染策略;为高频信号设独立存储;把中断行为当作一等 UX;让后台工作可导航。构建顺序为先定义 REPL 状态机,再分离转录与渲染状态,然后加入提示输入持久化、后台任务导航与通知、长历史虚拟化,最后加入远程/无头/仅查看的降级规则。
适用场景:终端优先编码智能体 REPL 或提示 UI 设计;消息历史、搜索、回退与中断行为决策;后台任务面、队友导航或任务详情对话框;大会话渲染优化;区分交互 UI 与无头或 SDK 行为。
限制与陷阱:UI 不应成为运行时无法恢复的语义会话状态唯一所有者;长历史性能应靠虚拟化而非静默截断语义历史;避免进入搜索、浮层或队友视图时丢失提示输入;避免把所有 UI 状态合并到同一 escape 路径。资料还给出框架选择参考:Ink 6 + React 19、Ratatui、Bubble Tea v2、OpenTUI,并说明 Goose 双表面共享 ACP 守护进程、Claude Code 状态行与键位细节。部分内容基于 2026 年内部快照,属示意性设计指导而非已发布产品行为。具体版本与平台可用性请以官方文档为准。