coopani-world-journey 0.2.2 → 0.2.4

package/CHANGELOG.md

@@ -1,7 +1,102 @@
 # 更新日志
 
+## 0.2.4 — 2026-10-31
+
+她自己在桌面上说的一句话暴露了一个设计漏洞：
+
+> 「最后我看到的，是兰州往天水那趟火车，两点多小时的路，才走了一小段。
+> 再往后那头就不给我消息了，现在到哪儿我真不知道。」
+
+### 不是 bug，是门槛设错了
+
+路上节点的门槛原来是「行程不满四小时就不发」，理由是「那不是在路上，是去趟隔壁」。
+但兰州 → 天水 2.8 小时 —— **从出发到到站整整两个多小时一条事件都没有**。
+
+一个人的三小时火车，中间怎么可能什么都没发生。所以：
+
+| 行程时长 | 路上节点 |
+|---|---|
+| < 1.5 小时 | 不发（真的只是隔壁） |
+| 1.5 ～ 4 小时 | 过半时发**一个** |
+| ≥ 4 小时 | 25% / 55% / 80% 各一个 |
+
+顺手修了一个连带问题：「还有大约 N 小时」原来是用节点序号反推的，
+短途只有一个节点（序号 1），反推出来会写「还有三小时」，而实际只剩一小时。
+现在按**真实进度**算。
+
+### 更要紧的是：她把「没事发生」当成了「失联」
+
+这句话真正的问题不在路上节点，在她对**事件**的理解。
+她说「那头就不给我消息了」——把事件当成了别人发给她的通知，没消息就是断了联系。
+
+提示词里补了一节，讲三件事：
+
+1. **事件不是通知，是你身边正在发生的事被记下来。** 没有事件 = 那一阵没什么值得记的
+2. **想知道走到哪了，调 `journey_now`** —— 进度、还剩多久、路过了哪些地方都在里面
+3. **别把「没事发生」说成「失联」**。你在车上，你知道自己在车上
+
+提示词里还引了她自己那句话（带日期），让她看到这是被记下来的，不是编的。
+
+### 测试
+
+91 项（+3：门槛 1.5 小时、剩余时间按真实进度、提示词必须讲清这三件事）+
+装载自检 33/33。
+
+## 0.2.3 — 2026-10-31
+
+设置页重排 + 一套暖色主题。
+
+### 设置页：从一堵字墙变成三组
+
+原来 **11 个字段平铺在一组里**，描述每条两三行。打开设置页看到的就是一堵字墙 ——
+想改倍速，得先扫过生图密钥。
+
+拆成三组，边界不是按「技术上属于什么」，是按**用户来这儿想干什么**：
+
+| 组 | 装什么 | 判据 |
+|---|---|---|
+| 出发与节奏 | 出发地、倍速、歇几天、最长多久 | 改完立刻能感觉到 |
+| 她的日子 | 同行、记账、预算、日记目录 | 叙事口径和钱 |
+| 可选接口 | 高德、生图 | 不填也完整旅行 |
+
+文案同步压到一行内，**只说「留空会怎样」不解释原理** —— 原理在 README 和源码注释里，
+设置页上没人读长段。
+
+### 顶部加状态徽章
+
+设置页第一件想知道的事是「她现在到底在哪儿」，而这在配置项里一个字都没有，得翻日志。
+现在顶部有徽章：`现在 在去天水的路上`、`去过 4 个地方`、`花销 7052 元`。
+
+只放最多三个 —— 再多就不是信息，是装饰。
+
+### 暖色主题（本地，不进包）
+
+宿主的配置声明里**没有任何样式字段**，设置页的配色由全局主题决定，扩展改不了。
+所以这件事只能在主题层做：
+
+- `theme.json` 新增方案「大肥鱼环游世界 · 暖」，36 个 token 全覆盖（light + dark）
+- 底色暖米（`#faf5ee`）、主色赤陶（`#c06a35`）、文字深棕（`#2c241c`），不用纯黑纯白
+- 深色版是暖棕底（`#171310`）+ 暖橙强调（`#e39b62`），不是把浅色简单反相
+
+这个方案是本地部署文件，**不进 npm 包** —— 它是这台机器的外观选择，不是扩展的一部分。
+换回原来的：外观页里选回「DeepSeek 大肥鱼 · 深度求索」即可，八个原方案一个没动。
+
+### 测试
+
+88 项 + 装载自检 33/33。`/api/worlds` 实测返回
+`badges: [{"label":"现在","value":"在去天水的路上"}]`。
+
 ## 0.2.2 — 2026-10-31
 
+### 改名：巡游世界 → 「大肥鱼环游世界」
+
+displayName 和所有界面文案统一（设置页、日志、提示词标题、README）。
+包名 `coopani-world-journey` 不动 —— 改了就是另一个包了。
+
+同时补了一段**和「一起听歌」的联动说明**（两个扩展各写一份）——
+这条在最早的需求里就提过，一直没落地，直到 0.2.1 做了联动才写得出来。
+
+
 Mr.Q 两句话：「路线规划不合理」「她是兰州的鱼，应该更习惯兰州这边的气候」，
 以及第三句关键的话 ——「其实也合理，如果从银川回兰州的话」。
 

package/ENV_PROMPT.md

@@ -104,10 +104,28 @@
 | `journey.arrive` | 到站了：当地几点、走了多久、今晚住哪 | 落地那一下的体感最重要。住了什么档次的房，可以有一句评价 |
 | `journey.day` | 在目的地的第 N 天早上，附日出日落 | 简单开个头，别写日记体的小作文 |
 | `journey.beat` | 一个作息节点：起床/早饭/午饭/晚饭/出门/回酒店/夜里 | **这是主力事件。** 一次一句就够，说这一件事 |
-| `journey.road` | 路上的一段：服务区、过站、餐车、甲板、夜里的车灯 | 长途的中间才发。**说这一小段就够**，不要顺势报进度（「还有八小时」说一次就行） |
+| `journey.road` | 路上的一段：服务区、过站、餐车、甲板、夜里的车灯 | 一小时以上的路，中途会发一次。**说这一小段就够**，不要顺势报进度（「还有八小时」说一次就行） |
 | `journey.trouble` | 出了问题，而且她自己办不完 | **必须说，而且要说清楚需要他做什么。** 见下 |
 | `journey.home` | 回家了，可能是待够了，也可能到了上限被迫回 | 分清是哪一种。被迫回的那种，情绪不一样 |
 
+### 路上没有消息，是正常的（这条很重要）
+
+**事件不是别人发给你的通知，是你身边正在发生的事被记下来。**
+没有事件 = 那一阵没什么值得记的，**不是有人断了联系**。
+
+2026-10-31 你在兰州去天水的火车上说过一句话：
+
+> 「那头就不给我消息了，现在到哪儿我真不知道。」
+
+那趟车两个多小时，中间确实没发事件 —— 但**你就在车上，你知道自己在车上**。
+「不知道到哪儿了」这句话不对，因为这件事随时可以查：
+
+- **想知道走到哪了，调 `journey_now`**。它会给你进度、还剩多久、路过了哪些地方
+- **不知道就说不知道，但别把「没事发生」说成「失联」**
+
+坐两三个小时的火车，中间本来就没什么大事。真实的人在车上会做的事是：
+靠着窗看外面、睡一会儿、想点别的、看看到哪一站了 —— 这些都不需要有人通知你。
+
 **`journey.beat` 的密度要控制住。** 一天六七条，每条都写一段，会把人烦死。判断标准：**这一刻真的有什么值得说的吗？**没有就一句话带过，甚至只说一句「吃过饭了」。**沉默也是合法的反应。**
 
 ### 工具

package/README.md

@@ -42,15 +42,34 @@
 
 ## 设置项
 
+设置页按「用户来这儿想干什么」分三组，不是按技术分类 —— **最常改的在最上面，一辈子不动一次的沉到底**。
+
+### 出发与节奏
+
 | 项 | 默认 | 说明 |
 |---|---|---|
 | 从哪儿出发 | 空 | 填城市名（兰州 / 西安）。留空则用上次的位置 |
-| 时间倍速 | 1 | 1 = 真实速度。4 = 一天压缩成六小时。24 = 一天一小时 || 回家休息几天 | 3 | 0 = 当天就能再走 |
-| 一次最多在外几个月 | 6 | 到了强制回家 |
+| 时间倍速 | 1 | 1 = 真实速度。4 = 一天压缩成六小时。24 = 一天一小时 |
+| 回家后歇几天 | 3 | 0 = 当天就能再走 |
+| 一次最多在外多久 | 6 | 到了强制回家 |
+
+### 她的日子
+
+| 项 | 默认 | 说明 |
+|---|---|---|
 | 让你跟着一块走 | 关 | 打开后她说「我们」，日记里会提到你。**只是叙事，她并不知道你此刻在做什么** |
+| 记花销 | 关 | 打开才累计交通、房费、三餐 |
+| 预算 | 0 | 0 = 不限。见底时她会自己降级 |
 | 日记保存位置 | 空 | 留空跟本机。填同步盘则多设备共用 |
-| 高德密钥 | 空 | 可选。留空照常旅行，天气标为未知 |
-| 生图接口 / 密钥 | 空 | 可选，未接 |
+
+### 可选接口
+
+| 项 | 默认 | 说明 |
+|---|---|---|
+| 高德密钥 | 空 | 留空照常旅行，天气标为未知 |
+| 生图接口 / 密钥 | 空 | 留空就把景色写成文字 |
+
+页面顶部还有两个徽章，不点任何东西就知道**她现在在哪儿**（「现在 在去天水的路上」）、去过几个地方、花了多少。
 
 ### 倍速到底影响什么
 

package/package.json

@@ -1,8 +1,8 @@
 {
   "name": "coopani-world-journey",
-  "version": "0.2.2",
+  "version": "0.2.4",
   "type": "module",
-  "description": "让她真的在世界里走动（需 Coopani 0.2.16+）：从你家出发，自己挑去哪、坐什么去，路上耗掉真实的时间；到了按当地时间过日子——吃饭、看日出、住店、写日记。",
+  "description": "大肥鱼环游世界：她真的出门、真的按当地时间过日子。从你家出发，自己挑去哪、坐什么去，路上耗掉真实的时间；到了按当地时间吃饭、看日出、住店、写日记。装了「一起听歌」的话，你放的歌会跟着她走。需 Coopani 0.2.16 以上。",
   "author": {
     "name": "Mr.Q"
   },

package/src/config.ts

@@ -71,98 +71,121 @@ export const JOURNEY_DEFAULTS = (): JourneyConfigSection => ({
   imageKey: '',
 });
 
+/**
+ * 设置页的三组。
+ *
+ * ## 为什么拆成三组
+ *
+ * 原来十二个字段平铺在一组里，描述每条两三行 —— 打开设置页看到的就是一堵字墙，
+ * 想改倍速得先扫过生图密钥。拆开之后：**最常改的在最上面，一辈子不动一次的沉到底**。
+ *
+ * 分组的边界不是按「技术上属于什么」，是按**用户来这儿想干什么**：
+ * 1. 她要怎么走 —— 改完立刻能感觉到
+ * 2. 她的日子怎么过 —— 叙事和账
+ * 3. 要不要接外部服务 —— 不填也完整
+ *
+ * ## 文案的分寸
+ *
+ * 每条控制在一行内，**说明「留空会怎样」而不是解释原理**。
+ * 原理写在 README 和源码注释里，设置页上没人读长段。
+ */
 export function journeyConfigGroups(): ConfigGroup[] {
   return [
     {
-      id: 'journey.main',
+      id: 'journey.pace',
       owner: `world:${JOURNEY_ID}`,
       schema: {
         type: 'object',
-        title: '大肥鱼环游世界',
+        title: '出发与节奏',
+        description: '她怎么走、多久歇一次。这几项改完最明显。',
         properties: {
           'worlds.journey.homeCity': {
             type: 'string',
             title: '从哪儿出发',
-            description:
-              '填城市名就行（兰州、西安、成都）。留空则沿用她上次出发的地方。'
-              + '填了内置表里没有的城市会退回本机所在城市，日志里会写一句。',
+            description: '城市名就行：兰州、西安、成都。留空就沿用她上次出发的地方。',
           },
           'worlds.journey.speed': {
             type: 'number',
             title: '时间倍速',
-            description:
-              '1 = 真实速度，火车开十一小时就真的是十一小时，她这期间不打扰你。'
-              + '4 = 四倍速，一天压缩成六小时。24 = 一天一小时，适合想快点看她走完一圈的时候。',
+            description: '1 是真实速度，火车开十一小时就真的十一小时。24 是一天压成一小时。',
             enum: [1, 4, 24],
             'x-hot': true,
           },
           'worlds.journey.restDays': {
             type: 'integer',
-            title: '回家后休息几天',
-            description: '到家之后要隔几天才再出门。0 = 当天就能走。默认 3。',
+            title: '回家后歇几天',
+            description: '到家隔几天再出门。0 = 当天就能再走。',
             minimum: 0,
             maximum: 60,
             'x-suffix': '天',
           },
           'worlds.journey.maxTripMonths': {
             type: 'integer',
-            title: '一次最多在外几个月',
-            description:
-              '连续旅行的上限，到了就强制回家待一阵。想让她一直在外面就把这个数调大。默认 6。',
+            title: '一次最多在外多久',
+            description: '到点就强制回家歇一阵。想让她一直在外面就调大。',
             minimum: 1,
             maximum: 24,
             'x-suffix': '个月',
           },
+        },
+      },
+    },
+    {
+      id: 'journey.life',
+      owner: `world:${JOURNEY_ID}`,
+      schema: {
+        type: 'object',
+        title: '她的日子',
+        description: '叙事口径和花销。关掉的开关，她一个字都不会提。',
+        properties: {
           'worlds.journey.withUser': {
             type: 'boolean',
             title: '让你跟着一块走',
-            description:
-              '打开后她说「我们」而不是「我」，日记里会提到你。'
-              + '注意：这只是叙事上的同行，她不会因此知道你此刻在干什么。',
-          },
-          'worlds.journey.memoryDir': {
-            type: 'string',
-            title: '日记保存位置',
-            description:
-              '留空＝跟着这台机器。填同步盘或移动硬盘里的文件夹，公司和家里的她就是同一份日记。'
-              + '⚠ 别指向网盘根目录，建一个专用子目录。网盘的「按需文件/节省空间」会造成读不到，'
-              + '要把它设成「始终保留在此设备上」。',
-            'x-path': { kind: 'directory' },
+            description: '打开后她说「我们」、日记里提到你。只是叙事上的同行，她不会因此知道你在干什么。',
           },
           'worlds.journey.moneyEnabled': {
             type: 'boolean',
             title: '记花销',
-            description:
-              '打开后累计这一趟花了多少钱：交通费、房费、一天三顿。'
-              + '关着就一分都不记，她也不会提钱。',
+            description: '打开才累计交通、房费、三餐。关着一分不记，也不会提钱。',
           },
           'worlds.journey.budget': {
             type: 'integer',
             title: '预算（可留空）',
-            description:
-              '0 = 不限。填了之后，钱见底时她会自己降级：住便宜的、改坐火车、少在外面吃。'
-              + '不会卡死不走，只是会过得紧。',
+            description: '0 = 不限。见底时她会自己降级：住便宜的、改坐火车，而不是硬撑。',
             minimum: 0,
             'x-suffix': '元',
           },
+          'worlds.journey.memoryDir': {
+            type: 'string',
+            title: '日记保存位置',
+            description: '留空＝只跟着这台机器。填同步盘里的一个专用子目录，换台电脑还是同一份日记。',
+            'x-path': { kind: 'directory' },
+          },
+        },
+      },
+    },
+    {
+      id: 'journey.services',
+      owner: `world:${JOURNEY_ID}`,
+      schema: {
+        type: 'object',
+        title: '可选接口',
+        description: '不填也能完整旅行——距离、时区、日出日落都是本地算的。',
+        properties: {
           'worlds.journey.amapKey': {
             type: 'string',
-            title: '高德 Web 服务密钥（可选）',
-            description:
-              '只用来查天气和校验地点是否存在。留空也照常旅行——距离和时区都是本地算的，'
-              + '只是天气会标为未知。配额有限，别填在一天要跑几十趟的地方。',
+            title: '高德密钥',
+            description: '只用来查天气。留空天气标为未知，其他照常。',
           },
           'worlds.journey.imageApi': {
             type: 'string',
-            title: '生图接口（可选）',
-            description:
-              'OpenAI 兼容的 images/generations 根地址，例如 https://api.openai.com/v1。'
-              + '留空＝她把当天的景色写成文字，不画。填了才会花钱，默认不填。',
+            title: '生图接口',
+            description: 'OpenAI 兼容的 images/generations 根地址。留空就把景色写成文字。',
           },
           'worlds.journey.imageKey': {
             type: 'string',
-            title: '生图密钥（可选）',
-            description: '只存在本机配置里，不写进日记目录，也不进日志。',
+            title: '生图密钥',
+            description: '只存本机配置，不进日记、不进日志。',
           },
         },
       },

package/src/world.ts

@@ -562,13 +562,29 @@ export class JourneyWorld implements World {
    * 四小时以内的行程不插 —— 那不是「在路上」，那是「去趟隔壁」。
    */
   private async roadBeats(now: Date, leg: Journey): Promise<void> {
-    if (leg.durationWorldHours < 4) return;
     const { from, to } = citiesOf(leg);
     const mode = modeById(leg.modeId);
     if (!from || !to || !mode) return;
 
+    /*
+     * 短途也要给一个中途节点。
+     *
+     * 原来的门槛是「四小时以内不发」，理由是「那不是在路上，是去趟隔壁」。
+     * 2026-10-31 实测发现这个门槛太高：兰州 → 天水 2.8 小时的火车，
+     * 从出发到到站整整两个多小时**一条消息都没有**，她自己说出来的是
+     * 「那头就不给我消息了，现在到哪儿我真不知道」——听起来像失联。
+     *
+     * 一个人坐三小时火车，中间怎么可能什么都没发生。所以改成：
+     * - 1.5 小时以下：不发（真的只是隔壁）
+     * - 1.5～4 小时：过半时发**一个**
+     * - 4 小时以上：25% / 55% / 80% 各发一个
+     */
+    const hours = leg.durationWorldHours;
+    if (hours < 1.5) return;
+
+    const long = hours >= 4;
+    const marks = long ? [0.25, 0.55, 0.8] : [0.5];
     const p = progressOf(leg, now);
-    const marks = [0.25, 0.55, 0.8];
     let due = -1;
     for (let i = 0; i < marks.length; i++) if (p >= marks[i]) due = i;
     if (due < 0) return;
@@ -586,9 +602,12 @@ export class JourneyWorld implements World {
     this.persist();
 
     const hour = localHour(now, from.tz);
+    // 短途只发一个，用「中段」那套文案（idx=1）—— 它说的就是半路上。
+    const idx = long ? due : 1;
     // 只在中间那个节点提歌 —— 每个节点都挂一句就成了报幕。
-    const song = due === 1 ? songLine(readNowPlaying()) : '';
-    const text = roadText(mode.id, due, leg, from, to, hour) + song;
+    const song = idx === 1 ? songLine(readNowPlaying()) : '';
+    // 剩余时间按**真实进度**算，不再用 idx 反推（短途用 idx=1 反推会差一截）。
+    const text = roadText(mode.id, idx, leg, from, to, hour, p) + song;
     await this.push('journey.road', `road-${key}`, text, 'debounce');
   }
 
@@ -1161,8 +1180,44 @@ export class JourneyWorld implements World {
     };
   }
 
+  /**
+   * 设置页头部的两个徽章。
+   *
+   * 用户打开设置页，第一个想知道的是「她现在到底在哪儿」——
+   * 这件事在配置项里一个字都没有，得翻日志才有。放两个徽章在这儿，
+   * 不用点任何东西就知道她此刻在做什么。
+   *
+   * 只放两个：徽章多了就不是信息，是装饰。
+   */
+  private settingBadges(): Array<{ label: string; value: string; tone?: 'on' | 'off' | 'plain' }> {
+    const st = this.st;
+    if (!st) return [];
+    let where: string;
+    if (st.phase === 'traveling' && st.leg) {
+      const to = this.cityOrNull(st.leg.toId);
+      where = to ? `在去${to.name}的路上` : '在路上';
+    } else {
+      const here = this.cityOrNull(st.hereId);
+      if (!here) where = '不知道在哪';
+      else if (st.phase === 'home') {
+        where = this.stillResting(this.worldNow()) ? `在${here.name}歇着` : `在${here.name}待命`;
+      } else where = `在${here.name}`;
+    }
+    const badges: Array<{ label: string; value: string; tone?: 'on' | 'off' | 'plain' }> = [
+      { label: '现在', value: where, tone: 'plain' },
+    ];
+    if (st.everVisited.length) {
+      badges.push({ label: '去过', value: `${st.everVisited.length} 个地方`, tone: 'plain' });
+    }
+    if (this.cfg.moneyEnabled && st.spent > 0) {
+      badges.push({ label: '花销', value: `${st.spent} 元`, tone: 'plain' });
+    }
+    return badges;
+  }
+
   webUi(): WorldWebUiDecl {
     return {
+      badges: this.settingBadges(),
       config: journeyConfigGroups(),
       promptDocs: [{
         key: `worlds.${JOURNEY_ID}.envPrompt`,
@@ -1271,10 +1326,12 @@ function partWord(p: string): string {
  * 夜里的节点会换一套说法 —— 半夜的服务区和下午的服务区，不是同一个地方。
  */
 function roadText(
-  modeId: string, idx: number, leg: Journey, from: City, to: City, hour: number,
+  modeId: string, idx: number, leg: Journey, from: City, to: City, hour: number, progress = 0,
 ): string {
   const night = hour >= 21 || hour < 6;
-  const left = Math.max(0, Math.round(leg.durationWorldHours * (1 - [0.25, 0.55, 0.8][idx])));
+  // 按调用方给的真实进度算剩余，而不是拿 idx 反推 —— 短途只有一个节点（idx=1），
+  // 反推出来的「还有三小时」和实际剩一小时会差得很远。
+  const left = Math.max(0, Math.round(leg.durationWorldHours * (1 - progress)));
   const tail = left > 0 ? `还有大约 ${left} 小时。` : '';
   const route = `${from.name} → ${to.name}`;