AI助手与对话
AssistantColleagueSlot
@mox-hub/patterns · AI · 助手与对话 · canonical
assistant-colleague-slot@mox-hub/patternsAI Executioncanonicalsrc/components/assistant-colleague-slot.tsx变体演示assistant-colleague-slot
Props API
| Prop | 类型 | 默认值 | 说明 |
|---|---|---|---|
| collapsed* | boolean | — | — |
| state* | AssistantStatusState | — | — |
| pending* | number | — | — |
| personaName* | string | — | — |
| onOpen* | () => void | — | — |
| labels* | Partial<AssistantColleagueSlotLabels> | — | — |
源码
/**
* 侧栏同事位 —— 主 AI 以「人」的身份占侧栏底部一个位置:
* 头像 + 状态点 + 待决数;点击走进办公室(门语义,办公室页是这扇门后的屋子)。
*
* 库内是纯展示件:状态、待决数与打开动作由 props 注入;
* ordo 侧保留 useAssistantStatus + useNavigate 的薄适配层。
*/
import { Bot } from 'lucide-react'
import { cn } from '@mox-hub/ui'
import { usePatternLabels } from '../lib/i18n'
import {
AssistantStatusDot,
STATE_TEXT,
type AssistantStatusState,
} from './assistant-status-dot'
/** 组件内文案缺省(中文常量;消费方经 labels 覆写接入 i18n)。 */
export interface AssistantColleagueSlotLabels {
personaName: string
open: string
status: Record<AssistantStatusState, string>
}
export const ASSISTANT_COLLEAGUE_SLOT_DEFAULT_LABELS: AssistantColleagueSlotLabels = {
personaName: '小周',
open: '主 AI 助手',
status: {
needYou: '需要你',
working: '工作中',
suggestions: '有建议',
idle: '空闲',
},
}
export interface AssistantColleagueSlotProps {
/** 侧栏是否收起(收起态只留头像 + 角标) */
collapsed: boolean
/** AI 同事四态 */
state: AssistantStatusState
/** 待决数(needYou 时显示角标) */
pending: number
/** 覆盖默认 personaName */
personaName?: string
/** 点击走进办公室 / 打开主面板 */
onOpen: () => void
/** 文案覆写(默认 zh-CN;主仓 i18n 适配层集中传入 t() 结果)。 */
labels?: Partial<AssistantColleagueSlotLabels>
}
export function AssistantColleagueSlot({
collapsed,
state,
pending,
personaName,
onOpen,
labels,
}: AssistantColleagueSlotProps) {
const D = usePatternLabels(
'assistantColleagueSlot',
ASSISTANT_COLLEAGUE_SLOT_DEFAULT_LABELS,
)
const name = personaName ?? labels?.personaName ?? D.personaName
const openLabel = labels?.open ?? D.open
const statusLabel = labels?.status?.[state] ?? D.status[state]
const active = state === 'needYou'
if (collapsed) {
return (
<button
type="button"
onClick={onOpen}
className="relative flex w-full items-center justify-center rounded-lg p-2 transition-colors hover:bg-sidebar-accent/80"
aria-label={openLabel}
data-ai-component="assistant.colleague-slot"
data-ai-action="assistant.colleague.office.click"
>
<span className="flex size-7 items-center justify-center rounded-lg bg-accent-purple-light text-accent-purple">
<Bot className="size-4" />
</span>
<AssistantStatusDot
state={state}
className="absolute end-1.5 top-1.5 ring-2 ring-sidebar"
/>
</button>
)
}
return (
<button
type="button"
onClick={onOpen}
className="flex w-full items-center gap-2 rounded-lg px-2 py-1.5 transition-colors hover:bg-sidebar-accent/80"
data-ai-component="assistant.colleague-slot"
data-ai-action="assistant.colleague.office.click"
>
<span className="relative flex size-7 shrink-0 items-center justify-center rounded-lg bg-accent-purple-light text-accent-purple">
<Bot className="size-4" />
<AssistantStatusDot
state={state}
className="absolute -end-0.5 -top-0.5 ring-2 ring-sidebar"
/>
</span>
<span className="min-w-0 flex-1 text-start">
<span className="block truncate text-sm font-medium text-sidebar-foreground">
{name}
</span>
<span className={cn('block truncate text-2xs', STATE_TEXT[state])}>
{statusLabel}
</span>
</span>
{active && pending > 0 && (
<span className="inline-flex h-4 min-w-4 shrink-0 items-center justify-center rounded-full bg-sidebar-primary px-1.5 text-3xs font-semibold text-primary-foreground tabular-nums">
{pending > 99 ? '99+' : pending}
</span>
)}
</button>
)
}
可访问性与 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 同事位:头像 + 四态状态点 + 待决角标;collapsed 只留头像,点击动作由 onOpen 注入。