唯一 UI 真源
这是公开、无敏感信息的可视化参考页。它和 Ops Home 都是消费者；机器真源归属 Valerie Bridge。
- 视觉基准
- KB Home · /reports/_kb_home.html
- Contract identity
- bridge-kb-home-ui
- Version
- 4.1.0
- Fingerprint
- sha256:26a79b5d3f55926b903029d6d63c8065123b69ddf3967e611568b5c397e9f519
- Canonical owner
- GitHub albertyangchao/valerie-bridge · config/html_ui_contract.json
- Renderer
- bridge_core.html_design.html_shell()
- Publisher
- Valerie Bridge reserved-page publisher；只接收 release manifest 中登记的页面
颜色与字体
所有色彩由共享 CSS token 驱动。白色、石板灰、细边界和系统字体构成默认视觉。
页面背景
#FFFFFF
弱背景
#F8F9FB
正文 / 标题
正文 #1F2328
标题 #0B1220
唯一弱重点色
#2C3E50
Font stack
-apple-system,system-ui,BlinkMacSystemFont,"SF Pro Text","Segoe UI",Inter,"PingFang SC","Hiragino Sans GB","Microsoft YaHei",sans-serif
标准控件
以下示例由当前共享 renderer 直接渲染，不是截图或独立 demo CSS。
卡片
白色表面、细边界、6px 圆角和极轻阴影；专题只改变内容，不重绘表面。
| 组件 | 统一要求 | 移动端 |
|---|---|---|
| Button | 共享 btn token、focus-visible | 保持可点击 |
| Card | 共享表面、边界、圆角、阴影 | 单列排列 |
| Table | 共享表头、边界与文字层级 | 堆叠或容器内滚动 |
| Navigation | 同一 toc 语义 | ≤1024px 默认隐藏为抽屉 |
桌面与手机导航
Desktop
数据型 KB 使用 locked sidebar 时，1025px 及以上目录固定在视口左侧；主页类页面仍使用同一 toc 控件。
Mobile
1024px 及以下目录默认隐藏。由顶栏目录按钮打开；关闭按钮、背景点击与 Escape 都必须关闭并同步 ARIA 状态。
正反例与发布闸门
正确
调用共享 html_shell；只提供内容、导航树和图表数据；构建产物携带版本、fingerprint 和 manifest。
错误
专题自建品牌色、全局页面壳、顶栏、侧栏或手机菜单；直接上传任意 HTML；让通用同步覆盖保留页面。
Fail closed
缺少 contract stamp、token 漂移、旧蓝色模板标记、SHA 不匹配或未列入 manifest 的文件，必须在发布前失败。