Skip to content

docs(firstrun): App 首屏三段式 —— AGENTS.md 规则 2/3 窄化修订 + 交互规约新一节 + 语音包时机 - #534

Merged
belliedmonkey merged 2 commits into
mainfrom
docs/firstrun-3step-spec
Sep 30, 2026
Merged

belliedmonkey merged 2 commits into
mainfrom
docs/firstrun-3step-spec

Conversation

@belliedmonkey

Copy link
Copy Markdown
Owner

按仓库的治理条:动交互要画布先行(画布见 #533),且领域设计改动必须先改文档、过评审,代码才动。这是那一版文档。跟踪 issue:#532。

1 · AGENTS.md 规则 2/3 —— 窄化修订(保留原文,加日期化注)

规则 2 加注(要点):承重的不动点「永远不付费的人有完整产品」保持不变;被削掉的是它的后半句「也永远不登录」—— App 现在要先登录。浏览器扩展不受影响(仍免登录、自带 key),所以「免费路径不依赖我们的服务端」这条承重线没动,免费路径的家仍在扩展侧。代价如实写:App 的未登录用户不再有完整产品。

规则 3 加注(要点):「产品必须对未登录用户完整」自 2026-10-01 起只对浏览器扩展成立;App 改为「登录是前提」。服务器仍只承担本机做不了的事;账号与同步仍免费;不付费仍然完整 —— 变的只是「不登录」。

这两条是宪法级改动,所以我不动证据链:原文一字不改,只在下面加日期化注,写明理由(#532 的实测)与代价。

2 · docs/interaction-spec.md —— 新增「App 首屏三段式(2026-10-01,#532)」

屏 守卫 内容 可跳过
屏 1 · 登录 !isLoggedIn 只有登录:品牌 + 一句话 + Apple / Google / 邮箱。无设置、无功能入口、无复习入口 否
屏 2 · 资源包 已登录且缺包 识别语言包 + 高质量朗读包:体积 · 进度 · 失败重试 · 网络前提 否
屏 3 · 引导 就绪且没看过 现有 welcome → firstuse → ext 是
  • 就绪 = 登录 ∧ 引擎可解析 ∧ 识别语言包 ∧ 朗读包(不含 Safari 扩展,#485 口径不变)
  • 老用户直进首页;已登录缺包 ⇒ 只出补齐单屏;唯一降级:该语种不支持识别 ⇒ 只下朗读包
  • 六条红线(判据原文在 design/firstrun-3step/firstrun-spec.html)

另:给旧节「首次运行引导(App 侧)」加 2026-10-01 注(signin 已移出为屏 1),并把该节所在的额度段里「登录永远不是墙」限定为「只对浏览器扩展成立」。

3 · docs/learning-design.md

  • §8.10.1 标「✅ 2026-09-30 用户裁定:通过」,并写明 1.19.0 范围内含中国版额度翻转(境内后端自 1.15.0 已在线;缺的是账本落进同一台机器 + 部署中继 + 翻 grant.china.ready)
  • §9.1.1 记前置入口:屏 2 是硬门;原来那四处懒加载入口仍保留,用于「模型被系统清掉」「用户后来换语言」

没动的

docs/domain-design.md §10 不改 —— 这次不碰 store 契约 / 共享面单源 / hidden 纪律 / 注入 UI 边界,所以那层没有变更。

验证

npm test → 2317 passed, 0 failed。没有动任何代码。

这是一道门,不是一次提交

按规矩,代码要等这份文档过评审。你确认(尤其是 AGENTS.md 那两段注的措辞)之后,我才往下走:门禁先红(六条)→ 代码 → 中国版额度翻转 → 全矩阵 → 重打包 120/62/70/62。

belliedmonkey and others added 2 commits October 1, 2026 00:32
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>
代码之前先改规约(AGENTS.md 的治理条:动交互要画布先行,且领域设计改动先过评审)。
画布与判据见 design/firstrun-3step/(#533),跟踪 #532。

- AGENTS.md 规则 2/3:日期化窄化修订(保留原文)。承重的两条不动 ——「不付费仍完整」与
  「免费路径不依赖我们的服务端」;被削的只是「**不登录也完整**」,且**只对 App 成立**
  (扩展仍免登录、自带 key 可用,免费路径的家没搬)。代价如实写:App 的未登录用户不再
  有完整产品。
- docs/interaction-spec.md:新增「App 首屏三段式(2026-10-01,#532)」—— 屏 1 登录(硬门)
  → 屏 2 资源包(硬门,无跳过)→ 屏 3 引导(可跳过);就绪 = 登录 ∧ 引擎 ∧ 识别包 ∧ 朗读包
  (不含扩展);老用户直进 / 缺包只出补齐屏;唯一降级(该语种不支持识别)。附六条红线。
  另给旧节「首次运行引导(App 侧)」加 2026-10-01 注(`signin` 已移出为屏 1),并把
  「登录永远不是墙」限定为「只对浏览器扩展成立」。
- docs/learning-design.md:§8.10.1 标「2026-09-30 用户裁定:通过」并写明 1.19.0 含中国版
  额度翻转(境内后端已在线,缺账本同机 + 中继 + 翻 ready);§9.1.1 记前置入口(屏 2 是硬门,
  原四处懒加载入口仍用于模型被清掉/换语言)。

npm test 2317 绿。未动代码。

(#532) (#533)

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 28007e0 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