rain
34 lines
5.4 KiB
Markdown
34 lines
5.4 KiB
Markdown
# 家谱 APP 交接记录
|
||
|
||
> 更新时间：2026-07-14
|
||
> 完整恢复手册见：[视觉设计交接手册](design/视觉设计交接手册.md)。本文件只保留当前真实停点，避免与历史草案互相矛盾。
|
||
|
||
## 当前状态
|
||
|
||
- `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`、本文件、[完整交接手册](design/视觉设计交接手册.md)、[总规划](规划.md)、[D1 视觉规范](design/D1_安卓视觉规范与页面壳.md)、[P00 资产台账](design/P00_页面结构与资产清单.md)、`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 仅用于布局、文字、状态与真实交互。
|