docs(上架): 应用商店上架 / 正式证书 / APP 备案 全套材料

## 背景

用户要同时办三件事：① 上架华为 AppGallery ② 申请正式发布证书 ③ 在阿里云做 APP 备案。
本目录是这三件事的全部材料，信息**全部取自真实代码与实测**，不是套模板。

## 材料清单

| 文件 | 用途 |
|---|---|
| `README总览.md` | 先看这个：材料索引 + 三件事的先后关系 + 你现在就能做的 |
| `商店上架文案.md` | AGC 各字段可直接复制的文案（一句话简介/应用介绍/更新说明/分级问卷/隐私标签） |
| `商店信息_结构化.json` | 同上，机器可读 |
| `隐私政策.md` | 完整隐私政策正文 |
| `用户服务协议.md` | 完整用户协议正文 |
| `正式证书与签名切换.md` | 发布证书申请 + release 打包全流程 |
| `APP备案材料.md` | 阿里云 APP 备案逐字段填写指引 |
| `图标/app_icon_216.png` | AppGallery 图标（216×216，9.7KB） |
| `图标/app_icon_1024.png` | 备案图标 + 1024 规格（112KB） |
| `verify_materials.py` | 校验材料与代码一致（42 项） |

## 实测核对过的事实（材料里的数字都从这里来）

- 包名 `familybook.yangyq.net`、版本 `0.8.0` / versionCode `800`（`AppScope/app.json5`）
- 应用名「家书」（`AppScope/resources/base/element/string.json`）
- 权限 **只有 3 个且全是普通权限**：INTERNET / GET_NETWORK_INFO / DETECT_GESTURE
  （`entry/src/main/module.json5`）—— 定位、通讯录、相机、麦克风、设备标识符**一个都没申请**
- 第三方 SDK：**无广告、无统计、无推送**
- 后端域名 `family.yangyq.net`，服务器阿里云 `47.104.72.161`（中国大陆）

权限少是审核优势：「权限滥用」是驳回第一大类原因，家书直接绕开。
隐私政策第二节与第十节做了**权限逐条对照表**，可直接给审核看。

## 图标为什么要重做

包内 `fb_logo.png` 是 **192×192 且自带圆角**（四角透明，半径约 33px）。
AppGallery 两种规格都不达标（要 216 或 1024，且「square-shaped icon」）。
→ 取内部主色 #F2E9D8 铺满方形画布补掉缺角，图案原样叠加、不裁切不缩放，
  生成 216 与 1024 两版。图案与包内完全一致（审核要求后台图标 = 包内图标同一图案）。

第一版直接用 LANCZOS 放大，**保留了圆角**，被 `verify_materials.py` 抓到并修正 ——
这就是写那个校验脚本的意义。

## 四个必须先解决的问题（已写进总览，不隐瞒）

1. **现在是调试证书** → 备案要正式证书的公钥/MD5，上架要正式签名（调试包报 991/1014）
2. **没有「家书」软著** → 备案不强制；华为要求但可用《免责函》过渡（6 项现有软著均无关）
3. **隐私政策页面还不存在** → 站点无 privacy 路由；建议用华为自带托管服务（SyncCalendar 用的那个，实测 200）
4. **阿里云服务器是否包年包月** → 备案硬性要求，需用户去控制台确认

## 顺序（三者有依赖，不能乱）

```
① 申请正式证书（10 分钟，AGC 即时出证）
      ↓ 拿到后才能
② APP 备案（1~20 工作日，最慢，先提交）
③ 打 release .app 包
      ↓ 拿到备案号才允许提审
④ 提交 AppGallery 审核（1~7 工作日）
      ↓
⑤ 公安联网备案（上架后 30 日内）
```

## 校验

`python3 verify_materials.py` → **42 项全过**：
包名/版本/名称与代码一致、权限集合完全一致、隐私政策"未申请"的声明与代码相符、
字数限内、三份文档互相不打架、图标尺寸与四角不透明、已知缺口如实记录。

## 没做的事（刻意的）

- 不生成截图：必须真机原生界面，不能是设计稿（审核明确禁止）
- 不填备案表：实名主体必须本人操作，且工信部短信核验要发到本人手机
- 不碰 AGC：需要登录用户账号，部分环节要扫码/人脸

docs/上架/用户服务协议.md

@@ -0,0 +1,202 @@
+# 家书 用户服务协议
+
+**生效日期**：2026 年 11 月 1 日
+**适用产品**：家书（HarmonyOS 应用，包名 `familybook.yangyq.net`）
+**开发者**：杨永全（个人开发者）
+
+---
+
+## 第一条 协议的主体与接受
+
+1.1 本协议是你与**家书开发者杨永全（个人开发者）**（下称"我们"）之间就使用「家书」应用（下称"本应用"）所订立的协议。
+
+1.2 你在注册、登录或使用本应用前，应当**完整阅读并同意**本协议及《家书隐私政策》。你点击"同意"、完成注册或实际使用本应用，即视为你已阅读并同意本协议全部内容。
+
+1.3 若你**不同意**本协议任何内容，请**停止注册与使用**。
+
+---
+
+## 第二条 服务内容
+
+2.1 家书是一款**家庭内部使用**的生活档案管理工具，提供以下功能模块：
+
+| 模块 | 功能概述 |
+|---|---|
+| 日程 | 日历（月/周/日视图）、重复日程、跨天日程、提醒、参与人、附件 |
+| 任务 | 看板与待办、子任务、评论、附件、状态流转 |
+| 名册 | 家庭成员与亲友的联系方式、关系、单位职务、标签分组 |
+| 纪念日 | 生日与重要日子提醒、关联成员 |
+| 观影 | 观影记录、海报、评分、影评与评论 |
+| 旅程 | 行程节点、交通、花费、照片、同行人 |
+| 财务 | 账本与账目、分类、快照 |
+| 读书 | 书架、章节、读书笔记 |
+| 资源 | 证件/资料归档、附件管理、分享 |
+| 笔记 | 分块笔记、标签、共享 |
+
+2.2 本应用为**客户端软件**。数据存储在你**自行部署**的服务端（当前为开发者自建的服务器 `family.yangyq.net`）。**我们不提供中心化云服务，也没有你的数据副本。**
+
+2.3 我们保留**增加、修改、删除**部分功能的权利。涉及核心功能的重大变更，会提前在应用内公告。
+
+---
+
+## 第三条 账号注册与使用
+
+3.1 **注册条件**
+
+- 你应具备**完全民事行为能力**。未满 14 周岁者**不得自行注册**；14 至 18 周岁者应在监护人陪同下阅读本协议并使用。
+- 你需要提供**真实有效的手机号**用于注册与登录。
+
+3.2 **账号归属**
+
+- 账号归**你个人**所有。同一家庭内的成员各自拥有独立账号，通过"家庭"关联。
+- 你应妥善保管账号与密码。**因你保管不善导致的损失，由你自行承担。**
+
+3.3 **禁止行为**
+
+你**不得**利用本应用从事下列行为：
+
+1. 上传、存储、传播**违法违规**内容（包括但不限于危害国家安全、淫秽色情、暴力恐怖、赌博、侵犯他人隐私与知识产权的内容）
+2. 未经授权访问他人账号或家庭数据
+3. 对本应用进行反向工程、反编译、篡改、破解，或制作衍生作品
+4. 使用自动化脚本、爬虫等工具批量抓取数据或对服务端发起攻击
+5. 利用本应用从事任何商业性转售、代运营
+6. 其他违反法律法规或损害他人合法权益的行为
+
+3.4 **违规处理**
+
+你若违反 3.3 条，我们有权视情节采取**警告、限制功能、暂停服务、注销账号**等措施；涉嫌违法的，将**向有关主管部门报告**并配合调查。
+
+---
+
+## 第四条 用户内容与知识产权
+
+4.1 **你录入的内容归你所有。** 我们**不主张**对你录入的任何内容（日程、笔记、照片、附件等）享有任何权利。
+
+4.2 为了向你提供服务，你授权我们在**必要范围内**处理这些内容（存储、加密、在你登录后向你展示、按你的指令同步）。**该授权仅限于提供服务所必需，且随服务终止而终止。**
+
+4.3 你应确保录入的内容**不侵犯他人合法权益**（如未经同意上传他人照片、身份证件）。因你录入内容引发的纠纷，由你自行负责。
+
+4.4 **本应用自身的知识产权**（软件代码、界面设计、图标、文案）归开发者所有，受法律保护。你在遵守本协议的前提下获得**非独占、不可转让、可撤销**的使用许可。
+
+4.5 本应用客户端源码以开源方式发布（仓库地址可向我们索取）。开源许可与本协议不冲突；**开源许可仅针对代码，不构成对你数据或商标的授权。**
+
+---
+
+## 第五条 服务的使用规范与限制
+
+5.1 **服务可用性**
+
+- 我们尽力保证服务稳定，但**不承诺服务绝对不中断**。因下列原因导致的服务中断，我们不承担责任：
+  - 你自行部署的服务端所在网络、服务器、电力等故障
+  - 不可抗力（自然灾害、战争、政府行为、大规模网络攻击等）
+  - 系统维护、升级（我们会尽可能提前公告）
+  - 你设备本身的故障、系统版本不兼容
+
+5.2 **数据备份是你的责任**
+
+- 你自行部署服务端，**数据安全的首要责任归你**。我们强烈建议你：
+  - 定期备份服务器数据库与附件目录
+  - 妥善保管 `config.php` 中的 `app_key`（敏感字段的加密密钥）——**该密钥丢失，已加密的字段将永久无法解密**
+- 我们提供 `设置 → 数据导出` 功能协助你备份。
+
+5.3 **容量与频率限制**
+
+- 为避免滥用，服务端可能对单次请求大小、附件总容量、API 调用频率进行限制。具体限制会以错误提示告知你。
+
+---
+
+## 第六条 免费与付费
+
+6.1 本应用**当前完全免费**，无内购、无订阅、无广告。
+
+6.2 若未来推出付费功能，我们会：
+- 提前**不少于 30 天**在应用内公告
+- 明确标价与服务内容
+- **不溯及既往**：已免费的现有功能不会变为收费
+
+---
+
+## 第七条 服务的变更、中断与终止
+
+7.1 **你可以随时终止**：卸载应用，或通过 `设置 → 账号 → 注销账号` 注销。
+
+7.2 **注销的后果**：
+- 注销后，服务端将在 **7 日内**删除该账号及其名下全部数据（含附件文件）
+- **删除不可恢复**，请在注销前自行导出备份
+- 注销后，同一手机号可重新注册，但**原数据不会恢复**
+
+7.3 **我们终止服务的情形**：
+- 你严重违反本协议（见 3.3、3.4 条）
+- 法律法规要求
+- 因不可抗力导致服务无法继续
+
+7.4 服务终止前，我们会**给予合理期限**供你导出数据（因违法违规被立即终止的除外）。
+
+---
+
+## 第八条 免责声明
+
+8.1 本应用是**辅助记录工具**，不构成任何专业建议。特别是：
+
+- **财务模块**仅用于家庭记账，**不构成任何投资、税务、会计专业意见**
+- **日程提醒**依赖设备通知能力，**可能因系统省电策略、权限关闭等原因延迟或未送达**。**请勿将本应用作为唯一提醒手段**用于重要事项（如航班、考试、就医）
+- **纪念日与年龄计算**仅供参考
+
+8.2 对于因使用或无法使用本应用而导致的**间接损失、利润损失、数据损失**，我们在法律允许范围内不承担责任。
+
+8.3 本条不排除依法应当承担的责任。
+
+---
+
+## 第九条 隐私保护
+
+9.1 我们按照《家书隐私政策》处理你的个人信息。该政策是本协议不可分割的一部分。
+
+9.2 核心承诺重申：
+- 不含广告 SDK、不含第三方统计 SDK
+- 不申请设备标识符
+- 不向第三方出售、出租、交换你的个人信息
+- 数据存储在中华人民共和国境内
+
+---
+
+## 第十条 协议的修改
+
+10.1 我们可能修订本协议。实质性修改（涉及你权利义务的重大变化）将：
+- 在应用内**弹窗提示**
+- 给予你**重新确认**的机会
+- 你若不同意，可停止使用并注销账号
+
+10.2 非实质性修改（文字修订、联系方式变更）直接更新本页并标注更新日期。
+
+---
+
+## 第十一条 法律适用与争议解决
+
+11.1 本协议的订立、效力、解释、履行及争议解决，适用**中华人民共和国法律**。
+
+11.2 因本协议产生的争议，双方应首先**友好协商**解决；协商不成的，任何一方可向**被告住所地有管辖权的人民法院**提起诉讼。
+
+---
+
+## 第十二条 其他
+
+12.1 本协议部分条款被认定无效或不可执行的，**不影响其余条款的效力**。
+
+12.2 我们未行使或延迟行使本协议项下任何权利，**不构成对该权利的放弃**。
+
+12.3 本协议标题仅为方便阅读，不影响条款解释。
+
+---
+
+## 第十三条 联系方式
+
+| 项 | 内容 |
+|---|---|
+| **开发者** | 杨永全（个人开发者） |
+| **联系邮箱** | `i@yangyq.net` |
+| **响应时限** | 收到后 15 个工作日内答复 |
+
+---
+
+*本协议自 2026 年 11 月 1 日起生效。*