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> | — | — |
源码
/**
* 早报区 —— 主 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/translatorprops,其次用I18nProvider目录;内置 zh-CN 默认值,en-US 为参考翻译。见Theming · i18n 与 RTL。 - 对比度:高对比度 token、2px 控件边框与 3px 焦点环由主题层统一提供,见Foundations · Contrast。
用法说明
AI 助理早报:自我介绍 + 待决/阻断/排队三计数;labels 覆写文案,计数结构兼容完整 AssistantStatus。