coopani-world-journey 0.2.2 → 0.2.3

package/CHANGELOG.md

@@ -1,7 +1,60 @@
 # 更新日志
 
+## 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/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.3",
   "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

@@ -1161,8 +1161,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`,