Ordo UI
AI审阅与决策

ConfidenceBar

@mox-hub/patterns · AI · 审阅与决策 · canonical

confidence-bar@mox-hub/patternsData Displaycanonicalsrc/components/confidence-bar.tsx
变体演示confidence-bar
AI 预估92%AI 预估52%AI 预估良AI 预估无信号

Props API

Prop类型默认值说明
value*number——
signal*ConfidenceSignal——
label*string——
hidePercent*boolean——
className*string——
labels*Partial<ConfidenceBarLabels>——

源码

packages/patterns/src/components/confidence-bar.tsx
import { cn } from '@mox-hub/ui';
import { usePatternLabels } from '../lib/i18n';
import {
  confidenceToSignal,
  normalizeConfidenceSignal,
  type ConfidenceSignal,
} from './ai-verdict-pill';

/**
 * 档位 → 概率条视觉(§5.3 语义色表状态:无=中性灰 · 弱=黄 · 良=蓝 · 强=绿;
 * 轨道用 -light 配对、填充用本色——与既有黄/紫配对惯例同构)。
 * 档 0 填充用 muted-foreground 中性灰(非语义色,不做状态表达,符合 §5.3)。
 */
const TIER_TRACK: Record<ConfidenceSignal, string> = {
  0: 'bg-muted',
  1: 'bg-accent-yellow-light',
  2: 'bg-accent-blue-light',
  3: 'bg-accent-green-light',
};
const TIER_FILL: Record<ConfidenceSignal, string> = {
  0: 'bg-muted-foreground/60',
  1: 'bg-accent-yellow',
  2: 'bg-accent-blue',
  3: 'bg-accent-green',
};
const TIER_TEXT: Record<ConfidenceSignal, string> = {
  0: 'text-content-text-muted',
  1: 'text-accent-yellow',
  2: 'text-accent-blue',
  3: 'text-accent-green',
};

/** 组件内文案缺省(中文常量;消费方经 labels 覆写接入 i18n)。 */
export interface ConfidenceBarLabels {
  advisory: string;
  estimatedProbability: string;
  /** 四档信号的读屏文字(0=无 / 1=弱 / 2=良 / 3=强) */
  signalLabels: readonly [string, string, string, string];
}

export const CONFIDENCE_BAR_DEFAULT_LABELS: ConfidenceBarLabels = {
  advisory: 'AI 快速判断 · 仅辅助参考,不改变判定权',
  estimatedProbability: 'AI 预估',
  signalLabels: ['无信号', '弱', '良', '强'],
};

export interface ConfidenceBarProps {
  /** [轨 A·兼容] 概率 0-1;内部按 A4 口径折算档位渲染(阈值见
   *  ai-verdict-pill 的 CONFIDENCE_SIGNAL_THRESHOLDS,勿在此重复换算)。
   *  有限值照常显示条 + 百分比(越界截断到 [0,1]);NaN/Infinity 防御性归一为
   *  「无信号」档(四格信号计空档呈现,不再整件消失)。与 signal 同传时 signal 优先。 */
  value?: number;
  /** [轨 B·新增] 四档信号直传(0=无/1=弱/2=良/3=强):渲染四格信号计(格数=档位,
   *  §8.5 第 4 条档位不靠颜色单独传达),无百分比。运行时经 normalizeConfidenceSignal
   *  防御性归一。 */
  signal?: ConfidenceSignal | null;
  /** 左侧标签(如「AI 预估达成」);缺省用「AI 预估」 */
  label?: string;
  /** 隐藏右侧百分比数字(空间紧张的行内/选项内嵌场景;仅轨 A 数值态有效) */
  hidePercent?: boolean;
  className?: string;
  /** 文案覆写(默认 zh-CN;主仓 i18n 适配层集中传入 t() 结果)。 */
  labels?: Partial<ConfidenceBarLabels>;
}

/**
 * ConfidenceBar - [AI] JEV 概率条(CAP-A-27 扩展批;组件规划账本 A4 四档信号升级)
 * 轨 A(数值):0-100% 细条 + 百分比,色随折算档位(原紫系 AI 标识色按 A4 退役为
 * 四档语义色:无=灰 · 弱=黄 · 良=蓝 · 强=绿);轨 B(直传档):四格信号计,格数即档位。
 * tooltip 恒挂 advisory 声明(保留不动)。手搓 div 条与 completion-review
 * 既有范式一致,不走 base-ui Indicator 的值注入(细条场景几何需自持)。
 */
export function ConfidenceBar({
  value,
  signal,
  label,
  hidePercent,
  className,
  labels,
}: ConfidenceBarProps) {
  const D = usePatternLabels('confidenceBar', CONFIDENCE_BAR_DEFAULT_LABELS);
  const direct = signal !== null && signal !== undefined;
  const tier: ConfidenceSignal | null = direct
    ? normalizeConfidenceSignal(signal)
    : value === undefined
      ? null
      : confidenceToSignal(value);
  if (tier === null) return null;
  const level: ConfidenceSignal = tier;
  // 轨 A 数值态:有限值照常条 + 百分比;NaN/直传档走四格信号计(无诚实数字可显)
  const numeric = !direct && value !== undefined && Number.isFinite(value);
  const pct = numeric ? Math.max(0, Math.min(1, value as number)) : null;
  const pct100 = pct !== null ? Math.round(pct * 100) : null;
  const resolvedLabel =
    label ??
    labels?.estimatedProbability ??
    D.estimatedProbability;
  return (
    <span
      title={labels?.advisory ?? D.advisory}
      data-ai-component="confidence-bar"
      data-confidence={pct ?? undefined}
      data-confidence-signal={level}
      className={cn('inline-flex items-center gap-1.5 select-none', className)}
    >
      {resolvedLabel && (
        <span className="shrink-0 text-xs text-content-text-muted">
          {resolvedLabel}
        </span>
      )}
      {numeric ? (
        <span
          role="meter"
          aria-label={resolvedLabel}
          aria-valuemin={0}
          aria-valuemax={100}
          aria-valuenow={pct100 ?? 0}
          className={cn(
            'relative inline-block h-1 w-14 shrink-0 overflow-hidden rounded-full',
            TIER_TRACK[level],
          )}
        >
          <span
            className={cn(
              'absolute inset-y-0 start-0 rounded-full',
              TIER_FILL[level],
            )}
            style={{ width: `${pct100}%` }}
          />
        </span>
      ) : (
        <span
          role="meter"
          aria-label={resolvedLabel}
          aria-valuemin={0}
          aria-valuemax={3}
          aria-valuenow={level}
          aria-valuetext={D.signalLabels[level]}
          className="flex shrink-0 items-center gap-0.5"
        >
          {([1, 2, 3, 4] as const).map((cell) => (
            <span
              key={cell}
              aria-hidden="true"
              className={cn(
                'h-1 w-2.5 rounded-xs',
                cell <= level ? TIER_FILL[level] : 'bg-muted',
              )}
            />
          ))}
          <span className="sr-only">{D.signalLabels[level]}</span>
        </span>
      )}
      {!hidePercent && pct100 !== null && (
        <span
          className={cn(
            'shrink-0 font-mono text-2xs tabular-nums',
            TIER_TEXT[level],
          )}
        >
          {pct100}%
        </span>
      )}
    </span>
  );
}

可访问性与 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。

用法说明

AI 置信度概率条:value 0-1 或 signal 0-3 双轨,signal 优先;数值态显示条+百分比,直传态显示四格信号计;弱信号不靠颜色单独传达。