coopani-world-music 0.3.13 → 0.3.14

package/CHANGELOG.md

@@ -1,5 +1,40 @@
 # 更新日志
 
+## 0.3.14
+
+**换台机器装扩展，动作自动补齐了**
+
+十一个自定义动作（蹦迪 / 跟着哼 / 坐着哼 / 怔住 …）一直住在**宿主桌宠包里**，
+不是本扩展的代码 —— 所以从市场装到一台新机器时，它们本来就是缺的。
+缺了会静默降级：`蹦迪` 退回原生 `dance`，原地踩拍、不横移。
+用户在另一台机器上的原话是「**蹦是蹦了，就是没走**」，这七个字就是降级的指纹。
+
+现在每次启动都会检查宿主词表，缺什么补什么：
+
+- **动手前先备份**到 `<data>/host-backup/<时间戳>/`，只留最近三份
+- **一处锚点对不上就一处都不写** —— 半截补丁比没打更难查
+  （白名单里多了词、派发里没这一段，她收到会当成不认识的动作用掉，表现得像"偶尔站住不动"）
+- 补完**要重启一次才生效**：桌宠页面已经把旧的 `body.js` 读进内存了，
+  这一轮仍然按旧词表降级，日志会写明
+- 任何异常都不许把扩展带崩：打不上就打不上，降级照样能听歌
+
+设置页「记录与位置」多了开关 **自动补齐桌宠动作**（默认开）。关掉就只用宿主原生的那几个。
+
+**顺带修了两个「她整首歌站着不动」的原因**
+
+1. `plain`（没标路数、字面也猜不出）原来被当成「这首淡，不该动」，动作返回空。
+   于是整首歌一个动作都没有，而且 `lastMove` 不更新，**避让机制整条失效**。
+   现在给中性的「打拍子」——不挑曲风、不带路数色彩。
+2. 表情那一格空了，会把整句动作候选一起吞掉。现在两件事解耦：
+   没有表情就只写动作。
+
+**已知偏差（没有假装验证过）**：补丁表里部分条目的注释文本与本机实际文件不完全一致
+（开发期直接改过宿主文件，脚本没逐字同步）。功能不受影响，但换台机器补出来的文件
+在注释上会有细微差别。要彻底对齐，得按当前宿主重新生成一遍补丁表。
+
+测试 89 项（88 通过 / 1 跳过），新增 6 项专测补丁层：
+打上、幂等、锚点失败一处不写、CRLF 宿主、宿主目录不存在、备份只留三份。
+
 ## 0.3.13
 
 **动作从 4 个扩到 11 个，而且不再由她自己挑**

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "coopani-world-music",
-  "version": "0.3.13",
+  "version": "0.3.14",
   "type": "module",
   "description": "陪着你听歌：知道 QQ音乐 / 网易云音乐 在放什么。换歌必说一句，一首歌里分几段接话，还能就着刚唱过的词评两句；表情动作跟着曲风变，另有律动、打拍子、闭眼听、蹦迪四个专属动作。记得住你听过什么——记忆可以存到你指定的文件夹，公司和家里接同一份。能替你暂停切歌，也能自己搜歌挑给你。和「陪打炉石」一起装更有意思：打牌时听的每一首她都知道。嫌吵能让其中一个先安静。",
   "author": {

package/src/config.ts

@@ -1,283 +1,301 @@
-/**
- * 配置段与设置页。
- *
- * 每一个字段都必须有读取点（见 world.ts 里的 this.cfg.xxx）；只声明不接线，
- * 使用者改了没效果而且不报错——这是这个框架最容易骗人的一处。
- *
- * 设置页按「会改的东西」分组，不按代码结构分组：说话节奏 / 读哪边 / 特殊时刻 / 记录与权限。
- * 顺序就是看见的顺序，最常动的放最前。
- */
-import type { ConfigGroup } from 'cortico/core/config-schema.ts';
-import type { WorldSection } from 'cortico/world.ts';
-import type { PlayerPref } from './players.ts';
-import { suggestedMemoryDir } from './storage.ts';
-
-export const MUSIC_ID = 'music';
-
-/** 开口频率。把"别太吵"做成代码里的规则，而不是指望模型自律。 */
-export type Chatinness = 'quiet' | 'normal';
-
-export interface MusicConfigSection extends WorldSection {
-  /** 她多爱接话。 */
-  chatiness: Chatinness;
-  /** 同时开着两个播放器时听谁的。 */
-  player: PlayerPref;
-  /** 采样间隔（毫秒）。改完要重启扩展实例。 */
-  intervalMs: number;
-  /** 额外认作播放器的 AUMID 片段，逗号分隔。 */
-  extraPlayers: string;
-  /** 深夜起点小时（0–23），窗口到 05:00。 */
-  nightFrom: number;
-  /** 连续听多久算"久听"。 */
-  longMinutes: number;
-  /** 听歌记录保留多少天。 */
-  keepDays: number;
-  /**
-   * 记忆存到哪个文件夹。留空＝跟着这台机器。
-   *
-   * 填一个两边都看得见的目录（OneDrive、NAS、移动硬盘），公司和家里就是同一份记忆。
-   * 只影响**记忆**类数据；当前播放状态和歌词缓存永远在本机，见 storage.ts。
-   */
-  memoryDir: string;
-  /** 允许她代为暂停/切歌。 */
-  controlAllowed: boolean;
-  /** 一首歌切成多长一段（秒）。每段结束推一条事件，让她就这一段说一句。0 = 不评论。 */
-  segmentEverySec: number;
-  /** 每首最多说几段。短歌靠它压次数，长曲靠它把段长拉开。 */
-  maxSegmentsPerTrack: number;
-  /** 允许她自己搜歌、挑歌。关了就只有看着的份。 */
-  selfPick: boolean;
-  /** 她上哪找歌。auto = 两个库都搜。 */
-  pickSource: 'auto' | 'qq' | 'netease';
-  /** 她什么时候可以主动挑：ask = 你问或话题合适时；idle = 静下来没歌时自己挑一首。 */
-  pickWhen: 'ask' | 'idle';
-  /** 允许她读这首歌的歌词。关了就只有听感，说不出词里在讲什么。 */
-  lyricAware: boolean;
-  /** 一次给她几行歌词。给多了她会复述，给少了没法评。 */
-  lyricLines: number;
-  /**
-   * 打炉石时让路。
-   *
-   * 打开后：检测到 `Hearthstone.exe` 在跑就不主动开口（换歌、段落都不说），
-   * 你戳她她还是照答 —— 让的是「主动播报」，不是「拒绝回答」。
-   *
-   * **默认关。** 两件事同时进行、各说各的，这是很多人喜欢的状态；
-   * 只有嫌吵的人才需要打开。看到进程也不等于正在对局，挂在后台也会让路。
-   */
-  yieldToHearthstone: boolean;
-}
-
-export const MUSIC_DEFAULTS = (): MusicConfigSection => ({
-  enabled: false, // 由 WorldSection 提供，扩展不能自己决定装上就开
-  chatiness: 'normal',
-  player: 'auto',
-  intervalMs: 1000,
-  extraPlayers: '',
-  nightFrom: 23,
-  longMinutes: 100,
-  keepDays: 90,
-  memoryDir: '',
-  controlAllowed: true,
-  segmentEverySec: 45,
-  maxSegmentsPerTrack: 3,
-  selfPick: false,
-  pickSource: 'auto',
-  pickWhen: 'ask',
-  lyricAware: true,
-  lyricLines: 2,
-  yieldToHearthstone: false,
-});
-
-const P = (field: string): string => `worlds.${MUSIC_ID}.${field}`;
-
-/**
- * 设置页。四组，每组一句话说清"改了会怎样"。
- *
- * 为什么不再堆成一组：十个字段一屏，最该调的（说话多不多）和最不该动的（采样间隔）
- * 混在一起，等于没分组。
- */
-export function musicConfigGroups(): ConfigGroup[] {
-  return [
-    {
-      id: 'music.talk',
-      owner: `world:${MUSIC_ID}`,
-      schema: {
-        type: 'object',
-        title: '她怎么开口',
-        description: '换歌必说一句；一首歌里说几句、隔多久说，由这两项决定。',
-        properties: {
-          [P('chatiness')]: {
-            type: 'string',
-            title: '接话频率',
-            description: '正常=换歌说一句，每段再说一句；安静=只在深夜、久听这类时刻开口，平时陪着你听，不评论。',
-            enum: ['normal', 'quiet'],
-          },
-          [P('maxSegmentsPerTrack')]: {
-            type: 'integer',
-            title: '一首歌说几次',
-            description: '不含开头那次。3 段的话：3 分半的歌约 52 秒一段，15 分钟的古典约 3 分 45 一段。调大就变密。',
-            minimum: 0,
-            maximum: 8,
-            'x-suffix': '段',
-          },
-          [P('yieldToHearthstone')]: {
-            type: 'boolean',
-            title: '打炉石时让路',
-            description: '打开后：检测到炉石在跑就不主动开口（换歌、段落都不说），你戳她还是照答；打完自动恢复。默认关——两件事同时进行、各说各的，很多人反而喜欢。注意：炉石挂在后台不动也算「在跑」，这时同样会安静。',
-          },
-          [P('segmentEverySec')]: {
-            type: 'integer',
-            title: '一段至少多长',
-            description: '秒。段长的下限，也是第一段的长度——换完歌要尽快表态，这一段不参与均分。填 0 就只报换歌。',
-            minimum: 0,
-            maximum: 180,
-            'x-suffix': '秒',
-          },
-        },
-      },
-    },
-    {
-      id: 'music.source',
-      owner: `world:${MUSIC_ID}`,
-      schema: {
-        type: 'object',
-        title: '从哪读',
-        description: '读 Windows 的系统媒体会话（SMTC）。只有播放器不上报时才退回读窗口标题。',
-        properties: {
-          [P('player')]: {
-            type: 'string',
-            title: '两个播放器同时在放',
-            description: '自动=谁在放听谁；也可以固定只听某一个。',
-            enum: ['auto', 'qq', 'netease'],
-          },
-          [P('extraPlayers')]: {
-            type: 'string',
-            title: '还认哪些播放器',
-            description: '逗号分隔的进程名片段，例如 spotify,foobar。留空则只认 QQ音乐和网易云。',
-          },
-          [P('intervalMs')]: {
-            type: 'integer',
-            title: '多久看一次',
-            description: '毫秒。默认 1000，够用就别动。改完要重启扩展才生效。',
-            minimum: 400,
-            maximum: 5000,
-            'x-suffix': 'ms',
-            'x-hot': false,
-          },
-        },
-      },
-    },
-    {
-      id: 'music.pick',
-      owner: `world:${MUSIC_ID}`,
-      schema: {
-        type: 'object',
-        title: '她自己找歌',
-        description: '打开之后她会自己去搜歌、挑一首、说清为什么想听，并给出链接。播放那一下仍要你来点——两个客户端都不接受从外部点播，原因写在 README 里。',
-        properties: {
-          [P('selfPick')]: {
-            type: 'boolean',
-            title: '允许她自己去搜歌挑歌',
-            description: '关着的时候她只评价你在放的，不会去翻别的。打开后她想听什么会直接说，并记进想听清单。',
-          },
-          [P('pickSource')]: {
-            type: 'string',
-            title: '上哪个曲库找',
-            description: '自动=两个库都搜再挑，有些冷门歌只有一边有；也可以固定只搜一家。',
-            enum: ['auto', 'qq', 'netease'],
-          },
-          [P('pickWhen')]: {
-            type: 'string',
-            title: '什么时候可以挑',
-            description: '问我才挑=你问她、或聊到想听什么的时候；自己挑=没歌在放的时候她可以主动挑一首，不用等你开口。',
-            enum: ['ask', 'idle'],
-          },
-        },
-      },
-    },
-    {
-      id: 'music.lyric',
-      owner: `world:${MUSIC_ID}`,
-      schema: {
-        type: 'object',
-        title: '歌词',
-        description: '打开之后她能知道这首歌此刻唱到哪一句，评价能落到词上，而不是只会说"鼓点不错"。歌词按歌名歌手去曲库反查，对不上就不给——宁可没有，也不能拿错歌的词去评。',
-        properties: {
-          [P('lyricAware')]: {
-            type: 'boolean',
-            title: '让她看歌词',
-            description: '关掉之后她只有听感：能说编曲、唱腔、节奏，说不出词里在讲什么。打开时每段会附上刚唱过的一两句，需要联网查一次词。',
-          },
-          [P('lyricLines')]: {
-            type: 'integer',
-            title: '一次给她几行',
-            description: '1–3。给两行她还能评，给三行以上她就容易照着念——那样听着像在念歌词，不是在聊天。',
-            minimum: 1,
-            maximum: 3,
-            'x-suffix': '行',
-          },
-        },
-      },
-    },
-    {
-      id: 'music.moments',
-      owner: `world:${MUSIC_ID}`,
-      schema: {
-        type: 'object',
-        title: '特殊时刻',
-        description: '两个只在特定条件下才触发的提醒，各只说一次，不反复念。',
-        properties: {
-          [P('nightFrom')]: {
-            type: 'integer',
-            title: '深夜从几点算',
-            description: '0–23，窗口到清晨 5 点。这段时间还在听，她会开口一次。',
-            minimum: 0,
-            maximum: 23,
-            'x-suffix': '点',
-          },
-          [P('longMinutes')]: {
-            type: 'integer',
-            title: '连续听多久算久',
-            description: '分钟。达标时提醒一次休息。设很大等于关掉这条。',
-            minimum: 20,
-            maximum: 480,
-            'x-suffix': '分',
-          },
-        },
-      },
-    },
-    {
-      id: 'music.data',
-      owner: `world:${MUSIC_ID}`,
-      schema: {
-        type: 'object',
-        title: '记录与位置',
-        description: '听歌记录存在哪、留多久，以及她能不能替你按键。',
-        properties: {
-          [P('memoryDir')]: {
-            type: 'string',
-            title: '记忆保存位置',
-            description:
-              '留空＝跟着这台机器。填一个同步盘或移动硬盘里的文件夹，公司和家里的桌宠就是同一份记忆（听过什么、给哪首写过笔记、欠你哪几首）。'
-              + '换位置不会丢旧记录——本机原来那份仍然一起读。'
-              + '两点要注意：别两台机器同时开着往同一个目录里写，网盘同步会打架；歌词缓存和「现在在放什么」永远留在本机，不跟着走。',
-            'x-path': { kind: 'directory', recommendedDir: suggestedMemoryDir() },
-          },
-          [P('keepDays')]: {
-            type: 'integer',
-            title: '听歌记录保留',
-            description: '天。超出的旧记录在下次启动时删掉。',
-            minimum: 1,
-            maximum: 365,
-            'x-suffix': '天',
-          },
-          [P('controlAllowed')]: {
-            type: 'boolean',
-            title: '允许她替你按暂停/切歌',
-            description: '关掉之后她只能看着，不能动你的播放器。',
-          },
-        },
-      },
-    },
-  ];
-}
+/**
+ * 配置段与设置页。
+ *
+ * 每一个字段都必须有读取点（见 world.ts 里的 this.cfg.xxx）；只声明不接线，
+ * 使用者改了没效果而且不报错——这是这个框架最容易骗人的一处。
+ *
+ * 设置页按「会改的东西」分组，不按代码结构分组：说话节奏 / 读哪边 / 特殊时刻 / 记录与权限。
+ * 顺序就是看见的顺序，最常动的放最前。
+ */
+import type { ConfigGroup } from 'cortico/core/config-schema.ts';
+import type { WorldSection } from 'cortico/world.ts';
+import type { PlayerPref } from './players.ts';
+import { suggestedMemoryDir } from './storage.ts';
+
+export const MUSIC_ID = 'music';
+
+/** 开口频率。把"别太吵"做成代码里的规则，而不是指望模型自律。 */
+export type Chatinness = 'quiet' | 'normal';
+
+export interface MusicConfigSection extends WorldSection {
+  /** 她多爱接话。 */
+  chatiness: Chatinness;
+  /** 同时开着两个播放器时听谁的。 */
+  player: PlayerPref;
+  /** 采样间隔（毫秒）。改完要重启扩展实例。 */
+  intervalMs: number;
+  /** 额外认作播放器的 AUMID 片段，逗号分隔。 */
+  extraPlayers: string;
+  /** 深夜起点小时（0–23），窗口到 05:00。 */
+  nightFrom: number;
+  /** 连续听多久算"久听"。 */
+  longMinutes: number;
+  /** 听歌记录保留多少天。 */
+  keepDays: number;
+  /**
+   * 记忆存到哪个文件夹。留空＝跟着这台机器。
+   *
+   * 填一个两边都看得见的目录（OneDrive、NAS、移动硬盘），公司和家里就是同一份记忆。
+   * 只影响**记忆**类数据；当前播放状态和歌词缓存永远在本机，见 storage.ts。
+   */
+  memoryDir: string;
+  /** 允许她代为暂停/切歌。 */
+  controlAllowed: boolean;
+  /**
+   * 启动时自动给宿主桌宠补齐自定义动作。
+   *
+   * 那十一个动作住在宿主包里，npm 带不过来 —— 关掉这个开关，换台机器就只剩原生动作，
+   * 「蹦迪」会退回原地跳舞（不横移）。默认开。
+   */
+  autoPatchHost: boolean;
+  /** 一首歌切成多长一段（秒）。每段结束推一条事件，让她就这一段说一句。0 = 不评论。 */
+  segmentEverySec: number;
+  /** 每首最多说几段。短歌靠它压次数，长曲靠它把段长拉开。 */
+  maxSegmentsPerTrack: number;
+  /** 允许她自己搜歌、挑歌。关了就只有看着的份。 */
+  selfPick: boolean;
+  /** 她上哪找歌。auto = 两个库都搜。 */
+  pickSource: 'auto' | 'qq' | 'netease';
+  /** 她什么时候可以主动挑：ask = 你问或话题合适时；idle = 静下来没歌时自己挑一首。 */
+  pickWhen: 'ask' | 'idle';
+  /** 允许她读这首歌的歌词。关了就只有听感，说不出词里在讲什么。 */
+  lyricAware: boolean;
+  /** 一次给她几行歌词。给多了她会复述，给少了没法评。 */
+  lyricLines: number;
+  /**
+   * 打炉石时让路。
+   *
+   * 打开后：检测到 `Hearthstone.exe` 在跑就不主动开口（换歌、段落都不说），
+   * 你戳她她还是照答 —— 让的是「主动播报」，不是「拒绝回答」。
+   *
+   * **默认关。** 两件事同时进行、各说各的，这是很多人喜欢的状态；
+   * 只有嫌吵的人才需要打开。看到进程也不等于正在对局，挂在后台也会让路。
+   */
+  yieldToHearthstone: boolean;
+}
+
+export const MUSIC_DEFAULTS = (): MusicConfigSection => ({
+  enabled: false, // 由 WorldSection 提供，扩展不能自己决定装上就开
+  chatiness: 'normal',
+  player: 'auto',
+  intervalMs: 1000,
+  extraPlayers: '',
+  nightFrom: 23,
+  longMinutes: 100,
+  keepDays: 90,
+  memoryDir: '',
+  controlAllowed: true,
+  autoPatchHost: true,
+  segmentEverySec: 45,
+  maxSegmentsPerTrack: 3,
+  selfPick: false,
+  pickSource: 'auto',
+  pickWhen: 'ask',
+  lyricAware: true,
+  lyricLines: 2,
+  yieldToHearthstone: false,
+});
+
+const P = (field: string): string => `worlds.${MUSIC_ID}.${field}`;
+
+/**
+ * 设置页。四组，每组一句话说清"改了会怎样"。
+ *
+ * 为什么不再堆成一组：十个字段一屏，最该调的（说话多不多）和最不该动的（采样间隔）
+ * 混在一起，等于没分组。
+ */
+export function musicConfigGroups(): ConfigGroup[] {
+  return [
+    {
+      id: 'music.talk',
+      owner: `world:${MUSIC_ID}`,
+      schema: {
+        type: 'object',
+        title: '她怎么开口',
+        description: '换歌必说一句；一首歌里说几句、隔多久说，由这两项决定。',
+        properties: {
+          [P('chatiness')]: {
+            type: 'string',
+            title: '接话频率',
+            description: '正常=换歌说一句，每段再说一句；安静=只在深夜、久听这类时刻开口，平时陪着你听，不评论。',
+            enum: ['normal', 'quiet'],
+          },
+          [P('maxSegmentsPerTrack')]: {
+            type: 'integer',
+            title: '一首歌说几次',
+            description: '不含开头那次。3 段的话：3 分半的歌约 52 秒一段，15 分钟的古典约 3 分 45 一段。调大就变密。',
+            minimum: 0,
+            maximum: 8,
+            'x-suffix': '段',
+          },
+          [P('yieldToHearthstone')]: {
+            type: 'boolean',
+            title: '打炉石时让路',
+            description: '打开后：检测到炉石在跑就不主动开口（换歌、段落都不说），你戳她还是照答；打完自动恢复。默认关——两件事同时进行、各说各的，很多人反而喜欢。注意：炉石挂在后台不动也算「在跑」，这时同样会安静。',
+          },
+          [P('segmentEverySec')]: {
+            type: 'integer',
+            title: '一段至少多长',
+            description: '秒。段长的下限，也是第一段的长度——换完歌要尽快表态，这一段不参与均分。填 0 就只报换歌。',
+            minimum: 0,
+            maximum: 180,
+            'x-suffix': '秒',
+          },
+        },
+      },
+    },
+    {
+      id: 'music.source',
+      owner: `world:${MUSIC_ID}`,
+      schema: {
+        type: 'object',
+        title: '从哪读',
+        description: '读 Windows 的系统媒体会话（SMTC）。只有播放器不上报时才退回读窗口标题。',
+        properties: {
+          [P('player')]: {
+            type: 'string',
+            title: '两个播放器同时在放',
+            description: '自动=谁在放听谁；也可以固定只听某一个。',
+            enum: ['auto', 'qq', 'netease'],
+          },
+          [P('extraPlayers')]: {
+            type: 'string',
+            title: '还认哪些播放器',
+            description: '逗号分隔的进程名片段，例如 spotify,foobar。留空则只认 QQ音乐和网易云。',
+          },
+          [P('intervalMs')]: {
+            type: 'integer',
+            title: '多久看一次',
+            description: '毫秒。默认 1000，够用就别动。改完要重启扩展才生效。',
+            minimum: 400,
+            maximum: 5000,
+            'x-suffix': 'ms',
+            'x-hot': false,
+          },
+        },
+      },
+    },
+    {
+      id: 'music.pick',
+      owner: `world:${MUSIC_ID}`,
+      schema: {
+        type: 'object',
+        title: '她自己找歌',
+        description: '打开之后她会自己去搜歌、挑一首、说清为什么想听，并给出链接。播放那一下仍要你来点——两个客户端都不接受从外部点播，原因写在 README 里。',
+        properties: {
+          [P('selfPick')]: {
+            type: 'boolean',
+            title: '允许她自己去搜歌挑歌',
+            description: '关着的时候她只评价你在放的，不会去翻别的。打开后她想听什么会直接说，并记进想听清单。',
+          },
+          [P('pickSource')]: {
+            type: 'string',
+            title: '上哪个曲库找',
+            description: '自动=两个库都搜再挑，有些冷门歌只有一边有；也可以固定只搜一家。',
+            enum: ['auto', 'qq', 'netease'],
+          },
+          [P('pickWhen')]: {
+            type: 'string',
+            title: '什么时候可以挑',
+            description: '问我才挑=你问她、或聊到想听什么的时候；自己挑=没歌在放的时候她可以主动挑一首，不用等你开口。',
+            enum: ['ask', 'idle'],
+          },
+        },
+      },
+    },
+    {
+      id: 'music.lyric',
+      owner: `world:${MUSIC_ID}`,
+      schema: {
+        type: 'object',
+        title: '歌词',
+        description: '打开之后她能知道这首歌此刻唱到哪一句，评价能落到词上，而不是只会说"鼓点不错"。歌词按歌名歌手去曲库反查，对不上就不给——宁可没有，也不能拿错歌的词去评。',
+        properties: {
+          [P('lyricAware')]: {
+            type: 'boolean',
+            title: '让她看歌词',
+            description: '关掉之后她只有听感：能说编曲、唱腔、节奏，说不出词里在讲什么。打开时每段会附上刚唱过的一两句，需要联网查一次词。',
+          },
+          [P('lyricLines')]: {
+            type: 'integer',
+            title: '一次给她几行',
+            description: '1–3。给两行她还能评，给三行以上她就容易照着念——那样听着像在念歌词，不是在聊天。',
+            minimum: 1,
+            maximum: 3,
+            'x-suffix': '行',
+          },
+        },
+      },
+    },
+    {
+      id: 'music.moments',
+      owner: `world:${MUSIC_ID}`,
+      schema: {
+        type: 'object',
+        title: '特殊时刻',
+        description: '两个只在特定条件下才触发的提醒，各只说一次，不反复念。',
+        properties: {
+          [P('nightFrom')]: {
+            type: 'integer',
+            title: '深夜从几点算',
+            description: '0–23，窗口到清晨 5 点。这段时间还在听，她会开口一次。',
+            minimum: 0,
+            maximum: 23,
+            'x-suffix': '点',
+          },
+          [P('longMinutes')]: {
+            type: 'integer',
+            title: '连续听多久算久',
+            description: '分钟。达标时提醒一次休息。设很大等于关掉这条。',
+            minimum: 20,
+            maximum: 480,
+            'x-suffix': '分',
+          },
+        },
+      },
+    },
+    {
+      id: 'music.data',
+      owner: `world:${MUSIC_ID}`,
+      schema: {
+        type: 'object',
+        title: '记录与位置',
+        description: '听歌记录存在哪、留多久、她能不能替你按键，以及要不要自动补齐桌宠动作。',
+        properties: {
+          [P('memoryDir')]: {
+            type: 'string',
+            title: '记忆保存位置',
+            description:
+              '留空＝跟着这台机器。填一个同步盘或移动硬盘里的文件夹，公司和家里的桌宠就是同一份记忆（听过什么、给哪首写过笔记、欠你哪几首）。'
+              + '换位置不会丢旧记录——本机原来那份仍然一起读。'
+              + '两点要注意：别两台机器同时开着往同一个目录里写，网盘同步会打架；歌词缓存和「现在在放什么」永远留在本机，不跟着走。',
+            'x-path': { kind: 'directory', recommendedDir: suggestedMemoryDir() },
+          },
+          [P('keepDays')]: {
+            type: 'integer',
+            title: '听歌记录保留',
+            description: '天。超出的旧记录在下次启动时删掉。',
+            minimum: 1,
+            maximum: 365,
+            'x-suffix': '天',
+          },
+          [P('controlAllowed')]: {
+            type: 'boolean',
+            title: '允许她替你按暂停/切歌',
+            description: '关掉之后她只能看着，不能动你的播放器。',
+          },
+          [P('autoPatchHost')]: {
+            type: 'boolean',
+            title: '自动补齐桌宠动作',
+            description:
+              '十一个自定义动作（蹦迪 / 跟着哼 / 坐着哼 等）不在本扩展里，而在桌宠宿主包里 —— '
+              + '所以从市场装到一台新机器时，它们本来是缺的，「蹦迪」会退回原地跳舞、不横着走。'
+              + '打开后每次启动都会检查宿主，缺什么补什么：动手前先备份，补完要重启一次才生效。'
+              + '关掉就只能用宿主原生的那几个动作。',
+            'x-hot': true,
+          },
+        },
+      },
+    },
+  ];
+}