Appearance
引用索引
本页是 Agent UI 的 traceability register。修改规范、验收场景或 schema 时，使用下列 source id 追溯依据。标准可以吸收这些来源的稳定模式，但不复制它们的 API。
最后复核日期：2026-05-11。
引用格式
设计记录或变更记录中使用：
text
[SRC-ID] -> 变更的 requirement 或 behavior示例：
text
[SRC-AI-SDK-PARTS] 支持 ordered typed message parts；Agent UI 要求 active-run part order preservation。外部来源
| Source id | Source | Evidence used | Agent UI requirements informed |
|---|---|---|---|
SRC-AGENTSKILLS-SPEC | Agent Skills specification | 简洁协议写法：directory/field tables、constraints、examples、progressive disclosure、validation。 | Agent UI 规范页应使用显式字段、约束、最小示例与 validation checklists。 |
SRC-AGUI-EVENTS | AG-UI Events | Streaming event categories、base event properties、run lifecycle、text message streaming、tool/state/activity event categories。 | Agent UI 应分类 lifecycle、text、tool、state、activity 与 special events，而不是只把 transcript 当唯一 stream。 |
SRC-AI-SDK-PARTS | Vercel AI SDK UIMessage | UIMessage 使用 parts 承载 UI 渲染和 metadata。 | Message parts 是 typed 与 ordered；最终回答文本不能吸收 process facts。 |
SRC-AI-SDK-V5-TOOLS | Vercel AI SDK 5.0 migration guide | Tool states 包含 input streaming、input available、output available、output error 等更细生命周期。 | Tool lifecycle 需要 input/progress/output/error states，并在 running 时 live rendering。 |
SRC-ASSISTANT-UI-PARTS | assistant-ui MessagePrimitive.Parts | Message parts 可按 text、reasoning、audio、tool-call、data 类型渲染。 | Client 需要 typed part renderers 与 fallback。 |
SRC-ASSISTANT-UI-COT | assistant-ui Chain of Thought guide | Reasoning 与 tool-call parts 可以被分组，但底层 part model 仍存在。 | Reasoning/tool grouping 是 projection mode；不能重排或重复 active facts。 |
SRC-LANGGRAPH-STREAMING | LangGraph JS streaming | Stream modes 包含 updates、messages、custom、tools、debug；tool events 包含 start、progress、end、error。 | Agent UI 应支持多 stream modes、typed tool events、progress 与 diagnostics。 |
SRC-LANGGRAPH-INTERRUPTS | LangGraph interrupts | Workflow 可暂停等待 human review，并用 structured command resume。 | Human-in-the-loop actions 需要 stable ids、visible pending state 与 controlled resume。 |
SRC-OPENAI-CHATKIT-THREAD-EVENTS | OpenAI ChatKit thread stream events | Thread metadata events、thread item added/updated/done/removed/replaced events、progress updates、client effects、stream options。 | Session/thread metadata、item lifecycle、transient progress 和 cancel options 应是一等 projection facts。 |
SRC-OPENAI-APPS-SDK | OpenAI Apps SDK reference | Tool descriptors、structured tool results、component resources、widget bridge concepts。 | Rich tool UI 应挂在 structured tool/component boundaries 上，而不是从 assistant text 推断。 |
SRC-COPILOTKIT | CopilotKit docs | Frontend actions、generative UI、shared state 与 human-in-the-loop patterns。 | UI tools 与 shared state updates 需要 controlled runtime boundaries。 |
SRC-CLAUDE-ARTIFACTS | Claude Artifacts help | 重要生成内容会在主对话外的 dedicated artifact area 打开。 | Durable deliverables 属于 Artifact Workspace，conversation 中只保留 reference。 |
SRC-A2A-PROTOCOL | Agent2Agent Protocol specification | Agent Card、task lifecycle、messages、parts、artifacts、input-required/auth-required 风格的 remote progress。 | Remote teammates 应把 remote agent/task truth 映射到 Agent UI surfaces，而不是替代本地 runtime owner model。 |
SRC-PAPERCLIP-HEARTBEAT | Paperclip heartbeat protocol | Background wake/sleep、heartbeat、task/background coordination patterns。 | Background agent work 应作为 scheduled/triggered teammate work；Paperclip 风格的 hierarchy language 不是 Agent UI 规范隐喻。 |
SRC-VITEPRESS-PUBLIC | VitePress asset handling and deploy docs | public 目录 assets 会复制到站点根，仓库 base path 部署需要 base-aware URLs。 | 独立可运行 demo 放在 docs/public/examples/，docs 页面只链接，不嵌入 demo 组件。 |
本地实现调研
以下本地来源用于 drafting flow taxonomy 的实现参考。它们不是公开 normative dependency，但解释了桌面工作台为什么需要这些 UI 行为。
| Source id | Local source | Evidence used | Agent UI requirements informed |
|---|---|---|---|
SRC-LIME-ROADMAP-AGENTUI | Lime docs/roadmap/agentui/ | Conversation/process/task/artifact/evidence 架构、event flow、hydration 与 performance constraints。 | Agent UI 应覆盖完整工作台流程，而不只是 thinking blocks。 |
SRC-CODEX-PROTOCOL | 本地 OpenAI Codex checkout：codex-rs/docs/protocol_v1.md 与 app-server protocol schema | Turn lifecycle、text deltas、plan deltas、approval/input requests、command output deltas、typed thread item categories。 | 标准 taxonomy 应包含 plan、reasoning、command execution、file changes、MCP/dynamic tools、web search、image view/generation、review mode、context compaction 与 collaborative agent calls。 |
SRC-CLAUDECODE-LOCAL | 本地 Claude Code checkout：message adapter 与 message rendering components | Streaming assistant content blocks、thinking visibility policy、tool progress、tool result grouping、compact boundary handling。 | Active thinking/tool progress 应保持可见，completed history 应降噪，tool results 不应污染 final text。 |
SRC-CLAUDECODE-TEAM | 本地 Claude Code checkout：src/Task.ts、src/coordinator/coordinatorMode.ts、src/tasks/InProcessTeammateTask/types.ts、src/tasks/LocalAgentTask/LocalAgentTask.tsx、src/tasks/RemoteAgentTask/RemoteAgentTask.tsx、SDK hook schemas。 | Task types 包含 local/remote agents 与 in-process teammates；coordinator mode 把 worker results 视为内部通知；teammate identity 携带 agentId、agentName、teamName、color、parent session、plan approval、permission、recent messages、pending user messages、idle/shutdown/progress。 | Agent UI v0.6 标准化 team roster、worker notifications、teammate transcript zoom、delegated plan/permission prompts、parent/child lineage，以及 coordinator synthesis 与 worker result 分离。 |
SRC-CODEX-COLLAB | 本地 Codex checkout：codex-rs/tui/src/multi_agents.rs、codex-rs/protocol/src/protocol.rs、codex-rs/app-server-protocol/src/protocol/event_mapping.rs、codex-rs/analytics/src/*。 | Collaborative tools 包含 spawn/send/resume/wait/close；TUI 渲染 spawned/sent/waiting/closed history rows；subagents 跟踪 source、parent thread id、nickname、role、depth；delegated approvals 与 subagent tool-call counts 被追踪。 | Agent UI v0.6 新增 delegate/continue/wait/stop/close controls、parent/child thread metadata、delegated approval source 与 parallel worker fanout/fanin surfaces。 |
SRC-LIME-TEAM-RUNTIME | Lime checkout：docs/aiprompts/task-agent-taxonomy.md、docs/aiprompts/state-history-telemetry.md、src-tauri/src/commands/aster_agent_cmd/subagent_runtime.rs、src-tauri/crates/agent/src/session_store.rs、src/components/agent/chat/teamWorkspaceRuntime.ts、src/lib/teamMemorySync.ts。 | Lime 将执行分类收敛为 agent turn、subagent turn 与 automation job；child subagent sessions 暴露 role、profile、team preset、runtime status、queue 与 team phase；request telemetry 通过 session/thread/turn/pending/queued/subagent keys 关联；team memory 使用 repo-scoped team.selection、team.subagents、team.parent_context。 | Agent UI v0.6 与 Lime 对齐：把 teammates 视为 child sessions/workbench facts，保留 request/session lineage，携带 runtimeEntity/queue/parallelism facts，并把 background work 收敛在 agent/subagent/automation 边界内，而不是创造第四类 runtime taxonomy。 |
SRC-LIME-AGENTRUNTIME-PROFILE | AgentRuntime project：docs/zh/profiles/lime.md、docs/public/schemas/agentruntime-lime-profile-*.schema.json 与 docs/public/fixtures/lime-profile/。 | Lime AgentRuntime Profile 把执行事实主链固定为 RuntimeEvent、ThreadReadModel、TaskSnapshot、evidence export、runtime ids、tool approval、task retry、routing 与 known-gap evidence behavior。 | Agent UI 必须投影 Agent Runtime facts，而不能成为 UI-owned truth source；runtime profile 测试用例验证 id preservation、read model projection、action controls、evidence/replay/review consistency 与 hydration。 |
Requirement traceability
| Requirement area | Primary sources |
|---|---|
| Ordered message parts | SRC-AI-SDK-PARTS、SRC-ASSISTANT-UI-PARTS、SRC-ASSISTANT-UI-COT、SRC-CODEX-PROTOCOL |
| Running process visible, completed process archived | SRC-CLAUDECODE-LOCAL、SRC-CODEX-PROTOCOL、SRC-AI-SDK-V5-TOOLS |
| Tool lifecycle and progress | SRC-AI-SDK-V5-TOOLS、SRC-LANGGRAPH-STREAMING、SRC-OPENAI-CHATKIT-THREAD-EVENTS |
| Human-in-the-loop actions | SRC-LANGGRAPH-INTERRUPTS、SRC-CODEX-PROTOCOL、SRC-COPILOTKIT |
| Session/thread hydration | SRC-OPENAI-CHATKIT-THREAD-EVENTS、SRC-LIME-ROADMAP-AGENTUI、SRC-CODEX-PROTOCOL |
| Artifact workspace | SRC-CLAUDE-ARTIFACTS、SRC-OPENAI-APPS-SDK、SRC-LIME-ROADMAP-AGENTUI |
| Evidence/timeline/replay | SRC-LIME-ROADMAP-AGENTUI、SRC-CODEX-PROTOCOL、SRC-LIME-AGENTRUNTIME-PROFILE |
| Runtime profile projection tests | SRC-LIME-AGENTRUNTIME-PROFILE、SRC-LIME-TEAM-RUNTIME、SRC-LIME-ROADMAP-AGENTUI |
| Spec writing style | SRC-AGENTSKILLS-SPEC |
| Team workbench 与 teammate identity | SRC-CLAUDECODE-TEAM、SRC-CODEX-COLLAB、SRC-LIME-TEAM-RUNTIME |
| Remote teammate mapping | SRC-A2A-PROTOCOL、SRC-CLAUDECODE-TEAM |
| Background teammate mapping | SRC-PAPERCLIP-HEARTBEAT、SRC-LIME-TEAM-RUNTIME |
| Standalone runnable examples | SRC-VITEPRESS-PUBLIC |