66 lines
3.5 KiB
Markdown
66 lines
3.5 KiB
Markdown
---
|
||
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，以上已观察值的事实状态不变。
|