jiapuapp/docs/夜间批量收敛交接_2026-07-20.md

# 家谱 APP 夜间批量收敛交接（2026-07-20）

## 1. 当前准确停点

- 当前阶段仍是 uni-app Android 项目的 H5 页面样式与视觉状态收敛，不对接接口。
- `pages.json` 注册 52 条活动路由；A02 已合并，A06 保持封存且源码、测试、文档和证据全部保留。
- 用户已明确通过 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. 本轮实际修改

### T01

- `pages/tree/t01-tree-overview.vue` 改为纵向三代世系结构。
- 保留加载、树、阅读提示、空、失败、节点选中及 T03/T04/T06/T07 路由。
- 新增/复用 tree 模块透明资产：节点框、选中节点框、状态框、人物信息栏。
- 聚焦测试：`tests/t01-tree-state-contract.ps1`、`tests/t01-all-states-visual-contract.ps1`。

### 普通 F/R/N/M 页面

- `components/ModulePage.vue` 是 28 个普通任务页的统一母版。
- 已删除重复的“页面编号 + 说明”介绍块，避免每页看起来像同一张编号展示页。
- 表单、列表、详情、时间轴、设置和状态仍是不同结构；加载统一使用 `AppLoading`。
- 每个模块使用自己的长背景和 `module-content-frame.png` / `module-field-frame.png`，不再引用 G 模块旧不透明业务面板。

### 其他自定义页

- F02 改用 F01 所属 family 资产。
- T03、T04—T06、T08 改用 T01/T07 的 tree 透明资产；`TreeMemberForm.vue` 继续统一 T04—T06 的表单与结果结构。
- G03、G08—G12 改用 G01 的透明宣纸框、列表卷框和新 `g-form-field-frame.png`。
- G05、G06 保留其特殊总览/搜索结构；G01 和六个已通过基准没有被批量母版覆盖。

## 3. 最新自动验证事实

- 5173 H5 服务仍在运行。
- 对 52 个活动页面和 2 个共享组件逐一请求 Vite 转换：`54/54` 返回 HTTP 200。
- PowerShell 静态契约总数 68：66 项通过，2 项为下述仓库治理失败。
- 页面与组件中的静态资产引用检查为 `0` 个缺失；活动页面和组件中的原生 `uni.showToast/showModal/showLoading/showActionSheet` 引用为 `0`。
- `git diff --check` 退出码为 0；只有现有 LF/CRLF 转换提示，没有空白错误。
- `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. 明早接管顺序

1. 完整阅读：
   - `AGENTS.md`
   - `docs/交接记录.md`
   - `docs/验收规划.md`
   - `docs/夜间批量收敛交接_2026-07-20.md`
2. 运行：
   - `git branch --show-current`
   - `git log -1 --oneline`
   - `git status --short`
   - `git status --short --ignored`
3. 保留所有现有修改、未跟踪与忽略文件；不要执行 add、commit、push、reset、checkout，不要使用 worktree 或多代理。
4. 检查 5173 和 9222。若现有 Chrome 项目页仍存在，只能复用；若需要为了 CDP 重启 Chrome，必须先让用户明确确认关闭现有窗口后再启动唯一审批窗口。
5. T01 已完成 412×915 正常树态、加载、阅读提示、空、失败、节点选择和四档响应式审核，并由用户明确通过；不要重新打开返工，除非用户指出新问题或共享视觉变更触发冻结回归。
6. 页面视觉审核暂时让位于全项目文档流迁移。用户指出原合同漏扫普通容器上的 `position: relative`；当前先返工 F10 的无意义定位，再处理 T01 世代栏与成员节点，之后才恢复模块抽查。
7. 只有用户明确通过的页面才能标 `[x]`。没有 CDP/截图/Android 证据时不得宣称最终完成。

## 5. Git 上传前注意

- 用户换机时只能通过 Git，不能复制项目目录。换机前必须由用户自行把全部应保留修改、未跟踪文件和删除记录提交并成功推送；否则新电脑 clone/pull 后必然缺失当前工作区状态。
- 当前工作区本来就包含大量已修改和未跟踪文件，它们是用户要求保留的页面、测试、文档、截图、母版和候选资产，不属于可擅自清理的垃圾。
- 本轮没有执行任何 Git 暂存、提交、推送、重置或检出操作。
- 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 自动删除未跟踪文件来缩小提交。
- `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 的提示词

```text
请全程使用中文。不要根据旧对话猜状态，不使用多代理或 worktree，不执行 git add、commit、push、reset、checkout，也不要删除、覆盖或清理任何现有修改、未跟踪文件、测试、文档、截图、母版和候选资产。

先完整阅读 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、G03、T01、T07、F01、F09、F10、R01、N01、M01 等当前 H5 视觉候选；其余页面以 `docs/验收规划.md` 为准，不能根据本提示词自行新增 `[x]`。Android/HBuilderX、接口和业务功能仍未完成。

当前最高优先级不是继续逐页视觉审核，而是完成全项目文档流迁移。原定位合同只扫描 `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 的失败不能靠放宽阈值或删除用户文件处理。
```