# 家谱 APP 交接记录

> 更新时间：2026-07-13  
> 用途：更换电脑或更换 GPT 后，从本文件恢复项目上下文。
> 当前阶段：P-00 地基重整收尾，**不要跳到 A02**。

## 1. 新接手者先读什么

1. 根目录 `AGENTS.md`：最小修改、先验证、不得覆盖未知改动。
2. [总规划](规划.md)：59 个页面的范围、当前状态和推进顺序。
3. [D1 安卓视觉地基规范](design/D1_安卓视觉规范与页面壳.md)：视觉、资产和注释硬规则。
4. [P00 页面结构与资产清单](design/P00_页面结构与资产清单.md)：页面重命名映射、资产去留和清理进度。
5. A01、G01 设计记录与下列冻结锚点：
   - `docs/design/screens/A01-启动登录引导-栅格验收-412x915.png`
   - `docs/design/screens/G01-我的家谱-紧凑版设计稿-v5-Tabbar安全区.png`

## 2. 当前事实

- 项目：Android `uni-app`，使用 HBuilderX；不做 iOS、H5、PC、后台或官网。
- 全量规划是 59 个页面／状态单元；`pages.json` 当前只有 15 个已注册路由。
- 用户已通过视觉验收的只有两个页面：A01 启动／登录引导、G01 我的家谱。
- A01、G01 是冻结视觉基准：可以抽取和整理内部实现，但不得改变用户已验收的可见效果。
- 其余页面现有代码只算功能骨架或本地 UI，不能标记为视觉完成。
- 已完成：15 个路由的语义化文件／跳转迁移、35 项在用资产迁入统一目录、24 项运行时零引用旧资产删除、公共页面／组件中文用途注释。
- A01 主／次完整按钮候选已生成并保存到项目，但比例尚不符合现有设计，尚未接入页面；当前第一优先级仍是 P-00 收尾：复核／重做候选，验收后替换旧角标拼接，再做 A01、G01 截图回归；不是继续 A02，也不是接接口。

## 3. 用户明确确认的规则

- 以 A01、G01 已完成样式为项目地基；不能推翻或另起一套画风。
- 资产先行：先形成一套可复用、已验收的资产包，再按资产包设计后续页面。
- 所有可见装饰使用图片资产；不使用 CSS／SVG 绘制祥云、边框、分隔纹、按钮边角等可见装饰。
- 不透明图片承担自身底色、纹理、完整按钮／卡片／页头背景；透明 PNG 只承担 Logo、图标、祥云、纹样、边框等叠加元素。
- 禁止把整页设计图或局部截图裁切后拼进页面；禁止按钮由角标、边线和 CSS 底色拼接。
- 页面、路由、资产都必须用语义名和页面编号；旧文件、重复版本和未引用资产确认后删除。
- 关键 JS、Vue 结构、资产图层与关键样式必须有中文注释；注释说明用途和约束，不堆砌无意义逐行注释。
- JS 和页面代码只做已确认的需求：不发散、不预埋猜测功能、不新增无关依赖、不保留无用代码。

## 4. P-00 应按什么顺序执行

1. 运行 `git status --short`，保留未知改动；不得使用 `git reset --hard` 或覆盖用户文件。
2. 依据 P00 文档核对 15 个当前路由的页面编号和目标语义名。
3. 扫描所有 `/static/assets/` 引用，填写每项资产的用途、透明属性、引用位置与去留状态。
4. 建立新的 `foundation/opaque`、`foundation/transparent`、`modules/<module>` 资产结构和资产清单。
5. 同轮更新 `pages.json`、跳转路径、测试和页面文件名；确认无引用后才删除旧路径和旧资产。
6. 为 A01 生成并单独验收两张完整不透明按钮图片，替换现有 CSS 底色加四角 PNG 的过渡实现；不得裁切设计图，也不得改变当前画风。
7. 运行最小相关审计、编译检查、A01/G01 四尺寸截图核对和 `git diff --check`；视觉是否通过以用户换电脑后的设计图复核为准。

## 5. 当前停点（下次从这里继续）

本次已经完成且通过回归：

- 15 个已注册路由改为“页面编号－语义名”文件和 URL；旧入口已移除。
- 35 项运行时资产进入 `static/assets/foundation` 或 `static/assets/modules/genealogy`，并按 `opaque`／`transparent` 分类。
- 24 项经运行时引用扫描确认无引用的旧副本已删除。
- 页面和 3 个公共组件均补上中文用途／图层注释。
- 已通过 `foundation-structure-audit`、`foundation-asset-audit`、A01/A02、G01、核心流程、编译、清单、SCSS、Vue 入口以及 `git diff --check` 回归。

当前没有改动 A01、G01 的可见布局。A01 仍使用旧的“CSS 底色 + 四角 PNG”按钮过渡实现，因此不能称为地基最终验收完成。

为避免下次电脑丢失进度，已把两张未接入候选放进项目：

| 文件 | 来源与状态 | 下次处理 |
| --- | --- | --- |
| `static/assets/foundation/opaque/a01-primary-button-candidate.png` | 图像生成工具生成，1983×793，完整朱砂按钮皮肤；未接入 | 比例约 2.5:1，与现有按钮约 3.6:1 不一致；不能裁切设计图或硬拉伸，需按设计图重新生成／确认。 |
| `static/assets/foundation/opaque/a01-secondary-button-candidate.png` | 图像生成工具生成，1983×793，完整宣纸按钮皮肤；未接入 | 与主按钮同样先重做或确认比例、角纹、金边，再进入页面。 |

下次严格按此顺序继续：

1. 打开 A01 设计图和当前候选，先确认按钮的目标比例、边框粗细、四角纹样和红／宣纸颜色；候选不合格就重新生成，不接入。
2. 两张完整不透明按钮资产分别通过图片尺寸、完整四边框、无截图裁切和设计图人工比对后，才替换 A01 的 CSS 背景、边框及 `auth-button-corner.png` 四角节点。
3. 更新 A01 资产台账和最小测试；运行页面契约、资产审计、编译检查。
4. 在 320 × 568、360 × 640、360 × 800、412 × 915 截图；A01、G01 都须与设计图再次并排验收。用户可撤销此前“通过”，以新的设计图复核为准。
5. 用户确认 P-00 后，才开始 A02；后续每个模块先定完整资产包和母版，再批量实现页面，禁止边做边换画风。

## 6. 现有路由概况

当前路由为：

```text
pages/auth/a01-entry
pages/auth/a02-login
pages/genealogy/g01-my-genealogies
pages/genealogy/g03-create-genealogy
pages/genealogy/g05-genealogy-overview
pages/genealogy/g06-search-genealogies
pages/genealogy/g10-application-review
pages/genealogy/g04-first-ancestor
pages/skeleton/content-list-skeleton
pages/family/f02-publish-feed
pages/tree/t01-tree-overview
pages/tree/t03-member-profile
pages/family/f01-family-feed
pages/profile/m01-profile-home
pages/notification/n01-message-center
```

这些路径已完成当前 15 个路由的语义化迁移；逐项状态与资产台账见 P00 文档。不要新增无编号的 `index.vue`、`list.vue`、`detail.vue` 作为最终页面。

## 7. 运行与验证

- 现有测试位于 `tests/`；改动前后优先执行受影响页面的审计脚本。
- A01 相关：`tests/a01-a02-ui-contract.ps1`、`tests/a01-asset-alpha-audit.ps1`、`tests/a01-design-record-audit.ps1`。
- 公共检查：`tests/foundation-structure-audit.ps1`、`tests/foundation-asset-audit.ps1`、`tests/compile-audit.ps1`、`tests/manifest-json.ps1`、`git diff --check`。
- 截图验收尺寸：320 × 568、360 × 640、360 × 800、412 × 915；A01、G01 必须至少复核 412 × 915。

## 8. 已知工作区注意事项

- 工作区可能带有用户未提交修改。只处理当前任务涉及文件；提交时只暂存本轮文件。
- 历史 `docs/superpowers/*a01*reference-asset-rebuild*` 与旧 G01 设计记录中存在已废弃的路径和“截图／切片式”尝试；不能作为当前实施依据。
- 当前依据永远以本文件、`docs/规划.md`、D1、P00 和用户最新消息为准；发生冲突时，以用户最新确认优先。