Skip to content

docs(design): 首屏三段式改版的画布/原型/规格进仓库(OpenDesign 产出) - #533

Merged
belliedmonkey merged 1 commit into
mainfrom
design/firstrun-3step
Sep 30, 2026
Merged

belliedmonkey merged 1 commit into
mainfrom
design/firstrun-3step

Conversation

@belliedmonkey

Copy link
Copy Markdown
Owner

1.19.0 首屏改版的设计来源进仓库。跟踪 issue:#532。

变更(只有 design/,不改产品代码)

design/firstrun-3step/ —— OpenDesign 项目的原始产出:

文件 是什么
firstrun-canvas.html 画布:每屏每态一板
firstrun-prototype.html 可点击原型:iPhone 390×800 走一遍冷启动;右上可切中国版
firstrun-spec.html 一页规格:唯一入口函数 · 状态表 · 就绪判据表 · 六条红线的判据
brand-spec.md · assets/* 品牌说明 · 板数据 · 样式
README.md 六条裁定 + 规格里六条红线 → 我们要落成的门禁对照表 + 已知非最终态

为什么先落这个

仓库规矩是动交互要画布先行,而这次是结构级改动(首屏三段式 + App 登录前提 + 就绪判据)。规格里已经逐条给出「怎么判红」,正是我们接下来要写进 npm test 的那六条 —— 先把它落进仓库,后续 PR 才能引用它。

品牌核验

生成的 CSS 用了我们的九个 token(terra #c67139 / 按钮 #ac6231 · sage #56633f / 已开启 #728157 · 奶油 #f5ead8 · 正文 #201e1d · 危险 #b3261e · Caprasimo · Figtree)—— 这个 daemon 上没有我们的 Organic 设计系统,品牌事实是以文字写进 prompt 的,未另发明一套。

验证

npm test → 2317 passed, 0 failed(design/ 不进构建,纯文档)

1.19.0 TestFlight 的第一条真机反馈:未登录首页太杂(设置链接 + 三个用不了的
功能入口 + 一句与登录卡自相矛盾的话),而两个设备包是懒加载 —— 新手路径无法
保证「配好了」。用户裁定三段式:屏1 登录(硬门)→ 屏2 资源包(硬门,无跳过)
→ 屏3 引导(可跳过),就绪 = 登录 ∧ 引擎 ∧ 识别包 ∧ 朗读包(不含扩展)。

本提交只落设计来源(不改产品代码):
- design/firstrun-3step/:画布 · 可点击原型 · 一页规格 · 品牌说明 · 板数据与样式
- design/firstrun-3step/README.md:六条裁定 + 规格里六条红线 → 我们要落成的门禁对照表
- 品牌已核验:生成的 CSS 用我们的九个 token(terra/sage/奶油/正文/危险 +
  Caprasimo/Figtree),未另发明一套

后续:文档先行(AGENTS.md 规则 2/3 窄化修订 · interaction-spec 首屏一节 ·
domain-design §9.2/§10 · learning-design §7.2/§8.10.1/§9.8)→ 门禁先红 → 代码
→ 中国版额度翻转 → 全矩阵 → 重打包 120/62/70/62。

(#532) (#528)

Co-Authored-By: opencode <noreply@opencode.ai>
Co-Authored-By: DeepSeek V4.1 Flash <noreply@deepseek.com>
Co-Authored-By: GLM 5.3 <noreply@zhipuai.cn>
@belliedmonkey
belliedmonkey merged commit 16f8305 into main Sep 30, 2026
5 checks passed
belliedmonkey added a commit that referenced this pull request Oct 4, 2026
main 只领先 2 笔(#533/#534,都是 OpenDesign 首屏三段式的文档落地,2026-10-01);
本分支领先 92 笔。唯一冲突在 `docs/interaction-spec.md` 的「App 首屏」两处:
main 是 2026-10-01 的**三段式**(登录 → 资源包 → 引导),本分支是 2026-10-03 用户裁定后的
**两段式**(撤掉引导屏)。两处都取本分支(更新的产品裁定)。

main 的两处非冲突新增已自动合入并保留:
- 「登录永远不是墙 —— 这一条只对浏览器扩展成立」的 #532 限定;
- 「首次运行引导(App 侧)」下的 2026-10-01 更新块。

目的:让 PR #535 与 main 可合并(此前 mergeStateStatus: DIRTY),从而触发 CI。
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant