Ordo UI
AI助手与对话

AssistantPanel

@mox-hub/patterns · AI · 助手与对话 · canonical

assistant-panel@mox-hub/patternsAI Executioncanonicalsrc/components/assistant-panel-layout.tsx
变体演示assistant-panel
待决 2

小周

工作中项目管理搭档

消息区与输入区(由消费方注入)

Props API

Prop类型默认值说明
expanded*boolean——
personaName*string——
statusState*AssistantStatusState——
statusLabel*string——
personaRole*string——
decisionTab*ReactNode——
headerActions*ReactNode——
children*ReactNode——
reviewModal*ReactNode——
className*string——

源码

packages/patterns/src/components/assistant-panel-layout.tsx
/**
 * AI 助理面板布局壳 —— 待决挂条 + 主对话面板外框 + 头部人格/状态区。
 *
 * 库内只负责布局与头部呈现;会话、流式消息、决策批阅、历史菜单、放大/关闭
 * 等编排逻辑全部由消费方注入(ordo 侧保留完整 AssistantPanel 编排层)。
 */
import type { ReactNode } from 'react'
import { Bot } from 'lucide-react'
import { cn } from '@mox-hub/ui'
import { AssistantStatusDot, STATE_TEXT } from './assistant-status-dot'

export interface AssistantPanelLayoutProps {
  /** 放大态:主面板 flex-1;否则固定 480px 档 */
  expanded: boolean
  personaName: string
  /** AI 同事四态 */
  statusState: import('./assistant-status-dot').AssistantStatusState
  /** 状态文案(已翻译/已本地化) */
  statusLabel: string
  /** 角色说明(如「项目管理搭档」) */
  personaRole: string
  /** 左侧待决卡片挂条 */
  decisionTab?: ReactNode
  /** 头部右侧动作(历史/放大/关闭等) */
  headerActions?: ReactNode
  /** 面板主体(消息区 + 输入区) */
  children: ReactNode
  /** 全屏批阅遮罩等 Portal 节点 */
  reviewModal?: ReactNode
  className?: string
}

export function AssistantPanelLayout({
  expanded,
  personaName,
  statusState,
  statusLabel,
  personaRole,
  decisionTab,
  headerActions,
  children,
  reviewModal,
  className,
}: AssistantPanelLayoutProps) {
  return (
    <div
      className="flex h-full w-full items-stretch justify-center gap-3"
      data-ai-component="assistant.panel-wrapper"
    >
      {decisionTab}

      <div
        className={cn(
          'relative flex flex-col overflow-hidden rounded-xl border border-(--panel-strong-border) bg-(--panel-strong-bg) shadow-xs backdrop-blur-(--panel-strong-blur)',
          expanded ? 'flex-1 min-w-0' : 'w-120 max-w-[calc(100vw-2rem)]',
          className,
        )}
        data-ai-component="assistant.panel"
      >
        <div className="flex h-12 shrink-0 items-center gap-2 border-b border-border px-3">
          <span className="flex size-8 shrink-0 items-center justify-center rounded-lg bg-accent-purple-light text-accent-purple">
            <Bot className="size-4.5" />
          </span>
          <div className="min-w-0 flex-1">
            <p className="truncate text-sm font-semibold text-content-text">{personaName}</p>
            <p className="flex items-center gap-1.5 truncate text-xs text-content-text-muted">
              <AssistantStatusDot state={statusState} />
              <span className={STATE_TEXT[statusState]}>{statusLabel}</span>
              <span aria-hidden="true">·</span>
              <span className="truncate">{personaRole}</span>
            </p>
          </div>
          {headerActions}
        </div>

        {children}
      </div>

      {reviewModal}
    </div>
  )
}

可访问性与 RTL

  • 键盘:交互件保留:focus-visible焦点环;浮层支持 Escape 关闭与焦点归还,菜单 / 页签按 Base UI 约定支持方向键。 筛选菜单、拖拽排序、执行树与模型 listbox 等关键键盘流由 Playwright 断言覆盖,见规范示例 · 交互与可访问性。
  • RTL:间距、对齐与方向性图标使用逻辑属性 (ms-* /text-start /rtl:-scale-x-100);通过 ThemeProvider 或I18nProvider 的direction="rtl"驱动,`lint:rtl` 会拦截新增物理类。
  • 文案:优先用组件labels /translate /translator props,其次用I18nProvider目录;内置 zh-CN 默认值,en-US 为参考翻译。见Theming · i18n 与 RTL。
  • 对比度:高对比度 token、2px 控件边框与 3px 焦点环由主题层统一提供,见Foundations · Contrast。

用法说明

AI 助理面板布局壳:待决挂条槽 + 主面板外框 + 人格/状态头部 + 头部动作槽;会话与批阅编排留在主仓。