DESIGN SPEC v2.1 — 可視化 本文档即 DESIGN-SPEC.md 的可执行形态 · ← 返回提案演示
デザイン仕様・コンポーネントライブラリ

デザイン仕様 — コンポーネントライブラリ

VCM 2.0 重设计提案的设计系统定义。所有令牌、组件、状态、动效在此可视化;三个演示页面(仪表盘 · 案件详情 · 用户管理)全部由本规范驱动。

01 カラー・トークン

结构色 + 唯一强调色 + 阶段数据色 + 语义色。全站仅 1 个交互强调色(Venture Azure);阶段色只用于编码阶段数据,永不作装饰;中性色统一 Slate 冷灰。

構造色(Slate 中性系)

--bg#F5F7FA · 页面底
--surface#FFFFFF · 表面
--surface-2#F1F5F9 · 次表面/表头
--ink#0F172A · 主文字(非纯黑)
--ink-2#334155 · 次文字
--ink-3#64748B · 辅助(12px 下限场景)
--line#E2E8F0 · 发丝线
--line-2#CBD5E1 · 输入边框

ブランドと唯一のアクセント

--navy#0A2E4A · 侧栏/品牌
--accent#14639E · 白字 6.3:1
--accent-deep#0F4C7A · hover 加深
--accent-tint#EAF2F9 · 选中/聚焦底
--accent-bright#4E9BD6 · 深色面上的强调

フェーズ色(データエンコーディング · 白字对比全部 ≥ 4.5:1)

--p1 Discover#0F766E · 5.7:1
--p2 Assess#A16207 · 5.2:1
--p3 Purchase#1E40AF · 9.3:1
--p4 Pilot#9F1239 · 8.1:1
--p5 Adopt#166534 · 7.4:1
规则说明
深色 → 填充阶段深色仅用于:阶段导轨段填充、列头文字、tag 文字(配 tint 底)
tint → 背景tint 仅用于:列头底、tag 底、选中态底。永不作大面积装饰
非色単独编码阶段永远同时呈现 名称+序号+数字——色彩不是唯一信息通道(色弱可读)

セマンティック色

--ok#15803D
--warn#B45309
--danger#B91C1C · 危险操作专用

02 タイポグラフィ

IBM Plex Sans JP(日文/界面)+ IBM Plex Mono(数字/代码/时间戳)。字号 8 档刻度,系统下限 12px(评审 FR-01:现网存在 687 处 8–10px 文字)。所有数字 tabular-nums。

40 / KPI¥3,150,000,000
28 / H1 詳細案件詳細ページ見出し
22 / H1 一覧ダッシュボード
18 / H2セクション見出し
16 / リードリード文。行高 1.7、限幅 66ch。
14 / 本文本文・ボタン・タブ
13 / テーブルテーブル正文・メニュー項目
12 / ラベルKPI ラベル・補助情報 — システム下限(8–10px は禁止)
属性定義
font-family界面 --sans / 数字·コード·日時 --mono
line-height正文 1.7 / 表格 1.5 / 标题 1.25–1.3
font-weight400 正文 · 500 强调/按钮 · 600 标题 · 700 仅 KPI 数值与 logo
数値tabular-nums 右对齐;金额 ¥1,964,385,000;日期 2026/10/21 12:52 等宽
行長段落 max-width: 66ch(长文本不再全宽铺开)

03 余白・角丸・影

4px 基数间距刻度;3 档圆角;2 档带色相阴影(禁外发光)。卡片策略:能用发丝线分组就不用卡片,只有悬浮层与看板卡片使用阴影。

--sp-1 · 4px
--sp-2 · 8px
--sp-3 · 12px
--sp-4 · 16px
--sp-5 · 24px
--sp-6 · 32px
--sp-7 · 48px
--radius-s 6px · 输入/按钮
--radius-m 10px · 卡片/表格
--radius-l 16px · 模态
--shadow-1 · 静置
--shadow-2 · 悬浮层

04 ボタン

5 变体 × 3 尺寸。规则:每视图至多 1 个 Primary;危险操作只用 danger(且必须过确认模态);文案具体化(「この編集を保存する」而非「保存」);active 态下沉 1px 模拟物理按压。

バリアント.btn-primary / secondary / ghost / danger / danger-ghost
Primary · 主操作
Secondary · 次操作
Ghost · 弱操作
Danger · 确认模态内
Danger-ghost · 列表弱危险
禁用态: opacity .45 + cursor:not-allowed,且 title 说明原因(例: 未保存时「Purchaseフェーズへ進む」置灰)。
サイズ.btn-sm 30px / .btn 38px / .btn-lg 44px
sm · 表格行内
md · 默认
lg · 页面级主操作
icon-btn · 图标按钮
状態hover / active / disabled / focus-visible
disabled(含禁用理由)
Try me: active 下沉
focus-visible 全站统一: outline: 2px solid var(--accent); outline-offset: 2px(评审 FR-05:现网 focus-visible 规则为 0 条)。

05 アイコン

统一 lucide 风格线性图标:stroke-width 1.75、round cap/join、两档尺寸(导航 17px / 操作 15-18px)。禁止 emoji 与混用图标库。以下为当前用集(点击 toast 显示名称):

dashboard
folder
chart
users
company
layers
search
bell
globe
edit
agent
lock
mfa-reset
more
close
chevron-down
alert

06 フォームコントロール

Label 恒在输入框上方(禁止 placeholder 兼职 label);helper 在下、错误贴源;输入高 38px;聚焦环统一。四个基础控件 + 状态全集:

テキスト入力 — 状態全集.input
会社ドメインのメールアドレス
メールアドレスの形式が正しくありません
この項目は手動変更できません
focus 状态请用 Tab 键体验: border-color: var(--accent) + 0 0 0 3px var(--accent-tint)。
選択コントロール.select / .check / .switch
セレクト(ネイティブ)
チェックボックス
ラジオ
スイッチ
セレクトは原則ネイティブ(OS のアクセシビリティをそのまま継承)。カスタムドロップダウンは下のメニューコンポーネントで。

08 チップ・タグ・バッジ

Filter chip(可按压,aria-pressed)用于筛选;tag(只读)用于角色/状态语义;badge(mono 数字)用于计数。点击下方 chip 体验按压态:

フィルタチップ
ロールタグ
システム管理者プロジェクト管理者 VCスタッフPM閲覧者
ステータスタグ
有効 未設定 POC 遅延
セグメント(二択切替)

09 フェーズコンポーネント

VCM 的核心组件。三态:done(深色填充·可回看)/ current(深色填充+「現在」chip+白色下划线)/ future(灰·disabled+title 理由)。真 button 实现、aria-current="step"、键盘可达(评审 FR-07/FR-10)。

フェーズレール.phase-rail / .phase-seg
done = 深色填充 current = 填充+現在chip future = 灰+disabled+理由
白字对比: P1 5.7 / P2 5.2 / P3 9.3 / P4 8.1 / P5 7.4(全部 ≥4.5:1,修复现网 2.9:1)。
フェーズタグ(行内・卡内)
Discover Assess Purchase Pilot Adopt

10 テーブル

语义 table;表头 12px 大写+次表面底;行高 56px(≥44px 命中区);数字列 mono 右对齐;行操作走 ⋯ 菜单;行 hover 微底色;移动端转卡式行(data-label 提供 pseudo 标签)。点击表头体验排序态:

ユーザー ↕ ロール 想定効果 ↕ 経過日数
齋齋藤 雅剛
システム管理者¥420,000,00067
高高橋 佳子
PM¥1,050,000,00038
西西村 英二
閲覧者—12
属性定義
行高56px(触控命中 ≥44px,修复现网 20-24px 链接)
数字列.num = mono + tabular-nums + 右对齐
表头截断长表头 min-width + 平假名换行,禁 ellipsis 截断(FR-15)
斑马纹不用斑马纹,用行 hover 底色 + 发丝线(更安静)

11 フィードバック — モーダル / トースト / 状態

危险操作双闸门(⋯菜单→确认模态);toast 底部居中 4.2s 自动消失、带具体结果文案;骨架屏与真实布局同构;空态=插画+一句话+行动按钮。以下全部可现场触发:

確認モーダル(危険)
トースト
インラインエラー
一覧の取得に失敗しました
ネットワークを確認し再試行してください(ERR_0x2F)
スケルトン(実レイアウト同構)行高 56px + shimmer
円形スピナーは禁止(skel がレイアウトを予告する)— 完整演示见 ユーザー管理 → 骨架屏演示。

12 モーション

MOTION_INTENSITY 6(Fluid CSS 区间):唯一缓动 cubic-bezier(0.16,1,0.3,1)(出栈感);三档时长;只动 transform/opacity;prefers-reduced-motion 全量关闭(现网为 0 条支持)。

トークン値用途
--dur-1140mshover / active / chip 按压
--dur-2260ms菜单展开 / 面板切换 / 模态进入
--dur-3420ms列表入场(stagger 60ms/项)
--easecubic-bezier(.16,1,.3,1)全站唯一缓动(spring 风格出栈)
@keyframes rise8px 上移淡入卡片/行入场,animation-delay: calc(var(--i) * 70ms)
breathe / shimmer / sweep2.4s / 1.4s / 1.8s状态点呼吸 / 骨架扫光 / KPI 一次性扫光

13 FR トレーサビリティ

本规范对《VCM STG 设计评审报告 2026-10-27》15 条 FR 的覆盖情况。FR-02(段落重复渲染)为工程 bug,不在设计规范范围。

FR评审发现规范落点演示位置
FR-01687 处 8–10px 微型文字§02 字号 8 档、下限 12px02
FR-03MFAリセット 无确认§07 ⋯菜单 + §11 确认模态双闸门用户管理
FR-04375px 横向溢出 1758px断点表:<1024 侧栏抽屉、<900 网格降列、<768 单列任意页 375px
FR-05175 个 <44px 目标、focus-visible 0 条§04 命中区 ≥38px、全站统一焦点环04
FR-06管理功能埋于用户菜单侧栏「管理」分组一级可达仪表盘
FR-07阶段条 div 不可键盘操作§09 真 button + aria-current + 禁用理由案件详情
FR-08H1 双标准(14px vs 32px)§02 列表页 22 / 详情页 28 两档02
FR-09数字无 tabular-nums§02 数字规则(mono+右对齐)10
FR-10阶段色白字 2.9:1§01 五档 AA 阶段色01
FR-11空态仅「全 0 件」§11 空态=插画+文案+行动空状態演示
FR-12DOM 53k px 无虚拟化卡片 line-clamp 2 行 + 阶段折叠交互模式仪表盘
FR-13Agent 与主系统断裂§01 色板 + Agent CTA 用主系统品牌(深藏青渐变)Agent カード
FR-14logo aria-label 未翻译等i18n 规则:aria-label 一并入翻译键—
FR-15表头截断 / PM 卡不可点§10 表头规则;看板卡片全链接化10