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

## 1. 当前准确停点

- 换机接管的权威提交已更新为 `01d246c 保存视觉审核与文档流迁移进度`；接管时已确认 `main`、该 HEAD 与空工作区。文中后续出现的 `5a31a75`／56 项变化均为提交前历史审计，不是当前基线。
- 全项目文档流迁移已完成源码收敛并进入最终回归：新合同从 35 个文件、390 条未白名单声明（278 条 `relative`）收敛到零未白名单违规，并拒绝失效白名单。审查覆盖共享组件、全部模块页面与封存 A06，不只覆盖 F10。
- 必要的固定导航、真实弹层、Toast、遮罩、底部弹层、全屏预览、局部媒体覆盖和 T01 关系线等保留精确白名单；普通根容器、Header/Content、正文、表单、按钮和卡片已迁移到正常流、flex 或 grid。
- 本轮没有新增 `[x]`。同尺寸 H5 对比未发现语义性可见变化，但仍须由用户决定是否维持迁移前冻结结论；没有 Android 新证据。
- 当前阶段仍是 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` 曾是普通任务页统一母版，现仅按不删除约束保留为历史文件；活动路由引用为 0。
- F03—F07、R03—R11、N02、M02—M10 已各自拥有业务数据、字段、状态、校验和导航，不再由 `page-catalog.js` 模拟页面差异。
- 页面继续共享 `AppLoading`、`AppButton`、`AppDialog`、`AppToast`、`PageHeader`、背景及模块视觉资产，不复制视觉原语。

### 其他自定义页

- F02 改用 F01 所属 family 资产。
- T03、T04—T06、T08 改用 T01/T07 的 tree 透明资产；T04—T06 已拆为添加亲属、编辑成员、维护关系三套独立业务结构，`TreeMemberForm.vue` 仅历史保留。
- G03、G08—G12 改用 G01 的透明宣纸框、列表卷框和新 `g-form-field-frame.png`。
- G05、G06 保留其特殊总览/搜索结构；G01 和六个已通过基准没有被批量母版覆盖。

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

- 5173 H5 服务仍在运行。
- 对 52 个活动页面和 2 个共享组件逐一请求 Vite 转换：`54/54` 返回 HTTP 200。
- PowerShell 静态契约总数 119：118 项通过；唯一失败为基础资产候选式命名。A01 新机预览已由代码管线重建，G06 一致性合同已改读长期 handoff 证据。
- 页面与组件中的静态资产引用检查为 `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` 已通过补齐可再生成目录忽略规则真实通过：35 个长期截图、19.51MB、52 个索引链接；没有删除长期资料或放宽阈值。
- 9222 后续已按用户许可开放并复用唯一项目页；排除会写回已清理 runtime 目录的旧 T07 baseline 后，26 项浏览器 runtime smoke 全部通过，52 页当前图已写入 `%TEMP%` 供复核。
- 后续经用户明确许可重启 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. 全项目文档流、数据驱动容量和 52 路由业务所有权均已收敛；当前直接把全量 H5 候选交给用户复核，不再恢复旧的通用 `ModulePage` 逐页审核路线。自动化通过不能替用户维持或新增 `[x]`。
7. 只有用户明确通过的页面才能标 `[x]`。没有 CDP/截图/Android 证据时不得宣称最终完成。

## 5. Git 上传前注意

- 用户换机时只能通过 Git，不能复制项目目录。换机前必须由用户自行把全部应保留修改、未跟踪文件和删除记录提交并成功推送；否则新电脑 clone/pull 后必然缺失当前工作区状态。
- 当前工作区本来就包含大量已修改和未跟踪文件，它们是用户要求保留的页面、测试、文档、截图、母版和候选资产，不属于可擅自清理的垃圾。
- 本轮没有执行任何 Git 暂存、提交、推送、重置或检出操作。
- 上传前历史只读复核曾记录：分支为 `main`，HEAD 为 `5a31a75 Review changes batch 6 of 6`，工作区有 56 项变化。上述内容已经合并进权威提交 `01d246c 保存视觉审核与文档流迁移进度`；本次换机接管已从该提交的空工作区开始。
- 上传前由用户自行审阅 `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，也不要删除、覆盖或清理任何现有修改、未跟踪文件、测试、文档、截图、母版和候选资产。

远端 `main` 的接管权威提交为 `01d246c 保存视觉审核与文档流迁移进度`。先完整阅读 AGENTS.md、docs/交接记录.md、docs/验收规划.md、docs/夜间批量收敛交接_2026-07-20.md 及文档流迁移 plan/spec，然后运行 git branch --show-current、git log -1 --oneline、git status --short、git status --short --ignored；提交不符或初始工作区不空立即停止。文中 `5a31a75`／56 项变化只是上传前历史审计。

当前仍是 uni-app Android 家谱项目的 H5 视觉阶段，不接接口。用户已明确通过 G01、G03、T01、T07、F01、F09、F10、R01、N01、M01 等当前 H5 视觉候选；其余页面以 `docs/验收规划.md` 为准，不能根据本提示词自行新增 `[x]`。Android/HBuilderX、接口和业务功能仍未完成。

全项目文档流迁移源码已完成收敛，当前停点是综合回归与用户复核交接。合同已扫描包括 `relative` 在内的全部 `position` 声明，从 35 个文件、390 条未白名单声明（278 条 `relative`）收敛到零未白名单违规，并拒绝失效白名单；旧“剩余 112 条”无效。审查覆盖共享组件、R/N/M/F/G/T/A 全模块和封存 A06，不只覆盖 F10。顶部和底部导航使用必要的 `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` 当前已真实通过。
```

## 7. 2026-07-20 夜间全量完成记录

- 23 个原 `ModulePage` 活动消费者已全部改为路由专属业务页面，52 条活动路由中直接引用 `ModulePage.vue` / `page-catalog.js` 的数量为 0。历史组件和目录按不删除约束保留。
- 原 22 个流程断点均已补齐本地 H5 入口、必要路由参数和返回方向；接口、持久化和系统权限仍延期到功能阶段。
- 全量验证为 Vite 54/54、浏览器 runtime smoke 26/26；PowerShell 119 项中 118 项通过，唯一失败为基础资产候选式命名。未运行会写回 `docs/design/screens/runtime/` 的旧 T07 baseline。
- 52 个活动页面逐页抓取 360×800 当前图到 `%TEMP%\jiapuapp-runtime\all-pages-2026-07-20`，并生成 A/G/T、F、R、N/M 四张联系表；与长期同模块 360×800 候选图比较后未发现横向溢出、明显裁切、错误共用业务母版或主动作不可达。
- Chrome 9222 和 Vite 5173 均在运行，复核结束时只保留 1 个 localhost 项目页。`unpackage/` 与 `docs/design/screens/runtime/` 未恢复。
- 本轮不接接口、不宣称 Android/HBuilderX 完成；页面发生可见变化，用户醒来后仍需明确说“通过”才能更新 `[x]`。
- 审计报告：`docs/active-page-business-ownership-audit_2026-07-20.md`。