完成40%

docs/design/视觉设计交接手册.md

@@ -3,41 +3,54 @@
 > 更新日期：2026-07-14
 > 用途：在新电脑或交给新的 GPT 后，按本手册恢复当前工作；它只记录已发生的事实，不把待验收写成已完成。
 
+## 0. 给新 GPT 的可直接执行指令
+
+你接手的是一个 **uni-app Android 家谱项目的高质量视觉设计任务**，全程中文工作；它不是只改 CSS 的任务。先不修改代码，完整阅读：`AGENTS.md`、`docs/交接记录.md`、本手册、`docs/规划.md`、`docs/design/D1_安卓视觉规范与页面壳.md`、`docs/design/P00_页面结构与资产清单.md`、`docs/superpowers/plans/2026-07-13-product-design-visual-refinement.md`、`design-qa.md`。随后只向用户简洁复述当前停点和准备如何处理反馈。
+
+必须保留已有未提交改动；不使用 worktree 或多代理；不执行 `git add`、`git commit`、`git push`、上传、`git reset` 或 `git checkout`。A01、A02、A04、A05、A06、G01、G03 的可见效果已获用户验收并冻结，不能以重构或顺手优化的名义改变。G07 是 G06 的页面内状态，不得重新建为独立页。
+
+当前唯一应向用户确认的候选是 G06：用户选定最近 ImageGen 第 3 稿的「朱砂题签 + 宽输入框 + 搜索按钮」方向，通用印玺已替换为项目真实 `brand-seal.png`。最后实际运行证据只有初始态 `docs/design/screens/runtime/2026-07-14/G06-selected-strip-final-initial-360x800.png`；同版结果态和无结果态截图未完成，G06 也**未验收**。不要把旧 `G06-no-panel-*` 截图当作当前最终版本。先请用户看当前初始态并决定是否继续；用户要求继续 G06 时，先截图审视，再补三态和验证；用户明确验收后，才继续 T02→T01（除非用户指定新优先级）。
+
+新环境必须可用并实际调用：`product-design:index`、`product-design:audit`、`imagegen`、`superpowers:test-driven-development`、`superpowers:systematic-debugging`、`superpowers:verification-before-completion`。没有这些能力时，先安装/启用同等能力，不得假装已经完成设计审视或位图生成。
+
 ## 1. 当前停点：先看这一节
 
-项目已有 59 条最终编号路由，第一版都可以浏览；这不等于 59 个页面已完成视觉验收。
+项目已有 55 条最终编号路由，第一版都可以浏览；这不等于 55 个页面已完成视觉验收。
 
-- 用户已经验收的视觉基准只有两个：**A01 启动/登录引导**、**G01 我的家谱**。它们的可见效果已冻结。
-- **A02 账号登录**已经完成一次资产化重做、功能回归和多尺寸截图，但**仍在等待用户审美验收**。在用户确认前，不得把 A02 标记为完成，也不得把它的样式批量传播到 A03--A06。
+- 用户已经验收的视觉基准有六个：**A01 启动/登录引导**、**A02 账号登录**、**A04 注册账号**、**A05 重置密码**、**A06 登录状态**、**G01 我的家谱**。它们的可见效果已冻结。
+- **A02 账号登录**已经完成资产化重做、功能回归和多尺寸截图，并于 2026-07-14 获用户审美验收。A03 已删除；A02 的短信 Tab 是唯一手机号验证码登录入口。A04、A05、A06 均于同日完成独立重做并获用户审美验收；G02 已按用户确认合并为 G01 的 `?state=empty` 并获用户审美确认；G04 已合并为 G03 的 `?step=ancestor`，G03 双步骤已获用户继续授权通过；G07 已合并为 G06 初始／结果／无结果状态。G06 曾被指出页头层级、伪控件和大面板截图感；用户最后选择最近 ImageGen 第 3 稿，当前以朱砂题签、真实品牌谱印、独立宽输入框和搜索按钮实现。最后候选只完成初始态新截图，结果态/无结果态的同版截图和用户审美确认尚未完成。
 - 其余模块的页面仍属于后续视觉设计任务；其中不少页面目前由 `components/ModulePage.vue` 与 `data/page-catalog.js` 提供第一版可浏览壳。这个壳是过渡方案，不是最终 UI。
 - 不提交、不推送、不上传 Git；由用户自行处理版本库操作。
 
-下一位执行者的第一件事不是开始做新页面，而是请用户查看 A02 的前后对比：
+下一位执行者先读取当前停点与已验收页面，再向用户展示 **G06 当前候选的初始态** 并等待反馈：
 
-- `docs/design/screens/runtime/2026-07-13/A02-before-after-360x800.png`
-- `docs/design/screens/runtime/2026-07-13/A02-after-412x915.png`
-- `docs/design/screens/runtime/2026-07-13/A02-sms-360x800.png`
+- `docs/design/screens/runtime/2026-07-14/A05-after-360x800.png`
+- `docs/design/screens/runtime/2026-07-14/A05-after-412x915.png`
+- `docs/design/screens/runtime/2026-07-14/A06-after-360x800.png`
+- `docs/design/screens/runtime/2026-07-14/A06-after-412x915.png`
+- `docs/design/screens/runtime/2026-07-14/A06-restricted-360x800.png`
+- `docs/design/screens/runtime/2026-07-14/G06-selected-strip-final-initial-360x800.png`
 
-用户若要求调整，只修改 A02 并重新截图、复核；用户若明确通过，才进入 A03--A06。
+旧 `G06-no-panel-*` 图是被用户否定后各轮尝试的历史证据，只能帮助理解迭代原因，不能用于当前验收。用户若要求调整，只修改对应页面状态并重新截图、复核；当前 A01、A02、A04、A05、A06、G01 两种状态与 G03 `create|ancestor` 均已明确通过。G06 当前候选的初始态待用户确认，结果态/无结果态的新截图待补；不得把 G06 写成已验收。只有用户明确通过 G06 或明确要求跳过它，下一项才按 T02→T01 状态收敛执行。
 
 ## 1.1 迁移前必须保留的文件
 
-本手册和截图工具是本轮新增文件；换电脑前，用户需在自行提交/上传时包含它们，或完整复制当前工作区。我没有执行任何 Git 暂存、提交、推送或上传操作。
+本手册、G06 最终候选资产和截图工具均是接管所需文件；换电脑前，用户需在自行提交/上传时包含它们，或完整复制当前工作区。我没有执行任何 Git 暂存、提交、推送或上传操作。
 
-至少要保留：`docs/design/视觉设计交接手册.md`、`docs/交接记录.md`、`scripts/capture-chrome-page.js`、A02 页面/资产/测试、`docs/design/screens/runtime/2026-07-13/` 的运行证据，以及现有计划与设计记录。只复制已提交的旧版本会丢失当前停点。
+至少要保留：`docs/design/视觉设计交接手册.md`、`docs/交接记录.md`、`scripts/capture-chrome-page.js`、G06 页面/资产/测试、`docs/design/screens/runtime/2026-07-14/G06-selected-strip-final-initial-360x800.png`、A02 页面/资产/测试、`docs/design/screens/runtime/2026-07-13/` 的运行证据，以及现有计划与设计记录。只复制已提交的旧版本会丢失当前停点。
 
 ## 2. 必读文件与唯一职责
 
 | 文件 | 负责什么 |
 | --- | --- |
 | `AGENTS.md` | 最小修改、保护既有未提交内容、验证后再交付的项目规则。 |
-| `docs/规划.md` | 59 个页面的范围、模块顺序和“完成”的定义。 |
+| `docs/规划.md` | 55 条独立路由的范围、模块顺序和“完成”的定义。 |
 | `docs/design/D1_安卓视觉规范与页面壳.md` | Android 页面、资产、布局与中文注释的硬约束。 |
 | `docs/design/P00_页面结构与资产清单.md` | 路由、页面文件和资产台账的唯一清单。 |
 | `docs/superpowers/plans/2026-07-13-product-design-visual-refinement.md` | 已批准的分模块视觉精修计划和验收顺序。 |
 | `docs/design/2026-07-13-A01-G01-A02-视觉审视.md` | A01/G01 视觉证据与旧 A02 的问题定位。 |
 | `docs/design/A02_账号登录_设计记录.md` | A02 当前实现、资产、截图和测试记录。 |
-| `design-qa.md` | A02 的 Design QA；当前 `final result: blocked`，原因是缺少用户的审美确认。 |
+| `design-qa.md` | A02 的 Design QA；当前 `final result: accepted`。 |
 | `docs/交接记录.md` | 简版当前状态与恢复入口；本手册提供完整操作细节。 |
 
 发生冲突时，按“用户最新明确指令 > AGENTS.md > 上表中的当前台账/计划 > 历史文档”的顺序处理。不要以旧的草案或已废弃的截图切片方案为依据。
@@ -88,7 +101,7 @@
 
 已通过的是：资产尺寸与不透明角审计、A01/A02 页面契约、编译检查、A02 的多尺寸运行截图和短信 Tab 交互。
 
-未通过的是：用户对 A02 的最终审美确认。因此 `design-qa.md` 必须保持 `blocked`，直至用户明确确认。用户若觉得顶部祥云偏多，只可先移除 A02 标题右侧的单个祥云；不要无根据改动面板框、输入区或交互。
+已通过的是：用户对 A02 的最终审美确认，`design-qa.md` 为 `accepted`，A02 可见效果冻结。用户若提出新的明确调整，只改动被指出的区域并重新截图复核；不要无根据改动面板框、输入区或交互。
 
 ## 5. 换电脑后如何恢复截图与审视能力
 
@@ -128,16 +141,16 @@ node scripts/capture-chrome-page.js `
 
 ## 6. 后续执行顺序与每轮产物
 
-### 门禁 0：先处理 A02
+### 门禁 0：A02 与 A04 已通过
 
-1. 让用户审 A02 前后对比与 412 × 915、短信 Tab 图。
-2. 若不通过：只在 A02 修正明确问题，先调整对应契约测试，再改页面/资产，重新截全尺寸图。
-3. 若通过：把 A02 状态同步到 `docs/规划.md`、`docs/交接记录.md`、`docs/design/A02_账号登录_设计记录.md` 与 `design-qa.md`，再开始 A03--A06。
+1. A02 与 A04 均已通过；不因后续页面改动而触碰其可见效果。
+2. 若用户提出明确调整：只在对应页面修正，先调整对应契约测试，再改页面/资产，重新截图复核。
+3. A05、A06 与 G01 空状态均已通过并完成状态同步；G04 已合并为 G03 `step=ancestor`，该双步骤已获用户通过；G07 已合并为 G06 三态。G06 当前朱砂题签候选只完成初始态新截图，尚待结果/无结果截图、审视和用户审美确认。
 
 ### 其后的模块顺序
 
-1. **账号 A03--A06**：以已验收 A02 为认证样板，但每个页面保留各自的任务与状态，不能直接复制表单。
-2. **家谱 G02--G12**：先做空态/创建、家谱概览与世代字等代表页，再扩展搜索、申请、设置。
+1. **账号 A04--A06**：以已验收 A02 为认证样板，但每个页面保留各自的任务与状态，不能直接复制表单。绑定手机号以后归个人中心安全设置的独立入口；微信授权取消、失败、受限归 A06。
+2. **家谱 G03、G05--G12**：G07→G06 搜索流程已收敛；先由用户审美确认 G06 当前候选，并补齐同版三态截图；之后再推进家谱概览、世代字、申请与设置。用户明确授权连续推进时，先执行 T02→T01 状态收敛。
 3. **世系树 T01--T08**：先建立树、成员档案、关系编辑三类代表页。
 4. **家族内容 F01--F10**：动态、文章、相册、媒体上传分别建立内容档案式层级。
 5. **人物记录 R01--R11**：人物档案、礼仪活动、成长时间线先定样板。
@@ -161,7 +174,7 @@ node scripts/capture-chrome-page.js `
 
 | 能力/技能 | 何时使用 | 项目中的正确做法 |
 | --- | --- | --- |
-| `product-design:index`、`product-design:audit` | 审视、评价或设计一个已运行页面/流程时。 | 先拿到真实路由截图，再依据 A01/G01 与页面任务写审视结论；不要靠源码猜好不好看。 |
+| `product-design:index`、`product-design:audit` | 审视、评价或设计一个已运行页面/流程时；接管 G06 后的第一项视觉工作也必须使用。 | 先拿到真实路由截图，再依据 A01/G01 与页面任务写审视结论；不要靠源码猜好不好看。 |
 | Product Design 的 `user-context`、`get-context`、`ideate`、`image-to-code`、Design QA 流程 | 需要探索方向、选择视觉方案、将已选样稿落地、或交付前比对时。 | 有明确视觉真源时先忠实落地；没有真源且需要新方向时先给可比较方案，选定后再实现；最后在 `design-qa.md` 诚实记录通过或阻塞。 |
 | `imagegen` | 现有资产无法承担完整视觉面时。 | 先用 A01/G01 实图作为参考，明确输出是完整不透明面板还是透明叠加件；检查实际尺寸/Alpha 后再放入项目。不能用截图代替资产。 |
 | `superpowers:brainstorming` 与 `superpowers:writing-plans` | 新模块或会改变页面行为的创作工作开始前。 | 先写清用户目标、交互和验收，不以“尽快”跳过设计决定。 |
@@ -169,7 +182,7 @@ node scripts/capture-chrome-page.js `
 | `superpowers:systematic-debugging` | 截图、路由、构建或测试出现意外时。 | 先复现和定位单一根因，禁止靠删测试、盲改样式掩盖问题。 |
 | `superpowers:verification-before-completion` | 任何“完成/修好/通过”的表述前。 | 以命令输出、运行截图和用户确认作证据；不能用意图代替验证。 |
 
-若新电脑没有 Product Design 或 ImageGen 插件，应先安装/启用同等能力；在能力缺失时不能假装完成视觉审计或资产生成。当前环境曾因 Windows 的 `python`/`python3` 只是商店占位符而无法保存 Product Design 的持久 context，这不影响当前项目文件和截图恢复；新环境若有可用 Python，可重新运行该插件的 context 预检。
+若新电脑没有 Product Design 或 ImageGen 插件，应先安装/启用同等能力；在能力缺失时不能假装完成视觉审计或资产生成。新环境先执行 `python --version`、`node --version` 确认可用环境；当前用户已确认 Python 已安装。若 Product Design 的持久 context 预检仍失败，记录原因即可，不得阻塞对项目内真实截图、资产和测试的接管。
 
 ## 8. 验证命令
 
@@ -196,6 +209,17 @@ powershell.exe -NoProfile -ExecutionPolicy Bypass -File tests/full-page-visual-c
 git diff --check
 ```
 
+G06 当前候选继续或验收前的最小回归集合：
+
+```powershell
+powershell.exe -NoProfile -ExecutionPolicy Bypass -File tests/g06-search-flow-contract.ps1
+node tests/g06-search-flow-runtime-smoke.js http://localhost:5173
+node scripts/capture-chrome-page.js "http://localhost:5173/#/pages/genealogy/g06-search-genealogies" ".search-page" "docs/design/screens/runtime/<日期>/G06-selected-strip-initial-360x800.png" 360 800
+git diff --check
+```
+
+若 G06 发生视觉改动，必须用真实输入分别截取有结果和无结果状态，再用 Product Design 审视；只有三态、相关测试与用户确认齐全，才能更新为验收通过。
+
 `git diff --check` 可能提示仓库既有的 CRLF 行尾警告；只有真正的空白错误或非零退出码才算失败。不要 reset、checkout、清空或覆盖用户已有改动。
 
 ## 9. 文档与资源维护清单