Ordo UI
AI助手与对话

AssistantOpeningReport

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

assistant-opening-report@mox-hub/patternsAI Executioncanonicalsrc/components/assistant-opening-report.tsx
变体演示assistant-opening-report

项目现状

我是小码,你的项目管理搭档。先看一眼今天的现状:

5待决2阻断3排队

Props API

Prop类型默认值说明
status*AssistantOpeningStatus——
personaName*string——
labels*Partial<AssistantOpeningReportLabels>——

源码

packages/patterns/src/components/assistant-opening-report.tsx
/**
 * 早报区 —— 主 AI「先开口」的确定性拼接(不依赖 LLM,LLM 文案记入 roadmap)。
 * 自我介绍一行 + 待决现状统计,让用户第一动作是「看和选」而非面对空白输入框。
 */
import { Sparkles } from 'lucide-react'
import { cn } from '@mox-hub/ui'
import { usePatternLabels } from '../lib/i18n'

/** 早报只需要三个计数字段;完整 AssistantStatus 结构兼容传入。 */
export interface AssistantOpeningStatus {
  pending: number
  blocking: number
  advisory: number
}

/** 组件内文案缺省(中文常量;消费方经 labels 覆写接入 i18n)。 */
export interface AssistantOpeningReportLabels {
  title: string
  /** 自我介绍模板,`{{name}}` 替换为 personaName */
  intro: string
  pending: string
  blocking: string
  advisory: string
}

export const ASSISTANT_OPENING_REPORT_DEFAULT_LABELS: AssistantOpeningReportLabels = {
  title: '项目现状',
  intro: '我是{{name}},你的项目管理搭档。先看一眼今天的现状:',
  pending: '待决',
  blocking: '阻断',
  advisory: '排队',
}

export interface AssistantOpeningReportProps {
  status: AssistantOpeningStatus
  personaName: string
  /** 文案覆写(默认 zh-CN;主仓 i18n 适配层集中传入 t() 结果)。 */
  labels?: Partial<AssistantOpeningReportLabels>
}

export function AssistantOpeningReport({
  status,
  personaName,
  labels,
}: AssistantOpeningReportProps) {
  const D = usePatternLabels(
    'assistantOpeningReport',
    ASSISTANT_OPENING_REPORT_DEFAULT_LABELS,
  )
  const title = labels?.title ?? D.title
  const introTemplate = labels?.intro ?? D.intro
  const intro = introTemplate.replace(/\{\{name\}\}/g, personaName)

  const stats: Array<{ label: string; value: number; tone: string }> = [
    {
      label: labels?.pending ?? D.pending,
      value: status.pending,
      tone: 'text-content-text-secondary',
    },
    {
      label: labels?.blocking ?? D.blocking,
      value: status.blocking,
      tone: status.blocking > 0 ? 'text-accent-red' : 'text-content-text-secondary',
    },
    {
      label: labels?.advisory ?? D.advisory,
      value: status.advisory,
      tone: status.advisory > 0 ? 'text-accent-yellow' : 'text-content-text-secondary',
    },
  ]

  return (
    <section
      className="space-y-2 rounded-xl border border-border bg-content-bg-secondary/50 p-3"
      data-ai-component="assistant.opening-report"
    >
      <div className="flex items-center gap-2">
        <Sparkles className="size-3.5 text-accent-purple" />
        <p className="text-xs font-semibold text-content-text">{title}</p>
      </div>
      <p className="text-xs text-content-text-secondary">{intro}</p>
      <div className="flex items-center gap-2">
        {stats.map((stat) => (
          <span
            key={stat.label}
            className={cn(
              'inline-flex items-center gap-1 rounded-full border border-border bg-background px-2 py-0.5 text-xs tabular-nums',
              stat.tone,
            )}
          >
            <span className="font-semibold">{stat.value}</span>
            {stat.label}
          </span>
        ))}
      </div>
    </section>
  )
}

可访问性与 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 助理早报:自我介绍 + 待决/阻断/排队三计数;labels 覆写文案,计数结构兼容完整 AssistantStatus。