v54：首页任务标题截断（真根因=两列网格被撑破）/ 名册分组→标签且候选读词表 / 旅程地图视图 / 旅程设置按钮 / 显示方式默认列表或地图

用户 2026-10-16 傍晚五条。

① 首页「近期任务」标题太长会挤成两行
   用户原话：「首页**近期任务**那个地方要注意截断：如果任务标题太长，
   会把这个任务**挤成两行**。」
   🔴🔴 **真根因是两层，第一版只修了表面**：
     · 表面：`.dash-what` 只有 `flex:1 1 auto; min-width:0`，**缺** nowrap/hidden/ellipsis
       ⇒ 收缩后文字在框内换行；
     · 真身：`.home-duo` 是**两列 grid**，grid 子项默认 `min-width: auto`
       （"我最小也得装下我的内容"）⇒ 一条长标题把那一列顶到 **1763px**
       （父 `home-duo` 才 1032px）⇒ **整个两列布局被撑破**、页面横向溢出到 **2089px**
       （视口 1440）。⇒ 行宽 1721px、`scrollWidth === clientWidth`，
       **`text-overflow: ellipsis` 看起来"没生效"** —— 其实容器自己先爆了。
   修法：`.home-duo > * { min-width: 0; }`，且 **整条 flex 链**都补
     （`.hd-pane` → `.hd-pane-head` → `.hd-pane-body` → `.dash-list/.tk-list` → `.tk-row`）
     —— 链上任何一层漏了，收缩就断在那一层、下面的 nowrap 全白写。
   配套：任务标题加 `title=` 悬停看全。
   ⚠️ 这是本项目**第二次**踩 flex/grid 的 `min-width:auto`（v53 的 `.mv-grid` 是同类）。
      **以后"文字截断不生效"先量容器有没有被撑破**。

② 名册「分组」→「标签」；打标签的候选要**从设置里读**
   用户原话：「现在名册里面给人打标签的时候，**这个标签数据是从哪读出来的**呀？
   在这个名册的设置页面，有很多分组，现在还叫分组。但是打标签的时候，
   **却不是从这些分组里读出来的**。……应该叫「名册标签」，是不是？
   **应该从这里面把所有标签都读出来**吧？……以后就没有分组的概念了，
   **全部都是标签的概念**。」
   🔴 **用户观察得完全正确，这是两套数据源**：
     · 设置页显示的词表来自 `person_groups`（**分组表**）；
     · 打标签的候选来自 `PersonTag::cloud()`（**你已经打过的词**，现算的）；
     ⇒ 两边根本不是一个数据源 ⇒ "设置里列着一堆、打标签时却只有几个"。
   修法：**`PersonTag::choices()` = 设置页词表 ∪ 我用过的词**（并集，词表在前）。
     · 词表里的词**还没用过**也能一点就打上（这正是词表的意义）；
     · 用过的词补在后面（历史不丢）；
     · 名册列表 / 新增 / 编辑 / 挑人 / 导入 **五处同一个函数**。
   界面口径全面改"标签"（**表名仍是 `person_groups`**：改名要背着 `PersonGroup` 类、
   `person_roster.group_id`、以及**另一个会话正在写的 `app/ApiHandler.php`**
   （它引用了 `PersonGroup::orderFor`）一起动，风险远大于收益）：
     · `_person_groups.php` 标题「名册标签」、按钮「加一个我自己的标签」；
     · 删除文案改成"只是从候选里去掉这个词，已打在别人身上的不受影响"
       （**语义真的变了**：标签是各自身上的字符串，不是引用）；
     · `people/_settings_menu.php`、`people/settings.php`、`settings/me.php`、
       `settings.php`（「公共分组」→「公共标签」）全部同步。
   顺带按"全部都是标签"改另两条入口：
     · `people/pick.php`「加进哪一组」下拉 → **打标签**；
     · `people/import.php` 同上；`ContactImporter::run()` 加 `$tags` 参数。
   🔴 新增 `PersonTag::addOne()`（**追加**一个标签）—— 这两处**绝不能用 `setFor()`**
      （它是"先 DELETE 再 INSERT"的整组替换）⇒ 会把人**原有**的标签清光
      （症状是"用一次导入，别人原有的标签全没了"，极难联想）。
   ⚠️ `group_id` 在 pick/import 的**服务端仍收着**（老书签/脚本兼容），只是界面不再展示。

③ 旅程模块加**地图视图**（读 TripLog 移植）
   用户原话：「你去读一下 TripLog 的代码，在旅程这个模块，**可以在地图上显示旅程数据**。
   1. 先读一下它之前那个代码是怎么实现的，**在我们的旅程模块也实现一下**。」
   读 TripLog（`templates/activities/index.php`）得到的要点：
     · 用**高德 AMap**（合规白名单内，绝不是境外瓦片）；
     · `position` 必须是 **[lng,lat] 数组**（传 `{lng,lat}` 裸对象会让 AMap 抛错、
       整个绘制循环当场中断 —— 它注释里写着"批 11 的光秃秃地图就是它"）；
     · `setFitView()` 后**上限 11 级**（只有一趟时会被放大到街道级，那是导航视角）；
     · `.amap-marker` 整层 `pointer-events:none`（否则包装层挡住别家卡片的点击）；
     · **容器必须有固定高度**（0 高度 → 空白地图）。
     它那套"同城环形扇开"是**几百行几何**，本仓数据量没压出这个问题 ⇒ **有意不做**。
   本仓数据更规整：`trip_nodes` 早有 `from_lng/from_lat/to_lng/to_lat`（v17 批）
   + `from_city/to_city` ⇒ 新增 `Trip::attachSpots()`：
     ① 有坐标取**重心**（不是端点 —— 端点会让"青岛→伊春"偏到某一头）；
     ② 没坐标退到**城市重心**（`Geo::lookup` 离线城市表，**不发网络请求**：
        列表页几十趟若逐条打高德逆地理，一次开页就是几十个外部请求）；
     ③ 都没有就不上图（列表里照常有，模板会说清"有几趟没上图"）。
     🔴 城市那里**必须也取重心**：`cities()` 的顺序是**按时间**（出发地在最前），
        取"第一个城市"会让**所有旅程都叠在家上**、地图毫无信息量。
   布局：两个视图用**标签页**（`?view=map` 是**链接**不是纯 JS 按钮 ——
     书签/前进后退/无 JS 都正确；也**有意不**把地图藏在 `display:none` 里，
     高德在 0 尺寸容器里会渲染空白）。
   高德 SDK 加载器重构：原来 `fbLoadAddr()` 顺带拉 `addr_suggest.js`，
   而地图只用 SDK 自带的 `AMap.Map/Marker` ⇒ 抽出 `window.fbAmapSdk()`（只拉 SDK）、
   新增 `fb-amap` meta（不带 plugin），`fb-addr` 那份共用同一加载器。

④ 旅程列表页「新建旅程」**后面**加「设置」按钮
   用户原话：「2. 在旅程的「新建旅程」后面也加一个「设置」按钮。」
   ⇒ 补 `_settings_menu.php`（设置恒排最右），菜单**第一条**加「显示方式」。

⑤ 显示方式：默认列表还是地图（用户自配）
   用户原话：「3. 里面的设置让用户自己配置：**到底默认显示旅程列表，还是用地图显示**。」
   ⇒ 新增 `trips/display`（设置页 + `?set=` 快速设置）与 `trips/display_save`，
     存 **`user_settings.trip_default_view`**（每人一份，**不是**全家设置）。
   ⚠️ 访客也能改（只影响自己看到的默认，不是数据变更）。

验证（新增 2 套件 + 更新 e2e/deploy 断言）：
 · _fb_v54_ui.py（**33 条**真机断言）
 · _b54_falsify.py（**11 注入 / 11 全抓**，基线 33/0）
 · e2e **1518/0**；familybook_deploy.sh 加「第54批形态」段（**24 条**）
 · 部署 **0 FAIL**；线上 **20 个文件 md5 逐字节一致**；
   线上实测：词表 24 条、`choices()` 24 条、**`cloud` 15 条全部 ⊆ `choices`**、
   4 趟旅程全部可上图（样例落在济南·青岛重心）；诊断页已删复验 404

⚠️ 本轮踩坑（已写进 pitfalls.md）：
 · 🔴🔴 **"文字截断不生效"要先量容器有没有被撑破**（第一嫌疑是 flex/grid 子项
   `min-width:auto`，不是 `text-overflow` 写错）；
 · **反向断言（"不该再出现 X"）必须用 `_code_has`（剥注释）** ——
   需求原话正当留在注释里，裸 `grep -F` 会命中自己的说明（本轮部署假红一次）；
 · **冗余防线会让反向验证打不红**（两处 `min-width:0` 只去掉一条 ⇒ 探针照旧全绿，
   注入必须一起去掉）；
 · **界面多加一个字符就可能打歪既有断言**（我在词表管理页给标签名加了 `#`，
   把 e2e 的 `my_group_order()` 读成 `#家人`）。

templates/layout.php

@@ -77,7 +77,19 @@ $isLoggedIn = \App\Auth::check();
 $_amapJs = \App\Geo::jsConfig();
 $_needAddr = ($_amapJs['key'] !== '');
 ?>
-<?php if ($_needAddr): ?>
+<?php /* 🔴 v54（用户 2026-10-16 第 3 条）：**高德地图 SDK** 的独立登记项。
+       旅程模块的"地图视图"要用 `AMap.Map` / `AMap.Marker`（不需要地址联想），
+       所以 SDK 的加载器必须能从**不依赖 `[data-addr]`** 的入口触发。
+       做法：把 SDK 地址与密钥单独挂一个 `fb-amap` meta，`fb-addr` 那份**共用**
+       同一个加载器（见下面脚本里 `window.fbAmapSdk()`）。
+       ⚠️ 仍然只在**配了 key** 时输出（凭据不该出现在用不到高德的页面）。
+       ⚠️ 插件按需：地图本身**不需要** AutoComplete 插件，只有地址联想要 ——
+          所以两份 meta 各带自己的 `plugin`（`fb-amap` 不带插件）。 */
+if ($_needAddr): ?>
+<meta name="fb-amap" content="<?= e(json_encode([
+    'sdk' => 'https://webapi.amap.com/maps?v=2.0&key=' . rawurlencode($_amapJs['key']),
+    'security' => $_amapJs['security'],
+], JSON_UNESCAPED_UNICODE | JSON_HEX_APOS | JSON_HEX_QUOT)) ?>">
 <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'])
@@ -304,33 +316,32 @@ window.FB_NOTIFY = {
       与 person_picker 的 `fbLoadPicker()` 完全同一套路。 */ ?>
 <script>
 (function () {
-  var meta = document.querySelector('meta[name="fb-addr"]');
-  if (!meta) { return; }            // 没配高德 key（或本页不需要）→ 什么都不做
+  /* 🔴 v54：配置源改成 `fb-amap`（**只要有高德 key 就输出**，与本页是否需要联想无关）——
+     因为"地图 SDK"与"地址联想脚本"现在是两件独立的事（见 meta 那段的说明）。
+     ⚠️ 兼容旧路径：万一哪天有页面只带了 `fb-addr`（老缓存 HTML），这里也能兜住。 */
+  var metaAmap = document.querySelector('meta[name="fb-amap"]');
+  var metaAddr = document.querySelector('meta[name="fb-addr"]');
+  var meta = metaAmap || metaAddr;
+  if (!meta) { return; }            // 没配高德 key → 什么都不做
   var conf;
   try { conf = JSON.parse(meta.getAttribute('content')); } catch (e) { return; }
-  if (!conf || !conf.js || !conf.sdk) { return; }
+  if (!conf || !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); }
+    // 联想脚本只在 `fb-addr` 那份配置里（地图页不需要它）
+    var jsUrl = '';
+    if (metaAddr) {
+      try {
+        jsUrl = (JSON.parse(metaAddr.getAttribute('content') || '{}') || {}).js || '';
+      } catch (e) { jsUrl = ''; }
+    }
+    if (!jsUrl) { return Promise.resolve(false); }
     return new Promise(function (res) {
       var s = document.createElement('script');
-      s.src = conf.js;
+      s.src = jsUrl;
       s.defer = true;
       s.onload = function () { res(true); };
       s.onerror = function () { res(false); };
@@ -338,15 +349,47 @@ window.FB_NOTIFY = {
     });
   }
 
-  /* 安全密钥必须在 SDK **之前**设好（高德要求），否则 AutoComplete 会被拒。 */
-  function boot() {
-    /* ⚠️ 安全密钥必须在 SDK **之前**设好（高德硬要求），否则 AutoComplete 会被拒。
-       放在这里而不是页面顶部：没用到地址联想的页面不该出现这两个凭据。 */
+  /**
+   * 🔴 v54（用户 2026-10-16 第 3 条）：把"**只拉高德地图 SDK**"这一步单独暴露出来。
+   *
+   * 为什么不能只留 `fbLoadAddr()`：那个函数**顺带**会去拉 `addr_suggest.js`
+   * （地址联想那一整块），而旅程地图只用 SDK 自带的 `AMap.Map` / `AMap.Marker`，
+   * 根本不需要联想脚本 —— 让地图页白拉一个用不上的脚本是浪费。
+   *
+   * ⚠️ 安全密钥 `_AMapSecurityConfig` 必须在 SDK **之前**设好（高德硬要求，
+   *    否则 SDK 内的服务调用会被拒）—— 所以密钥设置放在这里、由两个入口共用。
+   * ⚠️ 失败**不锁死** `sdkReady`：下次调用可以重试（网络抖动不该让地图永久白屏）。
+   * @return Promise<boolean> SDK 是否可用（AMap 全局对象就位）
+   */
+  window.fbAmapSdk = function () {
+    if (window.__AMAP_LOADED && typeof window.AMap !== 'undefined') {
+      return Promise.resolve(true);
+    }
+    if (sdkReady) { return sdkReady; }
+    /* 密钥必须在此刻（SDK 之前）设好，见上面的说明 */
     if (!window._AMapSecurityConfig) {
       window._AMapSecurityConfig = { securityJsCode: conf.security || '' };
     }
-    return loadSdk().then(function () {
-      if (!window.__AMAP_LOADED || typeof window.AMap === 'undefined') { return false; }
+    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(typeof window.AMap !== 'undefined');
+      };
+      s.onerror = function () { sdkReady = null; res(false); };   // 失败不锁死，下次可重试
+      document.head.appendChild(s);
+    });
+    return sdkReady;
+  };
+
+  /* 安全密钥必须在 SDK **之前**设好（高德要求），否则 AutoComplete 会被拒。 */
+  function boot() {
+    /* ⚠️ 密钥的设置已经收进 `fbAmapSdk()`（地图与联想两个入口共用一处），
+       这里只需要"先 SDK、再我们的脚本"这个顺序。 */
+    return window.fbAmapSdk().then(function (ok) {
+      if (!ok) { return false; }
       return loadOurs();
     });
   }
@@ -378,6 +421,20 @@ window.FB_NOTIFY = {
 </script>
 <script src="<?= e(asset('/assets/js/filter.js')) ?>"></script>
 <script src="<?= e(asset('/assets/js/preview.js')) ?>"></script>
+<?php /* 🔴 v54（用户 2026-10-16 第 3 条）：旅程**地图**脚本，按需加载。
+   判据用 `#tripMapCanvas`（地图容器真实 id）—— 只有旅程列表的"地图视图"会输出它，
+   别的页面不该白拉这一个脚本（与 note_editor / addr_suggest 同一套规矩）。
+   ⚠️ 它内部再按需去要**高德 SDK**（`window.fbAmapSdk()`，见上面 fb-amap 那段）——
+      所以这一条只管"要不要引我们自己的脚本"，SDK 由脚本自己拉。 */ ?>
+<script>
+(function () {
+  if (!document.getElementById('tripMapCanvas')) { return; }
+  var s = document.createElement('script');
+  s.src = <?= json_encode(asset('/assets/js/trip_map.js')) ?>;
+  s.defer = true;
+  document.head.appendChild(s);
+})();
+</script>
 <?php /* 🔴 v52（用户第 4 条）：笔记**详情页**的分段编辑（就地改一段、不跳整页编辑器）。
        ⚠️ 只在阅读态需要它 —— 判据用 `.note-read-body[data-note-id]`（模板在阅读态才输出），
           编辑页没有这个元素，因此不会白拉一份脚本。 */ ?>