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> | — | — |
源码
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/translatorprops,其次用I18nProvider目录;内置 zh-CN 默认值,en-US 为参考翻译。见Theming · i18n 与 RTL。 - 对比度:高对比度 token、2px 控件边框与 3px 焦点环由主题层统一提供,见Foundations · Contrast。
用法说明
AI 置信度概率条:value 0-1 或 signal 0-3 双轨,signal 优先;数值态显示条+百分比,直传态显示四格信号计;弱信号不靠颜色单独传达。