家谱 APP 交接记录

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

1. 新接手者先读什么

根目录 AGENTS.md：最小修改、先验证、不得覆盖未知改动。
总规划：59 个页面的范围、当前状态和推进顺序。
D1 安卓视觉地基规范：视觉、资产和注释硬规则。
P00 页面结构与资产清单：页面重命名映射、资产去留和清理进度。
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 应按什么顺序执行

运行 git status --short，保留未知改动；不得使用 git reset --hard 或覆盖用户文件。
依据 P00 文档核对 15 个当前路由的页面编号和目标语义名。
扫描所有 /static/assets/ 引用，填写每项资产的用途、透明属性、引用位置与去留状态。
建立新的 foundation/opaque、foundation/transparent、modules/<module> 资产结构和资产清单。
同轮更新 pages.json、跳转路径、测试和页面文件名；确认无引用后才删除旧路径和旧资产。
为 A01 生成并单独验收两张完整不透明按钮图片，替换现有 CSS 底色加四角 PNG 的过渡实现；不得裁切设计图，也不得改变当前画风。
运行最小相关审计、编译检查、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，完整宣纸按钮皮肤；未接入	与主按钮同样先重做或确认比例、角纹、金边，再进入页面。

下次严格按此顺序继续：

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

6. 现有路由概况

当前路由为：

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 和用户最新消息为准；发生冲突时，以用户最新确认优先。

7.7 KiB Raw Blame History Unescape Escape