修改完成55%
This commit is contained in:
+36
-21
@@ -1,33 +1,48 @@
|
||||
# 家谱 APP 交接记录
|
||||
|
||||
> 更新时间：2026-07-14
|
||||
> 完整恢复手册见：[视觉设计交接手册](design/视觉设计交接手册.md)。本文件只保留当前真实停点，避免与历史草案互相矛盾。
|
||||
> 更新日期：2026-07-15
|
||||
> 这是更换电脑或交给新 GPT 时的唯一快速入口。详细操作见 [视觉设计交接手册](design/视觉设计交接手册.md)，页面审核状态以 [总规划](规划.md) 为准。
|
||||
|
||||
## 当前状态
|
||||
## 1. 当前准确停点
|
||||
|
||||
- `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；由用户自行处理。
|
||||
- `pages.json` 当前登记 **54 条最终路由**；重复状态已经收敛到同一页面，例如 G02→G01、G04→G03、G07→G06、T02→T01。
|
||||
- 当前有 **7 个已验收**页面：A01、A02、A04、A05、A06、G01、G03。除非用户提出明确调整，不得改变这些页面已经验收的可见效果。
|
||||
- 其余 **47 个待审核候选**已经完成页面实现、H5 运行截图和内部视觉审视，统一在 `docs/规划.md` 标记为 `[~]`。候选不等于用户验收，只有用户明确通过后才能改为 `[x]`；要求返工时改为 `[!]`。
|
||||
- 下一步是按 `docs/规划.md` 逐页视觉审核，不再批量新增页面。接口资料只用于理解功能、字段和状态位置；本阶段不对接接口。
|
||||
- H5 Chrome 截图是候选审计证据，最终 Android/HBuilderX 真机或模拟器复核仍需在视觉审核后完成。
|
||||
|
||||
## 新电脑的第一步
|
||||
## 2. 新 GPT 启动顺序
|
||||
|
||||
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 节。
|
||||
1. 全程使用中文。先完整阅读 `AGENTS.md`、本文件、`docs/规划.md`、`docs/design/视觉设计交接手册.md`、`docs/design/D1_安卓视觉规范与页面壳.md`、`docs/design/P00_页面结构与资产清单.md` 和 `design-qa.md`。
|
||||
2. 运行 `git status --short`，识别并保留全部未提交改动。不要把旧提交状态当成当前工作区状态。
|
||||
3. 先向用户简洁复述：54 条路由、7 个已验收、47 个待审核，以及准备审核的具体页面；在用户给出页面反馈前不要盲目重做。
|
||||
4. 审核时先看 [视觉证据索引](design/视觉证据索引.md) 的默认代表图；发现具体问题后再展开多尺寸、before/after 或历史废稿。
|
||||
|
||||
## 已知验证与限制
|
||||
## 3. 必须调用的能力
|
||||
|
||||
- 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 必须实际具备并按触发条件调用：
|
||||
|
||||
## 给新 GPT 的直接任务说明
|
||||
- `product-design:index`：开始设计、审视或评价页面时先调用，用于选择正确的产品设计工作流。
|
||||
- `product-design:audit`：必须基于真实运行截图审视页面，不能只看源码判断好不好看。
|
||||
- `imagegen`：仅在缺少完整位图视觉资产时调用。完整按钮、卡片、边框和装饰面必须使用独立位图，不能用 CSS 伪造。
|
||||
- `superpowers:test-driven-development`：修改页面行为、路由或可审计视觉结构前，先写或更新最小契约测试并确认 RED。
|
||||
- `superpowers:systematic-debugging`：测试、截图、路由或构建出现异常时，先复现并定位根因再修改。
|
||||
- `superpowers:verification-before-completion`：宣称完成前，运行受影响测试、真实截图复核和 `git diff --check`。
|
||||
|
||||
这是一个高质量的 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 的世系树状态收敛（除非用户给出新的优先级）。
|
||||
## 4. 视觉审核降噪规则
|
||||
|
||||
新 GPT 必须实际具备并调用：`product-design:index` 与 `product-design:audit`（基于真实截图审视）、`imagegen`（仅在缺完整位图资产时生成）、`superpowers:test-driven-development`（先契约测试）、`superpowers:systematic-debugging`（测试/截图/路由/构建异常时先定位）、`superpowers:verification-before-completion`（宣称完成前测试、截图和 `git diff --check`）。完整按钮、卡片、边框和装饰面必须使用独立位图；CSS 仅用于布局、文字、状态与真实交互。
|
||||
- 默认每页只看一张 360×800 代表截图。
|
||||
- 同页有多个关键状态时，优先看一张状态联系表，不连续展示多张相似截图。
|
||||
- 412×915、小屏、多尺寸和前后对比图仅在发现比例问题、回归问题或用户要求时展开。
|
||||
- 历史废稿和 before/after 证据不删除，但只保留在 `docs/design/视觉证据索引.md` 的历史审计区。
|
||||
- 审核结论记录在 `docs/规划.md`；不要因为内部测试或 Product Design 审视通过就替用户勾选。
|
||||
|
||||
## 5. 禁止事项与完成验证
|
||||
|
||||
- 不使用 worktree 或多代理。
|
||||
- 不执行 `git add`、commit、push、上传、reset、checkout，也不覆盖用户现有文件。
|
||||
- 不擅自对接接口、修改接口契约、打 Android 包或把截图放入 `static/assets/` 当运行资源。
|
||||
- 只修改用户当前反馈涉及的页面和对应测试、截图、设计记录；不要顺手重构冻结页或相邻模块。
|
||||
- 完成一次页面返工前，至少运行对应契约测试、运行时 smoke、真实路由截图复核和 `git diff --check`；无法执行的检查必须明确说明。
|
||||
|
||||
Reference in New Issue
Block a user