# 家谱 APP 交接记录

> 更新时间：2026-07-13  
> 用途：更换电脑或更换 GPT 后，先读本文件即可恢复当前工作上下文。  
> 保密说明：账号、密码、令牌和其他敏感信息不记录在本文件。

## 1. 新接手者先做什么

按以下顺序阅读，不要跳过：

1. 根目录 `AGENTS.md`：项目工作约束，要求先确认依据、最小修改、修改后验证。
2. `docs/规划.md`：全项目范围、完成状态与推进顺序。
3. `docs/design/D1_安卓视觉规范与页面壳.md`：Android 视觉、兼容性、PNG 资产与背景规则。
4. `docs/design/G01_我的家谱_设计记录.md`：G01 已完成的施工与最终验收结论。
5. `docs/superpowers/specs/2026-07-12-g01-reference-typography-design.md` 与 `docs/superpowers/plans/2026-07-12-g01-information-hierarchy.md`：G01 的已确认规格与执行记录。

视觉唯一基准：

- `docs/design/screens/G01-我的家谱-紧凑版设计稿-v5-Tabbar安全区.png`

不要把“红色中国风”当作完成标准；G01 需要按此图逐区、逐字段、逐比例比对。

## 2. 项目与范围

- 项目：uni-app，目标为 Android，使用 HBuilderX 打包。
- 当前阶段：先完成全部页面视觉设计和小屏验收；**暂不恢复接口联调、真实账号联调或 Android 打包**。
- 当前正在处理：`D2 / A-01 至 A-06 账户与首次使用`设计；`A-01` 与 `A-02` 已于 2026-07-13 落地本地 UI 并等待运行时验收，`G-01 我的家谱`已验收完成。其余页面仍须先完成设计记录与效果稿归档再实现。
- 当前不做：iOS、PC 管理端、官网，以及新增业务接口。
- 本地展示数据的唯一来源：`data/mock.js`；G01 当前不调用远程 API。
- 本目录为 Git 仓库；不得重置文件或删除既有用户文件，提交时只暂存本轮受管文件。

## 3. 用户已确认的视觉规则

- 风格是“家祠卷轴”：朱砂页头、暖宣纸、古金细线、墨褐文字、淡墨山水/竹影；禁止绿色页面背景。
- 需要使用的图标、谱印框与云纹必须是项目内的透明 PNG；不能用文字、emoji、CSS 图形或网络图片替代可见图标。
- 参照图中的布局、字号、字段、图标可见面积和留白需要尽量一比一还原；不要只做“差不多”的国风页面。
- 要兼容老款 Android：用 rpx、Flex、边距与基础圆角；避免 CSS Grid、`flex gap`、`clip-path`、复杂滤镜和大面积动画。
- 每次完成一个可验收子项，更新 `docs/规划.md` 和对应设计记录；没有 HBuilderX 同尺寸截图确认时，不能勾选整个页面完成。

## 4. G01 当前实际状态

### 已施工并通过静态检查

- 朱砂顶部、项目 Logo、条件式通知红点、宣纸底纹、淡墨底图、底部 Tabbar。
- 当前家谱题签、四个快捷入口、分隔金线、创建/加入列表、新建按钮。
- 透明 PNG 资产已接入：快捷入口、Tab、通知、箭头、元信息图标、谱印框和新建云纹。
- 当前演示字段已统一为参考稿：
  - 当前家谱：`汤氏家谱 / 河南·洛阳 / 158 位成员 / 管理员`
  - 已加入家谱：`汤氏宗谱 / 山东·济宁 / 286 位成员 / 成员`
- 当前题签有标题/元信息分隔线；列表右侧角色和箭头应为同一水平基线；日期为“更新于”文字，不显示参考稿中没有的日历图标。

### 2026-07-13 最终验收结论

- 用户已提供 `360 × 800`、`320 × 568`（含滚动到底部）响应式预览，以及 HBuilderX Web 浏览器 `Pixel 2 XL` 常规屏预览。
- 已确认：顶部、题签、快捷入口、两条列表、新建按钮、山水和 Tabbar 无重叠或裁切；`320 × 568` 下新建按钮可完整露出在 Tabbar 上方。
- 用户明确确认可结项，故 G-01 已勾选完成。此结论不解除接口联调、真实账号联调或 Android 打包暂停。

## 5. G01 关键文件

| 作用 | 文件 |
| --- | --- |
| G01 页面与当前题签/快捷入口/新建按钮 | `pages/genealogy/index.vue` |
| G01 列表项 | `components/GenealogyCard.vue` |
| 顶部标题栏/Logo/通知点 | `components/PageHeader.vue` |
| 底部导航 | `components/AppTabbar.vue` |
| 展示数据 | `data/mock.js` |
| 视觉变量 | `styles/tokens.scss`、`styles/global.scss` |
| G01 图标 | `static/assets/icons/` |
| G01 背景 | `static/assets/backgrounds/` |
| G01 契约检查 | `tests/g01-visual-contract.ps1` |
| 新 PNG 透明检查 | `tests/g01-asset-alpha-audit.ps1` |

## 6. 已知技术注意项

- `tests/g01-visual-contract.ps1` 用 UTF-8 Base64 形式检查中文展示字段。这是为了避免 Windows PowerShell 5.1 将无 BOM UTF-8 脚本中的中文字符串误读为乱码；不要把该段直接改回裸中文字面量。
- `calendar-v1.png` 已因为参考稿没有该图标而删除；不要再次接入日期图标。
- G01 的背景资产应继续使用 `footer-mountain-bamboo.png`，不要换回实心灰山的 `footer-mountain-bamboo-v2.png`。
- 题签透明角已经过检查；若再次出现白角，优先检查题签容器是否重新加上不透明的矩形底色。
- 所有新 PNG 在接入前都要检查：RGBA、四角透明、主体没有大量空白、显示尺寸符合 24dp/设计稿。

## 7. 复核命令

在项目根目录的 PowerShell 中运行：

```powershell
powershell -ExecutionPolicy Bypass -File tests\g01-visual-contract.ps1
powershell -ExecutionPolicy Bypass -File tests\g01-asset-alpha-audit.ps1
powershell -ExecutionPolicy Bypass -File tests\compile-audit.ps1
powershell -ExecutionPolicy Bypass -File tests\uni-scss-injection.ps1
powershell -ExecutionPolicy Bypass -File tests\vue3-entry.ps1
```

最近一次结果：五项均为 `PASS`。这只证明代码和资产契约通过，**不替代 HBuilderX 视觉验收**。

## 8. 换电脑操作

1. 完整复制整个 `jiapuapp` 项目文件夹，保留 `docs/`、`static/`、`tests/`、`data/` 和所有 Vue/SCSS 文件。
2. 新电脑安装 HBuilderX 后，直接“打开目录”选择复制后的项目根目录。
3. 将本文件和后续页面的新截图一起发给新的 GPT，并说明：“先读 `docs/交接记录.md` 与 `AGENTS.md`，按规划继续页面设计，不要改接口。”
4. 新 GPT 修改后，先运行第 7 节命令，再由用户在 HBuilderX 提供同尺寸截图复核。

## 9. 2026-07-13 流程纠正记录

- A-01 的历史效果稿 v1、v2 与当前效果稿 v3 均已归档；当前入口依据为 `docs/design/screens/A01-启动登录引导-效果稿-v3-文字注册入口.png`，对应说明见 `docs/design/A01_启动登录引导_设计记录.md`。
- A-01 的固定栅格、状态、独立背景/图标及 320 × 568、360 × 640、360 × 800、412 × 915 静态效果稿已归档并经审计；它们仍不替代 uni-app 页面实现后的 Android 运行时验收。
- 先前误建的 A-01 规格和“四个独立按钮”执行计划已降为失效历史；2026-07-13 已确认文字注册入口方案，唯一需求所有者为 `docs/design/A01_启动登录引导_设计记录.md`。用户随后授权 A-01 欢迎入口与 A-02 双标签登录页的本地 UI 落地；不得接接口、执行真实登录或替其他未设计页面造功能。
- 所有后续页面效果图必须先保存到 `docs/design/screens/`，并在对应页面设计记录写明用途、状态和验收缺口；未完成归档不得展示为可推进的设计成果。
- G-01 已于 2026-07-13 经用户确认结项；当前进入 D2 / A-01 的设计工作，接口、真实登录和 Android 打包仍暂停。
- A-01 入口页与 A-02 双标签登录页已于 2026-07-13 落地本地 UI：路由入口为 `pages/auth/entry`；只有在 A-01 显式勾选协议后才可进入 A-02。页面不调用接口、不写登录态、不跳转家谱；微信、注册、协议、忘记密码和验证码仅提示待相应页面或能力完成。A-01/A-02 运行时四尺寸验收仍待执行。
- A-01 首次本地预览与 v3 效果稿存在红头高度、按钮宽度和垂直节奏偏差。整图视觉层方案已被用户否决并撤销；现以真实 DOM、分层背景和按钮图标重建页面，下一次 Android 预览必须以 v3 截图作同尺寸对比。