设计完成30%

2026-07-14 07:01:32 +08:00
parent 355f47976a
commit 1015e60ff7
95 changed files with 1991 additions and 349 deletions
@@ -1,110 +1,25 @@
 # 家谱 APP 交接记录

-> 更新时间：2026-07-13  
-> 用途：更换电脑或更换 GPT 后，从本文件恢复项目上下文。
-> 当前阶段：P-00 地基重整收尾，**不要跳到 A02**。
+> 更新时间：2026-07-14
+> 完整恢复手册见：[视觉设计交接手册](design/视觉设计交接手册.md)。本文件只保留当前真实停点，避免与历史草案互相矛盾。

-## 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`
+- `pages.json` 已登记 59 条最终编号路由，并由 `tests/full-page-visual-contract.ps1` 约束。
+- 用户已经验收并冻结可见效果的页面：A01 启动/登录引导、G01 我的家谱。
+- A02 账号登录已完成资产化重做、运行截图与自动回归；尚待用户审美确认，**不能标记为完成，也不能向 A03--A06 传播**。
+- 其余页面可浏览，但包含 `ModulePage.vue`/`page-catalog.js` 的临时第一版壳，不能当作最终视觉设计。
+- 不提交、不推送、不上传 Git；由用户自行处理。

-## 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，也不是接接口。
+1. 阅读 `AGENTS.md`、[总规划](规划.md)、[D1 视觉规范](design/D1_安卓视觉规范与页面壳.md)、[P00 资产台账](design/P00_页面结构与资产清单.md) 与[完整交接手册](design/视觉设计交接手册.md)。
+2. 保留工作区改动，运行 `git status --short`；不执行 reset、checkout 或覆盖用户文件。
+3. 先让用户查看 A02 的 `A02-before-after-360x800.png`、`A02-after-412x915.png` 和 `A02-sms-360x800.png`。用户未确认前，只能继续调整 A02。
+4. 需要自行截图时，用 `scripts/capture-chrome-page.js` 连接专用 Chrome 的调试端口 `9222`；完整启动命令和截图方式见交接手册第 5 节。

-## 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 和用户最新消息为准；发生冲突时，以用户最新确认优先。
+- A02 相关的 `a02-asset-alpha-audit`、`a01-a02-ui-contract`、`compile-audit` 和全量页面路由契约均已在本轮通过；后续修改仍要重新运行受影响检查。
+- `design-qa.md` 当前是 `final result: blocked`，唯一阻塞是用户尚未确认 A02 的审美结果。
+- 现有运行图来自 H5 Chrome 调试；最终 Android/HBuilderX 真机/模拟器视觉复核仍待补做，不能被 H5 截图替代。