OpenAgentPack Kit
组件

页面组合与辅助交互

侧栏与页头组合、状态灯、子线程、空错态与确认弹窗

pnpm kit:add chrome 复制页面组合与辅助交互组件,并带出所依赖的 AgentHeader、Message 与 EmptyState / ErrorState;会话目录 SessionSidebar 按独立条目复制。 完整骨架还组合 Layout 与 Chat,示例问题使用 Prompts:

pnpm kit:add layout
pnpm kit:add chrome
pnpm kit:add chat
pnpm kit:add prompts

何时使用

  • 按 antdx 骨架组装完整页面:会话目录、紧凑页头与聊天区一次到位。
  • 页面里有删除 / 归档等破坏性动作,需要确认弹窗与服务端一次性确认令牌。
  • 空目录、请求失败等占位态需要统一视觉,不散写占位文案。

代码演示

页面骨架(含破坏性动作确认)

选中会话、新建会话,经行尾「更多操作」菜单触发归档 / 删除确认弹窗。

Layout / AgentHeader / ConfirmDialog

两条硬约束:

  1. 破坏性动作必须 ConfirmDialog(role="alertdialog")语义,服务端再校验一次性确认令牌 (POST .../plan → 带 confirm_token 执行,缺令牌 400 / 重放 428)。
  2. 行内操作不能按钮嵌按钮:真实点击归最外层元素,内层按钮点不动(合成 el.click() 能触发, 只有真机抓得到);SessionList 行容器是 div,标题按钮与 menu 触发器是并列 button, 动作在 Menu 弹层内。

状态灯

phase 与 connection 组合区分已连接、生成中、等待审批、正在停止、已中断、重连中与错误。

StatusIndicator(连接 / 流式 / 错误)

新接入传 phase={chat.phase}、connection={chat.connection}、error={chat.streamError}; variant="badge" 适合页头,长错误截断显示,完整内容保留在 role="status" 文本中。

子线程兼容面板

面向既有 threads: Record<string, ChatMessage[]> 投影的只读兼容组件。

ThreadPanel(旧版分组兼容)

复用 Message 渲染各分片,可传 onArtifactDownload / onCopy;不发现 Agent、不查历史、不分页。 新对话页用 Chat 的 multiAgent,不要塞进审批插槽。

欢迎、加载与错误态

目录为空、请求失败、agent 未上架都走这两个组件。

EmptyState / ErrorState

聊天欢迎态把 EmptyState 与 Prompts 放同一容器整体居中, 输入框保持挂载;ErrorState 传 onRetry 显示重试按钮。

API

StatusIndicator

属性说明类型默认值
connected是否已建立连接;旧接入 props,新接入改传 connectionboolean—
turnRunning当前 Turn 是否在生成;与 phase 并存的旧 propsboolean—
phaseTurn 阶段,优先于由 turnRunning 推导"idle" | "running" | "requires_action" | "stopping" | "failed" | "interrupted"—
connection连接状态;connecting / reconnecting 提示覆盖暂存错误"disconnected" | "connecting" | "connected" | "reconnecting"—
error流错误,与错误模型同一套 code{ code: string; message: string } | null—
variantbadge 在保留状态文本的同时提供紧凑徽标,适合空间受限的页头"default" | "badge""default"

状态优先级:phase(缺省时由 turnRunning 推导)决定基础状态;connecting / reconnecting 覆盖显示重连提示;其余错误在非重连时优先显示。

ThreadPanel

属性说明类型默认值
threads线程 id 到消息数组的映射;空记录整体不渲染Record<string, ChatMessage[]>—
onArtifactDownload透传给 Message 的产物下载回调(fileId: string) => void—
onCopy透传给 Message 的复制回调(text: string) => void | Promise<void>—

ConfirmDialog

属性说明类型默认值
title操作标题string—
body弹窗正文,通常放真实 plan diffstring—
confirmLabel确认按钮文案string"确认"
cancelLabel取消按钮文案string"取消"
danger危险语义的确认按钮booleantrue
busy执行中禁用确认、取消和 Escapebooleanfalse
onConfirm实际执行;成功后由调用方关闭弹窗() => void—
onCancel取消回调() => void—

移动抽屉内发起的确认经 Layout 的 dialogs 插槽 渲染,待确认状态归调用方所有。

EmptyState

属性说明类型默认值
title状态标题或开场文案string—
hint补充说明string—
loading显示低强调进度标记,并用 role="status" 表达加载状态booleanfalse

ErrorState

属性说明类型默认值
message完整错误说明,支持换行string—
onRetry由调用方重新加载或恢复() => void—

主题变量(Design Token)

引入 @openagentpack/kit-chat-ui/theme.css 后使用以下冻结 token。下表列出亮色值, 暗色由 data-kit-theme="dark" 使用对应色板。

Token用途默认主题工作区主题
--kit-accent生成中、连接中与重连中的状态色;中性确认按钮底色#4f46e5#171717
--kit-danger失败、中断与错误状态色;危险确认按钮底色;ErrorState 图标与标题#dc2626#ad372f
--kit-accent-fg / --kit-danger-fg确认按钮文字#ffffff#ffffff
--kit-warning-fg等待审批状态色#b45309#805917
--kit-fg-muted空闲与停止状态色;说明文字与弹窗正文#5b6478#737373
--kit-bg-subtlebadge 与 ThreadPanel 底色;EmptyState 加载标记底#f6f7fb#f7f7f7
--kit-borderThreadPanel 与弹窗描边;取消按钮描边#e3e6ef#e5e5e5
--kit-border-subtlebadge 描边;ErrorState 描边;默认主题下等于 --kit-border#e3e6ef#ececec
--kit-surface弹窗与重试按钮底色#ffffff#ffffff
--kit-overlay弹窗遮罩rgb(0 0 0 / 40%)rgb(23 23 23 / 32%)
--kit-shadow弹窗投影0 8px 28px rgb(16 19 34 / 8%)0 4px 20px rgb(23 23 23 / 6%), 0 1px 4px rgb(23 23 23 / 4%)

badge 圆点闪动消费 Tailwind 内建 motion-safe:animate-pulse,遵循系统减少动画偏好; 焦点环走 --kit-focus(默认等于 --kit-accent);标题与说明使用 --kit-text-title / --kit-text-heading / --kit-text-label / --kit-text-caption 文字档位,弹窗与 ThreadPanel 圆角为 --kit-radius / --kit-radius-sm。更多主题配置见 组件总览。

本页目录