|
| 1 | +# 熵可视化设计宪法(单范式宣言) |
| 2 | + |
| 3 | +> **状态**: 已批准(2026-08-03 项目负责人裁决通过) |
| 4 | +> **上位文档**: `docs/product/ai-era-survival-positioning.md`(本宪法是其外层防御的落地规范) |
| 5 | +> **地位**: 熵减产品的最高视觉与体验宪法。与 `ui-ux-system.md`(执行层规范)的关系:本文定「为什么与是什么」,ui-ux-system 定「怎么做」。冲突时以本文为准。 |
| 6 | +> **核心命题**: 形式即概念——热力学第二定律是本产品唯一的视觉主角。 |
| 7 | +
|
| 8 | +--- |
| 9 | + |
| 10 | +## 第〇条 · 单一范式纪律 |
| 11 | + |
| 12 | +1. 本产品在同一时期只奉行**一个**叙事范式:「万物趋于无序,而你在此造序」。 |
| 13 | +2. **已落地现状勘误**:留存引擎并非愿景而是存量——珊瑚生态/连击气泡/深海发现/学习画像/深度计 5 大组件已随 v0.34.0 上线 Dashboard(`features/retention/`);启动仪式重塑已立项 v0.26.0。Foresight 中**其余**未立项愿景冻结为参考资料,不得并行立项,直至本范式 P1 验收通过。 |
| 14 | +3. 任何新增视觉提案必须先回答:它映射哪个学习变量?映射不了的,一律拒绝(见第二条)。 |
| 15 | +4. 本宪法的留存机制依据:`docs/knowledge/learning-mechanisms-analysis.md` 第四章(即时反馈 > 可变奖励 > 身份认同 > 损失规避,自主感为底线)。 |
| 16 | + |
| 17 | +--- |
| 18 | + |
| 19 | +## 第一条 · 核心映射表(唯一性约束) |
| 20 | + |
| 21 | +场景中每个视觉元素必须映射且只映射一个学习变量。此表是设计评审的一票否决工具。 |
| 22 | + |
| 23 | +| 学习变量 | 深海世界(dark) | 穹顶世界(light) | 说明 | |
| 24 | +|---------|-----------------|------------------|------| |
| 25 | +| 概念掌握度 | 发光体的亮度与清澈度 | 星体亮度 | 牢固=清冽明亮;薄弱=朦胧 | |
| 26 | +| 遗忘(熵增) | 混沌雾(缓慢渗透的半透明噪雾) | 星云尘埃遮蔽 | **可见但不刺眼**,见第四条防线 | |
| 27 | +| 复习行为 | 秩序波纹(从操作点扩散的光圈) | 星风吹散尘埃 | 每次复习的即时正反馈 | |
| 28 | +| 累计专注时长 | 珊瑚/海床地形高度 | 星座连线的密度 | 地质层——变化慢而厚重 | |
| 29 | +| 今日状态 | 海面光色与洋流速度 | 晨光角度与云层 | 实时层——每次打开都不同 | |
| 30 | +| 灵感数 | 萤火数量 | 流星余迹数量 | 微小、闪烁、可收集 | |
| 31 | +| 待复习优先级 | 雾的浓度排序 | 尘埃厚度排序 | **取代红点与数字角标** | |
| 32 | +| 概念关联 | 洋流线连接 | 星座连线 | 知识图谱的空间化 | |
| 33 | + |
| 34 | +**禁止项**:任何无映射的纯装饰动画;任何直接展示"遗忘数量/衰退百分比"的数字。 |
| 35 | + |
| 36 | +--- |
| 37 | + |
| 38 | +## 第二条 · 焦虑防线(觉察原则的硬边界) |
| 39 | + |
| 40 | +遗忘可视化天然滑向焦虑制造。以下边界为**硬约束**,任何实现违反即视为缺陷: |
| 41 | + |
| 42 | +1. **雾永远朦胧可拨开**:混沌雾的最大不透明度 ≤ 40%,被遮蔽的元素始终可见轮廓——"它在等你",不是"它没了"。 |
| 43 | +2. **零负向语言**:不出现"已遗忘/衰退/过期/落后"等词。待复习区域的文案范式:"朦胧的知识,等待一次唤醒"。 |
| 44 | +3. **零倒计时与零赤字**:界面任何位置不展示"距遗忘还有 X 天"类倒计时;不使用红色表达知识状态。 |
| 45 | +4. **无他人参照**:永不展示与其他用户的比较(远期"远方光点"功能仅存在性提示,无量级)。 |
| 46 | +5. **可关闭性**:混沌雾渲染提供全局开关(设置项),关闭后世界退化为纯净亮度映射。觉察是镜子,用户有权移开视线。 |
| 47 | +6. **回归奖赏**:久别返回时,世界的第一反馈永远是"欢迎回来"性质的(洋流变暖、一颗星主动亮起),禁止任何形式的冷遇。 |
| 48 | + |
| 49 | +--- |
| 50 | + |
| 51 | +## 第三条 · 签名时刻脚本(全产品唯一一级时刻) |
| 52 | + |
| 53 | +**挂载点**:掌握一个概念(费曼评估通过 / 卡片标记「牢固」)。依据:learning-mechanisms-analysis §4.1 将「即时反馈缺口」列为最高优先级——深潜/费曼/闪卡完成时均缺乏可视化正反馈。 |
| 54 | + |
| 55 | +**三幕结构**(总时长 ≤ 10s): |
| 56 | +- **第一幕 · 静默(1-2s)**:环境音淡出,场景光照聚焦于操作点,世界为之安静。 |
| 57 | +- **第二幕 · 事件(4-6s)**:一颗星亮起(穹顶)/ 一簇珊瑚绽放发光(深海),秩序波纹扩散,与邻近知识连出新的线段。 |
| 58 | +- **第三幕 · 余韵(2s)**:动画结束,但**痕迹永久保留**在场景中。下次打开应用,这一刻的证据仍在。 |
| 59 | + |
| 60 | +**约束**: |
| 61 | +1. **可变重奏**:同一成就不重播同一演出(3 套以上变体随机),对抗多巴胺适应。 |
| 62 | +2. **可打断**:Esc / 任意操作立即终止演出,直达结果状态。 |
| 63 | +3. **reduced-motion**:提供静帧版(星直接亮起 + 一次柔和闪烁)。 |
| 64 | +4. **声音占一半**:专属单音音效(候选:声呐泛音/单音钢琴),与现有音效库风格统一(见第六条)。 |
| 65 | +5. **首潜加长版**:First Dive 完成时播放「创世版」——世界从混沌中点亮第一颗星,onboarding 即创世(见第七条)。 |
| 66 | + |
| 67 | +--- |
| 68 | + |
| 69 | +## 第四条 · 性能预算(三级降级表) |
| 70 | + |
| 71 | +基座现实:3D 层刚偿还过稳定性债务(frameloop 冻结、相机飞行、计时停摆),且目标用户含大量学生笔记本(核显/集显)。**先有预算,再有特效。** |
| 72 | + |
| 73 | +| 资源 | high(澎湃) | medium(从容) | low(静谧) | |
| 74 | +|------|------------|--------------|------------| |
| 75 | +| 混沌雾 | Shader 体积雾 | 2 层径向渐变叠加 | 静态纹理 | |
| 76 | +| 秩序波纹 | 全屏后处理涟漪 | CSS/SVG 圆环动画 | 一次透明度闪烁 | |
| 77 | +| 粒子(萤火/星尘) | ≤ 1500 | ≤ 500 | ≤ 100(静态) | |
| 78 | +| 星座连线 | 发光 shader 线 | LineBasicMaterial | 直连细线 | |
| 79 | +| 签名时刻后处理 | Bloom+DoF | 仅 Bloom | 关闭,亮度补偿 | |
| 80 | + |
| 81 | +1. 任何新增 GPU 元素必须先在此表登记预算并修改本条,方可实现。 |
| 82 | +2. low 档**不删视觉语义**(雾仍在、星仍亮),只降精度——与既有降级哲学一致。 |
| 83 | +3. frameloop 冻结教训:所有新增动画必须验证 `never → always` 切换路径(LoopResumer 机制)。 |
| 84 | + |
| 85 | +--- |
| 86 | + |
| 87 | +## 第五条 · 排印与构图(叙事面规范) |
| 88 | + |
| 89 | +1. **跳率 ≥ 4x**:叙事面字号体系为 64-96px 衬线大字 + 10-12px 注文,取消中间档。 |
| 90 | +2. **文字即场景**:大字直接悬浮于 3D 空间(电影字幕式),不进面板。 |
| 91 | +3. **留白纪律**:叙事面内容占屏 ≤ 40%。 |
| 92 | +4. **东方签名**:竖排注文 + 印章式标记(如「潜」字圆章)为品牌专属元素,仅出现于叙事面。 |
| 93 | +5. **双轨制**:功能面(设置/卡管理/列表)不适用本节,保持效率密度,共享色彩令牌。 |
| 94 | + |
| 95 | +--- |
| 96 | + |
| 97 | +## 第六条 · 存量资产接线(禁止重复造轮子) |
| 98 | + |
| 99 | +| 存量资产 | 接线方式 | |
| 100 | +|---------|---------| |
| 101 | +| `StartupRitual`(三步启动仪式) | 仪式第三步呼吸结束后,接「今日海况/天象」一句叙事文案——仪式成为世界的每日开场 | |
| 102 | +| `First Dive` 新手引导 | 终点改造为「创世版签名时刻」:点亮第一颗星 | |
| 103 | +| `CreatureAvatar` / `CreatureBubble` | 即伴游生物的现成载体:AI 低语 = 生物凑近发光;禁止另起炉灶画新的 AI 形象 | |
| 104 | +| `public/sounds/`(49 个音效,含 ritual 呼吸、assistant 系列) | 签名时刻音效从现有音色体系衍生;混沌退却/秩序波纹需新增 ≤ 2 个音效 | |
| 105 | +| `features/retention/`(v0.34.0 已上线:coralEngine/streakEngine/discoveryEngine/profileEngine/dailyVariation + 5 大组件) | **本宪法的引擎层,禁止重造**:世界叙事是这些引擎的空间化外壳——珊瑚引擎→世界地质层,发现引擎→稀有事件演出,每日变化引擎→实时层洋流/晨光,social proof→远方光点 | |
| 106 | +| 四大设计原则 | 本宪法所有条款的验收官;任何冲突条款以四原则为准 | |
| 107 | +| 新手期双标签导航 | 创世时刻后沿用现有副标题淡出机制,不重复设计过渡 | |
| 108 | + |
| 109 | +--- |
| 110 | + |
| 111 | +## 第七条 · 冷启动与空状态 |
| 112 | + |
| 113 | +1. 新用户的世界是**未点亮的混沌**(非空白)——雾中隐约有待亮的轮廓,暗示可能性。 |
| 114 | +2. 第一次学习动作即创世(第一颗星/第一株珊瑚),由 First Dive 保证当天发生。 |
| 115 | +3. 零数据界面禁止出现空洞感:用叙事文案填充("这片海还没有名字,从今天的第一次深潜开始")。 |
| 116 | + |
| 117 | +--- |
| 118 | + |
| 119 | +## 第八条 · 验收标准 |
| 120 | + |
| 121 | +1. **陌生人测试**:未接触过产品的测试者看首页截图,第一反应描述为"风景/世界"而非"面板/工具"。 |
| 122 | +2. **装裱测试**:叙事面任意一屏去掉所有交互元素后仍可独立成立为画面。 |
| 123 | +3. **焦虑审计**:按第二条逐项走查,任何违反即阻断发版。 |
| 124 | +4. **低配测试**:核显设备上 medium 档帧率 ≥ 45fps,low 档 ≥ 30fps。 |
| 125 | +5. **转述测试**:内测用户能自发用一句话复述签名时刻。 |
| 126 | + |
| 127 | +--- |
| 128 | + |
| 129 | +## 第九条 · 分期路径 |
| 130 | + |
| 131 | +- **P0 · 宪法落地**(本次):映射表驱动的双世界场景升级(雾/星/波纹静态版)+ 排印规范 —— 对应 canvas v3 验证。 |
| 132 | +- **P1 · 闭环**:真实数据接入映射表、签名时刻三幕实现、First Dive 创世改造、StartupRitual 接线。 |
| 133 | +- **P2 · 纵深**:可变重奏演出库、声景体系、疲劳共情、延时摄影开场;另见 `docs/product/mcp-learning-memory-interface.md`(世界状态模型的下游消费方)。 |
| 134 | + |
| 135 | +--- |
| 136 | + |
| 137 | +## 第十条 · 叙事层叠加(A+B/C/D 落地条款) |
| 138 | + |
| 139 | +单范式是骨架(A:熵可视化);以下三个叙事层允许作为血肉叠加,但每层的一切元素必须先过第一条映射表与第二条焦虑防线。 |
| 140 | + |
| 141 | +| 叙事层 | 机制 | 映射挂点 | 排期 | |
| 142 | +|--------|------|---------|------| |
| 143 | +| **C 潮汐节律** | 实时层的投递机制:专注活跃期=涨潮(世界收拢变深);复习候选以「退潮冲上岸的贝壳」形态出现,取代传统提醒推送 | 「今日状态」行 + review_candidates | **P1**(低成本,优先纳入) | |
| 144 | +| **D 沉积层与钻探** | 深海模式累计变量呈现:专注史沉积为地层(最早学的在最深处);复习流程=「钻探取芯」抵达特定地层 | 「累计专注」行(珊瑚地质层扩展为地层);复习入口 | P1 深海先行 / P2 全量 | |
| 145 | +| **B 纪录片旁白** | 关系层声音:日终/启动仪式时 AI 生成第二人称自然纪录片腔旁白(「今天,你下潜了 47 分钟……」) | StartupRitual 接线点 + 日终摘要 | **P2**(先纯文案内测,AI 味重则废) | |
| 146 | + |
| 147 | +**叠加纪律:** |
| 148 | + |
| 149 | +1. 三层不得新增任何「视觉主角」——主角永远只有熵:潮汐是它的呼吸,地层是它的记录,旁白是它的观察者。 |
| 150 | +2. B 层是唯一有内容风险的层(AI 文案质量):P2 先跑纯文案内测,通过「可转述测试」后才允许进入世界;否则永久封存。 |
| 151 | +3. 立项过滤器自查:三层均以用户过程数据为输入(记忆资产)、裸 LLM 无数据不可复刻、全部本地实现——三问通过。 |
| 152 | +4. 潮汐与沉积层的动效预算必须先登记第四条性能表方可实现。 |
| 153 | + |
| 154 | +--- |
| 155 | + |
| 156 | +> **裁决记录**:2026-08-03 项目负责人批准全文;第〇条范式冻结与第三条挂载点(掌握一个概念)确认生效。 |
| 157 | +> **当前进度**:P0 已完成(canvas 叙事场景验证通过,含潮汐/沉积层叠加效果,无修改意见);**P1 实施中**——第一批:世界状态模型 + 数据接线(worldState 派生层)。 |
0 commit comments