修改完成55%

2026-07-15 08:31:21 +08:00
parent 8c98936da5
commit 241a7af54c
98 changed files with 3269 additions and 782 deletions
@@ -20,12 +20,11 @@
 ## 视觉

 - 保留 `PageHeader`、暖宣纸与朱砂/古金/墨褐的已验收语言，不触及 A01、A02、A04--A06、G01、G03。
- 新增不透明位图：世系画布 `t01-tree-canvas.png`、成员节点 `t01-member-node.png`、底部成员信息条 `t01-member-sheet.png`。它们承载纸纹、边框、关系线和卡片表面；Vue 只叠放真实文本、滚动和点击层。
- 完整画布含轻古金三代关系线，适配当前 mock 的一祖、两中代、三后代布局；远端节点仍使用同一空白节点皮肤，保持可读优先。
+- 复用已验收体系中的完整不透明位图：`g03-create-flow-panel.png` 作为世系画布，`g06-search-input-wide.png` 作为成员节点，`application-status-card.png` 作为底部信息条；Vue 只叠放真实文本、滚动和点击层，避免新增语义重复资产。
 - `landscape`、`empty`、`error` 使用画布内留白与现有透明云纹，不再生成一个通用状态卡页。

 ## 契约与验证

- 先红灯：T01 存在且 T02 路由/文件不存在；T01 有四态、三张位图、成员资料与新增亲属跳转；节点和信息条不允许 CSS 构造表面。
+- 先红灯：T01 存在且 T02 路由/文件不存在；T01 有四态、三类完整位图、成员资料与新增亲属跳转；节点和信息条不允许 CSS 构造表面。
 - 运行冒烟：默认 `?state=landscape`、`?state=empty`、`?state=error` 分别显示同页状态；`?genealogyId=1001` 显示节点并点选进入 T03。
 - 更新全量路由契约至 54，更新交接/P00/规划；截图至少包含 tree、empty、error 与 412×915 tree。
@@ -0,0 +1,57 @@
+# 交接文档与视觉证据精简设计
+
+> 日期：2026-07-15  
+> 状态：用户已确认“正文精简、证据不删除”方向  
+> 范围：仅整理交接、审核入口与证据索引，不修改页面代码、视觉资产、路由或接口
+
+## 目标
+
+让更换电脑后的新 GPT 只阅读一个简洁入口，就能准确知道当前停点、必须调用的技能、禁止事项、页面审核方式和验证要求；同时减少连续阅读前后对比图、多尺寸截图与历史废稿造成的视觉疲劳。
+
+## 信息结构
+
+1. `docs/交接记录.md` 作为唯一快速入口，只保留：
+   - 54 条最终路由、7 个已验收页、47 个待审核候选的准确状态；
+   - 下一步是按 `docs/规划.md` 逐页审核，而不是继续批量设计或对接接口；
+   - 新 GPT 的必读顺序、技能调用顺序、禁止事项和最小恢复检查；
+   - 一处“视觉证据归档”链接，不逐张罗列历史对比图。
+2. `docs/design/视觉设计交接手册.md` 保留完整操作方法，但删除重复、陈旧的截图清单和过期停点；截图规则改为“审核时默认只看一张代表图，状态复杂时看一张状态联系表，发现问题后才展开历史对比与多尺寸证据”。
+3. 新增 `docs/design/视觉证据索引.md`，集中保存现有代表截图、状态联系表、历史前后对比和模块设计记录的路径。证据文件不删除、不移动。
+4. `.superpowers/sdd/task-1-report.md` 明确标记为早期 A02 专项报告，不再承担当前总交接职责；当前交接以 `docs/交接记录.md` 为准。
+
+## 新 GPT 的启动契约
+
+交接入口必须明确写出以下顺序：
+
+1. 完整阅读 `AGENTS.md`、`docs/交接记录.md`、`docs/规划.md` 和视觉交接手册，先运行 `git status --short`，不得覆盖未提交改动。
+2. 设计或审视页面时，先调用 `product-design:index`；基于真实运行截图调用 `product-design:audit`。
+3. 只有缺少完整位图视觉资产时才调用 `imagegen`；按钮、卡片、边框和装饰面不得用 CSS 伪造。
+4. 修改页面行为、路由或可审计视觉结构前调用 `superpowers:test-driven-development`，先更新最小契约测试。
+5. 测试、截图、路由或构建异常时调用 `superpowers:systematic-debugging`。
+6. 宣称完成前调用 `superpowers:verification-before-completion`，运行受影响测试、真实截图复核和 `git diff --check`。
+7. 不使用 worktree、多代理、`git add`、commit、push、上传、reset 或 checkout。
+
+## 视觉审核降噪规则
+
+- 默认审核材料：每页一张 360×800 代表截图。
+- 同页包含关键状态时：使用一张状态联系表代替多张连续截图。
+- 412×915、小屏、多尺寸和前后对比图只在发现比例问题、回归问题或用户要求时展开。
+- 历史废稿与 before/after 图保留在证据索引的“历史审计”区域，不出现在快速交接正文。
+- 用户明确通过一页后才把 `docs/规划.md` 的 `[~]` 改为 `[x]`；要求返工时改为 `[!]`。
+
+## 需要修正的当前矛盾
+
+- 将已验收数量统一为 7：A01、A02、A04、A05、A06、G01、G03。
+- 将候选数量统一为 47，并保持“候选不等于用户验收”。
+- 删除 G06“结果态、无结果态截图尚未完成”的陈旧描述；保留 G06 尚未获用户视觉验收的事实。
+- 删除“下一项继续推进 F/R/N/M”的旧停点，改为“全部候选已覆盖，等待逐页审核”。
+- 明确 H5 截图是候选审计证据，最终 Android/HBuilderX 真机或模拟器复核仍在视觉审核之后。
+
+## 验证
+
+- 用文本检索确认交接文档不再出现“六个已验收”“G06 结果态未截图”“继续推进 F/R/N/M”等陈旧表述。
+- 确认快速交接入口包含全部六类技能调用规则和 Git/多代理禁令。
+- 确认 `docs/规划.md` 仍为 7 个 `[x]`、47 个 `[~]`、0 个遗漏项。
+- 运行 `git diff --check`。
+- 不删除任何现有 PNG，不修改页面、路由、接口或运行资产。
+
@@ -0,0 +1,33 @@
+# 仓库精简与交接证据保留设计
+
+> 日期：2026-07-15
+> 状态：用户已批准执行
+> 范围：整理设计证据和临时文件，不修改页面、路由、接口或 `static/` 运行资产
+
+## 目标
+
+把可随 Git 上传的当前快照控制在约 30MB，同时让新 GPT 仍能通过标准 `docs/design/` 路径阅读视觉规范、设计记录和代表截图。完整审计证据移到项目外的本地归档，不删除。
+
+## 文件边界
+
+- 完整保留：源码、测试、`static/`、`docs/design/*.md`、`docs/design/references/` 两张风格锚点。
+- Git 内保留：7 个已验收页面代表图、F/R/N/M 三张联系表、根页面代表图、G05/G06/G08–G12 代表图、T01/T03–T08 代表图。
+- 项目外归档：其余 before/after、多尺寸、历史废稿、完整运行截图以及 `tmp/` 临时源文件。
+- 新增 `.gitignore`：排除 `tmp/`、`unpackage/`、临时审计图和误放到 `docs/superpowers/specs/design/` 的目录。
+- 更新 `docs/design/视觉证据索引.md`：只链接 Git 内保留的证据；完整历史归档写明本机路径和非 Git 属性。
+
+## 归档位置
+
+`C:\Users\Rain\Desktop\job\jiapuapp-design-evidence-archive-2026-07-15`
+
+归档目录包含原始 `docs/design/` 完整副本和项目根 `tmp/` 临时源文件。移动前必须确认源目录位于项目内、目标目录位于上述固定路径且目标不存在；不得覆盖已有目录。
+
+## 验收
+
+- `docs/design/` 标准路径恢复，17 个设计 Markdown 均保留。
+- `docs/design/screens/` 不超过 20MB、35 个文件。
+- `docs/design/视觉证据索引.md` 的 Markdown 链接全部有效。
+- `static/` 无任何内容差异。
+- 完整外部归档存在且大于 90MB。
+- 精简契约、交接契约和 `git diff --check` 通过。
+- 不执行 `git add`、commit、push、reset、checkout 或历史重写。