jiapuapp/docs/交接记录.md

家谱 APP 交接记录

更新时间：2026-07-13
用途：更换电脑或更换 GPT 后，先读本文件即可恢复当前工作上下文。
保密说明：账号、密码、令牌和其他敏感信息不记录在本文件。

1. 新接手者先做什么

按以下顺序阅读，不要跳过：

1. 根目录 AGENTS.md：项目工作约束，要求先确认依据、最小修改、修改后验证。
2. docs/规划.md：全项目范围、完成状态与推进顺序。
3. docs/design/D1_安卓视觉规范与页面壳.md：Android 视觉、兼容性、PNG 资产与背景规则。
4. docs/design/G01_我的家谱_设计记录.md：G01 已完成的施工与最终验收结论。
5. docs/superpowers/specs/2026-07-12-g01-reference-typography-design.md 与 docs/superpowers/plans/2026-07-12-g01-information-hierarchy.md：G01 的已确认规格与执行记录。

视觉唯一基准：

• docs/design/screens/G01-我的家谱-紧凑版设计稿-v5-Tabbar安全区.png

不要把“红色中国风”当作完成标准；G01 需要按此图逐区、逐字段、逐比例比对。

2. 项目与范围

• 项目：uni-app，目标为 Android，使用 HBuilderX 打包。
• 当前阶段：先完成全部页面视觉设计和小屏验收；暂不恢复接口联调、真实账号联调或 Android 打包。
• 当前正在处理：D2 / A-01 至 A-06 账户与首次使用设计；A-01 与 A-02 已于 2026-07-13 落地本地 UI 并等待运行时验收，G-01 我的家谱已验收完成。其余页面仍须先完成设计记录与效果稿归档再实现。
• 当前不做：iOS、PC 管理端、官网，以及新增业务接口。
• 本地展示数据的唯一来源：data/mock.js；G01 当前不调用远程 API。
• 本目录为 Git 仓库；不得重置文件或删除既有用户文件，提交时只暂存本轮受管文件。

3. 用户已确认的视觉规则

• 风格是“家祠卷轴”：朱砂页头、暖宣纸、古金细线、墨褐文字、淡墨山水/竹影；禁止绿色页面背景。
• 需要使用的图标、谱印框与云纹必须是项目内的透明 PNG；不能用文字、emoji、CSS 图形或网络图片替代可见图标。
• 参照图中的布局、字号、字段、图标可见面积和留白需要尽量一比一还原；不要只做“差不多”的国风页面。
• 要兼容老款 Android：用 rpx、Flex、边距与基础圆角；避免 CSS Grid、flex gap、clip-path、复杂滤镜和大面积动画。
• 每次完成一个可验收子项，更新 docs/规划.md 和对应设计记录；没有 HBuilderX 同尺寸截图确认时，不能勾选整个页面完成。

4. G01 当前实际状态

已施工并通过静态检查

• 朱砂顶部、项目 Logo、条件式通知红点、宣纸底纹、淡墨底图、底部 Tabbar。
• 当前家谱题签、四个快捷入口、分隔金线、创建/加入列表、新建按钮。
• 透明 PNG 资产已接入：快捷入口、Tab、通知、箭头、元信息图标、谱印框和新建云纹。
• 当前演示字段已统一为参考稿：
  • 当前家谱：汤氏家谱 / 河南·洛阳 / 158 位成员 / 管理员
  • 已加入家谱：汤氏宗谱 / 山东·济宁 / 286 位成员 / 成员
• 当前题签有标题/元信息分隔线；列表右侧角色和箭头应为同一水平基线；日期为“更新于”文字，不显示参考稿中没有的日历图标。

2026-07-13 最终验收结论

• 用户已提供 360 × 800、320 × 568（含滚动到底部）响应式预览，以及 HBuilderX Web 浏览器 Pixel 2 XL 常规屏预览。
• 已确认：顶部、题签、快捷入口、两条列表、新建按钮、山水和 Tabbar 无重叠或裁切；320 × 568 下新建按钮可完整露出在 Tabbar 上方。
• 用户明确确认可结项，故 G-01 已勾选完成。此结论不解除接口联调、真实账号联调或 Android 打包暂停。

5. G01 关键文件

作用	文件
G01 页面与当前题签/快捷入口/新建按钮	pages/genealogy/index.vue
G01 列表项	components/GenealogyCard.vue
顶部标题栏/Logo/通知点	components/PageHeader.vue
底部导航	components/AppTabbar.vue
展示数据	data/mock.js
视觉变量	styles/tokens.scss、styles/global.scss
G01 图标	static/assets/icons/
G01 背景	static/assets/backgrounds/
G01 契约检查	tests/g01-visual-contract.ps1
新 PNG 透明检查	tests/g01-asset-alpha-audit.ps1

6. 已知技术注意项

• tests/g01-visual-contract.ps1 用 UTF-8 Base64 形式检查中文展示字段。这是为了避免 Windows PowerShell 5.1 将无 BOM UTF-8 脚本中的中文字符串误读为乱码；不要把该段直接改回裸中文字面量。
• calendar-v1.png 已因为参考稿没有该图标而删除；不要再次接入日期图标。
• G01 的背景资产应继续使用 footer-mountain-bamboo.png，不要换回实心灰山的 footer-mountain-bamboo-v2.png。
• 题签透明角已经过检查；若再次出现白角，优先检查题签容器是否重新加上不透明的矩形底色。
• 所有新 PNG 在接入前都要检查：RGBA、四角透明、主体没有大量空白、显示尺寸符合 24dp/设计稿。

7. 复核命令

在项目根目录的 PowerShell 中运行：

powershell -ExecutionPolicy Bypass -File tests\g01-visual-contract.ps1
powershell -ExecutionPolicy Bypass -File tests\g01-asset-alpha-audit.ps1
powershell -ExecutionPolicy Bypass -File tests\compile-audit.ps1
powershell -ExecutionPolicy Bypass -File tests\uni-scss-injection.ps1
powershell -ExecutionPolicy Bypass -File tests\vue3-entry.ps1

最近一次结果：五项均为 PASS。这只证明代码和资产契约通过，不替代 HBuilderX 视觉验收。

8. 换电脑操作

1. 完整复制整个 jiapuapp 项目文件夹，保留 docs/、static/、tests/、data/ 和所有 Vue/SCSS 文件。
2. 新电脑安装 HBuilderX 后，直接“打开目录”选择复制后的项目根目录。
3. 将本文件和后续页面的新截图一起发给新的 GPT，并说明：“先读 docs/交接记录.md 与 AGENTS.md，按规划继续页面设计，不要改接口。”
4. 新 GPT 修改后，先运行第 7 节命令，再由用户在 HBuilderX 提供同尺寸截图复核。

9. 2026-07-13 流程纠正记录

• A-01 的历史效果稿 v1、v2 与当前效果稿 v3 均已归档；当前入口依据为 docs/design/screens/A01-启动登录引导-效果稿-v3-文字注册入口.png，对应说明见 docs/design/A01_启动登录引导_设计记录.md。
• A-01 的固定栅格、状态、独立背景/图标及 320 × 568、360 × 640、360 × 800、412 × 915 静态效果稿已归档并经审计；它们仍不替代 uni-app 页面实现后的 Android 运行时验收。
• 先前误建的 A-01 规格和“四个独立按钮”执行计划已降为失效历史；2026-07-13 已确认文字注册入口方案，唯一需求所有者为 docs/design/A01_启动登录引导_设计记录.md。用户随后授权 A-01 欢迎入口与 A-02 双标签登录页的本地 UI 落地；不得接接口、执行真实登录或替其他未设计页面造功能。
• 所有后续页面效果图必须先保存到 docs/design/screens/，并在对应页面设计记录写明用途、状态和验收缺口；未完成归档不得展示为可推进的设计成果。
• G-01 已于 2026-07-13 经用户确认结项；当前进入 D2 / A-01 的设计工作，接口、真实登录和 Android 打包仍暂停。
• A-01 入口页与 A-02 双标签登录页已于 2026-07-13 落地本地 UI：路由入口为 pages/auth/entry；只有在 A-01 显式勾选协议后才可进入 A-02。页面不调用接口、不写登录态、不跳转家谱；微信、注册、协议、忘记密码和验证码仅提示待相应页面或能力完成。A-01/A-02 运行时四尺寸验收仍待执行。
• A-01 首次本地预览与 v3 效果稿存在红头高度、按钮宽度和垂直节奏偏差。现已改为直接使用 docs/design/screens/A01-启动登录引导-效果稿-v3-文字注册入口.png 作为可见视觉层，并仅保留透明交互热区；下一次 Android 预览必须以该 v3 截图作同尺寸对比。