---
status: candidate-not-implemented
colors:
  primary: "#17634c"
  surface: "#ffffff"
  text: "#1d1d1f"
typography:
  bodySize: "16px"
  bodyLineHeight: 1.6
  family: '"Microsoft YaHei", "PingFang SC", sans-serif'
rounded:
  navigationItem: "9px"
spacing:
  navigationHorizontal: "24px"
components:
  primaryAction:
    background: "{colors.primary}"
    foreground: "{colors.surface}"
  surfacePanel:
    background: "{colors.surface}"
    color: "{colors.text}"
---

# 兴邦 v2 视觉契约草案

## Overview

当前是基于已观察代码整理的候选契约。此文件尚未被 CSS 或构建消费，状态为 Present，不能声称 Token-ready/Aligned/Backstopped。正式 token 文件路径、导出与防漂移测试在 M1/M4 决定并实现。

## Colors

primary #17634c 来自 src/components/xingbang/navigation.css 的 xb-brand-mark 及 src/app/globals.css 的 xingbang-mark；surface 白色取自现有业务面板；text #1d1d1f 来自 globals.css。当前全局 accent 是蓝色 #002fa7，与业务导航绿色并存，不能声称已经统一品牌主题。

提案：业务预审延续深绿和白色证据面板，减少装饰色。primary 用于主动作和品牌，不代表风险结论；成功/警告/阻断必须文字标识。辅助状态色和对比度尚待审查，未擅自编造正式 token。

## Typography

正文 16px、行高 1.6 来自 globals.css；中文字体延续现有字体栈。预审结果、问题、证据三层信息明确，不把大量技术标签放在首页。数字不得比证据更突出，真实业务不放未验证的通过概率。原型按用户新增要求展示独立的演示概率与沙盘对照，百分比旁必须有演示标识；解释、缺证与人工复核提示不能被数字淹没。

## Layout

项目与版本头部 → 判断摘要 → 核查/经验主区 → 证据抽屉/动作侧栏。小窗口切换为纵向，路径图始终有文字列表。导航水平 padding 24px 与导航项圆角 9px 来自 navigation.css 的后置业务可读性规则；不意味着其他组件强制使用这些值。

## Elevation & Depth / Shapes

只对抽屉与浮层建立必要层次。面板阴影、圆角、间距完整尺度待视觉评审，禁止各组件自行新增任意裸值。已观察导航值不等于全站设计系统。

## Components

RunSummary、EvidenceDrawer、CaseTimelinePanel、ExperienceEditor、ScenarioPanel、EvaluationPanel 均为提案，状态和权限以 UI Spec 为准。动作 hover/disabled/focus token 待补齐并验证；原型与正式实现必须使用同一来源。

## Do / Don't

- 用“依据、差异、尚未验证”帮助业务人员理解；不要用黑盒发光大脑代替证据链。
- 线宽代表定义明确的等级；不要把模拟路径长度、线宽或模型确信度当作概率。
- 减少动效可关闭动画；焦点、错误、成功必须有文字和可见形状。
- 实施时验证正文/焦点对比度达到流程要求；当前尚未执行，不能标已通过。

## 缺口与门禁

needs-design-decision：完整状态色、间距尺度、响应断点、组件状态 token；owner 前端负责人；needed-by UI 实现前。需要 token 导出检查、对比度测试、键盘测试及文案 key 检查，结果纳入 test-evidence。

## 2026-09-28 原型方向补充

用户已选“深色导航＋浅色工作区”。Superdesign 原型采用深绿导航、浅灰工作背景和白色证据面板，通过关系图与克制动效体现科技感。具体候选颜色、间距及交互在 .superdesign/concept-design-system.md；记录与验收见 [交互原型](12-prototype.md)。这些为原型设计决策，尚未写入生产CSS，以上已观察值的事实状态不变。

## 2026-09-29 概率解释可视化

沿用原型色板，概率环强调结果、六轴雷达强调证据阶段；局部科技面板使用现有深绿/青绿语义色，不引入营销插画。图表须附刻度定义、虚实线图例与等价可交互文字列表。只使用短时状态过渡，prefers-reduced-motion时关闭；无持续扫光或闪烁。维度选择进入依据抽屉，原型概率来源进入人工情景表。图形不能暗示权重、面积或资料完整度与真实审批概率等价。详见[概率设计](13-probability-prototype.md)。

## 2026-09-29 来源与状态分离

新增语义token候选：origin-history（历史提炼）、origin-manual（人工创建）、origin-policy（制度导入）。用于卡片标题条和来源徽标，要求视觉差异明显且不占用风险状态色；具体色值、hover/focus与对比度在T09依据现有设计系统定案。本轮未写生产CSS或重画原型。

每种来源必须同时有文字和图标；data_domain和审核status各有独立徽标。来源区别不是权限区别，也不是可信等级。图表维度改为方案驱动；六轴只描述已有原型，生产按UI Spec第9节处理2/6/9维及异刻度。