v63：卡片配色 / 日历本靠右 / 地图题图 / 设置页清理 / 公共标签颜色 / 令牌下线

- 卡片右上角按钮改用「来自哪个模块」的主题色：HomeCards 登记表新增 mod 字段
  与 module()，首页从登记表取色（原来是模板里硬编码 in_array(['agenda','tasks'])
  白名单，新加带按钮的卡片会默默变灰）
- 首页日程把日历本放到色块右侧：.ag-ev 改弹性行，「时间+标题」包进
  .ag-ev-main（flex:1 1 auto; min-width:0），日历本作右侧兄弟。
  原来 display:block 会把日历本顶到第二行，色块一矮就完全看不见
- 旅程地图显示题图：服务端把 media_url(cover_key) 塞进地图数据，
  地图卡片左侧 40x40 题图（object-fit:cover），没有题图不留灰框
- 系统设置第一块改叫「系统标语」；删掉「首页上那一行小字」提示、
  「不是全家的统一口号」说明、「上次结构升级有步骤失败了」整框；
  运行环境删「排错时看这一块」与「亲属连线」那一行（功能与数据未动）
- 公共标签：说明文字全删；列表与编辑合并成一行（色块+名字+N人+箭头+编辑）；
  person_groups 加 color 列（Schema addColumn，老库可升）；点「编辑」弹框
  改名字与颜色、点「完成」提交；下面那个独立编辑列表撤掉。删除挪进弹框
- 个人设置删掉「手动签发接口令牌」整块；settings/api_token 路由保留但挡下提交
  （只删界面会留下知道地址就能用的后门）；令牌只由登录后自动签发，
  设备管理卡保留。apiTokens/apiPlain/apiLabel/apiBase 四个变量一并撤掉

app/HomeCards.php

@@ -43,47 +43,71 @@ final class HomeCards
     public const HEIGHTS = [2, 4, 6, 8];
 
     /**
-     * 卡片注册表：key => [名字, 说明, 默认宽, 默认高, 详情页路由, 按钮文字, 是否有"显示几条"]
+     * 卡片注册表：key => [名字, 说明, 默认宽, 默认高, 详情页路由, 按钮文字, 是否有"显示几条", 来自哪个模块]
      *
      * ⚠️ key 就是模板名（`_card_<key>.php`）与 `data-hc` 的值，三处必须一致。
      * ⚠️ 新加一张卡片只改这里 + 写一个 `_card_xxx.php`：布局设置页、默认布局、
      *    首页渲染全部自动出现（`HomeMods` 那条"新增模块的唯一入口"的同一条经验）。
+     *
+     * 🔴 v63（用户 2026-10-19 第 1 条）：「卡片右上角的按钮，应该跟这个卡片来自于
+     *    什么模块的主题色一样才对。」⇒ 每张卡片登记它**来自哪个模块**（`mod`），
+     *    右上角按钮的底色就取那个模块的主题色（家庭级、可在设置里改，见 `Module::color`）。
+     *    ⚠️ 之前只有日程/任务两张硬编码写死（`in_array($hcKey, ['agenda','tasks'])`），
+     *       那张白名单放在模板里 —— 新加一张带按钮的卡片就忘了加，按钮默默变灰。
+     *       现在登记在这里：**有 route 就该有 mod**，两件事一次改完。
+     *    ⚠️ `mod` 只影响按钮配色，不参与权限/路由；认不出的 key 走 `Module::color` 的兜底。
      */
     public const TYPES = [
         'brief' => [
             'name' => '概述', 'desc' => '问候、日期、农历、天气，以及今天的数字',
-            'w' => 8, 'h' => 2, 'route' => '', 'more' => '', 'n' => 0,
+            'w' => 8, 'h' => 2, 'route' => '', 'more' => '', 'n' => 0, 'mod' => '',
         ],
         'agenda' => [
             'name' => '今天的日程', 'desc' => '按日视图那样排的今天',
             'w' => 4, 'h' => 8, 'route' => 'calendar', 'more' => '更多日程', 'n' => 0,
+            'mod' => 'calendar',
         ],
         'tasks' => [
             'name' => '近期任务', 'desc' => '进行中与待办（含看板与状态）',
             'w' => 4, 'h' => 8, 'route' => 'tasks', 'more' => '全部任务', 'n' => 0,
+            'mod' => 'tasks',
         ],
         'memories' => [
             'name' => '往年的今天', 'desc' => '往年同一天的观影与旅程',
-            'w' => 4, 'h' => 4, 'route' => '', 'more' => '', 'n' => 0,
+            'w' => 4, 'h' => 4, 'route' => '', 'more' => '', 'n' => 0, 'mod' => '',
         ],
         'days' => [
             'name' => '纪念日', 'desc' => '接下来 60 天的纪念日与生日',
             'w' => 4, 'h' => 4, 'route' => 'days', 'more' => '全部纪念日', 'n' => 0,
+            'mod' => 'days',
         ],
         'movies' => [
             'name' => '观影', 'desc' => '最近看过的片子',
             'w' => 4, 'h' => 4, 'route' => 'movies', 'more' => '观影记录', 'n' => 0,
+            'mod' => 'movies',
         ],
         'books' => [
             'name' => '读书', 'desc' => '在读与最近加进书架的书',
             'w' => 4, 'h' => 4, 'route' => 'books', 'more' => '书架', 'n' => 0,
+            'mod' => 'books',
         ],
         'contacts' => [
             'name' => '联系人', 'desc' => '名册里的人，可以选显示几个',
             'w' => 4, 'h' => 4, 'route' => 'people', 'more' => '名册', 'n' => 8,
+            'mod' => 'people',
         ],
     ];
 
+    /**
+     * 这张卡片来自哪个模块（没有归属的返回空串 —— 模板据此决定按钮用不用主题色）。
+     *
+     * ⚠️ 别在模板里再写一份白名单：`mod` 是唯一来源。
+     */
+    public static function module(string $key): string
+    {
+        return (string)(self::TYPES[$key]['mod'] ?? '');
+    }
+
     /**
      * 默认布局（第一次打开首页的人看到的样子）。
      *

app/PersonGroup.php

@@ -24,6 +24,44 @@ final class PersonGroup
     /** 公共分组（管理员维护，全家共用）的 owner_id */
     public const PUBLIC_OWNER = 0;
 
+    /**
+     * 🔴 v63（用户 2026-10-19 第 5 条）：「每个标签增加一个颜色。」
+     *
+     * 色板 = 标签可以挑的颜色。与「模块主题色」（`Module::PRESET_COLORS`）**同一条
+     * 审美规矩**：中低饱和、中低明度 —— 标签是纸面上的一行字，颜色太艳会盖过内容。
+     *
+     * ⚠️ 挑色是"选"不是"填"：界面上只给这些色块（外加一个系统取色器兜底），
+     *    服务端一律按白名单校验（`sanitizeColor`），别让手改表单塞进 CSS。
+     */
+    public const SWATCHES = [
+        '#A84A28', '#8A6B4B', '#4A7C82', '#7A4E8C', '#3F7D5A', '#B0763A',
+        '#5566A8', '#A8574F', '#5C8A48', '#6B5B95', '#9A5C7A', '#3D6B8E',
+    ];
+
+    /** 颜色白名单：只接受 #rrggbb，其余回退到 $fallback（同 `Nav::safeColor` 的做法） */
+    public static function sanitizeColor(string $c, string $fallback): string
+    {
+        return preg_match('/^#[0-9a-fA-F]{6}$/', trim($c)) ? strtolower(trim($c)) : $fallback;
+    }
+
+    /**
+     * 这个标签"实际显示成什么颜色"。
+     *
+     * ⚠️ 没选过颜色（`color` 为 NULL/空）时**按 id 稳定地**从色板里挑一个 ——
+     *    不能用"列表里的第几个"来挑：那样改一次顺序，满屏标签颜色全跳一遍，
+     *    用户会以为自己点错了。用 id 取模则"这个标签一辈子是这个色"，直到用户改它。
+     */
+    public static function swatch(array $g): string
+    {
+        $raw = trim((string)($g['color'] ?? ''));
+        if ($raw !== '') {
+            return self::sanitizeColor($raw, self::SWATCHES[0]);
+        }
+        $id = (int)($g['id'] ?? 0);
+        $n  = count(self::SWATCHES);
+        return self::SWATCHES[$id % $n];
+    }
+
     /** 预置分组的来源在 Schema::DEFAULT_GROUPS（安装与升级共用一份，避免两处漂移） */
 
     /**
@@ -185,7 +223,8 @@ final class PersonGroup
      * @param int $ownerId 0=公共（只有管理员能建，调用方把关）；否则=建给自己的
      * @return array{ok:bool,id?:int,error?:string}
      */
-    public static function add(int $familyId, string $name, int $ownerId = self::PUBLIC_OWNER): array
+    public static function add(int $familyId, string $name, int $ownerId = self::PUBLIC_OWNER,
+                               string $color = ''): array
     {
         $ownerId = max(0, $ownerId);
         $name = trim($name);
@@ -208,19 +247,28 @@ final class PersonGroup
         );
         $st2->execute([$familyId, $ownerId]);
         $max = (int)$st2->fetchColumn();
+        // 🔴 v63：颜色可空 —— 空串存 NULL（= "还没选过"，见 swatch() 的说明）。
+        //    传了颜色就按白名单归一（非法值退回空 = 也当没选过，不写脏数据进库）。
+        $col = trim($color) === '' ? null : self::sanitizeColor($color, '');
         $db->prepare(
-            'INSERT INTO person_groups (family_id, owner_id, name, position, is_builtin)
+            'INSERT INTO person_groups (family_id, owner_id, name, color, position, is_builtin)
-             VALUES (?, ?, ?, ?, 0)'
+             VALUES (?, ?, ?, ?, ?, 0)'
-        )->execute([$familyId, $ownerId, $name, max($max + 10, 80)]);
+        )->execute([$familyId, $ownerId, $name, $col, max($max + 10, 80)]);
         return ['ok' => true, 'id' => (int)$db->lastInsertId()];
     }
 
     /**
      * 改名。$ownerId 用来确认"你改的是你自己那一套里的分组"——
      * 公共分组只有管理员能改（调用方把关），别人的私自分组连管理员也不该动。
+     *
+     * 🔴 v63：顺手支持改颜色（`$color === null` = **不动颜色**）。
+     *    ⚠️ 用 null 而不是空串表示"不改"：空串是"清掉颜色"这个合法意图
+     *       （退回按 id 取默认色），两者必须能区分 —— 这是"部分更新"接口
+     *       最容易写错的一处（传不传那个字段，语义完全不同）。
      * @return array{ok:bool,error?:string}
      */
-    public static function rename(int $familyId, int $id, string $name, int $ownerId): array
+    public static function rename(int $familyId, int $id, string $name, int $ownerId,
+                                  ?string $color = null): array
     {
         $ownerId = max(0, $ownerId);
         $name = trim($name);
@@ -243,12 +291,23 @@ final class PersonGroup
         if ((int)$st->fetchColumn() > 0) {
             return ['ok' => false, 'error' => '已经有叫「' . $name . '」的分组了。'];
         }
+        if ($color === null) {
             $up = $db->prepare(
                 'UPDATE person_groups SET name = ? WHERE family_id = ? AND owner_id = ? AND id = ?'
             );
             $up->execute([$name, $familyId, $ownerId, $id]);
+        } else {
+            $col = trim($color) === '' ? null : self::sanitizeColor($color, '');
+            $up = $db->prepare(
+                'UPDATE person_groups SET name = ?, color = ? WHERE family_id = ? AND owner_id = ? AND id = ?'
+            );
+            $up->execute([$name, $col, $familyId, $ownerId, $id]);
+        }
         if ($up->rowCount() === 0) {
-            return ['ok' => false, 'error' => '找不到这个分组。'];
+            // ⚠️ rowCount()===0 有两种可能：找不到（不可能，上面刚查过）与
+            //    **改的值和原来一模一样**（MySQL 对无变化的 UPDATE 不计数）。
+            //    后者不是错误 —— 用户点了「完成」但什么都没改，不该报"找不到"。
+            return ['ok' => true];
         }
         return ['ok' => true];
     }

app/Schema.php

@@ -375,6 +375,7 @@ CREATE TABLE IF NOT EXISTS `person_groups` (
   `family_id`  INT UNSIGNED NOT NULL,
   `owner_id`   INT UNSIGNED NOT NULL DEFAULT 0 COMMENT '0=全家的公共分组（管理员在系统设置里维护）；否则=这个人的私自分组，只有他自己看得到',
   `name`       VARCHAR(20)  NOT NULL COMMENT '分组名，如「家人」「同事」',
+  `color`      VARCHAR(7)   DEFAULT NULL COMMENT '标签颜色 #rrggbb（v63；NULL=还没选过，界面按顺序取默认色）',
   `position`   INT NOT NULL DEFAULT 100 COMMENT '默认顺序（用户没自定义顺序时按它排）',
   `is_builtin` TINYINT(1) NOT NULL DEFAULT 0 COMMENT '1=安装时预置的分组',
   `created_at` DATETIME NOT NULL DEFAULT CURRENT_TIMESTAMP,
@@ -2390,6 +2391,18 @@ SQL);
             }
         });
 
+        /* 🔴 v63（用户 2026-10-19 第 5 条）：「公共标签这个板块…每个标签增加一个颜色。」
+           ⇒ `person_groups` 加 `color`。
+           ⚠️ 老库没有这一列，**必须**用 addColumn 显式补（CREATE TABLE IF NOT EXISTS
+              对已存在的表什么都不做 —— 这是本文件开头那段的全部意义）。
+           ⚠️ 允许 NULL（不是 NOT NULL DEFAULT）：NULL = "从来没选过颜色"，
+              界面按标签顺序从预设色板里挑一个（`PersonGroup::swatch()`）。
+              给了 DEFAULT 就分不清"用户故意选了那个色"和"系统默认给的"。
+           ⚠️ 位置：`ADD COLUMN ... AFTER \`name\`` —— 列顺序影响不了程序，
+              但影响"人看 information_schema 时的心智"，放在名字后面最自然。 */
+        self::addColumn($db, 'person_groups', 'color',
+            "ADD COLUMN `color` VARCHAR(7) DEFAULT NULL COMMENT '标签颜色 #rrggbb（v63；NULL=还没选过，界面按顺序取默认色）' AFTER `name`");
+
         // 被容错跳过的数据步骤记进设置，系统设置页会把它显出来 ——
         // 不然「升级没跑完」这件事只活在日志里，跟没发生一样。
         if (self::$stepErrors) {

assets/css/app.css

@@ -1423,6 +1423,36 @@ body[class] .semi-datepicker-day-inhover { background-color: color-mix(in srgb,
 .order-move .btn { padding: 2px 8px; line-height: 1.4; }
 .order-move .btn[disabled] { opacity: .35; cursor: default; }
 
+/* ---- 🔴 v63（用户 2026-10-19 第 5 条）：公共标签的颜色 ----
+   一行 = 序号 · 色块 · 名字 · N人 · ▲▼ · 编辑。 */
+.pg-dot {
+  flex: 0 0 auto; width: 12px; height: 12px; border-radius: 50%;
+  box-shadow: inset 0 0 0 1px rgba(0,0,0,.12);   /* 浅色底上也要看得见边界 */
+}
+/* 色板（弹框里）：点一下就选。⚠️ 选中态用 `is-on` 描一圈，
+   不与 `.is-on` 的通用含义冲突（本页没有别的 .is-on）。 */
+.pg-swatches { display: flex; flex-wrap: wrap; align-items: center; gap: 8px; margin-top: 6px; }
+.pg-sw {
+  width: 26px; height: 26px; border-radius: 7px; cursor: pointer;
+  border: 2px solid transparent; padding: 0;
+  box-shadow: inset 0 0 0 1px rgba(0,0,0,.12);
+}
+.pg-sw.is-on { border-color: var(--ink); }
+.pg-sw:hover { transform: scale(1.06); }
+/* 自定义取色器：与色块同尺寸，外观上就是色板里的第 13 格 */
+.pg-sw-custom {
+  width: 26px; height: 26px; border-radius: 7px; overflow: hidden; cursor: pointer;
+  box-shadow: inset 0 0 0 1px rgba(0,0,0,.12);
+  display: inline-flex;
+}
+.pg-sw-custom input[type="color"] {
+  width: 40px; height: 40px; margin: -7px; border: 0; padding: 0; cursor: pointer; background: none;
+}
+/* 新建时那个颜色下拉（窄屏缩一半，别把"加一个"按钮挤到下一行） */
+.pg-swatch-pick { flex: 0 0 auto; max-width: 96px; }
+/* 弹框底栏：删除在左、取消/完成在右 —— 与"危险动作离确认按钮远一点"的通行做法一致 */
+.rm-foot-gap { flex: 1 1 auto; }
+
 /* ---------------- 个人设置：关系分类管理 ---------------- */
 .inline-form { display: flex; gap: 8px; align-items: center; flex-wrap: wrap; }
 .inline-form .input { flex: 1 1 200px; max-width: 320px; }
@@ -4520,7 +4550,11 @@ button.btn, a.btn, summary.btn, .seg-btn, .icon-btn, .rv-act-btn, .cs-btn, .bf-b
    ⚠️ 白字压浅色本的兜底：加一层极轻的 text-shadow（不加深色罩，保持本色）。 */
 .ag-ev {
   position: absolute; left: 46px; right: 4px;
-  display: block; overflow: hidden; padding: 3px 7px;
+  /* 🔴 v63（用户 2026-10-19 第 2 条）：日历本要显示在色块**右侧** ⇒ 本体必须是
+     一行弹性容器。⚠️ 纵向排列时（`flex-direction: column`）`block` 子元素会各占一行，
+     日历本必然掉到第二行；色块很矮时就整条看不见。 */
+  display: flex; align-items: center; gap: 6px;
+  overflow: hidden; padding: 3px 7px;
   background: var(--brand); border-radius: 4px;
   font-size: 12px; line-height: 1.35; color: #fff;
   text-decoration: none; box-sizing: border-box;
@@ -4528,10 +4562,23 @@ button.btn, a.btn, summary.btn, .seg-btn, .icon-btn, .rv-act-btn, .cs-btn, .bf-b
   text-shadow: 0 1px 1px rgba(0,0,0,.18);
 }
 .ag-ev:hover { text-decoration: none; filter: brightness(1.08); z-index: 2; }
-.ag-ev .ag-ev-t { display: block; font-weight: 600; font-variant-numeric: tabular-nums; margin-right: 4px; float: left; }
+/* 「时间 + 标题」这一坨占满剩余宽度；`min-width:0` 是标题能被省略号截断的前提
-.ag-ev .ag-ev-w { display: block; overflow: hidden; text-overflow: ellipsis; white-space: nowrap; font-weight: 600; }
+   （没有它，flex 子项按内容撑宽 ⇒ 整行溢出、日历本被挤出可视区）。 */
-/* 日历本名：色块右下角的极淡小字（色块面积小，不加大徽标） */
+.ag-ev .ag-ev-main {
-.ag-ev .ag-ev-cal { display: block; font-size: 10.5px; opacity: .82; overflow: hidden; text-overflow: ellipsis; white-space: nowrap; }
+  display: flex; align-items: baseline; gap: 4px;
+  flex: 1 1 auto; min-width: 0;
+}
+.ag-ev .ag-ev-t { flex: 0 0 auto; font-weight: 600; font-variant-numeric: tabular-nums; }
+.ag-ev .ag-ev-w { flex: 0 1 auto; min-width: 0; overflow: hidden; text-overflow: ellipsis; white-space: nowrap; font-weight: 600; }
+/* 日历本名：色块**右侧**的极淡小字（色块面积小，不加大徽标）。
+   ⚠️ 它 `flex: 0 0 auto`（**不参与收缩**）：用户要的就是"看得见日历本" ——
+      让它跟着一起缩，色块一窄就又没了。改为**标题**让步（`.ag-ev-main` 可缩到 0）。
+      同时给它 `max-width: 45%` 兜底：日历本名过长时自己截断，别把标题吃光。 */
+.ag-ev .ag-ev-cal {
+  flex: 0 0 auto; font-size: 10.5px; opacity: .82;
+  max-width: 45%;
+  overflow: hidden; text-overflow: ellipsis; white-space: nowrap;
+}
 
 /* ---- 任务行：标题 + 状态 + **看板名** + 截止 ---- */
 .tk-list { display: flex; flex-direction: column; }
@@ -6090,15 +6137,26 @@ h5.md-h, h6.md-h { font-size: 14px; }
   pointer-events: auto; cursor: pointer;
 }
 .trip-pin-card {
+  display: flex; align-items: center; gap: 8px;   /* 🔴 v63：题图在左、文字在右 */
   background: var(--surface); border: 1px solid var(--line);
   border-left: 3px solid var(--brand);
   border-radius: 8px; padding: 6px 10px;
   box-shadow: 0 2px 8px rgba(0,0,0,.10);
-  max-width: 190px; white-space: nowrap;
+  max-width: 220px;
 }
+/* 🔴 v63（用户 2026-10-19 第 3 条）：旅程题图。
+   ⚠️ `object-fit: cover` 必须有：题图原图长宽比五花八门，默认 `fill` 会把人拉扁。
+   ⚠️ 有题图时卡片最多 220px（原来是 190px），文字那一块要 `min-width:0`
+      才能让 `.trip-pin-title` 的省略号真正生效（否则长标题把卡片撑破）。 */
+.trip-pin-thumb {
+  flex: 0 0 auto; width: 40px; height: 40px;
+  border-radius: 5px; overflow: hidden; background: var(--line-2);
+}
+.trip-pin-thumb img { display: block; width: 100%; height: 100%; object-fit: cover; }
+.trip-pin-body { display: block; min-width: 0; }
 .trip-pin-title {
   font-size: 13px; font-weight: 600; color: var(--ink);
-  overflow: hidden; text-overflow: ellipsis;
+  overflow: hidden; text-overflow: ellipsis; white-space: nowrap;
 }
 .trip-pin-sub { font-size: 11.5px; color: var(--muted); margin-top: 1px; }
 .trip-pin:hover .trip-pin-card { border-color: var(--brand); box-shadow: 0 4px 14px rgba(0,0,0,.16); }

assets/js/trip_map.js

@@ -76,12 +76,21 @@
         dx = Math.cos(ang) * rad;
         dy = Math.sin(ang) * rad;
       }
+      /* 🔴 v63（用户 2026-10-19 第 3 条）：「旅程地图模式，应该显示旅程的题图。」
+         ⇒ 卡片左侧一枚 40×40 的题图（`trip_details.cover_key` → 服务端算好的 URL，
+           见 _map_body.php）。没有题图就**只显示文字**，不摆灰色占位方块
+           （地图上每枚卡片都带一个灰框，整张图会显得脏）。 */
+      var thumb = p.cover
+        ? '<span class="trip-pin-thumb"><img src="' + esc(p.cover) + '" alt="" loading="lazy"></span>'
+        : '';
       var html = '<div class="trip-pin" style="left:' + (C + dx) + 'px;top:' + (C + dy) + 'px;">'
                + '<div class="trip-pin-card">'
+               + thumb
+               + '<span class="trip-pin-body">'
                + '<div class="trip-pin-title">' + esc(p.title) + '</div>'
                + (p.when ? '<div class="trip-pin-sub">' + esc(p.when) + '</div>' : '')
                + (p.city ? '<div class="trip-pin-sub">📍 ' + esc(p.city) + '</div>' : '')
-               + '</div></div>';
+               + '</span></div></div>';
       var mk = new AMap.Marker({
         // ⚠️ 必须是 [lng, lat] 数组（见文件头的说明）
         position: [p.lng, p.lat],

index.php

@@ -313,17 +313,15 @@ function render_me_settings(array $person, array $errors = []): void
         // 通讯录同步范围要和名册页**完全一致**（用户 2026-10-06 第 22 批确认）：
         // 名册页看到谁就同步谁。这里把人数带过去，用户当场就能对上。
         'davRosterN'  => PersonRoster::countFor($familyId, $me),
-        /* 🔴 v44（用户 2026-10-12 第 6 条）：移动端 API 令牌。
+        /* 🔴 v63（用户 2026-10-19 第 7 条）：`apiTokens` / `apiPlain` / `apiLabel` / `apiBase`
-           ⚠️ 明文同样只在**一次性会话槽位**里取一次（`api_plain`），
+           四个变量**随"手动签发令牌"那块一起撤掉** —— 界面已经不渲染它们，
-              取完后面 unset —— 与 DAV 口令同一条纪律。 */
+           还每次进设置页查一遍令牌表只是白花钱（`listFor` 是一次真实查询）。
-        'apiTokens'   => \App\ApiToken::listFor($me),
+           ⚠️ 但 `api_plain` 那两个会话槽位**仍然要 unset**（见本函数尾部）：
-        'apiPlain'    => (string)($_SESSION['api_plain'] ?? ''),
+              用户可能在升级前那一刻生成过令牌、明文还挂在会话里，
-        'apiLabel'    => (string)($_SESSION['api_plain_label'] ?? ''),
+              不清掉它就等于这页永远留着一份能看的明文。 */
-        'apiBase'     => rtrim((string)fb_config('base_url', ''), '/'),
         /* 🔴 v57（用户 2026-10-17）：「在个人设置里面有这个设备管理」。
            ⚠️ 这里传的是**按设备聚合**的列表（`listDevices`），不是令牌清单 ——
-              同一台手机重登过 5 次，网页上只该出现 1 行。
+              同一台手机重登过 5 次，网页上只该出现 1 行。 */
-              与上面 `apiTokens`（原始令牌行、只给"手动签发/吊销"用）不是一回事。 */
         'devices'     => \App\ApiToken::listDevices($me),
         'deviceMax'   => \App\ApiToken::MAX_DEVICES,
         'deviceTtl'   => \App\ApiToken::TTL_HOURS,
@@ -1925,7 +1923,12 @@ switch ($r) {
         } else {
             $owner = (int)Auth::personId();
         }
-        $res = PersonGroup::add((int)Auth::familyId(), (string)($_POST['name'] ?? ''), $owner);
+        // 🔴 v63：颜色可随新建一起给（`settings/groups/add` 的公共标签加色块选择）。
+        //    ⚠️ 没传 `color` 这个键 = 不设颜色（存 NULL，界面按 id 取默认色）；
+        //       传了空值 = 用户主动选了"不要颜色"⇒ 同样存 NULL。
+        //       两种都落到同一个值上，所以这里不用像 rename 那样区分 null / ''。
+        $res = PersonGroup::add((int)Auth::familyId(), (string)($_POST['name'] ?? ''), $owner,
+            (string)($_POST['color'] ?? ''));
         flash($res['ok'] ? 'ok' : 'err', $res['ok']
             ? '已加上分组「' . trim((string)($_POST['name'] ?? '')) . '」。'
             : (string)($res['error'] ?? '加不上。'));
@@ -1946,8 +1949,16 @@ switch ($r) {
         } else {
             $owner = (int)Auth::personId();
         }
+        /* 🔴 v63（用户 2026-10-19 第 5 条）：改名与改颜色走**同一个动作**
+           （「每个标签增加一个颜色。如果要编辑，就点击这个标签后面的编辑按钮，
+             然后弹出一个框，编辑后点击完成就行了」）。
+           ⚠️ 用 `array_key_exists` 判断"表单里到底有没有这个字段"，
+              不能用 `!== ''` —— 空值是一个**合法输入**（= 清掉颜色），
+              用 `!== ''` 就再也清不掉了。 */
+        $hasColor = array_key_exists('color', $_POST);
+        $newColor = $hasColor ? (string)$_POST['color'] : null;
         $res = PersonGroup::rename((int)Auth::familyId(), (int)($_POST['id'] ?? 0),
-            (string)($_POST['name'] ?? ''), $owner);
+            (string)($_POST['name'] ?? ''), $owner, $newColor);
         flash($res['ok'] ? 'ok' : 'err', $res['ok']
             ? '分组名已改。'
             : (string)($res['error'] ?? '改不了。'));
@@ -5158,17 +5169,28 @@ $want = array_keys($want);
 
     /* 🔴 v44（用户 2026-10-12 第 6 条）：移动端 API 令牌的**签发 / 吊销**。
        与 DAV 那两条同一个形态（明文进一次性会话槽位、只显示一次）。 */
+    /* 🔴🔴 v63（用户 2026-10-19 第 7 条）：**手动签发令牌这条入口整条下线**。
+       用户原话：「个人设置中：手动签发接口令牌，这一部分删除，不允许用户修改，
+                 不允许用户手动签发令牌，只能通过登录后，系统自动签发令牌。」
+
+       ⇒ `settings/api_token`（生成）**不再接受提交**：界面上那块已经删了；
+         若只删界面不删路由，它就变成一个"找不到按钮、但知道地址就能用"的后门 ——
+         那种入口比显式按钮危险。这里直接 302 回个人设置并给一句明确的话。
+       ⚠️ **`settings/api_revoke` 保留**：踢掉设备是用户该有的能力，
+          「设备管理」卡里那两个动作（移除一台 / 退出全部设备）还在用它。
+          换句话说：**签发只自动、吊销仍可用**，这条线才是用户要的形态。
+       ⚠️ 令牌机制本身（ApiToken 类、Bearer 校验、设备聚合）一个字没改。 */
     case 'settings/api_token':
+        Auth::requireLogin();
+        flash('err', '令牌由登录后自动签发，不能手动生成。要清掉某台设备，去「设备管理」移除它。');
+        redirect('settings/me');
+        break;
+
     case 'settings/api_revoke':
         $me = (int)Auth::personId();
         Auth::requireWrite();
         csrf_check();
-        if ($r === 'settings/api_token') {
+        if ((int)($_POST['id'] ?? 0) > 0) {
-            $label = trim((string)($_POST['label'] ?? ''));
-            $_SESSION['api_plain']       = \App\ApiToken::issue($me, $label);
-            $_SESSION['api_plain_label'] = $label;
-            flash('ok', 'API 令牌已生成（只显示这一次，请立刻复制到 App 里）。');
-        } elseif ((int)($_POST['id'] ?? 0) > 0) {
             \App\ApiToken::revoke($me, (int)$_POST['id']);
             flash('ok', '这枚 API 令牌已吊销。');
         } else {
@@ -5176,7 +5198,7 @@ $want = array_keys($want);
             unset($_SESSION['api_plain'], $_SESSION['api_plain_label']);
             flash('ok', '全部 API 令牌已吊销，所有 App 都需要重新登录。');
         }
-        redirect('settings/me', [], 'api');
+        redirect('settings/me', [], 'devices');
         break;
 
     /* 🔴 v57（用户 2026-10-17）：「设备管理」——把某一台设备远程退掉。

templates/home.php

@@ -144,10 +144,12 @@
             continue;                       // 注册了但还没写模板：跳过，不要白屏
         }
         $hcMore = (string)($hcDef['route'] ?? '') !== '' ? url((string)$hcDef['route']) : '';
-        // 日程/任务这两个按钮沿用模块主题色（v28 第 2、3 条）
+        /* 🔴 v63（用户 2026-10-19 第 1 条）：「卡片右上角的按钮，应该跟这个卡片
-        $hcColor = in_array($hcKey, ['agenda', 'tasks'], true)
+           来自于什么模块的主题色一样才对。」
-            ? \App\Module::color($hcKey === 'agenda' ? 'calendar' : 'tasks', (int)\App\Auth::familyId())
+           ⇒ 颜色从**卡片登记表**取（`HomeCards::module()`），不再在这里硬编码白名单。
-            : '';
+           日程卡来自 calendar、任务卡来自 tasks、观影来自 movies…… 一张不漏。 */
+        $hcMod   = \App\HomeCards::module($hcKey);
+        $hcColor = $hcMod !== '' ? \App\Module::color($hcMod, (int)\App\Auth::familyId()) : '';
         ?>
         <section class="card hc-card hc-w<?= (int)$card['w'] ?> hc-h<?= (int)$card['h'] ?>"
                  data-hc="<?= e($hcKey) ?>" id="homeCard-<?= e($hcKey) ?>">

templates/home/_card_agenda.php

@@ -147,8 +147,16 @@ unset($evRef);
                     width: calc(<?= (float)($ev['width'] ?? 100) ?>% - 4px);"
              title="<?= e((string)$ev['title']) ?>"
              data-cal="<?= (int)$ev['cal'] ?>">
+            <?php /* 🔴 v63（用户 2026-10-19 第 2 条）：「首页日程显示，把所属的日历本，
+               放在色块的右侧。」⇒ 时间与标题包进 `.ag-ev-main`（占据剩余宽度、可收缩），
+               日历本作为它右边的**兄弟**。
+               ⚠️ 原来是「时间 float:left + 标题 block + 日历本 block」三板斧：日历本
+                  `display:block` 必然被顶到第二行，色块一矮就完全看不见。改成弹性行
+                  后，日历本与标题同一行、永远在右。 */ ?>
+            <span class="ag-ev-main">
               <span class="ag-ev-t"><?= e((string)$ev['time']) ?></span>
               <span class="ag-ev-w"><?= e((string)$ev['title']) ?></span>
+            </span>
             <span class="ag-ev-cal"><?= e((string)$ev['calname']) ?></span>
           </a>
         <?php endforeach; ?>

templates/settings.php

@@ -14,16 +14,20 @@
 ?>
 <form method="post" action="<?= e(url('settings/update')) ?>" class="card card-pad">
   <?= csrf_field() ?>
-  <h2 class="section-title">家庭 <span class="hint">首页上那一行小字</span></h2>
+  <?php /* 🔴 v63（用户 2026-10-19 第 4 条）：
+     「在系统的设置页面，第一个模块家庭，首页上那一行小字，这个就不要了，
+       上面直接它的标题就是系统 slogan，或者叫系统标语。
+       下面，所以这一句兜底不是全家的统一口号，这句话给去掉。」
+     ⇒ ① 去掉 hint「首页上那一行小字」；② 标题改叫「系统标语」；
+        ③ 删掉"兜底不是全家统一口号"那段说明。
+     ⚠️ 口径没变：`settings.motto` 仍是**系统级兜底**（个人没写自己的 slogan
+        时才用它），只是不再在界面上解释这套优先级 —— 属于不动数据、只收文案。 */ ?>
+  <h2 class="section-title">系统标语</h2>
   <div class="form-grid">
     <div class="field full">
-      <label for="motto">系统 slogan</label>
+      <label for="motto">系统标语</label>
       <input class="input" id="motto" name="motto" value="<?= e($family['motto'] ?? '') ?>"
              placeholder="例如：一本用岁月写成的家谱">
-      <span class="tip">
-        每个人都可以在「我的资料」里写**自己的一句**，有的话就显示他自己的；
-        <b>没写的人才用这里的这句</b>。所以这是一句"兜底"，不是全家的统一口号。
-      </span>
     </div>
     <?php /* ⚠️ 天气的坐标输入框**从这里撤了**（用户 2026-10-03 第 1 条）。
          原话是「让用户在个人设置中填写自己的城市」——
@@ -35,16 +39,6 @@
   </div>
 </form>
 
-<?php if (($upgradeWarn ?? '') !== ''): ?>
-  <div class="flash" style="margin-top:16px">
-    <div class="flash-item err">
-      <b>上次结构升级有步骤失败了</b>（其余步骤已经跑完，站点可用）：<br>
-      <?= e((string)$upgradeWarn) ?><br>
-      <span class="muted small">修好之后可以清掉这条提示。</span>
-    </div>
-  </div>
-<?php endif; ?>
-
 <!-- ==================== 公共标签 ==================== -->
 <?php
 /* 🔴 v54（用户 2026-10-16 第 2 条）：这块从「公共分组」改口径为「公共标签」。
@@ -52,7 +46,23 @@
    ⇒ 这里维护的是**公共标签词表**：名册里给成员打标签时，这些词会出现在候选里
       （见 `App\PersonTag::choices()`）。表名仍叫 person_groups（见 _person_groups.php
       的说明：改名要背着 PersonGroup 类与其它会话正在改的 App-API 一起动，不划算），
-      但界面上一律说"标签"。 */
+      但界面上一律说"标签"。
+
+   🔴🔴 v63（用户 2026-10-19 第 5 条）整段重做。用户原话：
+     「公共标签这个板块，提示全部删除。编辑和列表放一起，每个标签增加一个颜色。
+       如果要编辑，就点击这个标签后面的编辑按钮，然后弹出一个框，编辑后点击完成就行了。
+       下面的编辑列表不要了。」
+   ⇒ 三件事：
+     ① **说明文字全删**（那句"这里维护的是公共标签…"整段不留）；
+     ② **列表与编辑合并成一处**：一行一个标签 = 色块 + 名字 + N 人 + ▲▼ + 「编辑」；
+        （原来是"上面一个只读列表 + 下面另一个改名列表"，同一个东西摆两遍）
+     ③ **颜色**：每行前面一个色块（`PersonGroup::swatch()`），
+        点行尾「编辑」弹出对话框改**名字 + 颜色**，点「完成」提交。
+   ⚠️ 弹框**全页一份**（`#pgEditModal`），行上只放 `data-pg-*` 数据：
+      一行一个 `<form>` + `<input type="color">` 会让页面 DOM 翻几倍
+      （本项目在名册页踩过：2369 个 form 把浏览器拖卡）。
+   ⚠️ 表单里留一个原生「完成」按钮并**不依赖 JS 才能提交**：脚本没跑时
+      行上的「编辑」按钮就是一个 `<a>` 到锚点，弹框默认可见（`<noscript>` 兜底）。 */
 $pubGroups = $pubGroups ?? [];
 $pubCounts = $pubCounts ?? [];
 $pubTotal  = count($pubGroups);
@@ -62,22 +72,15 @@ $pubTotal  = count($pubGroups);
     公共标签
     <span class="hint">全家人共用的一套</span>
   </h2>
-  <p class="small muted" style="margin:0 0 16px">
-    这里维护的是<b>公共标签</b> —— 建一次，全家每个人给名册成员打标签时都能拿来用。
-    <br>
-    每个人还可以在「名册 → 设置 → 名册标签」里<b>再加只给自己看的标签</b>，
-    那部分不在这儿、也不会影响别人。挪顺序用 ▲ ▼（▲▼ 调的是"全家的默认顺序"，
-    各人仍可在名册设置里改成自己习惯的顺序）。
-    <br>
-    删掉一个标签<b>只是从候选里去掉这个词</b>：已经打在别人身上的标签不受影响
-    （标签是各人身上记着的词，不是引用）。
-  </p>
 
   <?php if ($pubGroups): ?>
-    <ol class="order-list">
+    <ol class="order-list pg-list">
       <?php foreach ($pubGroups as $i => $g): $gid = (int)$g['id']; ?>
         <li class="order-row">
           <span class="order-no"><?= $i + 1 ?></span>
+          <?php /* 色块：显示这个标签"现在是什么颜色"（没选过就按 id 从色板取，见 swatch）。 */ ?>
+          <span class="pg-dot" style="background:<?= e(\App\PersonGroup::swatch($g)) ?>"
+                aria-hidden="true"></span>
           <span class="order-name"><?= e((string)$g['name']) ?></span>
           <span class="order-count"><?= (int)($pubCounts[$gid] ?? 0) ?> 人</span>
           <form method="post" action="<?= e(url('settings/groups/move')) ?>" class="order-move">
@@ -89,9 +92,17 @@ $pubTotal  = count($pubGroups);
             <button class="btn btn-ghost btn-sm" type="submit" name="dir" value="down"
                     title="下移一个" <?= $i === $pubTotal - 1 ? 'disabled' : '' ?>>▼</button>
           </form>
+          <?php /* 「编辑」= 打开弹框（JS）。`href` 指到本卡片的锚点，脚本没跑时
+                   点了至少跳回这里，不会"点了没反应"。 */ ?>
+          <button type="button" class="btn btn-ghost btn-sm js-pg-edit"
+                  data-pg-id="<?= $gid ?>"
+                  data-pg-name="<?= e((string)$g['name']) ?>"
+                  data-pg-color="<?= e(\App\PersonGroup::swatch($g)) ?>">编辑</button>
         </li>
       <?php endforeach; ?>
     </ol>
+  <?php else: ?>
+    <p class="small muted" style="margin:0 0 14px">还没有公共标签。加一个吧。</p>
   <?php endif; ?>
 
   <form method="post" action="<?= e(url('settings/groups/add')) ?>" class="inline-form" style="margin-top:16px">
@@ -99,39 +110,150 @@ $pubTotal  = count($pubGroups);
     <input type="hidden" name="scope" value="public">
     <label class="sr-only" for="newPubGroup">新标签名</label>
     <input class="input" id="newPubGroup" name="name" maxlength="20" placeholder="例如：邻居、亲家、老同事">
+    <?php /* 新建时也能顺手挑个颜色（色板与弹框里同一套，见 PersonGroup::SWATCHES）。 */ ?>
+    <select class="select pg-swatch-pick" name="color" aria-label="颜色">
+      <?php foreach (\App\PersonGroup::SWATCHES as $ci => $cc): ?>
+        <option value="<?= e($cc) ?>"<?= $ci === 0 ? ' selected' : '' ?>><?= e($cc) ?></option>
+      <?php endforeach; ?>
+    </select>
     <button class="btn btn-sm" type="submit">加一个公共标签</button>
   </form>
-
-  <?php if ($pubGroups): ?>
-    <ul class="group-manage" style="margin-top:14px">
-      <?php foreach ($pubGroups as $g): $gid = (int)$g['id']; ?>
-        <li class="group-manage-row">
-          <form method="post" action="<?= e(url('settings/groups/rename')) ?>" class="group-rename">
-            <?= csrf_field() ?>
-            <input type="hidden" name="id" value="<?= $gid ?>">
-            <input type="hidden" name="scope" value="public">
-            <label class="sr-only" for="pgname<?= $gid ?>">标签名</label>
-            <input class="input" id="pgname<?= $gid ?>" name="name" maxlength="20"
-                   value="<?= e((string)$g['name']) ?>">
-            <button class="btn btn-ghost btn-sm" type="submit">改名</button>
-          </form>
-          <span class="group-count muted small"><?= (int)($pubCounts[$gid] ?? 0) ?> 人</span>
-          <details class="del-wrap">
-            <summary class="btn btn-ghost btn-sm">删除</summary>
-            <form method="post" action="<?= e(url('settings/groups/delete')) ?>" class="del-confirm">
-              <?= csrf_field() ?>
-              <input type="hidden" name="id" value="<?= $gid ?>">
-              <input type="hidden" name="scope" value="public">
-              <span class="small muted">这组的人会变成「未分类」，确定？</span>
-              <button class="btn btn-ghost btn-sm danger" type="submit">确认删除</button>
-            </form>
-          </details>
-        </li>
-      <?php endforeach; ?>
-    </ul>
-  <?php endif; ?>
 </div>
 
+<?php /* ==================== 公共标签：编辑弹框（全页一份）====================
+   用户第 5 条原话：「如果要编辑，就点击这个标签后面的编辑按钮，然后弹出一个框，
+   编辑后点击完成就行了。」
+   ⚠️ 结构与名册那个标签弹框（`.rm-modal`）完全同形：fixed 遮罩 + 居中面板，
+      点遮罩 / ✕ / Esc 都能关。复用同一套 CSS，不另造一套弹框外壳。 */ ?>
+<div class="rm-modal" id="pgEditModal" hidden>
+  <div class="rm-mask" data-pg-close></div>
+  <div class="rm-panel" role="dialog" aria-modal="true" aria-label="编辑标签">
+    <div class="rm-head"><b>编辑标签</b>
+      <button type="button" class="rm-x" data-pg-close aria-label="关闭">✕</button></div>
+    <form method="post" action="<?= e(url('settings/groups/rename')) ?>" class="rm-body" id="pgEditForm">
+      <?= csrf_field() ?>
+      <input type="hidden" name="scope" value="public">
+      <input type="hidden" name="id" id="pgEditId" value="">
+      <div class="field">
+        <label for="pgEditName">标签名</label>
+        <input class="input" id="pgEditName" name="name" maxlength="20" required>
+      </div>
+      <?php /* 颜色：色板（点一下就选）+ 一个取色器兜底（想用自定义色时）。
+               两个控件写的是**同一个** `name="color"`，但取色器那份是 JS 同步的
+               只读镜像 —— 见下面的脚本说明。 */ ?>
+      <div class="field">
+        <label>颜色</label>
+        <div class="pg-swatches" id="pgEditSwatches">
+          <?php foreach (\App\PersonGroup::SWATCHES as $cc): ?>
+            <button type="button" class="pg-sw" data-pg-color="<?= e($cc) ?>"
+                    style="background:<?= e($cc) ?>" aria-label="选这个颜色"></button>
+          <?php endforeach; ?>
+          <label class="pg-sw-custom" title="自定义颜色">
+            <input type="color" id="pgEditColorPick" value="<?= e(\App\PersonGroup::SWATCHES[0]) ?>">
+          </label>
+        </div>
+        <input type="hidden" name="color" id="pgEditColor" value="">
+      </div>
+    </form>
+    <div class="rm-foot">
+      <?php /* 🔴 删除**挪进弹框**：原来它在下面那个"编辑列表"里，而用户要求
+               把那块整个撤掉 —— 功能不能跟着一起消失，改名/改色/删除
+               本来就是"管理一个标签"的三件事，放一处最自然。
+         ⚠️ 这里用**独立的第二张表单**（不是提交 pgEditForm）：删与改是两条
+            互斥路径，共用一个 form 会导致"点删除也把新名字提交一遍"。
+         ⚠️ 仍要 `confirm` 一次：删除会把挂着它的人变成「未分类」，
+            这是弹框里唯一一个有副作用的动作。 */ ?>
+      <form method="post" action="<?= e(url('settings/groups/delete')) ?>" id="pgDelForm"
+            onsubmit="return confirm('删掉这个标签？挂着它的人会变成「未分类」。');">
+        <?= csrf_field() ?>
+        <input type="hidden" name="scope" value="public">
+        <input type="hidden" name="id" id="pgDelId" value="">
+      </form>
+      <button type="submit" class="btn btn-ghost danger" form="pgDelForm">删除</button>
+      <span class="rm-foot-gap"></span>
+      <button type="button" class="btn btn-ghost" data-pg-close>取消</button>
+      <button type="submit" class="btn" form="pgEditForm">完成</button>
+    </div>
+  </div>
+</div>
+
+<script>
+/* 🔴 v63：公共标签的「编辑」弹框。
+   ⚠️ 写在一个 IIFE 里并**只在元素存在时才跑** —— 这一页可能因为权限/升级
+      而少渲染某几块（比如表还没迁移完），别让脚本在别处抛错。
+   ⚠️ 颜色有两个来源（色板按钮 / 取色器），最终都写进 `#pgEditColor`
+      这个 hidden 字段：**只提交一个** `name="color"`，服务端就不用猜
+      "到底以哪个为准"（两个同名控件同时提交时，PHP 取最后一个 —— 那是隐式行为，
+      不该依赖）。 */
+(function () {
+  var modal = document.getElementById('pgEditModal');
+  if (!modal || !document.querySelector('.js-pg-edit')) { return; }
+
+  var form   = document.getElementById('pgEditForm');
+  var fId    = document.getElementById('pgEditId');
+  var fName  = document.getElementById('pgEditName');
+  var fColor = document.getElementById('pgEditColor');
+  var picker = document.getElementById('pgEditColorPick');
+  var swBox  = document.getElementById('pgEditSwatches');
+  var delId  = document.getElementById('pgDelId');
+
+  function markOn(color) {
+    var list = swBox ? swBox.querySelectorAll('.pg-sw') : [];
+    for (var i = 0; i < list.length; i++) {
+      var on = (list[i].getAttribute('data-pg-color') || '').toLowerCase() === color.toLowerCase();
+      list[i].classList.toggle('is-on', on);
+    }
+  }
+
+  function setColor(color) {
+    fColor.value = color || '';
+    if (picker) { picker.value = color || '#a84a28'; }
+    markOn(color || '');
+  }
+
+  function open(btn) {
+    var gid = btn.getAttribute('data-pg-id') || '';
+    fId.value   = gid;
+    fName.value = btn.getAttribute('data-pg-name') || '';
+    setColor(btn.getAttribute('data-pg-color') || '');
+    // ⚠️ 删除表单里的 id 也要跟着灌 —— 忘了这一句，删除按钮会提交**上一次编辑过**的
+    //    那个标签的 id（或者空 id），症状是"删掉的不是我点的那个"。
+    if (delId) { delId.value = gid; }
+    modal.hidden = false;
+    fName.focus();
+    fName.select();
+  }
+
+  function close() { modal.hidden = true; }
+
+  // 行上的「编辑」
+  var btns = document.querySelectorAll('.js-pg-edit');
+  for (var i = 0; i < btns.length; i++) {
+    btns[i].addEventListener('click', function () { open(this); });
+  }
+  // 关闭：遮罩 / ✕ / 取消
+  var closers = modal.querySelectorAll('[data-pg-close]');
+  for (var j = 0; j < closers.length; j++) {
+    closers[j].addEventListener('click', close);
+  }
+  // Esc 关（与全站其它弹框一致）
+  document.addEventListener('keydown', function (e) {
+    if (!modal.hidden && (e.key === 'Escape' || e.keyCode === 27)) { close(); }
+  });
+  // 色板点击
+  if (swBox) {
+    swBox.addEventListener('click', function (e) {
+      var b = e.target && e.target.closest ? e.target.closest('.pg-sw') : null;
+      if (b) { setColor(b.getAttribute('data-pg-color') || ''); }
+    });
+  }
+  // 取色器改了就同步
+  if (picker) {
+    picker.addEventListener('input', function () { setColor(picker.value); });
+  }
+})();
+</script>
+
 <!-- ==================== 附件存储 ==================== -->
 <form method="post" action="<?= e(url('settings/storage')) ?>" class="card card-pad" style="margin-top:20px">
   <?= csrf_field() ?>
@@ -313,7 +435,13 @@ $pubTotal  = count($pubGroups);
 
 <!-- ==================== 运行环境 ==================== -->
 <div class="card card-pad" style="margin-top:20px">
-  <h2 class="section-title">运行环境 <span class="hint">排错时看这一块</span></h2>
+  <?php /* 🔴 v63（用户 2026-10-19 第 6 条）：
+     「运行环境后面的提示：排错时看这一块，删除。亲属连线，删除。」
+     ⇒ ① 去掉 hint「排错时看这一块」；② 删掉「亲属连线 N 条」那行。
+     ⚠️ 亲属连线的**数据与功能一点没动**（`person_relations` 表、建边解边、
+        家谱全在），只是不再在运行环境里报一个数字 —— 那个数对排错没有帮助，
+        反而会和"名册里看到的连线"打架（口径不同）。 */ ?>
+  <h2 class="section-title">运行环境</h2>
   <dl class="kv">
     <div class="kv-row"><dt>PHP</dt><dd><?= e(PHP_VERSION) ?></dd></div>
     <div class="kv-row"><dt>数据库</dt><dd><?= e($dbVersion) ?></dd></div>
@@ -330,10 +458,6 @@ $pubTotal  = count($pubGroups);
       <dt>附件出口</dt>
       <dd>统一走 media.php 代理 <span class="muted small">（本地与云端同一形态，需登录才能读）</span></dd>
     </div>
-    <div class="kv-row">
-      <dt>亲属连线</dt>
-      <dd><?= (int)$relCount ?> 条</dd>
-    </div>
     <div class="kv-row">
       <dt>账号</dt>
       <dd>

templates/settings/me.php

@@ -246,87 +246,22 @@ $rosterCount = $rosterCount ?? 0;
   <?php endif; ?>
 </div>
 
-<div class="card card-pad" id="api" style="margin-top:20px">
+<?php /* ==================== 手动签发接口令牌：v63 已整块删除 ====================
-  <h2 class="section-title">
+   🔴 v63（用户 2026-10-19 第 7 条）用户原话：
-    手动签发接口令牌
+   「个人设置中：手动签发接口令牌，这一部分删除，不允许用户修改，
-    <span class="hint">第三方脚本 / 调试用；App 正常登录**不需要**这里</span>
+     不允许用户手动签发令牌，只能通过登录后，系统自动签发令牌。」
-  </h2>
-  <p class="small muted" style="margin:0 0 14px">
-    接口地址前缀 <span class="mono"><b><?= e((string)$apiBase) ?>/api/v1/</b></span>，
-    请求头带 <span class="mono">Authorization: Bearer &lt;令牌&gt;</span>。
-    先调 <span class="mono">GET <?= e((string)$apiBase) ?>/api/v1/ping</span> 探连通（免令牌）。
-    <br>完整接口清单见仓库里的 <span class="mono">docs/API.md</span>。
-  </p>
 
-  <div class="form-grid">
+   ⇒ 这一整块（接口根地址说明 + 用户名对账行 + 明文令牌回显 + 已签发列表 +
-    <div class="field full">
+     「生成新令牌」/「吊销全部」两个按钮）**全部撤掉**。
-      <label>接口根地址</label>
+   ⚠️ 令牌机制本身一点没动：`api_tokens` 表、`Authorization: Bearer` 校验、
-      <input class="input mono" readonly value="<?= e((string)$apiBase . '/api/v1') ?>">
+      `settings/device_remove`（按设备踢）全都还在 —— 撤掉的只是"人手签发"这条入口。
-    </div>
+      令牌从此只有一个来源：**App 登录成功后由服务端自动签发**（见 ApiTokens::issue
-    <div class="field">
+      在登录流程里的调用点），登记成一台设备，在上一张「设备管理」卡里可见可踢。
-      <label>用户名 / 手机号</label>
+   ⚠️ 路由 `settings/api_token`（生成）也必须一起下线，否则它就是一个
-      <input class="input mono" readonly value="<?= e((string)$person['name']) ?>">
+      "界面上找不到、但知道地址就能用"的后门 —— 那种入口比显式按钮危险得多。
-      <span class="tip">令牌本身就是凭据，这一行只是给你对账用。</span>
+      保留 `settings/api_revoke`：**踢设备**是用户该有的能力（同上卡在用）。
-    </div>
+   ⚠️ 别把这张卡改成"只读展示已签发令牌"：那等于把"哪些设备在用我的账号"
-  </div>
+      又摆第二遍 —— 上面「设备管理」已经是那个清单了（按设备聚合，比按令牌行更准）。 */ ?>
-
-  <?php if (!empty($apiPlain)): ?>
-    <p class="tip" style="background:#FFF6E5;border-color:#E8C98A;padding:10px 12px;border-radius:8px">
-      <b>这是你的新令牌，只显示这一次，请立刻复制到 App 里：</b>
-      <?php if ((string)$apiLabel !== ''): ?>
-        （设备名：<?= e((string)$apiLabel) ?>）
-      <?php endif; ?>
-      <br><code class="mono" style="font-size:14px;word-break:break-all"><?= e((string)$apiPlain) ?></code>
-    </p>
-  <?php endif; ?>
-
-  <?php if (!empty($apiTokens)): ?>
-    <table class="res-table" style="width:100%;margin:6px 0 10px">
-      <thead>
-        <tr><th>设备名</th><th>签发时间</th><th>最近使用</th><th></th></tr>
-      </thead>
-      <tbody>
-        <?php foreach ($apiTokens as $tk): ?>
-          <tr>
-            <td><?= e((string)($tk['label'] ?: '（未命名）')) ?></td>
-            <td class="small muted"><?= e((string)($tk['created_at'] ?? '')) ?></td>
-            <td class="small muted"><?= e((string)($tk['last_used_at'] ?? '还没用过')) ?></td>
-            <td>
-              <form method="post" action="<?= e(url('settings/api_revoke')) ?>" class="res-inline"
-                    onsubmit="return confirm('吊销这枚令牌？这台设备会立刻掉线。')">
-                <?= csrf_field() ?>
-                <input type="hidden" name="id" value="<?= (int)$tk['id'] ?>">
-                <button class="btn btn-ghost btn-sm" type="submit">吊销</button>
-              </form>
-            </td>
-          </tr>
-        <?php endforeach; ?>
-      </tbody>
-    </table>
-  <?php else: ?>
-    <p class="small muted">还没有手动签发的令牌。App 登录走上面的「设备管理」，不用在这里生成。</p>
-  <?php endif; ?>
-
-  <?php if (\App\Auth::canWrite()): ?>
-    <div class="btn-row">
-      <form method="post" action="<?= e(url('settings/api_token')) ?>" class="res-inline">
-        <?= csrf_field() ?>
-        <input class="input" name="label" placeholder="设备名（如：我的手机）" style="max-width:200px">
-        <button class="btn btn-sm" type="submit">生成新令牌</button>
-      </form>
-      <?php if (!empty($apiTokens)): ?>
-        <form method="post" action="<?= e(url('settings/api_revoke')) ?>" class="res-inline"
-              onsubmit="return confirm('吊销全部令牌？所有 App 都要重新登录。')">
-          <?= csrf_field() ?>
-          <button class="btn btn-ghost btn-sm" type="submit">吊销全部</button>
-        </form>
-      <?php endif; ?>
-    </div>
-    <p class="small muted" style="margin:10px 0 0">
-      令牌只在生成那一次显示明文（库里只存哈希）。手机丢了就吊销那一枚。
-    </p>
-  <?php endif; ?>
-</div>
 
 <!-- ==================== 天气地点（用户 2026-10-03 第 1 条）==================== -->
 <?php /* 原话：「天气这个这样吧，让用户在个人设置中填写自己的城市。」

templates/trips/_map_body.php

@@ -16,8 +16,11 @@
  *   · 坐标来源：`Trip::attachSpots()` —— 旅程下所有节点的 from/to 坐标**取重心**；
  *     没有坐标就退到城市（内置离线城市表，**不发网络请求**，见那里的说明）。
  *   · 每趟旅程一枚标记，点它进 `trips/show`。
- *   · 卡片只放"标题 + 时间 + 城市"，不放封面图 —— 本仓列表已经是图片卡片，
+ *   · 🔴 v63（用户 2026-10-19 第 3 条）：「旅程地图模式，应该显示旅程的题图。」
- *     地图上再来一层图片会喧宾夺主（地图的作用是"看空间分布"）。
+ *     ⇒ 卡片左侧加一枚**题图小方图**（`trip_details.cover_key`，与列表页同一个来源、
+ *       同一套 `media_url()` 出口）。没有题图就只显示文字，不留灰框。
+ *     ⚠️ URL 在**服务端**算好塞进 JSON：`media_url()` 依赖站点路径与代理前缀
+ *        （见那个函数的说明），端上拼不出来。
  *   · 视野上限同样 11 级、贴合全部标记。
  *
  * ⚠️ **合规**：地图用高德（腾讯/高德/百度/天地图是合规白名单内），
@@ -43,6 +46,10 @@ foreach ((array)($rows ?? []) as $row) {
         'when'  => \App\Trip::activitySpan($row['starts_at'] ?? null, $row['ends_at'] ?? null),
         'city'  => (string)($row['city'] ?? ''),
         'url'   => url('trips/show', ['id' => (int)$row['id']]),
+        // 🔴 v63 第 3 条：题图。⚠️ 用 `media_url()` 而不是直接拼 storage 路径 ——
+        //    图片统一走 media.php 代理（桶不必开公共读），且**必须带版本号**，
+        //    否则换了题图缓存里还是老图。
+        'cover' => !empty($row['cover_key']) ? media_url((string)$row['cover_key']) : '',
     ];
 }
 ?>