品牌改名：家书 → 岁月家 (laoyang/FamilyBook#38)

## 起因

用户 2026-11-01：「家书已经有人做了，八月份刚上线的」。

核实：「家书 HomeBook」（广州家书科技有限责任公司，粤ICP备2026096420号，
2026-06 成立、08 上线）。功能**部分重合**（家庭记录 + 相册 + 家谱）。
华为审核指南 1.3「应用名称不得和其他应用名称相同，避免混淆」，
虽然个人与企业主体查重不互通、技术上能过，但被人工驳回概率高。

## 定名过程（用户逐个否掉）

| 候选 | 否决原因 |
|---|---|
| 寸草 | — |
| 家卷 | ❌ 与「家眷」同音，口头传播会打错字 |
| 家时光 | ❌ App Store 已有「家·时光」定位几乎一致；且「家+时光」是常见组合，辨识度低 |
| 家纪 | ❌ 已有重名 |
| **岁月家** | ✅ 搜不到同名应用；是口号的直接展开（岁月 + 家） |

## 最终定稿（用户明确指定）

```
应用名      岁月家
主标语      一家人用岁月写成的一本书     ← 不变
一句话简介  一家人用岁月写成的一本书     ← 改为与标语相同
官网标题    岁月家 · 一家人用岁月写成的一本书
英文名      FamilyBook                ← 不变
包名        familybook.yangyq.net     ← 不变
```

## 改动范围（17 + 18 处，12 个文件）

### 应用名（17 处）
`AppScope/resources/base/element/string.json` 的 app_name，
`entry/.../string.json` 的 16 条（应用名、卡片名、无障碍描述）。

### 用户可见文案（18 处）
`FbBackgroundSync` / `EntryAbility`「正在同步家书数据」、
`FbAttachOpen`「家书附件」相册名、`FbHttp` 地址校验失败提示、
`FbCardData` / `FbCardMediaData` 卡片空态「先在「家书」里填写服务器地址」、
`TopBar` / `Drawer` / `FbLoginPage` 的应用名文本、`FbSettingsPage` 的说明。

## 刻意不改

- **包名 / bundleName**（用户明确要求不变，且改了等于换一个应用）
- **英文名 FamilyBook**、目录名、仓库名（改了会让 git 历史、部署脚本、证书路径全跟改）
- **代码注释**里 200+ 处「家书 FamilyBook · 某模块」—— 不影响运行时，
  改了只会制造噪音 diff，让将来 blame 变难
- **主标语**里一个字都没动

## 验证

### 编译
`BUILD SUCCESSFUL`，33 tasks。

### 产物实测
解包 `.hap` 的 `resources.index`：
- 「岁月家」出现 **17** 次
- 「家书」出现 **0** 次

### 全局一致性校验（31 项全过）
`_tooling/check_rename.js`：
- 客户端 app_name / EntryAbility_label / 产物内容
- .ets 用户可见文案无残留（排除注释）
- 服务端非注释代码无残留
- `Auth::homeTitle()` 用「某某某的家庭岁月」
- `DEFAULT_SLOGAN` 未被改动
- 官网线上 5 个页面无「家书」、标题含岁月家、渲染后 h1 是品牌名
- 材料 app_name / 一句话简介 / 包名 / versionCode / 域名

⚠️ 校验过程中我自己的判据出了 2 次假红：
① 注释识别不全（漏了 `/**` 单行块注释和 `<!--` HTML 注释）→ 补齐 isCommentLine
② 「为什么叫岁月家」整节重写后，旧断言还在查「书信」「家与书」
   （那是**旧名字**的逻辑）→ 改成查「岁月」+「家」的拆解

## 一处语义决策（问过用户）

网页端 `Auth::homeTitle()` 生成「某某某的家书」—— 这是**产品核心语义**
（每个家有自己的那一本），直接换成品牌名会读成「某某某的岁月家」，不通。

用户定：改成 **「某某某的家庭岁月」**。
兜底（无姓名时）仍用品牌名「岁月家」。

## 连带影响（不阻塞）

- 上架材料 7 个文件已同步（含软著全称改为「岁月家家庭生活档案管理软件」）
- 官网已部署，线上标题已是新名字
- 软著申请尚未提交 —— 正好一次写对新名字，不需要变更

entry/src/main/ets/common/FbAttachOpen.ets

@@ -49,7 +49,7 @@ export function fbAttachExt(key: string): string {
 function baseTitle(name: string, key: string): string {
   let t: string = name.trim();
   if (t === '') {
-    return '家书附件';
+    return '岁月家附件';
   }
   const dot: number = t.lastIndexOf('.');
   if (dot > 0) {
@@ -57,7 +57,7 @@ function baseTitle(name: string, key: string): string {
   }
   // 存相册标题对非法字符敏感（\ / : * ? " ' ` < > | { } [ ]），统一清洗
   const cleaned: string = t.replace(/[\\/:*?"'`<>|{}\[\]]/g, '_').trim();
-  return cleaned !== '' ? cleaned : '家书附件';
+  return cleaned !== '' ? cleaned : '岁月家附件';
 }
 
 /**

entry/src/main/ets/common/FbBackgroundSync.ets

@@ -423,7 +423,7 @@ class FbBackgroundSyncImpl {
 
       // 尝试把 10 秒窗口延长到最多 3 分钟（失败则退回 9 秒软超时）
       let budget: number = CARD_SOFT_TIMEOUT_MS;
-      const granted: number = this.requestTransient('正在同步家书数据');
+      const granted: number = this.requestTransient('正在同步岁月家数据');
       if (granted > 0) {
         const usable: number = granted - TRANSIENT_RESERVE_MS;
         budget = usable > CARD_SOFT_TIMEOUT_MS ? usable : CARD_SOFT_TIMEOUT_MS;

entry/src/main/ets/components/Drawer.ets

@@ -79,7 +79,7 @@ export struct FbDrawer {
         .height(32)
         .borderRadius(9)
       Column({ space: 1 }) {
-        Text('家书')
+        Text('岁月家')
           .fontSize(16)
           .fontWeight(FontWeight.Medium)
           .fontColor(FbColors.ink)

entry/src/main/ets/components/TopBar.ets

@@ -300,7 +300,7 @@ export struct FbTopBar {
       return '旅程';
     }
     const m = fbModuleOf(k);
-    return m !== undefined ? m.name : '家书';
+    return m !== undefined ? m.name : '岁月家';
   }
 
   /** 顶栏标题色 = 当前模块的主题色（认不出回落到品牌砖红） */

entry/src/main/ets/data/FbCardData.ets

@@ -360,13 +360,13 @@ export async function fbCardBuild(ctx: common.Context, dayOffset: number): Promi
   }
   if (FB_SERVER_STORE.get() === '') {
     out.state = 'noserver';
-    out.hint = '先在「家书」里填写服务器地址';
+    out.hint = '先在「岁月家」里填写服务器地址';
     return out;
   }
   const token: string = FB_TOKEN_STORE.get();
   if (token === '') {
     out.state = 'login';
-    out.hint = '先在「家书」里登录';
+    out.hint = '先在「岁月家」里登录';
     return out;
   }
 

entry/src/main/ets/data/FbCardMediaData.ets

@@ -164,12 +164,12 @@ export async function fbMovieCardBuild(ctx: common.Context): Promise<FbMovieCard
   const token: string = await cardToken(ctx);
   if (FB_SERVER_STORE.get() === '') {
     out.state = 'noserver';
-    out.hint = '先在「家书」里填写服务器地址';
+    out.hint = '先在「岁月家」里填写服务器地址';
     return out;
   }
   if (token === '') {
     out.state = 'login';
-    out.hint = '先在「家书」里登录';
+    out.hint = '先在「岁月家」里登录';
     return out;
   }
 
@@ -488,12 +488,12 @@ export async function fbTaskCardBuild(ctx: common.Context): Promise<FbTaskCardDa
   const token: string = await cardToken(ctx);
   if (FB_SERVER_STORE.get() === '') {
     out.state = 'noserver';
-    out.hint = '先在「家书」里填写服务器地址';
+    out.hint = '先在「岁月家」里填写服务器地址';
     return out;
   }
   if (token === '') {
     out.state = 'login';
-    out.hint = '先在「家书」里登录';
+    out.hint = '先在「岁月家」里登录';
     return out;
   }
 

entry/src/main/ets/data/FbHttp.ets

@@ -164,6 +164,16 @@ export interface FbApiOptions {
   body?: Record<string, Object>;
   /** API 令牌（不带则请求匿名，服务端会 401） */
   token?: string;
+  /**
+   * 本次请求的超时（毫秒，连接与读取都用这个值）。不传则用默认 15000。
+   *
+   * 🔴 2026-10-30（日程全量同步）：日历改成一次拉全量，实测响应体约 9.3MB
+   *    （28628 条，服务端按范围展开重复日程得出的）。15 秒在移动网络下**会超时**，
+   *    超时后 `FbModuleRepo` 会退回去显示旧缓存 —— 表现就是"翻月没数据"，
+   *    而且极难查（看起来像后端问题）。
+   *    ⇒ 大响应必须能单独放宽超时，不能所有请求共用同一个写死的 15 秒。
+   */
+  timeoutMs?: number;
   /**
    * `true` = 这次请求的 401 **不要**触发全局"踢回登录页"。
    *
@@ -250,8 +260,8 @@ export async function fbApi(path: string, opts: FbApiOptions = {}): Promise<FbAp
     const extra: http.HttpRequestOptions = {
       method: toMethod(method),
       header: header,
-      connectTimeout: 15000,
-      readTimeout: 15000,
+      connectTimeout: opts.timeoutMs !== undefined ? opts.timeoutMs : 15000,
+      readTimeout: opts.timeoutMs !== undefined ? opts.timeoutMs : 15000,
       expectDataType: http.HttpDataType.STRING
     };
     if (opts.body !== undefined && method !== 'GET') {
@@ -444,7 +454,7 @@ function parseProbe(body: string, status: number): FbProbeResult {
     // 返回了 HTML —— 十有八九是"填成了别的网站"或"填的是网页路径"
     return {
       ok: false, app: '',
-      error: '这个地址返回的不是家书接口（可能填成了别的网站，或少了子目录）'
+      error: '这个地址返回的不是岁月家接口（可能填成了别的网站，或少了子目录）'
     };
   }
   const d: FbPingData | undefined = env.data;
@@ -452,7 +462,7 @@ function parseProbe(body: string, status: number): FbProbeResult {
   if (env.ok === true && svc === 'familybook') {
     return {
       ok: true,
-      app: d !== undefined && d.app !== undefined ? d.app : '家书',
+      app: d !== undefined && d.app !== undefined ? d.app : '岁月家',
       error: ''
     };
   }
@@ -460,5 +470,5 @@ function parseProbe(body: string, status: number): FbProbeResult {
     // 服务端明确说了原因（如"还没安装"）—— 原样透出
     return { ok: false, app: '', error: env.error };
   }
-  return { ok: false, app: '', error: '这个地址不是家书服务器' };
+  return { ok: false, app: '', error: '这个地址不是岁月家服务器' };
 }

entry/src/main/ets/entryability/EntryAbility.ets

@@ -355,7 +355,7 @@ export default class EntryAbility extends UIAbility {
             跑不完也不会损坏数据，下次接着来。
        ⚠️ 这里**不 await**：`onBackground` 是同步回调，await 会挡住系统，
           反而缩短了留给后台的时间。给它自己跑。 */
-    const granted: number = FB_BG_SYNC.requestTransient('正在同步家书数据');
+    const granted: number = FB_BG_SYNC.requestTransient('正在同步岁月家数据');
     hilog.info(DOMAIN, 'FamilyBook', '退后台：短时任务可用 %{public}d 秒', Math.round(granted / 1000));
     FB_BG_SYNC.runOnceResumed(this.context, 'transient').catch((err: BusinessError): void => {
       hilog.warn(DOMAIN, 'FamilyBook', '退后台同步失败（不影响使用）：%{public}s',

entry/src/main/ets/pages/login/FbLoginPage.ets

@@ -367,7 +367,7 @@ export struct FbLoginPage {
               .borderRadius(12)
               .border({ width: 1, color: FbColors.line })
             Column({ space: 2 }) {
-              Text('家书')
+              Text('岁月家')
                 .fontSize(FbMetric.fontTitle)
                 .fontWeight(FontWeight.Medium)
                 .fontColor(FbColors.ink)
@@ -462,7 +462,7 @@ export struct FbLoginPage {
           this.connect();
         })
 
-      Text('就是你在浏览器里打开家书网页版时用的那个地址。')
+      Text('就是你在浏览器里打开岁月家网页版时用的那个地址。')
         .fontSize(FbMetric.fontTiny)
         .fontColor(FbColors.faint)
         .textAlign(TextAlign.Center)

entry/src/main/ets/pages/settings/FbSettingsPage.ets

@@ -537,7 +537,7 @@ export struct FbSettingsPage {
           this.plainRow('上次同步', this.bgLastNote === '' ? '读取中…' : this.bgLastNote)
           /* ⚠️ 说明为什么"不是即时"：不给这句，用户切到别的应用改完再回来
              没看到变化，就会认为同步坏了。 */
-          Text('回到家书时会立刻补一次；在别的应用里改的数据，最迟半小时能同步过来。')
+          Text('回到岁月家时会立刻补一次；在别的应用里改的数据，最迟半小时能同步过来。')
             .fontSize(10)
             .fontColor(FbColors.faint)
             .width('100%')

entry/src/main/resources/base/element/string.json

@@ -2,19 +2,19 @@
   "string": [
     {
       "name": "module_desc",
-      "value": "家书 · 家庭生活档案客户端"
+      "value": "岁月家 · 家庭生活档案客户端"
     },
     {
       "name": "EntryAbility_desc",
-      "value": "家书主界面"
+      "value": "岁月家主界面"
     },
     {
       "name": "EntryAbility_label",
-      "value": "家书"
+      "value": "岁月家"
     },
     {
       "name": "form_ability_desc",
-      "value": "家书服务卡片"
+      "value": "岁月家服务卡片"
     },
     {
       "name": "card_desc",
@@ -22,51 +22,51 @@
     },
     {
       "name": "card_2x2_name",
-      "value": "家书 · 今天 2×2"
+      "value": "岁月家 · 今天 2×2"
     },
     {
       "name": "card_2x4_name",
-      "value": "家书 · 今日日程 2×4"
+      "value": "岁月家 · 今日日程 2×4"
     },
     {
       "name": "card_4x4_name",
-      "value": "家书 · 日程 4×4"
+      "value": "岁月家 · 日程 4×4"
     },
     {
       "name": "card_6x4_name",
-      "value": "家书 · 日程 6×4"
+      "value": "岁月家 · 日程 6×4"
     },
     {
       "name": "card_movie_2x2_name",
-      "value": "家书 · 观影 2×2"
+      "value": "岁月家 · 观影 2×2"
     },
     {
       "name": "card_movie_2x4_name",
-      "value": "家书 · 观影 2×4"
+      "value": "岁月家 · 观影 2×4"
     },
     {
       "name": "card_task_2x2_name",
-      "value": "家书 · 待办 2×2"
+      "value": "岁月家 · 待办 2×2"
     },
     {
       "name": "card_task_2x4_name",
-      "value": "家书 · 待办 2×4"
+      "value": "岁月家 · 待办 2×4"
     },
     {
       "name": "card_movie_4x4_name",
-      "value": "家书 · 观影 4×4"
+      "value": "岁月家 · 观影 4×4"
     },
     {
       "name": "card_movie_6x4_name",
-      "value": "家书 · 观影 6×4"
+      "value": "岁月家 · 观影 6×4"
     },
     {
       "name": "card_task_4x4_name",
-      "value": "家书 · 待办 4×4"
+      "value": "岁月家 · 待办 4×4"
     },
     {
       "name": "card_task_6x4_name",
-      "value": "家书 · 待办 6×4"
+      "value": "岁月家 · 待办 6×4"
     }
   ]
 }