Ordo UI
AI上下文与成本

DualTrackMetricPill

@mox-hub/patterns · AI · 上下文与成本 · canonical

dual-track-metric-pill@mox-hub/patternsData Displaycanonicalsrc/components/dual-track-metric-pill.tsx
变体演示dual-track-metric-pill
4.2k1m 32s$0.012claude-sonnet-5-5

Props API

Prop类型默认值说明
tokens*number——
durationMs*number——
costUsd*number——
model*string——
className*string——
labels*Partial<DualTrackMetricLabels>——

源码

packages/patterns/src/components/dual-track-metric-pill.tsx
import { Coins, Cpu, Timer } from 'lucide-react';
import { cn } from '@mox-hub/ui';
import { formatCompact, formatCurrency, formatLiveDuration } from '@mox-hub/ui/format';
import { usePatternLabels } from '../lib/i18n';

export interface DualTrackMetricLabels {
  tokens: string;
  duration: string;
  cost: string;
  model: (model: string) => string;
}

const DEFAULT_LABELS: DualTrackMetricLabels = {
  tokens: 'Token 消耗',
  duration: '执行耗时',
  cost: '预估费用',
  model: (model) => `模型: ${model}`,
};

export interface DualTrackMetricPillProps {
  tokens?: number;
  durationMs?: number;
  costUsd?: number;
  model?: string;
  className?: string;
  labels?: Partial<DualTrackMetricLabels>;
}

/**
 * DualTrackMetricPill - [AI] 双轨成本与执行微徽章 (DESIGN.md §6.1)
 * 11px Mono 字阶,低调沉稳色阶,用于 AI 执行卡片或会话消息的角落呈现。
 *
 * 数值格式化统一走 `@mox-hub/ui/format`(宪法 §14 唯一入口):
 * tokens → formatCompact、duration → formatLiveDuration、cost → formatCurrency。
 */
export function DualTrackMetricPill({
  tokens,
  durationMs,
  costUsd,
  model,
  className,
  labels,
}: DualTrackMetricPillProps) {
  const D = usePatternLabels('dualTrackMetricPill', DEFAULT_LABELS);
  const L = { ...D, ...labels };
  // tokens:固定 en 档跑 compact(k/M 记数,不随中文输出「万」);Intl 的
  // compact 单位是大写 K,按本件历史显示归一为小写 k(M/B 保持大写)。
  const formatTokens = (n: number) =>
    formatCompact(n, { locale: 'en' }).replace(/K$/, 'k');
  // duration:live 耗时渐进精度(<1s 毫秒 / <60s 0.1s / 以上分秒)。
  const formatDuration = (ms: number) => formatLiveDuration(ms);
  // cost:固定 en 档拿 "$" 前缀(默认 zh-CN 会输出 US$);精度沿用旧口径——
  // 不足 1 美分保留 4 位,否则最多 3 位。
  const formatCost = (usd: number) =>
    formatCurrency(usd, { locale: 'en', fractionDigits: usd < 0.01 ? 4 : 3 });

  return (
    <div
      className={cn(
        'inline-flex items-center gap-2 rounded-full border border-border/50 bg-muted/30 px-2 py-0.5 font-mono text-2xs text-content-text-muted select-none',
        className,
      )}
      data-ai-component="dual-track-metric-pill"
    >
      {tokens !== undefined && (
        <span className="inline-flex items-center gap-1" title={L.tokens}>
          <Coins className="size-3 shrink-0 text-accent-yellow" />
          <span className="font-medium text-content-text-secondary tabular-nums">
            {formatTokens(tokens)}
          </span>
        </span>
      )}
      {durationMs !== undefined && (
        <span className="inline-flex items-center gap-1" title={L.duration}>
          <Timer className="size-3 shrink-0 text-accent-blue" />
          <span className="font-medium text-content-text-secondary tabular-nums">
            {formatDuration(durationMs)}
          </span>
        </span>
      )}
      {costUsd !== undefined && (
        <span className="inline-flex items-center gap-1" title={L.cost}>
          <span className="text-accent-green">$</span>
          <span className="font-medium text-content-text-secondary tabular-nums">
            {formatCost(costUsd).replace('$', '')}
          </span>
        </span>
      )}
      {model && (
        <span className="inline-flex items-center gap-1" title={L.model(model)}>
          <Cpu className="size-3 shrink-0 text-accent-purple" />
          <span className="truncate max-w-28">{model}</span>
        </span>
      )}
    </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。

用法说明

成本/耗时/模型双轨微徽章:11px mono 字阶,用于 AI 执行卡或会话消息角落;数值走 format 工具。