AI助手与对话
AssistantContextChip
@mox-hub/patterns · AI · 助手与对话 · canonical
assistant-context-chip@mox-hub/patternsAI Executioncanonicalsrc/components/assistant-context-chip.tsx变体演示assistant-context-chip
任务 · TASK-1234
Props API
| Prop | 类型 | 默认值 | 说明 |
|---|---|---|---|
| type* | AssistantContextType | — | — |
| title* | string | — | — |
| onRemove* | () => void | — | — |
| labels* | Partial<AssistantContextChipLabels> | — | — |
源码
/**
* 上下文注入 chip —— 展示当前「正在查看」的实体(详情页自动上报),
* 用户可一键移除(提前告知语义:移除后随消息附带的上下文即取消)。
*
* 库内是纯展示件:实体类型/标题/移除动作由 props 注入;
* ordo 侧保留 useAppStore 的薄适配层。
*/
import { Eye, X } from 'lucide-react'
import { usePatternLabels } from '../lib/i18n'
export type AssistantContextType =
| 'task'
| 'bug'
| 'document'
| 'repository'
| 'member'
| 'project'
/** 组件内文案缺省(中文常量;消费方经 labels 覆写接入 i18n)。 */
export interface AssistantContextChipLabels {
type: Record<AssistantContextType, string>
remove: string
}
export const ASSISTANT_CONTEXT_CHIP_DEFAULT_LABELS: AssistantContextChipLabels = {
type: {
task: '任务',
bug: '缺陷',
document: '文档',
repository: '仓库',
member: '成员',
project: '项目',
},
remove: '不再附带此上下文',
}
export interface AssistantContextChipProps {
type: AssistantContextType
title: string
onRemove: () => void
/** 文案覆写(默认 zh-CN;主仓 i18n 适配层集中传入 t() 结果)。 */
labels?: Partial<AssistantContextChipLabels>
}
export function AssistantContextChip({
type,
title,
onRemove,
labels,
}: AssistantContextChipProps) {
const D = usePatternLabels(
'assistantContextChip',
ASSISTANT_CONTEXT_CHIP_DEFAULT_LABELS,
)
const typeLabel = labels?.type?.[type] ?? D.type[type]
const removeLabel = labels?.remove ?? D.remove
const label = [typeLabel, title].filter(Boolean).join(' · ')
return (
<div
className="flex items-center gap-1.5 rounded-md border border-border bg-content-bg-secondary px-2 py-1 text-2xs text-content-text-muted"
data-ai-component="assistant.context-chip"
>
<Eye className="size-3 shrink-0 text-accent-purple" />
<span className="truncate">{label}</span>
<button
type="button"
onClick={onRemove}
className="shrink-0 rounded-sm p-0.5 hover:bg-muted"
aria-label={removeLabel}
data-ai-action="assistant.context.remove.click"
>
<X className="size-3" />
</button>
</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。
用法说明
上下文注入 chip:展示当前查看实体(类型 + 标题)并可一键移除;labels 覆写类型名/移除文案。