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 的提示词

请全程使用中文。不要根据旧对话猜状态，不使用多代理或 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 的失败不能靠放宽阈值或删除用户文件处理。