v47：地址联想三处接入 / 读书页慢的真根因（会话锁）/ 笔记两处 / 日程状态下线

用户 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()` / 不删。

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"）。 */ ?>