106 lines
6.2 KiB
Markdown
106 lines
6.2 KiB
Markdown
# 家谱 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 打包**。
|
||
- 当前正在处理：`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 位成员 / 成员`
|
||
- 当前题签有标题/元信息分隔线；列表右侧角色和箭头应为同一水平基线；日期为“更新于”文字，不显示参考稿中没有的日历图标。
|
||
|
||
### 必须继续做的事
|
||
|
||
1. 用 HBuilderX 刷新 G01，并使用与参考稿相同的手机预览尺寸截屏。
|
||
2. 将新截图与 v5 参考稿并排比对，重点检查：
|
||
- 顶部家谱题签的字体、字段、分隔线和三组元信息是否同一行；
|
||
- 四个快捷图标的实际可见面积与文字大小；
|
||
- 两条列表的谱印、标题、地点/成员、日期、右侧角色和箭头基线；
|
||
- 新建按钮的云纹、文字、底部山水和 Tabbar 安全区。
|
||
3. 有任何差异时，只改对应 G01 组件并重新截图；不要提前勾选 `G-01`。
|
||
4. 最终还要按 `320 × 568` 和 `360 × 800` 做小屏检查，确认无重叠、无裁切、无底部遮挡。
|
||
|
||
## 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. 将本文件和新的 HBuilderX 截图一起发给新的 GPT，并说明：“先读 `docs/交接记录.md` 与 `AGENTS.md`，继续 G01 的视觉验收，不要改接口。”
|
||
4. 新 GPT 修改后，先运行第 7 节命令，再由用户在 HBuilderX 提供同尺寸截图复核。
|