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 | — | — |
源码
/**
* 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/translatorprops,其次用I18nProvider目录;内置 zh-CN 默认值,en-US 为参考翻译。见Theming · i18n 与 RTL。 - 对比度:高对比度 token、2px 控件边框与 3px 焦点环由主题层统一提供,见Foundations · Contrast。
用法说明
AI 助理面板布局壳:待决挂条槽 + 主面板外框 + 人格/状态头部 + 头部动作槽;会话与批阅编排留在主仓。