Ordo UI
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>——

源码

packages/patterns/src/components/assistant-colleague-slot.tsx
/**
 * 侧栏同事位 —— 主 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 /translator props,其次用I18nProvider目录;内置 zh-CN 默认值,en-US 为参考翻译。见Theming · i18n 与 RTL。
  • 对比度:高对比度 token、2px 控件边框与 3px 焦点环由主题层统一提供,见Foundations · Contrast。

用法说明

侧栏 AI 同事位:头像 + 四态状态点 + 待决角标;collapsed 只留头像,点击动作由 onOpen 注入。