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,190 @@
+# 家书 · 应用介绍文案（可直接复制到 AGC）
+
+> 三个版本按投放位置选用。字数已核算，均在上限内。
+
+---
+
+## 一、一句话简介（AGC「一句话简介」字段）
+
+**上限 17 个汉字。**
+
+### ✅ 采用版（13 字）
+
+```
+一家人的日程任务与生活档案
+```
+
+### 备选
+
+| 文案 | 字数 | 说明 |
+|---|---|---|
+| 把一家人的日子记在一起 | 11 | 更温情，偏情感诉求 |
+| 家庭日程与生活记录工具 | 11 | 更直白，偏功能诉求 |
+
+> ⚠️ 不要写「日历」「备忘录」「待办」这类通用词堆砌 —— 审核明确禁止在名称/简介里堆关键词。
+
+---
+
+## 二、应用介绍（AGC「应用介绍」字段）
+
+**上限 8000 字。** 以下约 1050 字，留足余量，且覆盖了「实际功能」以免被判"介绍与功能不符"。
+
+```
+家书，是给一家人用的生活档案工具。
+
+它不社交、不推送广告、不做推荐算法。它只做一件事：把一家人的日程、任务、重要日子、看过的电影、去过的地方、家里的账和资料，安安静静地记在一处，谁都能查得到，谁都不会漏掉。
+
+【十个模块，覆盖一家人的日常】
+
+日程 —— 月、周、日三种视图。支持重复日程（每天/每周/每月/每年/工作日）、跨天日程分段显示、参与人、提醒、附件照片。周视图与日视图上有一条红线标着"现在"，一眼知道今天过了多少。
+
+任务 —— 看板与待办。可以给任务加子任务、评论、附件，也可以按人分配、按截止日排序。家庭事项不再只装在一个人脑子里。
+
+名册 —— 家庭成员与亲友的联系方式、称谓、关系、单位职务、标签分组。谁是孩子的班主任、谁是哪一房的亲戚，都写清楚。
+
+纪念日 —— 生日、结婚纪念日、忌日，按农历或公历记，提前提醒。
+
+观影 —— 一家人看过的电影。记下片名、海报、评分和当时的一句感想。多年之后翻回去，比影评网站更有意思。
+
+旅程 —— 去过的地方。行程节点、交通、花费、照片、同行人。一趟旅行就是一条时间线。
+
+财务 —— 家庭账本。记账、分类、按月看，不做理财，不卖产品。
+
+读书 —— 书架与读书笔记。章节、摘抄、想法。
+
+资源 —— 证件与资料归档。身份证、户口本、保单、合同，拍下来存好，用的时候找得到。
+
+笔记 —— 分块笔记，随手记，可共享给家里人。
+
+【关于数据，三句话】
+
+第一，数据在你自己的服务器上。家书是客户端，服务端由使用者自行部署，开发者不设中心数据库，也没有你的数据副本。
+
+第二，能加密的都加密。密码单向哈希存储，手机号与证件号加密存储，附件落盘加密，登录令牌放在系统硬件密钥库里。
+
+第三，不含任何广告与统计 SDK。不申请设备标识码，不采集位置与通讯录，不向任何第三方出售或共享你的信息。
+
+【关于提醒的一句实话】
+
+家书的提醒依赖系统通知能力，可能因省电策略或权限关闭而延迟。请不要把它当成航班、考试、就医这类要事的唯一提醒手段。
+
+家书不是要替你做决定，也不是要你多用手机。它只是想让一家人少一点"我以为你记得"。
+```
+
+---
+
+## 三、新版本特性（AGC「版本更新说明」字段）
+
+**首次上架也建议填，审核会看。**
+
+```
+首个公开版本 0.8.0。
+
+本次为家书第一次上架，包含完整十个模块：日程、任务、名册、纪念日、观影、旅程、财务、读书、资源、笔记。
+
+主要能力：
+· 日程支持月/周/日三视图、重复日程、跨天分段、参与人与提醒
+· 任务支持看板、子任务、评论与附件
+· 新增桌面服务卡片（2×2 今日速览 / 2×4 正在进行 / 4×4 今日时间轴）
+· 支持后台定时同步，断网时展示本地缓存并明确提示"离线"
+· 附件与敏感字段本地加密（密钥存于系统硬件密钥库）
+· 全站 HTTPS，不含广告与第三方统计 SDK
+```
+
+---
+
+## 四、搜索关键词（AGC「关键词」字段，如提供）
+
+**不要堆砌，选 5–8 个真实相关的。**
+
+```
+家庭 日程 日历 待办 纪念日 观影记录 家庭账本 生活档案
+```
+
+> ⚠️ 别加"免费""最好用""万能"这类诱导词，也别加与功能无关的热门词（如"视频剪辑""壁纸"），会被判违规。
+
+---
+
+## 五、应用分类
+
+| 层级 | 建议 |
+|---|---|
+| 一级 | **实用工具** |
+| 二级 | 效率 / 备忘录 / 个人助理（以 AGC 下拉里的实际项为准） |
+
+### ❌ 不要选
+
+- **社交** —— 家书没有陌生人社交，选社交会被要求提供社交类资质，且审核标准更高
+- **金融理财** —— 财务模块只是记账，选理财类需要金融资质
+- **效率办公** —— 容易与办公软件混淆
+
+---
+
+## 六、内容分级
+
+**建议：3+**
+
+问卷逐条答案：
+
+| 问题 | 答案 |
+|---|---|
+| 是否包含暴力内容 | 否 |
+| 是否包含性/裸露内容 | 否 |
+| 是否包含恐怖/惊悚内容 | 否 |
+| 是否包含赌博 | 否 |
+| 是否包含酒精/烟草/毒品 | 否 |
+| 是否包含粗俗语言 | 否 |
+| 是否允许用户间自由社交或内容分享给陌生人 | 否（仅同一家庭内成员可见） |
+| 是否包含用户生成内容公开发布 | 否 |
+| 是否含应用内购买 | 否 |
+| 是否含广告 | 否 |
+| 是否可收集位置 | 否 |
+| 是否允许陌生人联系用户 | 否 |
+
+---
+
+## 七、云端隐私标签 / 数据安全表单
+
+AGC 会要求填写「数据安全」表单，逐项如下：
+
+| 项目 | 填写 |
+|---|---|
+| 是否收集个人信息 | **是** |
+| 收集哪些 | 手机号（账号）、姓名/昵称/头像、用户主动录入的家庭内容（含照片附件） |
+| 用途 | 账号登录与身份识别、提供记录与同步功能 |
+| 是否用于第三方广告 | **否** |
+| 是否与第三方共享 | **否** |
+| 是否可请求删除数据 | **是**（设置→账号→注销账号；各条目可单独删除） |
+| 传输是否加密 | **是**（全站 HTTPS） |
+| 是否可导出数据 | **是**（设置→数据导出） |
+| 数据存储地区 | 中华人民共和国境内 |
+
+---
+
+## 八、隐私政策 URL
+
+**必填，且必须是可公开访问的 HTTPS 链接。**
+
+推荐优先用**华为自带的隐私政策托管服务**（你上架「同步日历」时用的就是它，实测链接目前仍可访问）：
+
+- 位置：AGC → 我的应用 → 选应用 → 「隐私政策」/「协议服务」区域
+- 优点：免费、在华为域名下（审核认可度最高）、不用自己搭页面
+- 参考：SyncCalendar 的托管链接为
+  `https://agreement-drcn.hispace.dbankcloud.cn/index.html?lang=zh&agreementId=...`
+
+备选：部署到自己的站点（`https://family.yangyq.net/privacy`），但**必须确保不需登录即可访问**。
+材料见同目录 `隐私政策.md`。
+
+---
+
+## 九、提交前必须自己核对的 8 件事
+
+1. ☐ 后台应用名称 = 包内 `app_name` = **家书**（完全一致，含空格）
+2. ☐ 后台图标 216×216 = 包内 `fb_logo` 同一图案（**当前图标只有 192×192，需另出**）
+3. ☐ bundleName = **familybook.yangyq.net**（一个字符都不能错）
+4. ☐ versionCode = **800**（若之前提交过，必须递增）
+5. ☐ 用的是 **release 发布证书**打的 `.app`，**不是调试证书**（调试包审核必挂，报 991/1014）
+6. ☐ 截图 3–5 张，**真机原生鸿蒙界面**，不带调试信息、不带其他平台标识
+7. ☐ 隐私政策链接**在未登录状态下也能打开**
+8. ☐ 隐私政策里写的权限，与 `module.json5` 实际申请的权限**逐条对得上**
+   （本文档配套的《隐私政策》第十节已做逐条对照表，可直接给审核看）