jiapuapp/docs/design/A01_启动登录引导_设计记录.md

A-01 启动 / 登录引导设计记录

状态：文字注册入口方案已确认，D2 / A-01 进行中；尚未完成新版效果稿、布局验收或页面实现。

本页设计事实的唯一归档位置为本文件。旧的 2026-07-13-a01-login-guide-design.md 与 2026-07-13-a01-login-guide.md 仅保留为失效历史，不可作为实现或推进下一页的依据。

1. 已归档的美术锚点

• 文件：screens/A01-启动登录引导-效果稿-v1-显式协议.png
• 效果稿 v2：screens/A01-启动登录引导-效果稿-v2-独立注册.png，记录此前“四个独立按钮”的尝试；该入口结构已失效，不作当前方案依据。
• 当前效果稿 v3：screens/A01-启动登录引导-效果稿-v3-文字注册入口.png，体现本记录第 2 节的当前入口层级。
• 用途：保留本轮已确认的“家祠卷轴”欢迎页美术方向，不作为可直接还原的代码布局图，也不作为功能图标资产。
• 画面方向：朱砂家祠红头、暖宣纸主体、古金细线与云纹、墨褐标题、两侧淡墨建筑/竹影与底部山水。登录欢迎页后续必须使用独立的红头/宣纸背景组合，不复用 G01 的列表页大山水底图。

2. 已确认的页面结构与交互

• 标题区保留“家谱 / 为家族留存可传承的记忆”，使用美术锚点中的朱砂家祠红头、暖宣纸、古金云纹、墨褐文字与淡墨建筑/竹影层次。
• 操作区只保留两个大按钮和一个文字入口：朱砂主按钮“登录”、古金描边按钮“微信登录”，以及其下方的“还没有账号？注册账号”。“注册账号”仅为朱砂红可点击文字，不再作为独立大按钮。
• 入口顺序：登录为主入口；微信登录为次入口；注册账号为辅助文字入口。
• “登录”前往 A-02，且 A-02 内固定使用“账号密码登录 / 手机验证码登录”双标签切换，默认显示账号密码登录。微信入口由 A-03 承接授权中、取消与失败回跳状态。
• 注册账号入口前往 A-04；忘记密码属于 A-05，不在 A-01 新增入口。
• 协议必须为用户主动勾选：初始未勾选，可分别打开《家谱用户协议》和《隐私政策》。不得使用“登录即表示同意”或任何默认同意文案；未勾选时登录操作应明确提示用户先确认协议。

3. 固定布局与状态边界

• 页面采用纵向滚动；320 × 568 下两个按钮、注册文字和协议行可以滚动，但任一按钮文字、注册文字、协议行和底部内容不得被系统导航区遮挡。
• A-01 的登录与微信功能图标均需采用独立本地透明 PNG；微信标志只使用官方或许可来源的原色透明 PNG，不自行重绘或改色。账号密码与手机号验证码的表单图标归 A-02 设计时确定。
• A-01 只设计欢迎、入口与协议未勾选提示。账号密码与手机号验证码表单均归 A-02，微信授权结果归 A-03，注册归 A-04，忘记密码归 A-05。
• A-01 正常态必须展示两个按钮、注册文字入口和未勾选协议；点击任一需要授权的入口但未勾选协议时，仅提示“请先阅读并同意相关协议”，不视为用户已同意。
• 固定设计画布为 750rpx 宽；内容宽度 638rpx，左右各 56rpx。朱砂家祠头图高 196rpx；标题与副标题区域从头图下方开始，操作区首按钮顶边固定为 646rpx。
• 主按钮高度 108rpx，微信按钮高度 108rpx，二者间距 30rpx；注册文字在微信按钮下方 56rpx，字号 28rpx，整行居中且不得换行。两个按钮文字字号 36rpx，均单行居中。
• 协议行使用 26rpx 字号，页面最小底部内边距为 calc(32rpx + env(safe-area-inset-bottom))。320 × 568 时页面允许纵向滚动，协议行与任一入口均不得落入系统导航区。
• 仅作静态设计验证，不代表 uni-app 运行时验收；页面实现后仍须在 Android 320 × 568、360 × 640、360 × 800、412 × 915 上重新验收。

状态	触发	A-01 可见结果	去向
初始未勾选	首次进入	两个按钮、注册文字与空复选框	留在 A-01
未同意协议	点击登录、微信登录或注册账号	提示“请先阅读并同意相关协议”，不跳转、不改变勾选状态	留在 A-01
登录已确认协议	点击“登录”	结束 A-01 引导	A-02，默认账号密码登录标签
微信已确认协议	点击“微信登录”	结束 A-01 引导	A-03，显示授权中、取消或失败回跳
注册已确认协议	点击“注册账号”文字	结束 A-01 引导	A-04

A-01 资产清单

资产	用途	来源或生成提示	尺寸与验收
static/assets/backgrounds/auth-ancestral-header-v1.png	独立朱砂家祠头图	2026-07-13 内置图像生成：朱砂红、古金家祠线稿、无文字无徽标的浅横幅	750 × 196px PNG；不复用 G-01 背景
static/assets/backgrounds/auth-rice-paper-v1.jpg	独立暖宣纸底纹	2026-07-13 内置图像生成：暖象牙色宣纸、低对比纤维与边缘暗纹、中心留白	750 × 1334px JPG；不复用 G-01 背景
static/assets/backgrounds/auth-ink-scenery-v1.png	独立淡墨建筑、竹影与山水叠层	2026-07-13 内置图像生成：淡灰米色、底部山水亭台、右侧竹影、中心留白	750 × 1334px PNG；不复用 G-01 背景
static/assets/icons/auth/login-outline-v1.png	A-01 登录按钮的线性人物图标	项目既有 static/assets/icons/tab/profile-v4.png 的本地复用，未改色、未重绘	96 × 96px RGBA PNG；透明角与可见像素审计通过
static/assets/icons/auth/wechat-licensed-v1.png	A-01 微信登录按钮的微信图标	Icons8 的 https://img.icons8.com/color/96/weixing.png，获取日期 2026-07-13；使用条件见 https://icons8.com/license	96 × 96px RGBA PNG；透明角与可见像素审计通过；免费使用须在应用“关于/设置”及应用商店描述中保留 Icons8 署名链接

4. 静态设计验收与剩余缺口

• 静态设计验收已覆盖 320 × 568、360 × 640、360 × 800、412 × 915；四个尺寸均保持两个大按钮与单行文字注册入口。
• 归档文件：320 × 568、360 × 640、360 × 800、412 × 915。
• 此结论只验证设计稿与固定栅格，不替代 uni-app 页面实现后的 Android 运行时验收。
• 仍未确定《家谱用户协议》与《隐私政策》的最终页面去向及返回路径；在这两页完成设计前，A-01 不得标记为完整设计完成。
• 页面实现阶段仍须按本记录在 Android 实机或同等运行环境复核四个尺寸的安全区、滚动与文字折行。

5. 推进约束

• 当前正式工作是 D2 / A-01 启动登录引导 的设计；A-02 尚未开始设计，但其职责已明确为两种登录方式的双标签登录页。
• 只有确定协议页面的最终去向，并完成本文件第 4 节所述的运行时验收后，A-01 才能进入“设计完成”状态。
• 用户已于 2026-07-13 授权落地 A-01 欢迎入口与 A-02 双标签登录页的本地 UI；仍不接接口、不执行真实登录、不改 Android 打包配置。实现细节的唯一所有者见 docs/superpowers/specs/2026-07-13-a01-a02-static-ui-implementation-design.md。