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> | — | — |
源码
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/translatorprops,其次用I18nProvider目录;内置 zh-CN 默认值,en-US 为参考翻译。见Theming · i18n 与 RTL。 - 对比度:高对比度 token、2px 控件边框与 3px 焦点环由主题层统一提供,见Foundations · Contrast。
用法说明
成本/耗时/模型双轨微徽章:11px mono 字阶,用于 AI 执行卡或会话消息角落;数值走 format 工具。