修改未完成

docs/交接记录.md

@@ -1,110 +1,110 @@
 # 家谱 APP 交接记录
 
 > 更新时间：2026-07-13  
-> 用途：更换电脑或更换 GPT 后，先读本文件即可恢复当前工作上下文。  
-> 保密说明：账号、密码、令牌和其他敏感信息不记录在本文件。
+> 用途：更换电脑或更换 GPT 后，从本文件恢复项目上下文。
+> 当前阶段：P-00 地基重整收尾，**不要跳到 A02**。
 
-## 1. 新接手者先做什么
+## 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`
 
-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 的已确认规格与执行记录。
+## 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，也不是接接口。
 
-- `docs/design/screens/G01-我的家谱-紧凑版设计稿-v5-Tabbar安全区.png`
+## 3. 用户明确确认的规则
 
-不要把“红色中国风”当作完成标准；G01 需要按此图逐区、逐字段、逐比例比对。
+- 以 A01、G01 已完成样式为项目地基；不能推翻或另起一套画风。
+- 资产先行：先形成一套可复用、已验收的资产包，再按资产包设计后续页面。
+- 所有可见装饰使用图片资产；不使用 CSS／SVG 绘制祥云、边框、分隔纹、按钮边角等可见装饰。
+- 不透明图片承担自身底色、纹理、完整按钮／卡片／页头背景；透明 PNG 只承担 Logo、图标、祥云、纹样、边框等叠加元素。
+- 禁止把整页设计图或局部截图裁切后拼进页面；禁止按钮由角标、边线和 CSS 底色拼接。
+- 页面、路由、资产都必须用语义名和页面编号；旧文件、重复版本和未引用资产确认后删除。
+- 关键 JS、Vue 结构、资产图层与关键样式必须有中文注释；注释说明用途和约束，不堆砌无意义逐行注释。
+- JS 和页面代码只做已确认的需求：不发散、不预埋猜测功能、不新增无关依赖、不保留无用代码。
 
-## 2. 项目与范围
+## 4. P-00 应按什么顺序执行
 
-- 项目：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 仓库；不得重置文件或删除既有用户文件，提交时只暂存本轮受管文件。
+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`；视觉是否通过以用户换电脑后的设计图复核为准。
 
-## 3. 用户已确认的视觉规则
+## 5. 当前停点（下次从这里继续）
 
-- 风格是“家祠卷轴”：朱砂页头、暖宣纸、古金细线、墨褐文字、淡墨山水/竹影；禁止绿色页面背景。
-- 需要使用的图标、谱印框与云纹必须是项目内的透明 PNG；不能用文字、emoji、CSS 图形或网络图片替代可见图标。
-- 参照图中的布局、字号、字段、图标可见面积和留白需要尽量一比一还原；不要只做“差不多”的国风页面。
-- 要兼容老款 Android：用 rpx、Flex、边距与基础圆角；避免 CSS Grid、`flex gap`、`clip-path`、复杂滤镜和大面积动画。
-- 每次完成一个可验收子项，更新 `docs/规划.md` 和对应设计记录；没有 HBuilderX 同尺寸截图确认时，不能勾选整个页面完成。
+本次已经完成且通过回归：
 
-## 4. G01 当前实际状态
+- 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”按钮过渡实现，因此不能称为地基最终验收完成。
 
-- 朱砂顶部、项目 Logo、条件式通知红点、宣纸底纹、淡墨底图、底部 Tabbar。
-- 当前家谱题签、四个快捷入口、分隔金线、创建/加入列表、新建按钮。
-- 透明 PNG 资产已接入：快捷入口、Tab、通知、箭头、元信息图标、谱印框和新建云纹。
-- 当前演示字段已统一为参考稿：
-  - 当前家谱：`汤氏家谱 / 河南·洛阳 / 158 位成员 / 管理员`
-  - 已加入家谱：`汤氏宗谱 / 山东·济宁 / 286 位成员 / 成员`
-- 当前题签有标题/元信息分隔线；列表右侧角色和箭头应为同一水平基线；日期为“更新于”文字，不显示参考稿中没有的日历图标。
+为避免下次电脑丢失进度，已把两张未接入候选放进项目：
 
-### 2026-07-13 最终验收结论
+| 文件 | 来源与状态 | 下次处理 |
+| --- | --- | --- |
+| `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，完整宣纸按钮皮肤；未接入 | 与主按钮同样先重做或确认比例、角纹、金边，再进入页面。 |
 
-- 用户已提供 `360 × 800`、`320 × 568`（含滚动到底部）响应式预览，以及 HBuilderX Web 浏览器 `Pixel 2 XL` 常规屏预览。
-- 已确认：顶部、题签、快捷入口、两条列表、新建按钮、山水和 Tabbar 无重叠或裁切；`320 × 568` 下新建按钮可完整露出在 Tabbar 上方。
-- 用户明确确认可结项，故 G-01 已勾选完成。此结论不解除接口联调、真实账号联调或 Android 打包暂停。
+下次严格按此顺序继续：
 
-## 5. G01 关键文件
+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；后续每个模块先定完整资产包和母版，再批量实现页面，禁止边做边换画风。
 
-| 作用 | 文件 |
-| --- | --- |
-| 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. 现有路由概况
 
-## 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
-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
+```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
 ```
 
-最近一次结果：五项均为 `PASS`。这只证明代码和资产契约通过，**不替代 HBuilderX 视觉验收**。
+这些路径已完成当前 15 个路由的语义化迁移；逐项状态与资产台账见 P00 文档。不要新增无编号的 `index.vue`、`list.vue`、`detail.vue` 作为最终页面。
 
-## 8. 换电脑操作
+## 7. 运行与验证
 
-1. 完整复制整个 `jiapuapp` 项目文件夹，保留 `docs/`、`static/`、`tests/`、`data/` 和所有 Vue/SCSS 文件。
-2. 新电脑安装 HBuilderX 后，直接“打开目录”选择复制后的项目根目录。
-3. 将本文件和后续页面的新截图一起发给新的 GPT，并说明：“先读 `docs/交接记录.md` 与 `AGENTS.md`，按规划继续页面设计，不要改接口。”
-4. 新 GPT 修改后，先运行第 7 节命令，再由用户在 HBuilderX 提供同尺寸截图复核。
+- 现有测试位于 `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。
 
-## 9. 2026-07-13 流程纠正记录
+## 8. 已知工作区注意事项
 
-- A-01 的历史效果稿 v1、v2、v3 与四尺寸栅格稿均已归档；当前协议未勾选状态的运行时视觉依据为 `docs/design/screens/A01-启动登录引导-栅格验收-412x915.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 首次本地预览与 412 × 915 栅格验收图存在红头高度、按钮宽度和垂直节奏偏差。整图视觉层方案已被用户否决并撤销；现以真实 DOM、分层背景和按钮图标重建页面，下一次 Android 预览必须以该图作同尺寸对比。
+- 工作区可能带有用户未提交修改。只处理当前任务涉及文件；提交时只暂存本轮文件。
+- 历史 `docs/superpowers/*a01*reference-asset-rebuild*` 与旧 G01 设计记录中存在已废弃的路径和“截图／切片式”尝试；不能作为当前实施依据。
+- 当前依据永远以本文件、`docs/规划.md`、D1、P00 和用户最新消息为准；发生冲突时，以用户最新确认优先。