跳到主要内容

ADR-0016：体验优先 —「敢分享的美图」为主线（ICP 混合）

  • 状态：已接受（2026-08-02）
  • 决策者：项目维护者（用户否决「再问方向」；本 ADR 固化）

背景​

愿景仍是「数据库设计的 Git + Figma」，北极星仍是「每周有版本保存的活跃建模项目」。
版本保存 / 分享 / presence 已具备可用能力，但循环选题在「企业审批」「chrome 碎活」「双向实时同步 / MCP 大坑」与「UI 是否算 P2」之间反复抖动。

已证伪或否决：

  • 同步即主注 — 双向 live sync / 版本分支本季投入过大、ROI 不清；falsify。
  • UI 是 P2 — 用户明确拒绝；图本身颜值与三壳同语言是激活与传播杠杆，一等公民。

决策（ICP 混合，非纯 A/B）​

主体验注（约 90 天）：「敢分享的美图」

  1. 逆向 / 导入 / DDL → 自动布局质量 + ReactFlow 图本身美学（节点、边、背景、密度、字体），目标是用户愿意截图与分享。
  2. 设计器 + Home + 落地页 同一视觉语言（erd-* tokens）；禁止再散落 #4096ff 等默认蓝当主色。
  3. UI 美 = 一等公民，不得再标成可无限延期的 P2 化妆品。

并行维持的能力轨（不冻结、不大扩）：

  • 继续维护版本保存 / 分享 / presence（修 bug、可达性、可信反馈）。
  • 本季禁止新开：版本分支、双向 live sync、MCP / 公开 API 产品实现码（ADR-0013 仍为规划）。

降权：

  • 企业审批流不当作北极星主注。
  • 不改变图观感/分享欲的 chrome 微切片。
  • meta 循环 prompt 空转改写。

循环指令必须：双轨等权选题；禁止向用户开放式问方向；禁止碎活凑数。

后果​

  • 正面：激活与口碑（截图传播）有清晰主线；能力资产不丢；agent 循环停止方向抖动。
  • 代价：本季少做「同步/分支/MCP 产品码」与审批深水；部分 chrome 债后置。
  • 风险：只化妆不动建模回路 → 用走查+E2E 约束「图可读可分享」必须可验证；布局质量：导入/逆向/无坐标兜底已接共享 dagre（utils/graphLayout，默认 nodesep 56 / ranksep 108）；示例主图手排收紧（列间距 ~28px、x 跨度 ~1072）+ Frame padding 20；节点密度/PK·FK 徽章/自定义 erdSmooth 边（同表对多 FK 肘距分流 + 中间表 centerX/bypassY 避让 + 同 midX 通道干道 bundling + 叠表缝 mid-corridor / 两弯 escapeX + 稀疏 Hanan A* + 密障绕行竞短 + 高度数 hub Y 扇出）已落地；表节点卡片层次（surfaceMuted 表头 + 字段发丝线 + PK 左边条）✅；设计器与分享只读共用 ErdRelationEdge/associationsToEdges（含 layout hint）；三壳 chrome（顶栏 64 / 去水印 / Home 表面 token）已对齐；密 FK 导入走查 ✅（dense-fk.dbml）；分享同路由 + hub 扇出 ✅（demo.spec）；几何择柄（竖叠同侧短 U，消 circle-route）✅；Frame 主题色板 + 清 Ant 蓝/命令面板硬编码 ✅；边标签 chip 可读（surface 白底 + ink900/12/600，禁整块 opacity；碰撞盒 40×20）✅；导入/逆向后 Frame 自动建议（前缀/连通分量）✅；空态构图打磨（ER 剪影 + 主/次 CTA，去粉红卡通）✅；分享顶栏品牌对齐（W5 切片 3）✅；登录/注册品牌壳（W5 切片 4）✅；落地页 token 同源 ✅；密图密度微调（分享 fitView / relationNoShow 过滤）✅；字段行再压一档（min-height 22 / FIELD_ROW_H 26）✅ → 表节点密表再压（表头 pad 6 / 字段 minH 20 / FIELD_ROW_H 24）✅；导入后首屏打磨（空态「导入 DBML」+ 直开关系图 + fitView 同分享密）✅；竞品对照 /compare ✅；边标签密度 + Frame padding 20 ✅；Frame 标题栏密度（chrome 22）+ MiniMap sunk 对齐 ✅；Controls 面板密度（22×22 + surface chrome）✅；选中光晕统一（表/Frame --erd-selection-ring a18）✅；画布工具栏再收（height 22 / font 11）✅；空态面板再收（pad 14/18 + CTA 26 + 剪影 132）✅；命令面板密度（宽 440 / 输入 36 / 行 6×8）✅；实体新建弹层密度（宽 400 / 输入 28）✅；左树行高密度（22 / font 12）✅；分享只读多关系图切换 ✅；分享画布视口铺满（480→stage flex）✅；分享只读表清单折叠 ✅；分享 meta hint/描述密度 ✅；分享展开表清单行密度（22–28 / project-list）✅；边标签碰撞避让（bundle 拉伸 + AABB resolveEdgeLabelOffsets）✅；分享失效/空态品牌对齐（AuthBrandShell 门 + ErdEmptyDiagram 空态）✅；404/403 AuthBrandShell ✅；关系图 SCSS 清 brand 裸 rgba（--erd-frame-fill-brand / color-mix）✅；PK/FK/hover 行浅底 color-mix（warning/success/ink-900）✅；字段行扫读层次（名 500/PK 600 + 类型右对齐次要栏）✅；关系线默认描边权重/对比（ink900 + 2px / 选中 2.5；crow 对齐）✅；表头标题层次（title 14/700 vs chnname 10/400+0.88）✅；空态 CTA 层次（唯一主钮 + 次链 / 分享标题+hint）✅；基数 chip 扫读层次（12/600/ink900）✅；PK/FK 徽章扫读层次（10/700 + min-width 22 角色标列）✅；画布工具栏/Controls 扫读层次（单块 chrome + 适应画布/自动布局主操作）✅；表节点密表再压（表头 pad 6 / 字段 minH 20，层次不动）✅；Frame 标题扫读（label 12/700 vs meta 10/400+0.88，chrome 22）✅；画布工具栏「新建表」一键上图（非空建模回路）✅；连线失败可见反馈（重复关联 / 非法锚点 toast；空白取消不打扰）✅；字段行 ✎ 内联编辑 + 空名 toast（建模回路）✅；字段 Tab 跳行 + 类型即时 save-status（建模回路）✅；末行 Tab 新建字段（建模回路）✅；索引签再加一行 CTA（建模回路）✅；下一刀：建模回路摩擦（索引表删除确认 / JExcel 工具栏文案化）；勿再碎色·密度。
  • 与既有 ADR：不推翻 ADR-0001（ReactFlow）、ADR-0012（定位）、ADR-0013（MCP 规划不实现）；本篇只定本季投注权重。