From 32e9e9ab84beb858a76930ec2cf98733d1cc8c43 Mon Sep 17 00:00:00 2001
From: laoyang <i@yangyq.net>
Date: Wed, 14 Oct 2026 01:20:40 +0800
Subject: [PATCH] =?UTF-8?q?v47=EF=BC=9A=E5=9C=B0=E5=9D=80=E8=81=94?=
 =?UTF-8?q?=E6=83=B3=E4=B8=89=E5=A4=84=E6=8E=A5=E5=85=A5=20/=20=E8=AF=BB?=
 =?UTF-8?q?=E4=B9=A6=E9=A1=B5=E6=85=A2=E7=9A=84=E7=9C=9F=E6=A0=B9=E5=9B=A0?=
 =?UTF-8?q?=EF=BC=88=E4=BC=9A=E8=AF=9D=E9=94=81=EF=BC=89/=20=E7=AC=94?=
 =?UTF-8?q?=E8=AE=B0=E4=B8=A4=E5=A4=84=20/=20=E6=97=A5=E7=A8=8B=E7=8A=B6?=
 =?UTF-8?q?=E6=80=81=E4=B8=8B=E7=BA=BF?=
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

用户 2026-10-13 七条。拍板：影院只记地址、不存经纬度（后续用高德反查）；
日程状态只删界面与展示、数据库列保留（「后续会有一个整体清理的工作」）。

①🔴 读书页慢 —— 真根因是**会话锁**，不是封面（我先判断错了方向）
  用户原话：「读书现在还是非常慢，就是进入读书这个页面，刚开始还是非常的慢。」
  线上实测（真公网、同一会话连打 3 次）：
      第 1 次 TTFB 0.08s  ← 触发微信读书同步
      第 2 次 TTFB **8.73s**  ← 用户说的"刚开始非常慢"
      第 3 次 TTFB 0.07s
  插桩拿到的服务端时间线把因果钉死：
      21:18:05.483 QUEUED        ← 第 1 个请求排队
      21:18:05.501 FINISH  2ms   ← 响应确实提前发出去了（这步是好的）
      21:18:14.674 SYNC    9.2s  ← 但它仍占着这个人的会话文件锁跑完 9.2 秒
      21:18:14.682 QUEUED        ← 第 2 个请求此刻才真正开始执行
  ⇒ **`fastcgi_finish_request()` 只断开客户端连接、不释放 PHP 文件会话锁。**
    后台同步要 9.2 秒（真打微信读书接口），同一个人的下一个请求一路等到它跑完。
  修法（缺一不可）：
    · `WeRead::queueBackgroundSync()` 回调里 **先 `session_write_close()`、
      再 `fastcgi_finish_request()`**（顺序不能反）；
    · `index.php` 两处"渲染前排同步"的入口排完**立刻放锁**
      （shutdown 回调不一定执行：客户端中断/服务器超时才不放过）；
    · 顺带修 **`Holiday::queueBackgroundFetch()` 的同型问题**（联网 12 秒）。
  为什么以前没发现：v29 引入"后台化"时只验证了"响应是不是提前发出去"，
  **单次请求测量永远看不到这个 bug** —— 必须同一会话连打两次才现形。
  线上复验：修复后连打 4 次 = 0.15 / 0.15 / 0.09 / 0.15 秒（修复前第 2 次 8.73s）；
  后台同步仍正常（`weread_sync_at` 已更新）。

② 封面：顺手也修了（但这不是用户说的那个问题）
  · `media.php` 读 OSS 前先放会话锁（原来从不放，35 张封面串行）；
  · 新增 `Storage::cacheLocally()` 磁盘二级缓存（原来 `read()` 只读不写回）；
  · 让 304 不再先拉整张图（原来先取回 body、再判 `If-None-Match`）。
  线上实测：冷取 149ms（走 OSS）→ 热取 35ms（本地缓存、字节一致）
  → 带 `If-None-Match` 返回 **304 / 19.8ms / 空体**；35 张封面 103ms → 20ms（5 倍）。

③ 地址联想：抽成全站共用一份（`assets/js/addr_suggest.js`）+ 接入三处
  · 影院管理页、观影新增页的「新建影院」弹框、日程地点、行程出发/到达；
  · `layout.php` 按需加载（`[data-addr]` 出现才拉 SDK + 我们的脚本），
    并暴露 `fbLoadAddr(scope)` 给 AJAX 片段（v42 踩过"内联 script 不执行"）；
  · 安全密钥在 SDK 之前设置；回填支持 `data-addr-fill` / `data-addr-for`、
    **只补空白字段**（不覆盖用户手写）、直辖市 `province==city` 去重；
  · 字段名有两套（影院 `address`/`place`，行程 `from_addr`/`to_addr` 缩写 `_addr`），
    `fieldFor()` 带同义词表 + 后缀匹配；
  · 影院**只存地址、不存经纬度**（按用户要求）。

④ 笔记两条
  · 「点保存没反应」真因：附件区是个 `<form>` **套在保存表单里** ——
    HTML 不允许 form 套 form，浏览器丢掉内层标签、保留它的 `</form>`，
    于是**保存按钮成了孤儿**（`button.form === null`），点了不提交也不报错。
    真浏览器实测：修前 `btnInsideForm:false` / 点后 POST=0；修后 true / POST=1。
    改法：附件区改 `<div id="noteAttForm">`，上传按钮用 `formaction`。
  · 详情页宽度：`.note-read { max-width: 820px }` → `none`
    （内容卡 820px vs 下方共享卡 1032px；修后两者都是 1032px）。

⑤ 日程状态下线
  · 删表单里的「状态」下拉、`Calendar::statusWord()`、浮层 JSON 的 `status_word`；
  · **保留** `events.status` 列与 `Calendar::statusOf()`（契约不动，等整体清理）。

验证（新增 5 个套件）：
  · `_fb_v47_addr.py`（接线 24 条）/ `_fb_v47_addr_sim.py`（真浏览器 + 假高德，16 条）
  · `_fb_v47_readperf.py`（缓存与会话锁，23 条）
  · `_fb_v47_notes.py`（真浏览器，9 条）
  · `_b47_readperf_falsify.py`（反向验证 9 个注入）—— **9/9 全抓住**
  · 全量 e2e **1510/0**；vCard 规格+往返 40/0；TB 探针 44/0；
    v44 反向验证 17/0；全流水线 **PUSH_RC=0**（含"第47批形态"静态断言）
  · **线上终验**：读书页整页 81ms、封面 103→20ms、media 冷 149→热 35→304 19.8ms、
    修复前第 2 次请求 8.73s → 修复后 0.15s、地址联想 meta[fb-addr] 带真高德 key

顺带修掉三处**探针自身**的假红/假绿（详见 pitfalls.md）：
  · `_b44_falsify.py` 的"整小时"注入在**整点**与正确实现等价 ⇒ 换成恒错值；
  · `_fb_b44_ui.py` 3b 的并发计时断言在单进程 `php -S` 下必然假红 ⇒ 改断言确定事实；
  · 多处探针的"清理删除"撞沙箱删除门禁 ⇒ 探针**中途死掉**看起来像产品坏了
    ⇒ 统一改成 `_safe_rm()` / 不删。
---
 app/Calendar.php                     |  18 +--
 app/Holiday.php                      |  10 ++
 app/Storage/Storage.php              |  59 ++++++++
 app/WeRead.php                       |  33 ++++
 assets/css/app.css                   |   8 +-
 assets/js/addr_suggest.js            | 218 +++++++++++++++++++++++++++
 assets/js/entry_popup.js             |   7 +
 index.php                            |  20 +++
 media.php                            |  94 +++++++++++-
 templates/calendar/_event_fields.php |  31 ++--
 templates/layout.php                 |  90 +++++++++++
 templates/movies/cinemas.php         |  10 +-
 templates/movies/form.php            |   9 +-
 templates/notes/form.php             |  29 +++-
 templates/trips/_loc_field.php       |   6 +
 templates/trips/node_form.php        |  94 ++++--------
 16 files changed, 634 insertions(+), 102 deletions(-)
 create mode 100644 assets/js/addr_suggest.js

diff --git a/app/Calendar.php b/app/Calendar.php
index 29e64f9..5fc55f1 100644
--- a/app/Calendar.php
+++ b/app/Calendar.php
@@ -868,17 +868,12 @@ final class Calendar
         return in_array($v, ['confirmed', 'tentative', 'cancelled'], true) ? $v : 'confirmed';
     }
 
-    /**
-     * 🔴 v43（用户第 6 条）：日程状态的**中文说法** —— 条目详情浮层里要显示"状态"。
-     *   与 `templates/calendar/_event_fields.php` 那个 <select> 的选项文案**一字不差**：
-     *   两处各写一套必然有一天对不上（"确定" vs "已确认"）。
-     */
-    public static function statusWord(string $status): string
-    {
-        return ['confirmed' => '确定', 'tentative' => '待定', 'cancelled' => '取消'][
-            self::statusOf($status)
-        ];
-    }
+    /* 🔴 v47（用户 2026-10-13）：「日程的那个状态，什么确定、待定、取消，
+       我觉得没有什么意义，把它给删掉吧，不要了。」
+       ⇒ `statusWord()` **删除**（浮层自 v44 起就已不显示状态，它最后也没有消费者了）。
+       ⚠️ `statusOf()` **保留** —— 它在 Calendar 的三处写入路径（新建/更新/派生本）里
+          仍用于把外部传入的 status 规范化成合法枚举；列与导出契约都不动，
+          等"整体清理"那一轮再一起收（用户明确说了会做）。
 
     /**
      * 某个月（或某段日期）里**全部**日程：
@@ -976,7 +971,6 @@ final class Calendar
                             //    所以地点/备注/状态也要带出去（原来模板只用得到 title/time）。
                             'location'     => (string)($e['location'] ?? ''),
                             'note'         => (string)($e['note'] ?? ''),
-                            'status_word'  => self::statusWord((string)($e['status'] ?? 'confirmed')),
                             // 带上这一天的日期，重复日程点进去才能定位到"改哪一次"
                             'occ'     => $day,
                             'repeat'  => $rr,
diff --git a/app/Holiday.php b/app/Holiday.php
index 1d75fd0..6fed229 100644
--- a/app/Holiday.php
+++ b/app/Holiday.php
@@ -130,6 +130,16 @@ final class Holiday
         }
         self::$queued[$year] = true;
         register_shutdown_function(static function () use ($year): void {
+            // 🔴🔴 v47：**先放会话锁，再断连接**（顺序不能反）。
+            //    `fastcgi_finish_request()` 只断开客户端连接，
+            //    **不会释放 PHP 文件会话锁** —— 而这里要联网 12 秒（见下面 doFetch 的超时）。
+            //    不放锁的话，同一个人的**下一个请求**会一直等这次抓取跑完
+            //    ⇒ "页面秒回，但下一个页面卡十几秒"。
+            //    （同型问题在 WeRead 上实测到：第 2 个请求 TTFB 8.73s。
+            //      见 app/WeRead.php 的 queueBackgroundSync 长注释。）
+            if (session_status() === PHP_SESSION_ACTIVE) {
+                session_write_close();
+            }
             if (function_exists('fastcgi_finish_request')) {
                 fastcgi_finish_request();
             }
diff --git a/app/Storage/Storage.php b/app/Storage/Storage.php
index 9934c99..6e26672 100644
--- a/app/Storage/Storage.php
+++ b/app/Storage/Storage.php
@@ -174,6 +174,65 @@ final class Storage
         return self::disk($familyId)->exists($key);
     }
 
+    /**
+     * 把刚取到的内容**回写一份到本地磁盘**，给下一次读用。
+     *
+     * 🔴 v47（用户 2026-10-13）：「读书现在还是非常慢，这个问题需要彻底解决。」
+     *    实测：书架 35 张封面，每张 0.15~0.53s 去 OSS 取，**每次访问都重新取**。
+     *    `read()` 本来就是"本地优先"，但**只读不写** ⇒ OSS 上那份永远要远程拿。
+     *    这里补上"写回"，于是第二次起直接命中本地文件（0 次远程调用）。
+     *
+     * ⚠️ 只给**图片**用（调用方判断）。理由：
+     *    · 图片是"反复读、几乎不写、内容不变"的典型 —— 缓存收益最大；
+     *    · 附件/原书文件可能是几十上百 MB，缓存它们会把磁盘吃满，
+     *      而且下载本来就是低频、一次性的事，缓存它没有意义。
+     *
+     * ⚠️ **绝不因为缓存失败而影响这次请求**：磁盘满、权限不对、路径怪，
+     *    一律静默跳过 —— 缓存是纯优化，不是功能。
+     *
+     * @return bool 真的写成功了吗（调用方一般不关心）
+     */
+    public static function cacheLocally(string $key, string $binary): bool
+    {
+        $key = ltrim(str_replace('\\', '/', $key), '/');
+        if ($key === '' || $binary === '') {
+            return false;
+        }
+        // 与 media.php 同一条键净化判据：拒绝 `..`、绝对路径、点文件
+        if (strpos($key, "\0") !== false || strpos($key, '..') !== false
+            || !preg_match('#^[A-Za-z0-9][A-Za-z0-9._/-]*$#', $key)) {
+            return false;
+        }
+        foreach (explode('/', $key) as $seg) {
+            if ($seg === '' || $seg === '.' || $seg[0] === '.') {
+                return false;
+            }
+        }
+        $dst = FB_UPLOADS . '/' . $key;
+        // 已经有了就不重复写（两个请求同时到也不会互相踩：内容一样）
+        if (is_file($dst) && filesize($dst) === strlen($binary)) {
+            return true;
+        }
+        $dir = dirname($dst);
+        if (!is_dir($dir)) {
+            if (!@mkdir($dir, 0775, true) && !is_dir($dir)) {
+                return false;
+            }
+        }
+        // 先写临时文件再 rename：避免"写了一半被另一个请求读到"（读到半张图）
+        $tmp = $dst . '.tmp' . getmypid();
+        if (@file_put_contents($tmp, $binary) === false) {
+            @unlink($tmp);
+            return false;
+        }
+        if (!@rename($tmp, $dst)) {
+            @unlink($tmp);
+            return false;
+        }
+        @chmod($dst, 0664);
+        return true;
+    }
+
     /**
      * **唯一出口**：把相对键变成可访问地址。
      *
diff --git a/app/WeRead.php b/app/WeRead.php
index 5ddc685..4b465be 100644
--- a/app/WeRead.php
+++ b/app/WeRead.php
@@ -691,6 +691,33 @@ final class WeRead
      * ⚠️ 用 `register_shutdown_function` 而不是在这里直接调：
      *    必须等**页面已经渲染完**（输出都发出去）才切断，否则会把页面截断。
      * ⚠️ 同一个请求里只排一次（`$bgQueued`）：读书页会连着调好几次取数。
+     *
+     * 🔴🔴 v47（用户 2026-10-13：「读书现在还是非常慢，进入这个页面刚开始非常慢」）
+     *    —— **必须把会话锁也放掉，否则"后台化"是假的。**
+     *
+     *    现场实测（线上，真公网，同一会话连打 3 次）：
+     *      · 第 1 次  TTFB 0.08s   ← 触发同步
+     *      · 第 2 次  TTFB **8.73s** ← 就是用户说的"刚开始非常慢"
+     *      · 第 3 次  TTFB 0.07s
+     *    服务端时间线（插桩取得）把因果钉死了：
+     *      21:18:05.48 QUEUED          ← 第 1 个请求排队
+     *      21:18:05.50 FINISH  2ms     ← 响应确实提前发出去了（这步是好的）
+     *      21:18:14.67 SYNC    9.2s    ← 但它仍**占着这个人的会话文件锁**跑完 9.2 秒
+     *      21:18:14.68 QUEUED          ← 第 2 个请求此刻才真正开始执行
+     *    ⇒ PHP 的文件会话是**独占**的：`fastcgi_finish_request()` 只断开"客户端连接"，
+     *      **不会释放会话锁**。同一个人的下一个请求（刷新 / 点进读书 / 点别的页面）
+     *      会一路等到后台同步跑完 —— 于是"页面秒回、但下一个页面卡 9 秒"，
+     *      用户感觉就是"进读书页非常慢"。
+     *
+     *    ⚠️ 必须**两处**都放锁：
+     *      ① 关掉的这里（在 `fastcgi_finish_request()` **之前**）——
+     *         覆盖"本次是排同步的那个请求"。
+     *      ② 页面路由里、渲染**之前**（见 index.php 的 books 路由）——
+     *         因为后端的 shutdown 回调**不一定真的执行**（用户中断 / 服务器超时），
+     *         那时锁会一直挂到请求结束；提前放掉最稳妥。
+     *    放锁前要用的会话数据（familyId / personId）都在上方作为**参数**传进来了，
+     *    此后不再读 `$_SESSION`，所以放锁是安全的。
+     *    ⚠️ 读操作不受影响：放锁只影响"写"，而这里之后只做 HTTP + 写数据库。
      */
     public static function queueBackgroundSync(int $familyId, int $personId): void
     {
@@ -702,6 +729,12 @@ final class WeRead
         }
         self::$bgQueued[$personId] = true;
         register_shutdown_function(static function () use ($familyId, $personId): void {
+            // 🔴 v47：先放会话锁，再断连接 —— 顺序反了就没意义
+            //（`fastcgi_finish_request()` 会让 `session_write_close()` 变成 no-op 的时机
+            //  更早，所以锁必须在它之前放）。
+            if (session_status() === PHP_SESSION_ACTIVE) {
+                session_write_close();
+            }
             if (function_exists('fastcgi_finish_request')) {
                 fastcgi_finish_request();
             }
diff --git a/assets/css/app.css b/assets/css/app.css
index 852d516..e5d3e0e 100644
--- a/assets/css/app.css
+++ b/assets/css/app.css
@@ -5096,7 +5096,13 @@ h5.md-h, h6.md-h { font-size: 14px; }
 
 /* ---- 阅读态（第 8 条：点进来默认是"看"）----
    与编辑态的区别要**一眼看得出**：没有虚线框、没有按钮，就是一篇排好版的文档。 */
-.note-read { max-width: 820px; }
+/* 🔴 v47（用户 2026-10-13）：「标题和内容这个块的宽度并没有撑满整个页面，
+   它和下面那个共享给谁、还有权限那一块，宽度是不一致的。」
+   ⇒ 原来这里写着 `max-width: 820px`，而下面的「共享」卡是满宽的 ⇒ 上下两块对不齐。
+   ⚠️ 不要改成"给共享卡也加 820px"：用户要的是**撑满**，不是一起变窄；
+      正文卡与其它页面的 .card 保持同宽，视觉上才是一列。
+   ⇒ 直接放开限宽（.card 本身已有全页统一的内边距与最大宽度约束）。 */
+.note-read { max-width: none; }
 .note-read-title { margin: 0 0 6px; font-size: 22px; font-weight: 600; color: var(--ink); }
 .note-read-tags { margin: 0 0 14px; }
 .note-read-body { display: flex; flex-direction: column; gap: 14px; }
diff --git a/assets/js/addr_suggest.js b/assets/js/addr_suggest.js
new file mode 100644
index 0000000..77b81d9
--- /dev/null
+++ b/assets/js/addr_suggest.js
@@ -0,0 +1,218 @@
+/**
+ * 家书 FamilyBook · **地址联想**（高德 AutoComplete）—— 全站一份
+ *
+ * 🔴 v47（用户 2026-10-13）三条：
+ *    ①「影院管理中，输入影院名称的时候，应该自动帮我补齐所在的地方和详细地址。」
+ *    ②「行程里面…输入出发地和到达地的时候，都需要调用高德的接口，补齐详细地址。」
+ *    ③「日程中，当我输入地点的时候，也应该调用高德的接口，补齐详细地址。」
+ *
+ * 为什么不再"每页各写一段"：
+ *   原来的做法是 `trips/node_form.php` 里自己写一段内联脚本。v42 已经因此踩过一次
+ *   （弹框是 AJAX 片段、内联 `<script>` 不执行 ⇒ 联想失效，只好抽了个 `fbNodeForm()`）。
+ *   这次要接到**三处**（影院管理页、观影新增弹框、日程表单，而日程本身也是弹框），
+ *   再各写一份必然出现"某个入口忘了补"——所以抽成这一份，谁用谁调 `fbAddr()`。
+ *
+ * ⚠️ 与项目其它按需资源同一套规矩：
+ *   · 脚本**按需加载**（页面上真有 `[data-addr]` 才拉，见 layout.php 的 fb-addr meta）；
+ *   · SDK 的 key/安全密钥由 layout 注入（`window.FB_AMAP`），**本文件不碰配置**；
+ *   · **高德挂了也必须能用** —— 输入框仍是普通文本框，手敲照常保存。
+ *     所以所有 AMap 的调用都在 `__AMAP_LOADED` 判断之后，一条都不在外面。
+ *
+ * ⚠️ 幂等：同一段表单可能被反复塞进 DOM（弹框开关），用 `data-addr-bound` 挡住重复绑定。
+ *    **但"绑定"要分两层**：input 的事件只绑一次；每次调用都要**重画一次**已有值
+ *    （因为重画后 DOM 是新的、可能带着服务端回填的地址）。
+ */
+(function () {
+  'use strict';
+
+  // 高德 SDK 的就绪状态由 layout 注入的那段脚本维护（见 fb-addr 注入块）
+  function sdkReady() {
+    return !!(window.__AMAP_LOADED && typeof window.AMap !== 'undefined'
+              && window.AMap.AutoComplete);
+  }
+
+  /** 把 location（AMap.LngLat 或 {lng,lat} 或字符串）统一成 {lng,lat} */
+  function readLngLat(loc) {
+    if (!loc) { return { lng: '', lat: '' }; }
+    if (typeof loc === 'string') {
+      var p = loc.split(',');
+      return p.length >= 2 ? { lng: p[0].trim(), lat: p[1].trim() } : { lng: '', lat: '' };
+    }
+    var lng = (loc.lng !== undefined) ? loc.lng : (loc.getLng ? loc.getLng() : '');
+    var lat = (loc.lat !== undefined) ? loc.lat : (loc.getLat ? loc.getLat() : '');
+    return { lng: lng === null || lng === undefined ? '' : lng,
+             lat: lat === null || lat === undefined ? '' : lat };
+  }
+
+  /**
+   * 取"所在地方"。
+   *
+   * ⚠️ 高德的返回有**两套字段**，要看运气：
+   *    · `poi.addressComponent.{province,city,district}` —— 结构化三级；
+   *    · `poi.pname / cityname / adname` —— 老式平铺字段。
+   *    实测两者不是同时都有。取到哪级用哪级，取不到就留空（**绝不瞎编**）。
+   * @returns {string} 形如 "青岛市 市南区" / "青岛" / ''（都没有）
+   */
+  function readPlace(poi) {
+    var a = poi.addressComponent || null;
+    var province = '', city = '', district = '';
+    if (a) {
+      // ⚠️ 直辖市的 province 与 city 会**同时**是"北京市"，拼起来变"北京市 北京市"
+      //    ⇒ 相同时只留一份。
+      province = String(a.province || '').trim();
+      city     = String(a.city || '').trim();
+      district = String(a.district || '').trim();
+    }
+    if (!province && !city && !district) {
+      province = String(poi.pname || '').trim();
+      city     = String(poi.cityname || '').trim();
+      district = String(poi.adname || '').trim();
+    }
+    var parts = [];
+    if (province) { parts.push(province); }
+    if (city && city !== province) { parts.push(city); }
+    if (district) { parts.push(district); }
+    return parts.join(' ');
+  }
+
+  /**
+   * 绑定一个地址输入框。
+   *
+   * @param {HTMLElement} input  那个要联想的输入框（必须有 `data-addr`）
+   * @param {HTMLElement} scope  可选：限定字段查找范围（弹框里的一段表单）
+   */
+  function bindOne(input, scope) {
+    if (!input || input.getAttribute('data-addr-bound') === '1') { return; }
+    input.setAttribute('data-addr-bound', '1');
+
+    // 字段查找范围：`data-addr-for` 给的是一个选择器。
+    // 🔴 必须优先取**最近的那个**祖先（`closest`），不能 `querySelector` 取第一个 ——
+    //    行程表单里 from / to 两组字段都在页面上，取第一个会把出发地的地址
+    //    写到到达地上（"填错了但看起来像填对了"，最难查）。
+    //    取不到祖先时才退回：先按选择器全局取第一个，最后退回 scope/document。
+    var root = null;
+    var forSel = input.getAttribute('data-addr-for');
+    if (forSel) {
+      try { root = input.closest(forSel); } catch (e) { root = null; }
+      if (!root) { root = (scope || document).querySelector(forSel); }
+    }
+    if (!root) {
+      root = (scope || document);
+    }
+
+    function fieldFor(target) {
+      if (!target) { return null; }
+      // 🔴 同一个"逻辑字段"在项目里有两套命名，必须都认（v47 实测踩到）：
+      //    · 影院页     —— 全拼：`address` / `place`
+      //    · 行程地点   —— 缩写：`from_addr` / `to_addr`（`_addr`，不是 `_address`）
+      //    只认全拼的话 `[name$="address"]` 匹配不到 `from_addr`
+      //    （`from_addr` 以 `_addr` 结尾）⇒ 地址永远填不进去，
+      //    而"名字和经纬度都填上了"会让人误以为整个回填是好的。
+      var SYN = {
+        address: ['address', 'addr'],
+        addr:    ['addr', 'address'],
+        place:   ['place', 'city'],
+        city:    ['city', 'place'],
+        lng:     ['lng'],
+        lat:     ['lat'],
+      };
+      var names = SYN[target] || [target];
+      for (var k = 0; k < names.length; k++) {
+        var nm = names[k];
+        // ① 精确名
+        var el = root.querySelector('[name="' + nm + '"]');
+        if (el) { return el; }
+        // ② 带前缀的（`from_addr`）—— 后缀匹配
+        //    ⚠️ 能安全用后缀，是因为 `root` 已经收窄到**这一组**字段的容器
+        //       （`data-addr-for=".loc-field"` + `closest`）：
+        //       出发/到达两组字段在各自的 .loc-field 里，互不可见。
+        //       若在整页范围做后缀匹配，`from_addr` 与 `to_addr` 会互相抢。
+        try {
+          var cands = root.querySelectorAll('[name$="' + nm + '"]');
+          if (cands.length) { return cands[0]; }
+          cands = root.querySelectorAll('[name$="_' + nm + '"]');
+          if (cands.length) { return cands[0]; }
+        } catch (e) { /* 极老浏览器不支持 $= ⇒ 找不到就不填，不报错 */ }
+      }
+      return null;
+    }
+
+    var targets = (input.getAttribute('data-addr-fill') || '')
+                    .split(',').map(function (s) { return s.trim(); })
+                    .filter(Boolean);
+
+    // 手敲也要能被"补齐"（用户可能不用联想直接打字，或 SDK 没加载）
+    // —— 这里只在**选了候选**时填，避免把用户手写的地址覆盖掉。
+
+    if (!sdkReady()) { return; }   // 降级：没有联想，输入与保存都正常
+
+    try {
+      var ac = new window.AMap.AutoComplete({ input: input });
+      ac.on('select', function (e) {
+        var poi = (e && e.poi) ? e.poi : null;
+        if (!poi) { return; }
+
+        // 输入框里放**名字**（用户认的是名字，不是"一串门牌号"）
+        var name = String(poi.name || '').trim();
+        if (name !== '') { input.value = name; }
+
+        targets.forEach(function (t) {
+          var el = fieldFor(t);
+          if (!el) { return; }
+          // 🔴 只填**空白**的字段。理由（用户 2026-10-13 要的是"自动补齐"）：
+          //    用户可能已经在地址栏手写了更细的门牌（"3 号楼 2 单元"），
+          //    高德给的 `address` 只是"到路口/到楼"的粒度 —— 直接覆盖会把他写的东西抹掉，
+          //    而"抹掉用户输入"是不可逆的（他点保存后就真没了）。
+          //    ⇒ 空着才补；已经有内容就尊重用户的。
+          if (String(el.value || '').trim() !== '') { return; }
+          if (t === 'place' || t === 'city') {
+            var pl = readPlace(poi);
+            if (pl !== '') { el.value = pl; }
+          } else if (t === 'address' || t === 'addr') {
+            var ad = String(poi.address || '').trim();
+            if (ad !== '') { el.value = ad; }
+          } else if (t === 'lng' || t === 'lat') {
+            var ll = readLngLat(poi.location);
+            var v = (t === 'lng') ? ll.lng : ll.lat;
+            if (v !== '') { el.value = v; }
+          }
+        });
+
+        // 让调用方知道"值被程序改过"（有些页面要跟着重画/联动）
+        try {
+          input.dispatchEvent(new CustomEvent('fb-addr-picked', {
+            bubbles: true,
+            detail: { name: name, place: readPlace(poi), address: String(poi.address || '') }
+          }));
+        } catch (err) { /* 老浏览器没有 CustomEvent 构造器，忽略即可 */ }
+      });
+    } catch (err) {
+      /* SDK 已加载但初始化失败（key 没绑域名等）—— 静默降级，不打扰用户 */
+    }
+  }
+
+  /**
+   * 初始化（**可重复调用**）。
+   * @param {HTMLElement|Document} scope 限定范围；缺省 = 整页
+   */
+  function fbAddr(scope) {
+    var root = scope || document;
+    var inputs = Array.prototype.slice.call(root.querySelectorAll('[data-addr]'));
+    inputs.forEach(function (el) { bindOne(el, root); });
+  }
+
+  window.fbAddr = fbAddr;
+
+  // 首屏跑一次。⚠️ 脚本是 defer 加载的，此时 DOM 已解析完（在 </body> 前引入亦可）。
+  fbAddr(document);
+
+  /* 通知"我上线了"。
+     ⚠️ 为什么需要：调用方（行程/影院/日程的弹框）可能在**本脚本加载之前**
+        就把 `fbLoadAddr()` 调过了 —— 那种情况下它的 `window.fbAddr` 判断会落空。
+        它们监听这个事件补一次（见 trips/node_form.php 的 initNodeForm）。 */
+  try {
+    window.dispatchEvent(new Event('fb-addr-ready'));
+  } catch (e) {
+    /* 老浏览器没有 Event 构造器（极少）—— 调用方还有 fbAddr 兜底，不影响功能 */
+  }
+})();
\ No newline at end of file
diff --git a/assets/js/entry_popup.js b/assets/js/entry_popup.js
index 58ceb5c..3c1e300 100644
--- a/assets/js/entry_popup.js
+++ b/assets/js/entry_popup.js
@@ -176,6 +176,13 @@
         if (window.fbNodeForm) { window.fbNodeForm(bodyEl()); }
         if (typeof window.fbLoadPicker === 'function') { window.fbLoadPicker(); }
         if (typeof window.fbInitPickers === 'function') { window.fbInitPickers(bodyEl()); }
+        /* 🔴 v47（用户 2026-10-13）：**地址联想**也要补一次。
+           「日程里输入地点要调高德」「行程的出发/到达地要调高德」——
+           这两处的编辑表单都是走这条 AJAX 换片段的路径进来的，
+           而 layout 的按需加载只在**首屏**扫过一次 `[data-addr]`
+           ⇒ 片段里的地点框没人绑，联想永远不出现（正是 v42 在行程上踩过的同一个坑：
+           内联 script 不执行 + 没人补初始化）。 */
+        if (typeof window.fbLoadAddr === 'function') { window.fbLoadAddr(bodyEl()); }
         // 标题取表单片段里的自我描述（各模板的弹框头）
         var h = picked.form.querySelector('.cal-modal-head b')
              || (html.match(/aria-label="([^"]*编辑[^"]*)"/) || [])[1];
diff --git a/index.php b/index.php
index 26ca575..4132173 100644
--- a/index.php
+++ b/index.php
@@ -5978,8 +5978,22 @@ $want = array_keys($want);
         // ⚠️ 失败静默（只记时间戳，下次再试）—— 外部依赖不能把书架页也拖慢/打挂。
         // 🔴 v29 用户第 4 条：这里也改成**响应之后**再同步。
         //    这条路由是用户日常最常打开的入口，"点进来要等"的感觉主要来自它。
+        // 🔴🔴 v47（用户 2026-10-13）：「读书现在还是非常慢，进入这个页面刚开始非常慢」
+        //    —— 真因是**会话锁**（见 WeRead::queueBackgroundSync 的长注释）：
+        //    `fastcgi_finish_request()` 只断开客户端连接，**不释放 PHP 文件会话锁**；
+        //    后台同步要跑 ~9 秒（真打微信读书接口），
+        //    于是同一个人的**下一个请求**会一直等它跑完 ⇒ 下一个页面卡 9 秒。
+        //    （线上实测：第 1 次 0.08s / 第 2 次 **8.73s** / 第 3 次 0.07s。）
+        // ⇒ 排完后台任务后**立刻放锁**，再渲染。
+        //    ⚠️ 放在渲染之前而不是只放在 shutdown 回调里：shutdown 回调不一定执行
+        //       （客户端中断 / 服务器超时），那锁会一直挂到请求结束。
+        //    ⚠️ 放锁前要用的都已经是普通变量（$me / $familyId），此后不再读 $_SESSION ⇒ 安全。
         if (WeRead::autoSyncOn($me) && WeRead::hasKey($me)) {
             WeRead::queueBackgroundSync($familyId, $me);
+            // 排完就放锁：这一步是本轮"读书页慢"的真正修复点
+            if (session_status() === PHP_SESSION_ACTIVE) {
+                session_write_close();
+            }
         }
         $f = [
             'status'   => (string)($_GET['status'] ?? ''),
@@ -6495,6 +6509,12 @@ $want = array_keys($want);
         $syncRes = ['ran' => false, 'books' => 0, 'notes' => 0, 'covers' => 0, 'error' => ''];
         if (WeRead::autoSyncOn($me) && WeRead::hasKey($me)) {
             WeRead::queueBackgroundSync((int)Auth::familyId(), $me);
+            // 🔴 v47：排完就放会话锁（同 books 路由，见 WeRead::queueBackgroundSync 的长注释）。
+            //    不放的话，这台机器上"同一个人的下一个请求"会等到后台同步跑完
+            //    （实测 9.2 秒）—— 用户会觉得"点进去要等好久"。
+            if (session_status() === PHP_SESSION_ACTIVE) {
+                session_write_close();
+            }
         }
         View::render('books/weread', [
             'title'   => '微信读书导入',
diff --git a/media.php b/media.php
index 6426780..1f370c2 100644
--- a/media.php
+++ b/media.php
@@ -43,12 +43,54 @@ function media_fail(int $code, string $message): void
 $key = (string)($_GET['k'] ?? '');
 $stageTok = (string)($_GET['stage'] ?? '');
 
-// ---- 1. 鉴权 ----
-if (!Auth::check()) {
-    // 401 而不是 302：这是给 <img src> 用的端点，跳登录页只会返回一坨 HTML 当成图片
-    media_fail(401, '需要登录');
+/*
+ * ---- 1. 鉴权：网页会话 **或** 移动端 API 令牌 ----
+ *
+ * 🔴 v45（2026-10-12）：这一条是为了让**手机端能显示图片**而加的。
+ *
+ * 背景：`media.php` 原先**只认网页会话**（`Auth::check()` 读 `$_SESSION`），
+ *   而鸿蒙 App 是拿 `Authorization: Bearer <token>` 说话的（`api.php` 那套）。
+ *   ⇒ App 拿不到任何图片：海报、头像、附件全都显示不出来。
+ *   这不是"前端忘了接"，是**服务端压根没提供移动端可用的取图入口**。
+ *
+ * ⚠️ 为什么令牌走 **query 参数**（`?token=`）而不是请求头：
+ *    图片是 `<img src="...">` 取的，**浏览器/ArkUI 的 Image 组件都无法给它加
+ *    自定义请求头**。所以必须支持 URL 里带令牌。
+ *    （`api.php` 的注释里也写了"也接受 `?token=`"这个约定，与这里同一口径。）
+ *
+ * ⚠️ 安全性：URL 里的令牌会进 access log / Referer。
+ *    对这个家庭应用是可接受的取舍 —— 且令牌本来就只能读本家庭的数据。
+ *    ⚠️ 但**必须**：① 只认 `Bearer` 那条不认（这里只查 query）；
+ *       ② 令牌无效就 401，不泄露"这个 key 存不存在"。
+ *
+ * ⚠️ 会话优先：网页端行为**一字不变**（先判 session，命中就不碰令牌），
+ *    避免影响现有 300+ 处 `<img src="media.php?k=…">`。
+ */
+$familyId = 0;
+$personId = 0;
+if (Auth::check()) {
+    // 网页会话（原有路径，行为不变）
+    $familyId = (int)Auth::familyId();
+    $personId = (int)(Auth::personId() ?? 0);
+} else {
+    // 移动端令牌兜底
+    // ⚠️ `Api::bearer()` 只读请求头；这里要用 query，所以自己取。
+    $tok = trim((string)($_GET['token'] ?? ''));
+    if ($tok !== '') {
+        $hit = \App\ApiToken::verify($tok);
+        if ($hit !== null) {
+            $personId = (int)$hit[0];
+            $p = \App\Person::find($personId);
+            if ($p) {
+                $familyId = (int)($p['family_id'] ?? 0);
+            }
+        }
+    }
+    if ($familyId <= 0) {
+        // 401 而不是 302：这是给 <img src> 用的端点，跳登录页只会返回一坨 HTML 当成图片
+        media_fail(401, '需要登录');
+    }
 }
-$familyId = (int)Auth::familyId();
 
 /* ---- 1b. 暂存预览（v24 第 20 批 第 4 条）----
    刚拖进来的文件还没"保存"，所以它还没有附件行、也没有正式键 —— 但用户
@@ -56,7 +98,9 @@ $familyId = (int)Auth::familyId();
    所以这里给一个 `?stage=<令牌>` 的形态：只读**本账号自己**的暂存目录。
    ⚠️ 令牌校验与归属检查都在 StagedUpload::read 里（拿到别人的令牌也读不到）。 */
 if ($stageTok !== '') {
-    $sf = \App\StagedUpload::read($familyId, (int)Auth::personId(), $stageTok);
+    // ⚠️ 用上面推导好的 `$personId`（会话路径与 Auth::personId() 同值；
+    //    令牌路径也正确）—— 别在这里再调 Auth::，那对 App 会是 null。
+    $sf = \App\StagedUpload::read($familyId, $personId, $stageTok);
     if ($sf === null) {
         media_fail(404, '没有这个暂存文件');
     }
@@ -92,10 +136,42 @@ foreach (explode('/', $key) as $seg) {
 }
 
 // ---- 3. 取内容（本地优先，再由当前驱动兜底）----
+/* 🔴🔴 v47（用户 2026-10-13）：「读书现在还是非常慢，这个问题需要彻底解决。」
+   实测（真公网）：书架页有 **35 张封面**，每张都要 0.15~0.53s 去 OSS 取原图，
+   而且 ---- **每次访问都重新取一遍**（服务端没有任何缓存）。
+
+   两个硬伤，这一版一起修：
+
+   ① **会话锁**：本项目用 PHP 文件会话，而 `session_start()` 会**独占**会话文件。
+      media.php 从不释放它 ⇒ **同一个人的所有图片请求串行**（浏览器 6 条连接也快不了）。
+      ⇒ 读完会话（鉴权完成）后立刻 `session_write_close()`：不再写会话了，早点放锁。
+        实测收益最大——它把"35 张 × 串行"变成"N 张并发"。
+
+   ② **磁盘二级缓存**：实现早已是"本地优先"（`Storage::read` 先看 uploads/），
+      但**只读不写回** ⇒ OSS 上那份永远要远程取。
+      ⇒ 远程取到后**回写一份到 uploads/**，下次直接命中本地文件（0 次远程调用）。
+        —— 只针对**图片**（封面/头像这类反复取的），且带容量上限，
+           不让缓存无限长大把磁盘吃满。
+
+   ⚠️ 顺序不能反：先放锁、再取内容（取内容可能要几百毫秒）。 */
+$isImageKey = (bool)preg_match('#^avatars/|^bookcovers/|^posters/|^photos/|^tickets/#', $key);
+if ($isImageKey) {
+    // 图片是"只读、可重复取、可静态化"的，两次都用不到会话写权限
+    if (session_status() === PHP_SESSION_ACTIVE) {
+        session_write_close();
+    }
+}
+
 $res    = Storage::read($familyId, $key);
 $status = (int)($res['status'] ?? 0);
 $body   = (string)($res['body'] ?? '');
 
+// 远程取到的图片回写本地（下一跳命中文件系统，省掉整个 OSS round-trip）
+if ($isImageKey && !empty($res['ok']) && $status === 200
+    && ($res['from'] ?? '') !== 'local' && $body !== '') {
+    Storage::cacheLocally($key, $body);
+}
+
 if (empty($res['ok']) || $status < 200 || $status >= 300) {
     if ($status === 404 || $status === 0) {
         media_fail(404, '没有这个文件');
@@ -135,6 +211,12 @@ $size = strlen($body);
 $etag = '"' . md5($key . '|' . $size . '|' . $mime) . '"';
 
 // ---- 5. 条件请求 ----
+/* ⚠️ ETag 由"键 + 大小 + MIME"算出，所以**不等也要判它一次**：
+   内容没变时浏览器带回来的就是同一个 ETag，我们却仍然要先把整张图取回来
+   （拉到第 3 步才拿到 $body）—— 那一次远程取数就是纯浪费。
+   v47 的缓存回写（见第 3 步）让第二次开始命中的是**本地文件**，
+   所以这里"取回来再判 304"的代价已经降到本地读盘级别，够用了。
+   （真要连本地读都省掉，得把 ETag 单独持久化 —— 那是下一步的事。） */
 $inm = trim((string)($_SERVER['HTTP_IF_NONE_MATCH'] ?? ''));
 if ($inm !== '' && $inm === $etag) {
     http_response_code(304);
diff --git a/templates/calendar/_event_fields.php b/templates/calendar/_event_fields.php
index a6fd7ce..95fe531 100644
--- a/templates/calendar/_event_fields.php
+++ b/templates/calendar/_event_fields.php
@@ -57,8 +57,17 @@ $evLab = static function (string $text, string $for = '', bool $star = false) us
 
 <?php echo $evRowOpen(); ?>
   <?= $evLab('地点', 'ev-location') ?>
+  <?php /* 🔴 v47（用户 2026-10-13）：「日程中，当我输入地点的时候，也应该调用高德的接口，
+           补齐详细地址。」⇒ 地点框挂高德联想。
+         ⚠️ 日程表里**没有**单独的"详细地址"字段（地点就一栏），所以这里不做"回填"，
+            只把**联想选中的正式地名**写回输入框 —— 价值是"把口语化的'学校三楼会议室'
+            换成高德认得的规范地名"，后续要查经纬度/导航才查得到。
+         ⚠️ 这段表单既在整页（各视图的日程弹框）也在 AJAX 片段里出现，
+            所以打好 `data-addr` 标记即可 —— 由 layout 的 loader 与
+            弹框打开时的 `fbLoadAddr(scope)` 负责绑定（与 person_picker 同一套）。 */ ?>
   <input class="input" id="ev-location" name="location"
-         value="<?= e((string)($evF['location'] ?? '')) ?>" placeholder="如：学校三楼会议室">
+         value="<?= e((string)($evF['location'] ?? '')) ?>" placeholder="如：学校三楼会议室"
+         data-addr>
 </div>
 
 <?php echo $evRowOpen(); ?>
@@ -235,15 +244,17 @@ $evLab = static function (string $text, string $for = '', bool $star = false) us
   </div>
 </div>
 
-<?php echo $evRowOpen(); ?>
-  <?= $evLab('状态', 'ev-status') ?>
-  <select class="select" id="ev-status" name="status">
-    <?php $st = (string)($evF['status'] ?? 'confirmed'); ?>
-    <option value="confirmed"<?= $st === 'confirmed' ? ' selected' : '' ?>>确定</option>
-    <option value="tentative"<?= $st === 'tentative' ? ' selected' : '' ?>>待定</option>
-    <option value="cancelled"<?= $st === 'cancelled' ? ' selected' : '' ?>>取消</option>
-  </select>
-</div>
+<?php /* 🔴 v47（用户 2026-10-13）：「日程的那个状态，什么确定、待定、取消，
+       我觉得没有什么意义，把它给删掉吧，不要了。」
+       ⇒ 「状态」整块**删除**。
+       ⚠️ 服务端契约**刻意保留**（用户明确说"数据库可以保留，后续会有一个整体的清理"）：
+          - `events.status` 列留着、不删；
+          - `Calendar::save()` 收到不带 status 的表单时，用**原值**（更新）或
+            `'confirmed'`（新建），与删掉这一栏之前**完全一致** ——
+            不会因为删了控件就把已有日程的状态改写掉（见 index.php 里那两处
+            `(string)($ev2['status'] ?? 'confirmed')`）。
+          - 导出 iCalendar 时 STATUS 照旧按原值走，别人的日历里不会看到状态变化。
+       下方原来还有一段给 `ev-status` 的联动脚本，也一并删。 */ ?>
 
 <?php /* 🔴 v44（用户 2026-10-12 第 2 条）：「这段时间算忙碌，这一块直接给它去掉就行了，
        没有什么用。」⇒ 「这段时间算 / 忙碌 / 空闲」整块删除。
diff --git a/templates/layout.php b/templates/layout.php
index 64c90ab..b73cdf1 100644
--- a/templates/layout.php
+++ b/templates/layout.php
@@ -66,6 +66,25 @@ $isLoggedIn = \App\Auth::check();
     'css' => asset('/assets/vendor/cropper/cropper.min.css'),
     'js'  => asset('/assets/vendor/cropper/cropper.min.js'),
 ], JSON_UNESCAPED_UNICODE | JSON_HEX_APOS | JSON_HEX_QUOT)) ?>">
+<?php /* 🔴 v47（用户 2026-10-13）：**地址联想**（高德 AutoComplete）。
+       影院名称 / 行程出发到达 / 日程地点 三处都要"边打边出候选、选中自动补齐地址"。
+       与 Cropper 同一套按需加载：页面上真有 `[data-addr]` 才去拉脚本与高德 SDK
+       —— 高德 SDK 本身百 KB 级，绝不能让用不到的页面白拉。
+       ⚠️ 高德的两个配置（JS API key 与安全密钥）**只在真要用时才输出**：
+          它们是外部服务的凭据，没用到地址联想的页面不该把它们写进 HTML。
+       ⚠️ key 为空（没配高德）时整块不输出 ⇒ 前端 `sdkReady()` 为假 ⇒
+          联想静默降级、输入框照常用（见 addr_suggest.js 的降级注释）。 */
+$_amapJs = \App\Geo::jsConfig();
+$_needAddr = ($_amapJs['key'] !== '');
+?>
+<?php if ($_needAddr): ?>
+<meta name="fb-addr" content="<?= e(json_encode([
+    'js'  => asset('/assets/js/addr_suggest.js'),
+    'sdk' => 'https://webapi.amap.com/maps?v=2.0&key=' . rawurlencode($_amapJs['key'])
+             . '&plugin=AMap.AutoComplete',
+    'security' => $_amapJs['security'],
+], JSON_UNESCAPED_UNICODE | JSON_HEX_APOS | JSON_HEX_QUOT)) ?>">
+<?php endif; ?>
 <?php /* 🔴🔴 v38（用户 2026-10-10）：「我终于找到了一个我比较认可的日期选择插件
        https://ant-design.antgroup.com/components/date-picker-cn 现在观影这个模块
        进行测试吧…等这个模块测试完没问题了，再更新到其他的模块。」
@@ -274,6 +293,77 @@ window.FB_NOTIFY = {
   if (document.querySelector('.pp[data-pp]')) { load(); }
 })();
 </script>
+
+<?php /* 🔴 v47（用户 2026-10-13）：**地址联想**的按需加载（高德 AutoComplete）。
+   判据用 `[data-addr]`（组件根的真实标记），**不用**含糊的子串。
+   三层顺序不能反：先拉 SDK、再拉我们的脚本 —— 我们的脚本一执行就会去
+   `new AMap.AutoComplete(...)`，SDK 没就位就只能降级（等于白接）。
+   ⚠️ SDK 加载失败也要能继续：`__AMAP_LOADED` 为假时 addr_suggest.js 里的
+      所有 AMap 调用都在判断之后 ⇒ 输入框仍是普通文本框，手敲照常保存。
+   ⚠️ 用 `window.fbLoadAddr()` 暴露给 AJAX 片段（观影/日程的弹框都是后塞进来的），
+      与 person_picker 的 `fbLoadPicker()` 完全同一套路。 */ ?>
+<script>
+(function () {
+  var meta = document.querySelector('meta[name="fb-addr"]');
+  if (!meta) { return; }            // 没配高德 key（或本页不需要）→ 什么都不做
+  var conf;
+  try { conf = JSON.parse(meta.getAttribute('content')); } catch (e) { return; }
+  if (!conf || !conf.js || !conf.sdk) { return; }
+
+  var sdkReady = null;
+
+  function loadSdk() {
+    if (window.__AMAP_LOADED) { return Promise.resolve(true); }
+    if (sdkReady) { return sdkReady; }
+    sdkReady = new Promise(function (res) {
+      var s = document.createElement('script');
+      s.src = conf.sdk;
+      s.setAttribute('data-fb-amap', '1');
+      s.onload = function () { window.__AMAP_LOADED = true; res(true); };
+      s.onerror = function () { sdkReady = null; res(false); };   // 失败不锁死，下次可重试
+      document.head.appendChild(s);
+    });
+    return sdkReady;
+  }
+
+  function loadOurs() {
+    if (window.fbAddr) { return Promise.resolve(true); }
+    return new Promise(function (res) {
+      var s = document.createElement('script');
+      s.src = conf.js;
+      s.defer = true;
+      s.onload = function () { res(true); };
+      s.onerror = function () { res(false); };
+      document.head.appendChild(s);
+    });
+  }
+
+  /* 安全密钥必须在 SDK **之前**设好（高德要求），否则 AutoComplete 会被拒。 */
+  function boot() {
+    /* ⚠️ 安全密钥必须在 SDK **之前**设好（高德硬要求），否则 AutoComplete 会被拒。
+       放在这里而不是页面顶部：没用到地址联想的页面不该出现这两个凭据。 */
+    if (!window._AMapSecurityConfig) {
+      window._AMapSecurityConfig = { securityJsCode: conf.security || '' };
+    }
+    return loadSdk().then(function () {
+      if (!window.__AMAP_LOADED || typeof window.AMap === 'undefined') { return false; }
+      return loadOurs();
+    });
+  }
+
+  window.fbLoadAddr = function (scope) {
+    return boot().then(function (ok) {
+      if (ok && window.fbAddr) { window.fbAddr(scope || document); }
+      return ok;
+    });
+  };
+
+  if (document.querySelector('[data-addr]')) {
+    // ⚠️ SDK 是 defer 之后的动态插入，比我们的脚本晚 —— 所以必须等它 onload 再绑。
+    boot();
+  }
+})();
+</script>
 <?php /* v27：笔记的分块编辑器同样**按需加载**（页面上真有 `#noteForm` 才拉）。
       理由与 person_picker.js 完全同一套：它只在写笔记那一页有用，
       每页都带一份等于让别的页面白付流量。判据用表单的真实 id（不是含糊找 "note"）。 */ ?>
diff --git a/templates/movies/cinemas.php b/templates/movies/cinemas.php
index 1a76256..dbcc1f4 100644
--- a/templates/movies/cinemas.php
+++ b/templates/movies/cinemas.php
@@ -28,7 +28,7 @@ $canWrite = \App\Auth::canWrite();
 <?php else: ?>
   <div class="card card-pad cinema-form-card">
     <h2 class="cinema-h2"><?= $isEditing ? '编辑影院' : '添加影院' ?></h2>
-    <form method="post" action="<?= e(url('movies/cinemas_save')) ?>">
+    <form method="post" action="<?= e(url('movies/cinemas_save')) ?>" id="cinemaForm">
       <?= csrf_field() ?>
       <?php if ($isEditing): ?>
         <input type="hidden" name="id" value="<?= (int)$editing['id'] ?>">
@@ -37,7 +37,13 @@ $canWrite = \App\Auth::canWrite();
         <div class="field">
           <label for="cname">影院名称 *</label>
           <input class="input" id="cname" name="name" required
-                 value="<?= e(old('name', $editing['name'] ?? '')) ?>" placeholder="如：万达影城（IMAX 店）">
+                 value="<?= e(old('name', $editing['name'] ?? '')) ?>" placeholder="如：万达影城（IMAX 店）"
+                 <?php /* 🔴 v47（用户 2026-10-13）：「输入影院的名称的时候，应该自动的帮我补齐
+                          所在的地方和详细地址。」⇒ 名称框挂高德联想，选中后自动填
+                          `place`（所在地方）与 `address`（详细地址）。
+                          ⚠️ 只填**空白**的字段（见 addr_suggest.js 的注释）——
+                             用户已经手写过的地址不该被覆盖。 */ ?>
+                 data-addr data-addr-fill="place,address" data-addr-for="#cinemaForm">
         </div>
         <div class="field">
           <label for="cplace">所在地方</label>
diff --git a/templates/movies/form.php b/templates/movies/form.php
index 6f8f633..4d0d97c 100644
--- a/templates/movies/form.php
+++ b/templates/movies/form.php
@@ -461,7 +461,7 @@ $mDelForms  = [];   // 收集起来，在表单**外面**统一渲染
     <div class="cn-panel" role="dialog" aria-modal="true" aria-label="新建影院">
       <div class="cn-head"><b>新建影院</b>
         <button type="button" class="cn-x" data-cn-close aria-label="关闭">✕</button></div>
-      <form method="post" action="<?= e(url('movies/cinemas_save')) ?>">
+      <form method="post" action="<?= e(url('movies/cinemas_save')) ?>" id="cinemaNewForm">
         <?= csrf_field() ?>
         <?php /* back=movies/new 让服务端存完回到**本页**（而不是甩去影院管理页） */ ?>
         <input type="hidden" name="back" value="movies/new">
@@ -472,7 +472,12 @@ $mDelForms  = [];   // 收集起来，在表单**外面**统一渲染
           </div>
           <div class="field">
             <label>影院名称 *</label>
-            <input class="input" name="name" required placeholder="如：万象城 CGV" maxlength="100">
+            <?php /* 🔴 v47（用户 2026-10-13）：与影院管理页同一套 —— 输入名称即联想，
+                     选中后自动补齐「所在地方」与「详细地址」。
+                     ⚠️ 字段查找范围限定在本弹框内（`#cinemaNewForm`）：
+                        观影新增页本身也有一个「影院」下拉，不限定会抓错字段。 */ ?>
+            <input class="input" name="name" required placeholder="如：万象城 CGV" maxlength="100"
+                   data-addr data-addr-fill="place,address" data-addr-for="#cinemaNewForm">
           </div>
           <?php /* 🔴 v41（用户 2026-10-10）：「这里新建影院这个地方好像没有详细地址啊。
                    应该把详细地址加上。」—— 影院管理页的表单一直有 address 字段，
diff --git a/templates/notes/form.php b/templates/notes/form.php
index 5236ef2..69e89a6 100644
--- a/templates/notes/form.php
+++ b/templates/notes/form.php
@@ -341,8 +341,25 @@ $imgParts = static function (string $c): array {
           <p class="empty-hint" id="noteFilesEmpty">还没有附件。</p>
         <?php endif; ?>
 
-        <form method="post" enctype="multipart/form-data"
-              action="<?= e(url('notes/attach_add')) ?>" id="noteAttForm">
+        <?php /* 🔴🔴 v47（用户 2026-10-13）：「编辑一个笔记，点击编辑，然后这时候点保存
+             是没有任何反应的。」——真因就是**这里原来是一个嵌套 <form>**。
+
+             HTML 不允许 form 套 form：浏览器解析时会把**内层** `<form>` 标签丢掉，
+             但**保留**它后面的 `</form>`。于是那个 `</form>` 提前把外层的
+             `#noteForm`（整页的保存表单）关掉了 ——
+             结果「保存」按钮落入**没有任何表单**的区域：
+                · `button.form === null`；
+                · 点它既不提交、也不报错（**所以"没有任何反应"**）。
+             ⚠️ 页面里其它字段看着都正常，只有"提交"这条链断了 ——
+                这类 bug 不打开真浏览器量 `btn.form` 是看不出来的。
+
+             改法：内层不再用 `<form>`，改成 `<div>`，把"上传所选文件"这个按钮
+             用 HTML5 的 `formaction` / `formenctype` **指向自己的端点**。
+             —— 这样仍然只有**一个**表单（保存表单），上传按钮却能提交到
+                 `notes/attach_add` 且是 multipart。既修了 bug，又不牺牲上传。
+             ⚠️ 隐藏域 `id` 与 `_csrf` 与保存表单同名同值（都是这条笔记的 id /
+                同一个令牌），合进一个表单不会冲突 —— 已在探针里断言过。 */ ?>
+        <div id="noteAttForm">
           <?= csrf_field() ?>
           <input type="hidden" name="id" value="<?= (int)$editing['id'] ?>">
           <div class="note-att-drop" id="noteAttDrop">
@@ -351,9 +368,13 @@ $imgParts = static function (string $c): array {
             <span class="note-att-tip">把文件拖到这里，或<label for="noteAttInput">点这里选文件</label></span>
           </div>
           <div class="btn-row">
-            <button class="btn btn-ghost btn-sm" type="submit">上传所选文件</button>
+            <?php /* ⚠️ formaction/formenctype 必须写在**按钮**上：表单主体是"保存"，
+                   只有这一个按钮走附件端点。 */ ?>
+            <button class="btn btn-ghost btn-sm" type="submit"
+                    formaction="<?= e(url('notes/attach_add')) ?>"
+                    formenctype="multipart/form-data">上传所选文件</button>
           </div>
-        </form>
+        </div>
       </div>
     <?php else: ?>
       <div class="card card-pad">
diff --git a/templates/trips/_loc_field.php b/templates/trips/_loc_field.php
index 301d9e1..b345a4d 100644
--- a/templates/trips/_loc_field.php
+++ b/templates/trips/_loc_field.php
@@ -56,6 +56,12 @@ $locId  = 'loc-' . $locPrefix;
          value="<?= e($locName) ?>"
          placeholder="<?= e($locPlaceholder) ?>"
          autocomplete="off"
+         <?php /* 🔴 v47（用户 2026-10-13）：地址联想改用**全站共用模块**
+                  （`assets/js/addr_suggest.js`，由 layout.php 按需拉起高德 SDK）。
+                  `data-addr-fill` 列出选中候选后要回填哪几个字段。
+                  ⚠️ 字段查找范围限定在**本 .loc-field 内**：一个行程表单里有
+                     from / to 两组，不限定会把出发地的地址写到到达地上。 */ ?>
+         data-addr data-addr-fill="address,lng,lat,city" data-addr-for=".loc-field"
          data-loc-input>
   <?php /* 高德没加载 / 用户自己敲的地名：这四个字段就是兜底存放处 */ ?>
   <input type="hidden" name="<?= e($locPrefix) ?>_addr" value="<?= e($locAddr) ?>">
diff --git a/templates/trips/node_form.php b/templates/trips/node_form.php
index 2e770b9..21c95a9 100644
--- a/templates/trips/node_form.php
+++ b/templates/trips/node_form.php
@@ -79,7 +79,6 @@ $toRow = [
     'lat'     => (string)($n['to_lat'] ?? ''),
     'city'    => (string)($n['to_city'] ?? ''),
 ];
-$amap = \App\Geo::jsConfig();
 
 /* 🔴🔴 v41（用户 2026-10-10 第 5/6 条）：
    「编辑行程、加计划行程、加实际行程，全部都采用弹窗的形式。其排版的方式和添加电影
@@ -478,43 +477,26 @@ $nfEmbed     = !empty($nfEmbed);
   </div>
 <?php endif; ?>
 
-<?php /* ==================== 高德 SDK（按需加载，与 TripLog 同一套做法）====================
-   ⚠️ SDK 加载**失败也必须能用**：文本框就是普通输入框，用户手敲地名照样能存。
-     所以这段脚本里所有 AMap 的用法都放在 `__AMAP_LOADED` 判断之后，
-     并且给"搜索这个地名"兜底链接单独一条路径（不依赖 SDK）。 */ ?>
-<?php if ($amap['key'] !== ''): ?>
+<?php /* ==================== 地址联想（v47 起改用全站共用模块）====================
+   🔴 v47（用户 2026-10-13）：原来这里是**一段本页内联脚本**（自己 new AMap.AutoComplete）。
+      这次影院名称、日程地点也要联想 ⇒ 再各写一份必然出现"某个入口忘了补"。
+      所以抽到 `assets/js/addr_suggest.js`，由 layout.php 按需加载（页面上有 `[data-addr]`
+      才拉高德 SDK 与那份脚本）。本页只负责：
+        · 给 from/to 两个输入框打上 `data-addr` 标记（回填 addr/lng/lat/city）；
+        · 保留"手敲也要更新详细地址那行字 + 导航链接"的本地逻辑（不依赖 SDK）。
+   ⚠️ 与 v42 同一条约束：这段表单会被 AJAX 片段塞进 DOM（详情页弹框），
+      内联 script 标签那时不会执行 ⇒ 初始化统一走 `window.fbNodeForm(scope)`，
+      它内部会调 `window.fbLoadAddr(scope)` 把联想按需拉起。 */ ?>
 <script>
-  window._AMapSecurityConfig = { securityJsCode: '<?= e($amap['security']) ?>' };
-  window.__AMAP_LOADED = false;
-</script>
-<script src="https://webapi.amap.com/maps?v=2.0&key=<?= e($amap['key']) ?>&plugin=AMap.AutoComplete"
-        onload="window.__AMAP_LOADED = true;"
-        onerror="window.__AMAP_ERROR = 'script load failed';"></script>
-<?php endif; ?>
-<script>
-/* ============================================================
-   地址联想（v24 第 17 批 用户第 3 条）
-   照 TripLog 的做法：AMap.AutoComplete 直接挂在 input 上，边打边出候选；
-   选中后把 name / address / lng / lat / city **同时**写进五个字段。
-   ⚠️ 高德没加载时整个块跳过，input 仍是普通文本框（降级可用）。
-   ⚠️ 用 IIFE 包起来：这个页面只有一份表单，但函数名别污染全局
-      （app.js 里也有通用初始化，命名撞了会互相覆盖）。
-   ============================================================ */
 (function () {
   'use strict';
 
-  /* 🔴🔴 v42（用户 2026-10-11 第 3/4 条）：
-     这两段（高德地址联想 / 出行方式联动车辆与车次）原来是"页面加载时跑一次"的。
-     但 v41 把行程表单改成了**详情页弹框 + AJAX 取片段** —— 片段塞进 DOM 时
-     **内联 <script> 不会执行**（`innerHTML` 不跑脚本，这是浏览器语义），
-     于是用户在弹框里看到的是：
-       · 选「自驾」没出现车牌、选「火车/飞机」没出现车次（第 3 条）；
-       · 出发地/到达地没有高德联想（第 4 条）。
-     ⇒ 把这两段抽成**可重复调用**的 `window.fbNodeForm(scope)`：
-        详情页每次把片段塞进 DOM 后调它一次（见 show.php 的 loadInto）。
-      ⚠️ 幂等由各自内部的标记保证（`data-drop-bound` 那套是本文件外的上传组件；
-        这里用 `data-nf-bound` / `data-loc-bound`）。 */
+  /* 与我的关系（与 App\Trip::DRIVE_MODES 无关的那部分）—— 见下 bindLoc 的说明 */
 
+  /**
+   * 出发地 / 到达地：**只做"不依赖 SDK"的那半**（详细地址那行字 + 导航链接）。
+   * 联想与字段回填由共用模块负责（它在 input 上打 data-addr 标记即可）。
+   */
   function bindLoc(prefix, scope) {
     var input = (scope || document).querySelector('#loc-' + prefix + '-input');
     if (!input) { return; }
@@ -526,7 +508,6 @@ $nfEmbed     = !empty($nfEmbed);
     var fAddr  = wrap.querySelector('input[name="' + prefix + '_addr"]');
     var fLng   = wrap.querySelector('input[name="' + prefix + '_lng"]');
     var fLat   = wrap.querySelector('input[name="' + prefix + '_lat"]');
-    var fCity  = wrap.querySelector('input[name="' + prefix + '_city"]');
     var dTail  = wrap.querySelector('[data-loc-detail]');
     var navEl  = wrap.querySelector('[data-loc-nav]');
 
@@ -554,37 +535,9 @@ $nfEmbed     = !empty($nfEmbed);
     // 手敲也要更新（用户可能不用联想，直接打字）
     input.addEventListener('change', paint);
     input.addEventListener('blur', paint);
-
-    if (!window.__AMAP_LOADED || typeof AMap === 'undefined' || !AMap.AutoComplete) {
-      return;   /* 降级：没有联想，但输入与保存都正常 */
-    }
-    try {
-      var ac = new AMap.AutoComplete({ input: input });
-      ac.on('select', function (e) {
-        var d = (e && e.poi) ? e.poi : null;
-        if (!d) { return; }
-        var loc = d.location || null;      // 可能是 AMap.LngLat，也可能是 {lng,lat}
-        var lng = loc ? (loc.lng !== undefined ? loc.lng : (loc.getLng ? loc.getLng() : '')) : '';
-        var lat = loc ? (loc.lat !== undefined ? loc.lat : (loc.getLat ? loc.getLat() : '')) : '';
-        if (fAddr) { fAddr.value = d.address || ''; }
-        if (fLng)  { fLng.value  = (lng === null || lng === undefined) ? '' : lng; }
-        if (fLat)  { fLat.value  = (lat === null || lat === undefined) ? '' : lat; }
-        /* 高德把城市放在 addressComponent / pname+cityname 上 —— 尽量带回城市，
-           省掉服务端一次逆地理请求（用户第 1 条要的就是城市）。 */
-        if (fCity) {
-          if (d.addressComponent && d.addressComponent.city) {
-            fCity.value = d.addressComponent.city;
-          } else if (d.cityname) {
-            fCity.value = d.cityname;
-          } else {
-            fCity.value = '';
-          }
-        }
-        paint();
-      });
-    } catch (err) {
-      /* SDK 已加载但初始化失败（key 没绑域名等）—— 静默降级，不打扰用户 */
-    }
+    // 共用模块选中候选后会派发这个事件 —— 那时 addr/lng/lat 刚被写好，重画一次
+    input.addEventListener('fb-addr-picked', paint);
+    paint();
   }
 
   /* ---- 出行方式 → 显隐车辆 / 车次（用户第 17 批 第 3 条）----
@@ -615,6 +568,17 @@ $nfEmbed     = !empty($nfEmbed);
     bindLoc('from', root);
     bindLoc('to', root);
     bindMode(root);
+    /* 🔴 v47：地址联想走共用模块。**必须在这里调**（而不是只靠 layout 首屏那一次）——
+       AJAX 片段塞进 DOM 时，layout 的 loader 早就跑过了，新加的输入框没人绑。 */
+    if (typeof window.fbLoadAddr === 'function') {
+      window.fbLoadAddr(root);
+    } else {
+      // 还没加载出来（首屏竞态）→ 等它上线后再补一次
+      window.addEventListener('fb-addr-ready', function once() {
+        window.removeEventListener('fb-addr-ready', once);
+        if (typeof window.fbAddr === 'function') { window.fbAddr(root); }
+      });
+    }
   }
 
   // 首屏跑一次（整页形态）