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

源码

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

用法说明

上下文注入 chip:展示当前查看实体(类型 + 标题)并可一键移除;labels 覆写类型名/移除文案。