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 打包。
• 当前正在处理：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 位成员 / 成员
• 当前题签有标题/元信息分隔线；列表右侧角色和箭头应为同一水平基线；日期为“更新于”文字，不显示参考稿中没有的日历图标。

必须继续做的事

1. 用 HBuilderX 刷新 G01，并使用与参考稿相同的手机预览尺寸截屏。
2. 将新截图与 v5 参考稿并排比对，重点检查：
   • 顶部家谱题签的字体、字段、分隔线和三组元信息是否同一行；
   • 四个快捷图标的实际可见面积与文字大小；
   • 两条列表的谱印、标题、地点/成员、日期、右侧角色和箭头基线；
   • 新建按钮的云纹、文字、底部山水和 Tabbar 安全区。
3. 有任何差异时，只改对应 G01 组件并重新截图；不要提前勾选 G-01。
4. 最终还要按 320 × 568 和 360 × 800 做小屏检查，确认无重叠、无裁切、无底部遮挡。

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. 将本文件和新的 HBuilderX 截图一起发给新的 GPT，并说明：“先读 docs/交接记录.md 与 AGENTS.md，继续 G01 的视觉验收，不要改接口。”
4. 新 GPT 修改后，先运行第 7 节命令，再由用户在 HBuilderX 提供同尺寸截图复核。