保存视觉审核与文档流迁移进度

2026-07-20 17:23:09 +08:00
parent 5a31a75da0
commit 01d246c47b
59 changed files with 3615 additions and 378 deletions
@@ -0,0 +1,73 @@
+# 全项目文档流迁移实施计划
+
+> **执行要求：** 使用 `superpowers:executing-plans` 当前会话内联执行。用户禁止多代理、worktree 及全部 Git 写操作；不执行提交步骤。
+
+**目标：** 除用户指定 fixed 的顶部/底部导航与真实弹层外，清除全项目页面内容的脱离文档流定位，并保持现有业务状态与视觉语言。
+
+**架构：** 以一个静态合同和精确 JSON 白名单为单一规则所有者；先完成 R02 样板，再迁移共享组件和模块页面。每批通过现有 CDP smoke、四档响应式及同尺寸截图后进入下一批。
+
+**技术栈：** uni-app Vue 3、SCSS、PowerShell、Node.js、Chrome CDP。
+
+## 全局约束
+
+- 禁止普通内容使用 `absolute/fixed/sticky`、负外边距或以位移 transform 承担布局；按钮按压等不改变排版的交互微动效可以保留。
+- 允许定位的职责为固定顶部/底部导航、独立视口背景、真实弹层，以及受明确父容器约束的纯装饰、角标、红点和关系线，必须精确白名单。
+- 不删除或重绘现有资产；装饰图优先改作 background/border-image，只有确需局部叠放时保留 absolute。
+- 四档为 320×568、360×640、360×800、412×915。
+- 每次只修改当前批次，验证失败立即停止扩散。
+
+---
+
+### 任务 1：建立全项目失败合同
+
+**文件：**
+- 新建：`tests/document-flow-position-allowlist.json`
+- 新建：`tests/document-flow-position-contract.ps1`
+
+- [ ] 白名单先登记 `PageHeader.vue` 的固定顶部栏、`AppTabbar.vue` 的固定底部栏、`AppDialog.vue` 的弹窗层／皮肤和 `AppToast.vue` 的 Toast；其他页面本地弹层在迁移到对应批次时逐项审计后登记。
+- [ ] 合同扫描 `pages/**/*.vue` 与 `components/**/*.vue` 的 style 块，报告不在精确文件+选择器白名单内的 `absolute/fixed/sticky`。
+- [ ] 合同同时禁止普通选择器出现负 margin 和 `transform: translate(...)` 布局。
+- [ ] 运行合同并保存初始 37 文件违规清单；预期 FAIL，不放宽规则。
+
+### 任务 2：R02 文档流样板
+
+**文件：**
+- 修改：`pages/records/r02-person-detail.vue`
+- 修改：`tests/r02-person-detail-contract.ps1`
+- 修改：`tests/r02-person-detail-runtime-smoke.js`
+
+- [ ] 先扩展 R02 合同，禁止文件内 `absolute/fixed/sticky` 并要求题签、卡片、短字段、长字段和状态卡使用 background + flex/grid。
+- [ ] 运行确认 RED。
+- [ ] 删除装饰 `<image>` 叠层；对应容器使用 records 资产作为背景。
+- [ ] 题签 copy、字段 label/input、textarea、状态文案全部使用文档流；容器高度由内容和 min-height 控制。
+- [ ] 运行 R02 合同、入口交互 smoke、四档 smoke，捕获 412×915 详情和编辑态供复核。
+
+### 任务 3：共享基础组件
+
+**文件：** `components/AppButton.vue`、`PageHeader.vue`、`AppTabbar.vue`、`ModulePageBackground.vue`、`GenealogyPageBackground.vue`、`GenealogyCard.vue`
+
+- [ ] 每个组件先新增聚焦合同并确认 RED。
+- [ ] PageHeader 与 AppTabbar 保留 fixed，并分别提供正常流顶部占位和页面底部避让；按钮/Header 的局部装饰、角标与红点逐项判断，能用背景则转背景，必须叠放则精确白名单；独立视口背景层可保留 fixed。
+- [ ] GenealogyCard 内容改 flex/grid，皮肤转背景。
+- [ ] 对 G01、T07、F01、R01、N01、M01 六基准做四档和同尺寸回归。
+
+### 任务 4：通用 ModulePage
+
+**文件：** `components/ModulePage.vue` 及其聚焦测试
+
+- [ ] 合同禁止普通表单、列表、详情、时间轴、设置和状态卡定位。
+- [ ] 装饰图转背景；字段用 grid；卡片内容自然撑高。
+- [ ] 执行全部消费 ModulePage 的路由 smoke 和四档回归。
+
+### 任务 5：模块分批迁移
+
+- [ ] R → N → M → F：每页先合同 RED，再改文档流，再跑模块四档。
+- [ ] G：保留真实弹层白名单，页面卡片、表单、Header、背景全部文档流。
+- [ ] T：目录和表单使用 grid/flex；T01 世系节点和关系线用 grid/border 重做。
+- [ ] A：登录、注册、重置和封存 A06 的普通内容文档流；验证弹窗／Toast 保留精确白名单。
+
+### 任务 6：最终收敛
+
+- [ ] `tests/document-flow-position-contract.ps1` 最终 PASS，输出零普通内容违规。
+- [ ] 运行活动路由转换、关键交互 smoke、四档响应式和 `git diff --check`。
+- [ ] 更新验收规划与交接记录，逐一说明冻结页是否保留 `[x]`；没有截图或用户确认不得宣称视觉冻结完成。
@@ -1,53 +0,0 @@
-# T01 纵向世系轴基准 Implementation Plan
-
-> **For agentic workers:** REQUIRED SUB-SKILL: Use superpowers:executing-plans to implement this plan task-by-task. Steps use checkbox (`- [ ]`) syntax for tracking。
-
-**Goal:** 将 T01 重构为纵向分代、关系线清晰、节点可选择的世系树基准页。
-
-**Architecture:** 页面继续由 `treeState` 管理加载、树、阅读提示、空和失败状态。树态使用固定的三代模拟数据和绝对定位关系线，透明真实资产承载节点、状态卡和成员信息栏，横向滚动只服务同代分支扩展。
-
-**Tech Stack:** uni-app、Vue 3、SCSS、现有 PNG 资产、PowerShell 静态契约、Chrome CDP 运行时验证。
-
-## Global Constraints
-
- 只修改 T01 及其聚焦测试、设计文档和复制到 tree 命名空间的资产。
- 不接 API，不新增路由，不使用系统弹窗或加载。
- 不执行 Git add、commit、push、reset、checkout，不使用 worktree 或多代理。
- 不删除或覆盖现有修改、测试、文档、截图与资产。
-
-### Task 1: 新视觉契约（RED）
-
-**Files:**
- Modify: `tests/t01-tree-state-contract.ps1`
- Modify: `tests/t01-all-states-visual-contract.ps1`
-
- [ ] 要求 `lineage-connector`、三代横向标签、透明节点／状态／信息栏资产和现有四条路由。
- [ ] 明确禁止 T01 继续引用三个旧不透明表面资产。
- [ ] 运行两个契约，确认因页面尚未实现新结构而失败。
-
-### Task 2: 透明资产与纵向树（GREEN）
-
-**Files:**
- Create: `static/assets/modules/tree/transparent/t01-member-node.png`
- Create: `static/assets/modules/tree/transparent/t01-member-node-selected.png`
- Create: `static/assets/modules/tree/transparent/t01-state-panel.png`
- Create: `static/assets/modules/tree/transparent/t01-member-drawer.png`
- Modify: `pages/tree/t01-tree-overview.vue`
-
- [ ] 复制经过检查的现有透明资产到 tree 模块命名空间，不改动来源文件。
- [ ] 重排三代节点，加入祖先到子代的垂直／水平关系线和明确世代带。
- [ ] 实现红色选中节点、底部透明成员栏和同代横向阅读提示。
- [ ] 保留 `AppLoading`、查询状态和 T03/T04/T06/T07 导航。
- [ ] 运行聚焦契约并修至通过。
-
-### Task 3: 运行时与视觉复核
-
-**Files:**
- Modify only if necessary: `tests/t01-tree-state-runtime-smoke.js`
- Create/update evidence under: `docs/design/screens/runtime/2026-07-20/t01-baseline/`
-
- [ ] 运行 T01 运行时 smoke，检查各状态和人物资料跳转。
- [ ] 在既有 Chrome 标签页检查四档响应式尺寸，重点排除节点裁切、断线和底栏遮挡。
- [ ] 对同一 `412×915` 状态做前后视觉对照并修复可见的 P0/P1/P2 问题。
- [ ] 只向用户展示正常树态，等待明确审批后再切下一状态；审批前不标记 `[x]`。
-
@@ -0,0 +1,44 @@
+# 全项目文档流迁移设计
+
+## 目标
+
+把项目中除固定顶部导航栏、固定底部导航栏、真实弹窗、Toast、遮罩、底部弹层和全屏预览外的页面结构全部改为正常文档流，消除正常文字、输入框、按钮、卡片和背景依赖 `absolute`、`fixed` 或 `sticky` 的布局风险。迁移覆盖 `pages/`、`components/`、活动页面和封存的 A06 源码，不接接口、不删除资产。
+
+## 当前证据
+
+只读审计发现 37 个 Vue 文件包含 `position: absolute|fixed|sticky`。用法混合了正常内容、装饰图层、页面背景、Tabbar、世系关系线和真实弹层，不能机械删除。R02 已证明普通文字、字段标签和输入框也被定位到装饰图之上，系统字体、长文案、键盘或尺寸变化时存在重叠风险。
+
+## 单一合同
+
+- 正常页面内容只允许块级流、flex、grid、gap、padding、margin 和内容自然撑高。
+- 禁止用 `absolute`、`fixed`、`sticky`、负外边距或位移 transform 摆放普通文字、输入、按钮、卡片、页面背景或世系节点。
+- `position: relative` 虽不脱离文档流，但普通内容无明确必要时不使用；不得以它作为重新叠放内容的前置手段。
+- 装饰框优先使用 `background-image`、`border-image` 或九宫格背景；确实需要叠在明确局部容器内的纯装饰图层、角标和红点可以使用 `absolute`，但不得承担正文排版。
+- 世系节点使用 grid/flex 文档流；关系线属于节点间局部绘制层，可按实际结构使用 grid 边框或受父容器约束的 `absolute`，不得用定位摆放节点正文。
+- 允许定位的职责只有：固定顶部/底部导航、独立视口背景层、真实弹窗、Toast、遮罩、底部弹层、全屏预览，以及受明确父容器约束的纯装饰/角标/关系线。顶部、底部导航使用 `position: fixed`，页面内容通过正常流占位和安全区 padding 避让。每条例外必须进入精确白名单，记录文件、选择器和用途，不允许按模糊类名放行。
+- 合同所有者为 `tests/document-flow-position-contract.ps1`，白名单为 `tests/document-flow-position-allowlist.json`。合同必须扫描所有 `position` 声明，包括 `relative`；普通容器不得因叠层或 z-index 习惯而残留无意义定位。运行代码、文档和其他测试不得重新定义第二套例外规则。
+
+## 迁移顺序
+
+1. 建立合同、精确白名单和 37 文件初始清单，测试先失败并输出全部违规位置。
+2. R02 作为第一张页面样板：人物题签、档案卡、表单、状态卡全部改为背景 + flex/grid 文档流。
+3. 迁移共享控件：AppButton、PageHeader、AppTabbar、ModulePageBackground、GenealogyPageBackground、GenealogyCard；PageHeader 与 AppTabbar 保留用户指定的 fixed 白名单，清除其内部普通内容和装饰定位；弹层组件保留白名单定位。
+4. 迁移 `ModulePage`，让普通 F/R/N/M 页面共享文档流结构。
+5. 按 R → N → M → F → G → T → A 迁移专属页面；A06 源码也纳入静态合同。
+6. 每批执行聚焦合同、现有交互 smoke、四档响应式、真实截图和 `git diff --check`。
+
+## 冻结页
+
+当前冻结页不自动取消 `[x]`。每次共享组件或页面迁移后进行同尺寸前后对比：无可见变化且四档通过则保留；有任何可见变化则退回 `[~]` 等待用户复核。不得用自动化通过替代用户确认。
+
+## 验收门槛
+
+- 全项目合同最终为零违规，白名单只含固定顶部/底部导航和真实弹层。
+- 52 条活动路由和封存 A06 源码均被扫描。
+- 四档固定为 320×568、360×640、360×800、412×915。
+- 长文案、约 1.3 倍字号、输入校验和键盘场景不重叠，操作区可滚动到达。
+- 5173 和唯一 9222 Chrome 标签继续复用；不声明 Android 已完成。
+
+## 边界
+
+不执行多代理、worktree、git add/commit/push/reset/checkout；不删除、覆盖或清理现有修改、未跟踪文件、测试、文档、截图、母版和候选资产。已知仓库治理失败不通过放宽阈值或删除文件处理。
@@ -1,38 +0,0 @@
-# T01 纵向世系轴基准设计
-
-## 目标
-
-将 T01 从“横向大画布上的独立成员卡”调整为可直接读懂亲缘关系的纵向世系轴，并作为后续世系树页面的视觉基准。本轮仅使用页面内模拟数据，不接接口。
-
-## 已确认方向
-
- 始祖置于顶部中央，后代按世代向下分层。
- 同一世代横向排列；只有分支超过当前宽度时才横向拖动。
- 首屏必须完整看到始祖和主要下一代，不能以裁切节点暗示结构。
- 祖先到子代之间显示连续、清晰的关系线；选中成员以红色节点框和文字强调。
- 世代标题采用横向分层标签，不再使用分散的竖排小字。
- 选中成员信息放在底部透明信息栏中，保留“查看资料”“添加亲属”。
- 加载、阅读提示、空、失败继续由 T01 同页状态承载。
-
-## 视觉资产
-
- 页面背景继续使用 T 系列 `ModulePageBackground`。
- 成员节点复用现有透明卷框资产，树状态面板与底部信息栏复用现有透明金线框资产，并复制到 tree 模块命名空间。
- 移除 T01 对 `g03-create-flow-panel.png`、`g06-search-input-wide.png`、`application-status-card.png` 三个不透明表面资产的引用。
- 关系线属于数据关系可视化，可由布局元素绘制；不使用 CSS 仿造装饰图案、SVG 或表情符号。
-
-## 状态与交互
-
- `loading`：保留 `AppLoading` 动画。
- `tree`：展示纵向三代世系，默认选中始祖；点击节点更新底部信息栏。
- `landscape`：说明“上下看世代、左右看同代分支”，操作后回到树态。
- `empty`：引导录入首代成员并跳转 T04。
- `error`：说明读取失败，重试后回到树态。
- 保留 T03、T04、T06、T07 路由入口。
-
-## 响应式与验收
-
- 内部检查 `320×568`、`360×640`、`360×800`、`412×915`，不把响应式尺寸逐档交给用户确认。
- `412×915` 作为当前正常树态的首个视觉审批证据。
- H5 截图仅作内部候选；Android/HBuilderX 真机或模拟器验证仍未完成。
-
@@ -3,17 +3,20 @@
 > 最后更新：2026-07-20
 > 用途：更换电脑、重新打开 Codex/GPT 后的唯一接管入口。
 > 当前阶段：只做页面样式与视觉流程验收；不对接接口，不做功能验收。
-> 当前施工停点：六个模块基准 G01、T07、F01、R01、N01、M01 已由用户明确通过；T01 已完成纵向世系轴候选，留待 2026-07-21 首项人工审核；其余页面已按所属基准完成夜间批量收敛，继续保持 `[~]` 等待人工/Android 验收。最新事实与换机提示见 `docs/夜间批量收敛交接_2026-07-20.md`。
+> 当前施工停点：六个模块基准 G01、T07、F01、R01、N01、M01，以及 T01、G03、F09 和 F10 已由用户明确通过并进入当前 H5 视觉冻结。T08、F05、F06 仍按已记录的局部通过范围保持 `[~] ⚠`。F08 的正常、空相册、照片预览和相册失效四种 H5 视觉状态已由用户确认合适，但因真实入口、跳转、接口和 Android 未完成继续保持 `[~] ⚠`。F10 已成为专属视频待开放状态页，用户明确通过 412×915 候选；按钮真实返回 F01，静态合同、运行时跳转和四档响应式 smoke 通过，但 F01 真实入口、视频接口、列表／失败数据态和 Android 不在本次结论内。下一步审核 R02；其余页面保持原标记。最新事实与换机提示见 `docs/夜间批量收敛交接_2026-07-20.md`。

 ## 0. 2026-07-20 最新接管覆盖说明

 本节覆盖下方仍保留的 2026-07-19 历史停点；不要再从 G01 正常态重新开始。

 - 活动路由仍为 52 条，A02 已合并，A06 仍封存保留。
- 用户已明确通过 6 个模块基准：G01、T07、F01、R01、N01、M01。`docs/验收规划.md` 应统计为 6 个 `[x]`、46 个 `[~]`。
- T01 按用户最终选择的方案 1 完成纵向世系轴候选，明早首先审核 T01；用户未明确通过前不得标 `[x]`。
+- 用户已明确通过 6 个模块基准、T01、G03、F09 及 F10：G01、G03、T01、T07、F01、F09、F10、R01、N01、M01。`docs/验收规划.md` 应统计为 10 个 `[x]`、42 个 `[~]`。
+- T01 已完成固定左侧代际栏返工，并在唯一 Chrome 项目页完成正常、加载、阅读提示、空、失败、节点选中及四档 H5 审核；用户已明确通过，现为 `[x]` 并冻结。状态联系表为 `docs/design/screens/runtime/2026-07-20/T01-state-contact-sheet.png`，响应式联系表为同目录 `T01-responsive-contact-sheet.png`。
+- G03 已在 320×568 完成正常、创建必填、重复家谱提醒、创建失败、录入首代和首代必填审核，并补齐其余三档正常态；用户已明确通过，现为 `[x]` 并冻结。状态联系表为 `docs/design/screens/runtime/2026-07-20/G03-sample-320x568-contact-sheet.png`，响应式联系表为同目录 `G03-responsive-contact-sheet.png`。
+- T08 已由用户通过 320×568 隐私、离世纪念和无权限三个直达视觉状态，联系表为 `docs/design/screens/runtime/2026-07-20/T08-direct-states-320x568-contact-sheet.png`；由于 T03 没有真实入口且其余三档未验，必须继续保持 `[~] ⚠`。
 - F/R/N/M 的 28 个普通任务页已统一到模块母版并删除重复编号介绍块；F02、T03—T06、T08、G03、G08—G12 已收敛旧跨模块不透明面板引用。
 - 5173 服务运行，52 个页面和 2 个共享组件的 Vite 转换为 54/54；当夜 Chrome 未开放 9222，因禁止新开第二个浏览器/标签页，没有生成虚假的 CDP、截图或四档响应式通过结论。
+- 后续经用户许可重启并开放 9222；复核时 5173 返回 HTTP 200，9222 仅有 1 个项目页面。该后续事实只支撑 T01 的 H5 证据，不得扩写为 Android 或其他页面已完成。
 - 旧资产命名审计与历史截图数量上限仍是已知失败项；用户明确要求保留全部现有资产、截图、母版和候选，不得通过删除文件或放宽阈值处理。
 - 新会话先完整阅读 `docs/夜间批量收敛交接_2026-07-20.md`，再复核当前工作区和浏览器状态。

@@ -319,6 +322,18 @@ git diff --check

 GPT 不操作 Git。用户切换电脑前应自行确认以下内容已纳入版本控制并同步：

+### 2026-07-20 Git 唯一换机通道
+
+- 用户已明确：换机时**只能通过 Git 交接，不能复制整个项目目录**。因此远端仓库必须成为源码、文档、测试、实际运行资产和长期交接证据的唯一换机载体。
+- 当前分支为 `main`，当前 HEAD 为 `5a31a75 Review changes batch 6 of 6`。2026-07-20 最新只读检查仍有 **56 项工作区变化**：25 项修改、4 项删除、27 项未跟踪；这些内容尚未仅凭现有 HEAD 获得换机保障。
+- 在用户自行审阅、暂存、提交并成功推送这些应保留变化之前，**不得开始换机，也不得认为交接已经同步完成**。新电脑只执行 clone/pull 无法获得未提交修改、未跟踪文件和本轮删除记录。
+- 用户自行提交前必须同时核对 `git status --short`、`git status --short --ignored` 和 `git diff --check`；不能遗漏未跟踪的规划、测试、F08 实际资产及 `.hbuilderx/launch.json`，也不能遗漏已确认的生成物／过期文档删除记录。
+- `unpackage/`、`docs/design/screens/runtime/` 已按用户明确授权删除，不需要进入远端；`docs/design/screens/handoff/`、`static/assets/` 中实际引用资产、源码、有效测试、验收规划和交接记录必须进入远端。
+- 本轮 GPT 仍不执行 `git add`、`commit`、`push`；这些操作必须由用户自行完成。推送后应在新电脑核对分支、HEAD 和干净／预期的 `git status`，再按本文件第 13 节停点继续。
+- 2026-07-20 上传前只读审计：已配置远端 `origin`，当前上游为 `origin/main`；Git 候选文件共 589 个、约 164.88MiB，最大单文件 6,822,092 字节，**没有超过 20MiB 或 100MiB 的单文件**；31 个未跟踪实体文件合计 18,674,321 字节（约 17.81MiB）。这些本地体积指标未发现常见单文件上传硬阻断，但远端网络、认证和仓库配额只有实际推送才能最终确认。
+- 同次审计确认：文档流总规划／设计、F08 实际资产、定位合同与白名单、三份交接／验收文档、`.hbuilderx/launch.json` 均存在且未被 `.gitignore` 排除；长期 handoff 30 个文件全部已跟踪，没有未跟踪 handoff 文件。
+- `git diff --check` 退出码为 0；`git fsck --full` 退出码为 0。对象库存在历史 dangling blob/tree 和 4 个约 4.05MiB 的临时 garbage 对象，但没有对象损坏报告；不要为清理它们执行 reset、手工删除 `.git` 对象或改写历史，它们不属于本次新提交的可达内容。
+
 - `pages.json`
 - `pages/auth/a01-entry.vue`
 - A02 删除记录及相关路由／测试收敛文件
@@ -361,3 +376,11 @@ GPT 不操作 Git。用户切换电脑前应自行确认以下内容已纳入版
 - `tmp/` 只允许保存短期诊断图和 ImageGen 中间源，最终资产必须进入 `static/assets/`，换机代表证据必须进入 `docs/design/screens/handoff/`。
 - 不要执行 `git add .` 后盲目提交；用户应先用 `git status --short --ignored` 确认缓存目录仍为 `!!` 忽略状态。
 - 当前不重写 Git 历史、不执行 `git gc`、不删除 `.git` 内的孤立索引；若远端仍拒绝推送，应保留完整错误信息，再按远端限制单独排查，不能用 reset 或重建仓库规避。
+
+## 13. 2026-07-20 文档流迁移未完成阻断与清理记录
+
+- 当前迁移**未完成**。原定位合同只扫描 `absolute/fixed/sticky`，漏掉了普通容器上不必要的 `position: relative`；F10 已被用户现场指出，其他页面也必须按同一规则重新审计。后续不得再用“剩余 112 条”作为完整数字，必须先扩展合同覆盖所有 `position` 声明。
+- 正确边界：固定顶部/底部导航、真实弹层、Toast、全屏预览等保留必要定位；普通页面根容器、Header/Content 包装、正文、表单、卡片和可用 grid 同单元叠放的装饰不得残留无意义 `relative/absolute`。
+- 当前停点：先返工 F10，再处理 T01 世代栏与成员节点；没有新的用户视觉确认，不新增 `[x]`。
+- 本次用户明确授权清理无用文件。已确认 `unpackage/dist/` 为可再生成构建产物，`docs/design/screens/runtime/` 为短期诊断证据且不能作为长期唯一资料；两者可以删除。长期 `docs/design/screens/handoff/`、实际引用资产、有效测试与源码继续保留。
+- 2026-07-20 已完成或被总规划取代的 F05/F06/F08/F09/F10/R02/T01 单页 plan/spec 不再作为独立合同；有效结论以本记录、`docs/验收规划.md` 及 `2026-07-20-project-document-flow-migration` 总规划/设计为准。
@@ -4,8 +4,15 @@

 - 当前阶段仍是 uni-app Android 项目的 H5 页面样式与视觉状态收敛，不对接接口。
 - `pages.json` 注册 52 条活动路由；A02 已合并，A06 保持封存且源码、测试、文档和证据全部保留。
- 用户已明确通过 6 个模块基准：G01、T07、F01、R01、N01、M01。
- T01 已按用户最终选择的方案 1 完成“纵向世系轴”候选：始祖居上、后代逐代向下、同代横向展开、关系线连续、节点可选择、底部显示人物信息与操作。T01 尚未经过用户视觉审核，不得标记 `[x]`。
+- 用户已明确通过 6 个模块基准、T01 及 G03：G01、G03、T01、T07、F01、R01、N01、M01。
+- T01 已在方案 1 基础上改为固定左侧代际栏，代际标签与右侧节点／关系线画布彻底分区；用户已明确通过正常、加载、阅读提示、空、失败、节点选中及四档 H5 尺寸，现标记 `[x]` 并进入视觉冻结。
+- G03 已完成 320×568 多状态和四档正常态审核；用户已明确通过，现标记 `[x]` 并进入视觉冻结。下一步优先审核 T 模块带 `⚠` 的 T08，但其直达视觉候选不得冒充真实入口已完成。
+- T08 的 320×568 隐私、离世纪念和无权限三个直达视觉状态已由用户明确通过；T03 真实入口仍缺失且其余三档未验，所以继续保持 `[~] ⚠`。下一步优先审核 F 模块带 `⚠` 的 F05。
+- F05 修正后的 320×568 失效态已由用户明确通过；F04 真实入口仍缺失、正常／加载／失败等状态尚未整体确认且其余三档未验，所以继续保持 `[~] ⚠`。下一步优先审核 F06。
+- F06 已改为页面专属谱文编辑器；用户已明确通过 320×568 空表单、已有草稿、加载、就近校验、保存中、保存失败和保存成功七态。外层装饰框从整图拉伸改为九宫格后，因边缘压缩出现双线不明显；现将九宫格宽度调整为 `64rpx`，用户已明确通过双线恢复后的 320×568、360×640、360×800、412×915 四档正常态，以及边框调整后的校验／保存失败／保存成功三状态回归。F04／F05 真实入口仍缺失，Android 也未验，所以继续保持 `[~] ⚠`；下一步优先抽查 F08。
+- F08 已改为专属相册详情页；用户已确认正常、空相册、照片预览和相册失效四种 H5 视觉状态合适。由于 F07 真实入口、F09 跳转、接口和 Android 未完成，继续保持 `[~] ⚠`。
+- F09 已改为专属照片上传页；覆盖初始、权限、已选择、上传中、失败重试和成功，单张说明区可见显示当前照片缩略图与“第 N 张 / 共 N 张”，切换照片后说明独立保存。用户在 412×915 审阅后明确要求标 `[x]`；静态合同、交互 smoke、412 布局 smoke 和四档响应式 smoke 均通过。该冻结只覆盖当前 H5 视觉候选，不包含 F08 真实入口、系统权限、上传接口、持久化或 Android；下一步审核 F10。
+- F10 已改为专属视频待开放状态页；“返回家族首页”不再误入通用成功态，现真实返回 F01。用户已明确通过 412×915 候选并要求进入下一页；静态合同、真实返回运行时 smoke、四档响应式 smoke、同尺寸视觉对比和 `git diff --check` 均通过。该冻结只覆盖当前 H5 待开放视觉，不包含 F01 真实入口、视频接口、列表／失败数据态或 Android；下一步审核 R02。
 - 其余未验收页面已按所属基准批量收敛，但仍保持 `[~]`；H5 自动检查不等于用户或 Android 验收。

 ## 2. 本轮实际修改
@@ -41,6 +48,7 @@
 - `foundation-asset-audit.ps1` 仍因历史基础资产文件名含 `v1/v2/v3` 等候选式命名失败；这是既有已知问题，不能通过删除仍在使用的资产或放宽规则解决。
 - `repository-handoff-size-contract.ps1` 因 `docs/design/screens` 现有 647 张历史截图超过 35 张上限失败。用户明确要求不删除或清理截图，所以保留并如实记录。
 - 9222 Chrome 调试端口当夜未监听，但有 Chrome 进程连接 5173。为遵守“已有项目页时不得新开第二个浏览器或标签页”，没有另启浏览器，也没有伪造运行时 smoke、截图或四档响应式证据。
+- 后续经用户明确许可重启 Chrome 并开放 9222；T01 复核期间始终复用同一项目标签页。5173 返回 HTTP 200，9222 项目页面数为 1；T01 的 9 张原始状态／尺寸证据均核对为目标分辨率，两项聚焦契约通过。该后续结果不等于 Android 真机或其他候选页面已经验收。
 - Android/HBuilderX 真机或模拟器验证、系统字体放大、软键盘、4GB Android 长图性能仍未完成。

 ## 4. 明早接管顺序
@@ -57,17 +65,19 @@
   - `git status --short --ignored`
 3. 保留所有现有修改、未跟踪与忽略文件；不要执行 add、commit、push、reset、checkout，不要使用 worktree 或多代理。
 4. 检查 5173 和 9222。若现有 Chrome 项目页仍存在，只能复用；若需要为了 CDP 重启 Chrome，必须先让用户明确确认关闭现有窗口后再启动唯一审批窗口。
-5. 首先在 412×915 展示 T01 正常树态，等待用户结论；随后审核 T01 的加载、阅读提示、空、失败、节点选择和四档响应式。
-6. T01 通过后，按模块抽查批量候选：G → T → F → R → N → M。优先检查带 `⚠` 的页面、表单长内容页和 320×568 小屏。
+5. T01 已完成 412×915 正常树态、加载、阅读提示、空、失败、节点选择和四档响应式审核，并由用户明确通过；不要重新打开返工，除非用户指出新问题或共享视觉变更触发冻结回归。
+6. 页面视觉审核暂时让位于全项目文档流迁移。用户指出原合同漏扫普通容器上的 `position: relative`；当前先返工 F10 的无意义定位，再处理 T01 世代栏与成员节点，之后才恢复模块抽查。
 7. 只有用户明确通过的页面才能标 `[x]`。没有 CDP/截图/Android 证据时不得宣称最终完成。

 ## 5. Git 上传前注意

+- 用户换机时只能通过 Git，不能复制项目目录。换机前必须由用户自行把全部应保留修改、未跟踪文件和删除记录提交并成功推送；否则新电脑 clone/pull 后必然缺失当前工作区状态。
 - 当前工作区本来就包含大量已修改和未跟踪文件，它们是用户要求保留的页面、测试、文档、截图、母版和候选资产，不属于可擅自清理的垃圾。
 - 本轮没有执行任何 Git 暂存、提交、推送、重置或检出操作。
- 最后复核分支为 `main`，HEAD 为 `887481a 验收完成40%`；`git status --short` 有 171 项，包含用户此前和本轮需要保留的大量修改/未跟踪内容。
+- 2026-07-20 最新只读复核：分支为 `main`，HEAD 为 `5a31a75 Review changes batch 6 of 6`；`git status --short` 有 56 项，包括 25 项修改、4 项删除和 27 项未跟踪内容。
 - 上传前由用户自行审阅 `git status --short` 和 `git diff --check`；不要让新的 GPT 自动删除未跟踪文件来缩小提交。
- 若要解决 647 张截图导致的仓库大小契约失败，应由用户另行决定“哪些是长期证据、哪些只留本机”，获得明确授权后再做，不得在视觉施工会话里自行删除。
+- `unpackage/` 和 `docs/design/screens/runtime/` 已按用户明确授权清理，不需要上传；长期 `docs/design/screens/handoff/`、实际运行资产、源码、测试和交接文档必须进入远端。既有 `repository-handoff-size-contract` 失败不得通过放宽阈值或继续删除长期资料伪造通过。
+- 上传前只读审计未发现常见 Git 体积硬阻断：远端 `origin` 和上游 `origin/main` 已配置，候选内容没有超过 20MiB／100MiB 的单文件，最大单文件约 6.51MiB，未跟踪文件合计约 17.81MiB；关键交接文件均未被忽略，`git diff --check` 与 `git fsck --full` 均为 0。该结论只证明本地提交候选结构可上传，网络、认证和远端配额仍必须以用户实际 push 结果为准。

 ## 6. 可直接发给新 GPT 的提示词

@@ -76,9 +86,13 @@

 先完整阅读 AGENTS.md、docs/交接记录.md、docs/验收规划.md、docs/夜间批量收敛交接_2026-07-20.md，然后运行 git branch --show-current、git log -1 --oneline、git status --short、git status --short --ignored。

-当前仍只做 uni-app Android 家谱项目的 H5 视觉审核，不接接口。G01、T07、F01、R01、N01、M01 六个模块基准已由用户明确通过。T01 已按方案1改成纵向世系轴，但尚未人工通过；其余页面已按模块基准批量收敛，仍是待验收候选。5173 当夜运行正常，52 页面 + 2 共享组件 Vite 转换为 54/54；9222 当夜未监听，因此不能把运行时 smoke、四档响应式或 Android 写成已完成。
+当前仍是 uni-app Android 家谱项目的 H5 视觉阶段，不接接口。用户已明确通过 G01、G03、T01、T07、F01、F09、F10、R01、N01、M01 等当前 H5 视觉候选；其余页面以 `docs/验收规划.md` 为准，不能根据本提示词自行新增 `[x]`。Android/HBuilderX、接口和业务功能仍未完成。

-先检查 5173 和 9222。如果已有 Chrome 项目页，只能复用同一个窗口和标签页；若必须重启以开放 9222，先征得我的明确同意。先在 412×915 展示 T01 正常树态，之后按加载、阅读提示、空、失败、节点选中和四档尺寸审核。只有我明确说“通过”才能标 [x]。发现问题只返工当前页。T01 通过后按 G、T、F、R、N、M 模块抽查批量候选，优先带 ⚠ 页面和 320×568 小屏。
+当前最高优先级不是继续逐页视觉审核，而是完成全项目文档流迁移。原定位合同只扫描 `absolute/fixed/sticky`，漏掉普通容器上无意义的 `position: relative`，所以此前“剩余 112 条”不能作为完整数字。先扩展合同覆盖所有 `position`，再返工 F10，随后处理 T01 世代栏与成员节点。顶部和底部导航应使用必要的 `fixed`；普通根容器、Header/Content 包装、文本、表单和卡片不得滥用定位；真实弹窗、Toast、全屏预览和确有必要的局部装饰层可以保留精确白名单。
+
+换机只能通过 Git。开始工作前先确认用户已把上一台电脑的全部应保留修改、未跟踪文件和删除记录提交并推送；然后核对当前分支、HEAD、`git status --short` 和 `git status --short --ignored`。若远端没有上述 2026-07-20 文档流迁移文件、测试、F08 资产或交接更新，立即停止，不能用旧 HEAD 猜状态。
+
+检查 5173 和 9222。如果已有 Chrome 项目页，只能复用同一个窗口和标签页；若必须重启以开放 9222，先征得我的明确同意。只有用户明确说“通过”才能新增 `[x]`；定位迁移造成可见变化时，冻结页面必须重新对比，不能用自动测试代替用户确认。

 请先简要复述当前停点，再开始检查；没有真实证据不得宣称完成。已知 foundation-asset-audit 和 repository-handoff-size-contract 的失败不能靠放宽阈值或删除用户文件处理。
 ```
@@ -17,12 +17,20 @@

 ### 2026-07-20 夜间批量收敛说明

- 用户已明确授权：T01 留待次日人工审核，其余未验收页面不再逐页提问，统一按 G01、T07、F01、R01、N01、M01 六个已确认基准推进。
+- 用户已明确授权：其余未验收页面不再逐页提问，统一按 G01、T07、F01、R01、N01、M01 六个已确认基准推进；T01 已在后续人工审核中明确通过。
 - 本轮已将 F/R/N/M 的 28 个普通任务页统一到各自模块母版，删除重复的页面编号介绍块；表单、列表、详情、时间轴、设置和状态页仍保留不同业务结构。
 - F02、T03—T06、T08、G03、G08—G12 已移除跨模块旧不透明业务面板引用，改用所属模块或 G01/T07 基准的真实透明资产。
 - T01 已形成纵向世系轴候选：始祖在上、后代向下分代、同代横向扩展、关系线连续、节点可选择、底部人物信息栏独立。
 - 52 条活动路由及 2 个共享组件已通过 5173 Vite 逐文件转换（54/54）；68 项 PowerShell 静态测试中 66 项通过。剩余 2 项为已知仓库治理项：旧基础资产命名审计和历史截图数量上限。
 - 当前 Chrome 项目页仍连接 5173，但没有开放 9222 调试端口；为避免违反“不得新开第二个浏览器或第二个项目标签页”，本轮未伪造 CDP 运行截图、四档响应式和交互 smoke 证据。除用户已明确通过的基准页外，其余页面继续保持 `[~]`，明早人工复核后再决定是否标 `[x]`。
+- 后续复核已在复用的唯一 Chrome 项目页完成：用户先通过 T01 的 412×915 正常树态，再明确通过加载、阅读提示、空、失败、节点选中及 320×568、360×640、360×800、412×915 四档尺寸。状态与响应式联系表分别为 `docs/design/screens/runtime/2026-07-20/T01-state-contact-sheet.png` 和 `T01-responsive-contact-sheet.png`；T01 自本次确认起进入视觉冻结。该结论仍不包含 Android 真机、接口或业务功能验收。
+- G 模块后续抽查从 320×568 长表单风险页 G03 开始；用户已明确通过正常、必填校验、重复家谱提醒、创建失败、录入首代和首代必填校验，随后补齐并检查其余三档正常态。状态联系表为 `docs/design/screens/runtime/2026-07-20/G03-sample-320x568-contact-sheet.png`，响应式联系表为同目录 `G03-responsive-contact-sheet.png`；G03 自本次确认起进入视觉冻结。该结论不包含真实创建接口、持久化、Android 真机或中断恢复功能验收。
+- T 模块优先抽查带 `⚠` 的 T08；用户已明确通过其 320×568 隐私、离世纪念和无权限三个直达视觉状态，联系表为 `docs/design/screens/runtime/2026-07-20/T08-direct-states-320x568-contact-sheet.png`。由于 T03 仍无真实入口且其余三档未验，T08 继续保持 `[~] ⚠`；该视觉子项通过不得冒充入口、流程或整页验收完成。
+- F 模块带 `⚠` 页面从 F05 开始抽查；用户已明确通过修正后的 320×568 失效态，失效内容使用“谱文已失效／这篇谱文已无法查看／返回谱文列表”的页面专属语义。修复前后联系表为 `docs/design/screens/runtime/2026-07-20/F05-expired-before-after-320x568.png`。由于 F04 真实入口仍缺失、正常／加载／失败等状态尚未整体确认且其余三档未验，F05 继续保持 `[~] ⚠`；下一步审核 F06。
+- F06 已改为页面专属谱文编辑器；用户已明确通过 320×568 的空表单、已有草稿、加载、就近校验、保存中、保存失败和保存成功七态，联系表为 `docs/design/screens/runtime/2026-07-20/F06-seven-states-320x568-contact-sheet.png`。外层装饰框曾因整图纵向拉伸导致边线变形，改为九宫格后又因边缘压缩只剩一根明显线条；现将九宫格宽度调整为 `64rpx`，用户已明确通过双线恢复后的 320×568、360×640、360×800、412×915 四档正常态，标准表面截图联系表为同目录 `F06-double-line-64-surface-responsive-contact-sheet.png`；边框调整后的校验／保存失败／保存成功三状态回归也已由用户明确通过，联系表为 `F06-double-line-64-surface-state-contact-sheet.png`。F04／F05 真实入口仍缺失，Android 也未验证，因此继续保持 `[~] ⚠`。
+- F08 已改为专属相册详情页；用户已查看并确认正常、空相册、照片预览和相册失效四种 H5 视觉状态合适。320×568 状态证据为 `docs/design/screens/runtime/2026-07-20/F08-states-320x568-v2-contact-sheet.png`，412×915 逐态证据由同一 Chrome 项目页完成。由于 F07 真实入口、F09 跳转、接口和 Android 未完成，F08 继续保持 `[~] ⚠`。
+- F09 已改为专属照片上传页，覆盖初始、权限提示、已选择、上传中、失败重试和上传成功；单张说明区补充当前照片缩略图、“第 N 张 / 共 N 张”和切换后独立保存的真实本地绑定。用户在 412×915 审阅后明确要求标记 `[x]`；聚焦静态合同、交互 smoke、412 布局 smoke 和四档响应式 smoke 均通过。该 `[x]` 只表示当前 H5 视觉候选冻结，不包含 F08 真实入口、系统权限、上传接口、持久化或 Android 验证。
+- F10 已改为专属视频待开放状态页，移除点击“返回家族首页”后误入通用成功态的问题；按钮现真实返回 F01。用户已明确通过 412×915 候选并要求进入下一页；静态合同、真实返回运行时 smoke、四档响应式 smoke、同尺寸前后视觉对比和 `git diff --check` 均通过。该 `[x]` 只冻结当前 H5 待开放视觉，不表示视频接口、列表／失败数据态、F01 真实入口或 Android 已完成。

 页面只有同时满足以下条件才能从 `[~]` 改为 `[x]`：

@@ -199,7 +207,7 @@ G01、G03、G05、G06、G08、G09、G10、G11、G12 共 9 个活动 G 页面统
 | 状态 | 序号 | 页面 | 真实入口与必须覆盖的可能性 |
 | --- | ---: | --- | --- |
 | `[x]` | 4 | G01 我的家谱 | 用户已在本轮逐项通过正常、空、加载、失败、添加家谱弹层、切换家谱弹层、独立滚动及响应式检查；作为 G 系列基准冻结。Android/HBuilderX 与 4GB Android 长图性能仍待后续平台验证，不等于接口或 Android 功能通过 |
-| `[~]` | 5 | G03 创建家谱 | G01 空态或“添加家谱”→创建独立家谱；姓氏、谱名、堂号、所在地、访问规则，创建前提示搜索潜在已有家谱；覆盖必填校验、创建中、失败和已创建但始祖未完成的中断恢复；成功后直接成为创建者→录入始祖→进入 G05 总览，不直接跳 T01；下属支系创建待接口提供上级谱与权限字段 |
+| `[x]` | 5 | G03 创建家谱 | 用户已明确通过创建信息、必填校验、重复家谱提醒、创建失败、录入首代、首代必填校验及四档 H5 尺寸；320×568 下主操作、错误文案和弹窗无溢出或遮挡，三项聚焦契约与运行时 smoke 通过。真实创建、持久化、中断恢复、下属支系字段、Android 真机与接口功能仍待后续验证 |
 | `[~]` | 6 | G06 加入家谱 | G01 空态或“添加家谱”→加入；搜索／邀请码双模式、地区与谱名筛选；结果卡展示谱名、姓氏、地区、堂号、所属上级谱、当前支系、管理／认证信息、成员规模和更新时间，并覆盖未加入、已加入、审核中、被拒绝、已退出／移除、我创建的六种操作状态；邀请码验证、初始、加载、结果、无结果、无效／过期邀请码、失败、清空输入 |
 | `[~]` | 7 | G08 关系确认与入谱 | G06 选定家谱→填写真实姓名和以已知长辈为参照的文字关系；搜索态显示申请说明／提交申请并在成功后进入 G09，邀请码态显示可选补充信息／确认加入并明确无需审核，成功后返回 G01 选中新家谱；覆盖校验、重复提交、提交中、成功／失败、返回保护；结构化关系待接口提供后迁移 |
 | `[~]` | 8 | G09 我的申请 | G08 搜索来源提交成功→申请记录；待审、通过、拒绝、修改后重新提交、撤回、空、失败；邀请码来源不进入本页 |
@@ -217,13 +225,13 @@ G01、G03、G05、G06、G08、G09、G10、G11、G12 共 9 个活动 G 页面统

 | 状态 | 序号 | 页面 | 真实入口与必须覆盖的可能性 |
 | --- | ---: | --- | --- |
-| `[~]` | 13 | T01 世系树 | 已按方案 1 重构为纵向世系轴候选：始祖居上、后代向下分代、同代横向扩展、关系线连续、节点选中与底部人物信息栏；加载、树、空、失败、阅读提示均保留。52 路由 Vite 转换和聚焦静态契约已通过，等待 2026-07-21 用户视觉审核；9222 缺失导致当夜未完成 CDP 四档和交互 smoke |
+| `[x]` | 13 | T01 世系树 | 用户已明确通过固定左侧代际栏方案：代际标签与关系线分区，始祖居上、后代向下分代、同代横向扩展，节点可选并显示底部人物信息栏；加载、阅读提示、空、失败、节点选中和四档 H5 尺寸均有真实证据。固定栏横向拖动前后保持不动，聚焦静态契约通过；Android 真机、接口与业务功能仍待后续验证 |
 | `[~]` | 14 | T04 新增亲属 | T01→新增；首位成员／普通亲属、关系选择、必填、保存中、结果 |
 | `[x]` | 15 | T07 成员目录 | T01→成员目录；列表、搜索、无结果、失败、成员选择 |
 | `[~]` | 16 | T03 成员档案 | T01/T07→成员；正常、失败、隐私字段、编辑入口 |
 | `[~]` | 17 | T05 编辑成员 | T03→编辑；字段校验、保存中、成功／失败、无权限 |
 | `[~]` | 18 | T06 编辑关系 | T01→编辑关系；冲突、循环关系、说明弹窗、保存失败 |
-| `[~]` ⚠ | 19 | T08 成员状态 | 应由 T03 进入；去世、隐私隐藏、无权限；当前无真实入口 |
+| `[~]` ⚠ | 19 | T08 成员状态 | 用户已明确通过 320×568 隐私隐藏、离世纪念和无权限三个直达视觉状态，聚焦契约与运行时 smoke 通过；应由 T03 进入，但当前仍无真实入口且其余三档未验，因此只记录视觉子项通过，不标 `[x]` |

 ### 5.5 家族动态与内容

@@ -233,12 +241,12 @@ G01、G03、G05、G06、G08、G09、G10、G11、G12 共 9 个活动 G 页面统
 | `[~]` | 21 | F02 发布动态 | F01→发布；空内容、键盘、提交中、成功／失败、重复提交 |
 | `[~]` | 22 | F03 动态详情 | F01 动态卡→详情；正文、评论、操作结果、内容失效 |
 | `[~]` | 23 | F04 谱文列表 | F01→谱文；分类、列表、空、失败、新建入口 |
-| `[~]` ⚠ | 24 | F05 谱文详情 | 应由 F04 文章进入；详情、收藏、失效内容；当前卡片只弹提示 |
-| `[~]` ⚠ | 25 | F06 编辑谱文 | 应由 F04 新建／F05 编辑进入；草稿、校验、保存、失败 |
+| `[~]` ⚠ | 24 | F05 谱文详情 | 用户已明确通过修正后的 320×568 失效态；应由 F04 文章进入，但当前无真实入口，正常／加载／失败等状态尚未整体确认且其余三档未验，因此只记录失效视觉子项通过，不标 `[x]` |
+| `[~]` ⚠ | 25 | F06 编辑谱文 | 用户已明确通过 320×568 七态、双线九宫格修正后的四档正常态，以及边框调整后的校验／保存失败／保存成功三状态回归；应由 F04 新建／F05 编辑进入，但当前无真实入口，Android 也未验证，因此不标 `[x]` |
 | `[~]` | 26 | F07 相册列表 | F01→相册；列表、空、失败、新建相册 |
-| `[~]` ⚠ | 27 | F08 相册详情 | 应由 F07 相册进入；照片墙、空相册、预览、失效；当前无跳转 |
-| `[~]` ⚠ | 28 | F09 上传照片 | 应由 F08→添加照片；权限、选择、上传进度、失败重试 |
-| `[~]` ⚠ | 29 | F10 家族视频 | 应由 F01 内容入口进入；未开放、空、列表、失败；当前无入口 |
+| `[~]` ⚠ | 27 | F08 相册详情 | 用户已确认正常、空相册、照片预览和相册失效四种 H5 视觉状态合适；F07 真实入口、F09 跳转、接口和 Android 未完成，因此不标 `[x]` |
+| `[x]` | 28 | F09 上传照片 | 用户已明确要求当前 H5 视觉候选标 `[x]`：专属相册续页式上传页覆盖初始、权限、已选择、上传中、失败重试和成功，单张说明与当前照片有可见绑定，聚焦合同、交互、412 布局及四档响应式 smoke 通过；F08 真实入口、系统权限、上传接口、持久化和 Android 仍属后续功能验证 |
+| `[x]` | 29 | F10 家族视频 | 用户已明确通过当前 H5 待开放状态页：412×915 视觉保持原候选，按钮真实返回 F01，聚焦合同、运行时跳转和四档响应式 smoke 通过；F01 真实入口、视频接口、列表／失败数据态和 Android 仍待后续验证 |

 ### 5.6 人物、礼仪与档案