jiapuapp/docs/交接记录.md

家谱 APP 交接记录

更新时间：2026-07-14 完整恢复手册见：视觉设计交接手册。本文件只保留当前真实停点，避免与历史草案互相矛盾。

当前状态

• pages.json 已登记 55 条最终编号路由，并由 tests/full-page-visual-contract.ps1 约束。
• 用户已经验收并冻结可见效果的页面：A01 启动/登录引导、A02 账号登录、A04 注册账号、A05 重置密码、A06 登录状态、G01 我的家谱。
• A02 已完成资产化重做、运行截图与自动回归，并于 2026-07-14 获用户视觉验收；A03 已删除，A02 的短信 Tab 是唯一手机号验证码登录入口；A04 已于 2026-07-14 完成平衡修订并获用户视觉验收；A05、A06 已于同日获用户视觉验收。不能改变 A01、A02、A04、A05、A06、G01、G03 的已验收可见效果。G01 的 ?state=empty 已获用户审美确认；G04 已按用户确认合并为 G03 的 ?step=ancestor，G03 双步骤已获用户继续授权通过。G07 已收敛为 G06 的初始／结果／无结果状态。G06 经过多轮审视后，用户选定最近 ImageGen 第 3 稿的「朱砂题签 + 独立输入框 + 独立按钮」方向；题签中原本的通用印玺已改为项目真实 brand-seal.png。当前仅保存了该最终候选的初始态运行图，结果态和无结果态的同版重新截图尚未完成；G06 尚未获用户视觉验收，不能写成已完成或冻结。
• 其余页面可浏览，但包含 ModulePage.vue/page-catalog.js 的临时第一版壳，不能当作最终视觉设计。
• 不提交、不推送、不上传 Git；由用户自行处理。

新电脑的第一步

1. 按顺序阅读 AGENTS.md、本文件、完整交接手册、总规划、D1 视觉规范、P00 资产台账、docs/superpowers/plans/2026-07-13-product-design-visual-refinement.md、design-qa.md；然后先用中文向用户复述当前停点，不改代码。
2. 保留工作区改动，运行 git status --short；不执行 reset、checkout 或覆盖用户文件。
3. A02、A04、A05、A06 已验收、A03 已删除；A04 最终证据为 A04-after-balance-360x800.png 与 A04-after-balance-412x915.png，A05 证据为 A05-after-360x800.png 与 A05-after-412x915.png，A06 证据为 A06-after-360x800.png、A06-after-412x915.png 与 A06-restricted-360x800.png。G01 默认态前后比对为 G01-default-before-after-360x800.png，空状态已验收；G03 双步骤证据为 G03-create-after-360x800.png、G03-ancestor-after-360x800.png、G03-ancestor-after-412x915.png，均已获用户继续授权通过。G06 的当前候选图是 G06-selected-strip-final-initial-360x800.png：它只证明最后选定样式的初始态。旧 G06-no-panel-* 图仅保留为迭代历史，不可当作当前最终三态证据；新的结果态、无结果态截图与用户验收都待补。
4. 需要自行截图时，用 scripts/capture-chrome-page.js 连接专用 Chrome 的调试端口 9222；完整启动命令和截图方式见交接手册第 5 节。

已知验证与限制

• A02 相关的 a02-asset-alpha-audit、a01-a02-ui-contract、a02-register-entry-contract、capture-chrome-page-contract、compile-audit 和全量页面路由契约均已在本轮通过；后续修改仍要重新运行受影响检查。
• design-qa.md 当前是 final result: accepted，仅记录已冻结 A02；A02 已不再阻塞后续页面，但后续页面必须分别经过截图、审视和用户验收。A06、G01 两个状态与 G03 双步骤均已获用户确认；G06 的最终候选只有初始态新图，三态复核与用户审美确认均待补。
• 现有运行图来自 H5 Chrome 调试；最终 Android/HBuilderX 真机/模拟器视觉复核仍待补做，不能被 H5 截图替代。

给新 GPT 的直接任务说明

这是一个高质量的 uni-app Android 家谱视觉设计任务，不是 CSS 微调任务。先读取本文件列出的必读材料和技能说明，保留工作区全部未提交改动，不使用 worktree、多代理、git add、commit、push、上传、reset 或 checkout。

当前第一优先级不是开启新页面：先向用户展示并审视 docs/design/screens/runtime/2026-07-14/G06-selected-strip-final-initial-360x800.png，说明 G06 仍待验收。只有用户要求继续 G06 时，才先用 Product Design 对真实运行页面截图审视；若要改行为、路由或可审计视觉结构，先写/更新最小失败契约测试，再实现。继续时要补最后选定样式的结果态和无结果态截图、运行 G06 静态契约与 Chrome 冒烟、更新 design-qa.md，再请求用户审美确认。用户明确验收 G06 后，下一优先级才是 T02→T01 的世系树状态收敛（除非用户给出新的优先级）。

新 GPT 必须实际具备并调用：product-design:index 与 product-design:audit（基于真实截图审视）、imagegen（仅在缺完整位图资产时生成）、superpowers:test-driven-development（先契约测试）、superpowers:systematic-debugging（测试/截图/路由/构建异常时先定位）、superpowers:verification-before-completion（宣称完成前测试、截图和 git diff --check）。完整按钮、卡片、边框和装饰面必须使用独立位图；CSS 仅用于布局、文字、状态与真实交互。