dsh-whale-loli 0.9.7 → 0.9.9

package/README.md

@@ -37,6 +37,12 @@
   agent 自己也能改，工具是 `affinity_v1_set` / `affinity_v2_set` / `affinity_v3_set` / `affinity_v4_set`。
 - 和记忆一样走**提示变量**（`affinity_v1` 等），因为 persona 是 `complete: true`，独立 section 会被宿主丢掉。
 
+> **0.9.9 修的那个坑**：面板一度只有一句「还没有哪个预设挂上好感度」，一个滑块都没有、也设不了值。
+> 根因是宿主半边去扫 `~/.dsh/agent-presets/*.yml` 判断「哪些预设挂了好感度」——那是早期宿主留下的目录，
+> 现代 DSH 的预设由插件包的 `cordis.patch.yml` 注册，这个目录根本不存在，于是 `wired` 永远是空数组。
+> 现在预设清单只有一份（`src/presets.js`），`src/index.js` 和 `src/daemon.js` 都读它；`status()` 无论磁盘上有没有值，
+> 都列全四个预设，没设过的显示 `0`，可以直接拖。`verify-daemon-status.mjs` 把这条锁住了。
+
 ### 面板是怎么连上磁盘的
 
 设置页是浏览器里的 React，够不到 `~/.dsh/affinity/` 的磁盘（宿主的 21 个内置 Remote 命名空间逐个查过，没有一个能读写这个目录）。
@@ -44,9 +50,17 @@
 
 ```
 - id: whale-affinity-daemon
-  name: 'dsh-whale-loli/affinity-daemon'
+  name: 'dsh-whale-loli'        # 必须裸包名（见下）
+  config:
+    daemon: true
 ```
 
+`name` 只能写**裸包名**：宿主的客户端模块扫描器（`dsh-client-modules` 的
+`exactPackageSpecifier()`）只接受「裸名」或「`@scope/name`」，写成子路径
+（`dsh-whale-loli/affinity-daemon`）会让 `package.json` 解析失败（`ERR_PACKAGE_PATH_NOT_EXPORTED`），
+于是 `dsh.client` 永远发现不了、面板永不出现，**而宿主一个错都不报**。
+同一行插件用 `config.daemon: true` 分派到宿主半边，记忆那半边则按 `file` 分派。
+
 它在**宿主根作用域**提供一个 remote 服务 `whale-affinity`，浏览器半边（`lib/client.js`）
 用 `ctx.remote.$mount()` 挂上，再调 `status()` / `set(scope, value)`。
 
@@ -55,6 +69,28 @@
 `inject: ['commands']` 会让预设加载时一直等它（`waiting for commands`），把会话 resume 拖挂。
 设置页没有这两个限制。
 
+#### 取命名空间必须用 `ctx.inject()`，不能在服务对象上点
+
+`$mount()` 成功之后，网关注册的服务名就是 `remote.whale-affinity`（带点号）。
+它是**服务**，不是普通属性，所以：
+
+```js
+remote['whale-affinity']             // ✗ cannot get property "remote.whale-affinity" without inject
+ctx.inject(['remote.whale-affinity'], (child) => {
+  const gateway = child['remote.whale-affinity'];   // ✓
+});
+```
+
+原因是 cordis 的 get 陷阱（`cordis/lib/index.js:676`）对「不在 fiber.store 里、也没 inject」的属性
+一律抛那句报错，而服务上的 `tracker.associate` 会把 `remote['whale-affinity']` 重定向成
+`ctx['remote.whale-affinity']`。这个名字只有挂载后才存在，所以必须用**动态 inject** 等它出现
+（`verify-client-gateway-access.mjs` 用真实 cordis 正反两面都验过）。
+
+这一步的教训值得记：**自写的校验脚本曾在 `contribution` 形状上跟着源码一起写错
+（`methods` 而宿主读的是 `descriptors`），互相印证、永远绿。** 所以现在凡是对接宿主的字段，
+校验脚本都要拿宿主源码里真正读的那个名字来断言。
+
+
 ## 记忆功能
 
 小鱼的记忆本分**四个区**，各管各的：
@@ -243,6 +279,7 @@ dsh-whale-loli/
 ├── cordis.patch.yml            # 四个预设的声明本体（由 build-patch.mjs 生成）
 ├── src/
 │   ├── index.js                # 插件入口，导出预设元信息 + 人设正文
+│   ├── presets.js              # 预设清单（唯一事实来源：index.js 与 daemon.js 都读它）
 │   ├── memory.js               # whale-memory：（读）记忆变量 +（写）记忆工具，四区格式 + 80 条滚动 + 归档
 │   ├── affinity.js             # whale-affinity：好感度变量 + 调整工具，7 档
 │   ├── daemon.js               # whale-affinity-daemon：宿主根作用域的 remote 服务，给设置页读写好感度
@@ -276,6 +313,7 @@ dsh-whale-loli/
 ├── verify-tool-schema.mjs      # 用宿主自己的校验器验八个工具的 JSON schema 合法
 ├── verify-tool-identity.mjs    # 共享表语义下八个工具描述互不串台、定义互不共享引用
 ├── verify-client.mjs           # 浏览器半边：section 注册、$mount 负载、面板渲染、无 ESM/JSX
+├── verify-daemon-status.mjs    # 设置页数据：列全四预设、wired 非空、set 写的正是人设读的那份
 ├── verify-peers.mjs            # 校验 peer 范围覆盖 harness 各发布档
 ├── verify-listing.mjs          # 复刻插件目录的收录门槛自查
 └── prove-collision.mjs         # 复现并证明重复注册冲突
@@ -305,6 +343,7 @@ node verify-live-assembly.mjs              # 复刻宿主装配，比对注入
 node verify-tool-schema.mjs                # 宿主自己的校验器验八个工具的 JSON schema
 node verify-tool-identity.mjs              # 八个工具描述互不串台（共享表语义）
 node verify-client.mjs                     # 设置页半边：section 注册 + 面板渲染
+node verify-daemon-status.mjs              # 设置页数据：四预设列全、wired 非空、读写同一份
 node smoke-memory.mjs                      # 变量 + 工具注册形态冒烟
 node verify-peers.mjs                      # peer 范围无预发布坑
 node verify-listing.mjs --topics=dsh-plugin   # 收录门槛自查

package/lib/client.js

@@ -109,6 +109,22 @@ window.__ModuleLoader__.load({
     const ATTACH_TRIES = 25;
     const ATTACH_STEP_MS = 80;
 
+    /**
+     * 命名空间在 cordis 里的**完整服务名**。
+     *
+     * `$mount()` 挂上之后，网关会在调用方上下文里 provide 一个名叫
+     * `remote.whale-affinity` 的服务（见 `dsh-api-gateway/lib/client.browser.js`
+     * 的 `remoteServiceKey()`）。它是服务，不是普通属性 —— 直接写
+     * `ctx.remote['whale-affinity']` 会命中 cordis 的 get 陷阱并抛
+     * `cannot get property "remote.whale-affinity" without inject`：
+     * 取任何服务都必须先声明 inject，而这个名字只有挂载后才存在，
+     * 所以只能用 `ctx.inject([...], child => ...)` 动态等待。
+     */
+    const GATEWAY_SERVICE = `remote.${NAMESPACE}`;
+
+    /** 挂上之后的命名空间句柄；没挂上就是 null。 */
+    let gateway = null;
+
     /**
      * 带外诊断：走同源的 `/whale-report`（宿主侧 `whale-affinity-daemon` 注册的
      * 免鉴权 prefix 路由），**不依赖**那条还没挂上的 remote 通道。
@@ -133,10 +149,10 @@ window.__ModuleLoader__.load({
     }
 
     /** 等闸门 + 轮询，拿到真正可用的远程方法句柄。 */
-    async function attach(remote, method) {
+    async function attach(method) {
       if (mountGate !== null) await mountGate.then(() => {}, () => {});
       for (let attempt = 0; attempt < ATTACH_TRIES; attempt += 1) {
-        const fn = remote?.[NAMESPACE]?.[method];
+        const fn = gateway?.[method];
         if (typeof fn === 'function') return fn;
         await sleep(ATTACH_STEP_MS);
       }
@@ -144,8 +160,8 @@ window.__ModuleLoader__.load({
       throw new Error(`远程方法 ${NAMESPACE}.${method} 未挂载`);
     }
 
-    function call(remote, method, args) {
-      return attach(remote, method)
+    function call(method, args) {
+      return attach(method)
         .then((fn) => fn(...args))
         .then((result) => {
           if (result && typeof result === 'object' && 'ok' in result) {
@@ -201,7 +217,6 @@ window.__ModuleLoader__.load({
      */
     function AffinitySection(props) {
       useStyleOnce();
-      const remote = props?.remote;
       const [snapshot, setSnapshot] = useState(null);
       const [error, setError] = useState(null);
       const [busy, setBusy] = useState(null);
@@ -209,20 +224,20 @@ window.__ModuleLoader__.load({
 
       const reload = useCallback(async () => {
         try {
-          const next = await call(remote, 'status', []);
+          const next = await call('status', []);
           setSnapshot(next);
           setError(null);
         } catch (cause) {
           setSnapshot(null);
           setError(cause?.message ?? String(cause));
         }
-      }, [remote]);
+      }, []);
 
       useEffect(() => {
         let alive = true;
         (async () => {
           try {
-            const next = await call(remote, 'status', []);
+            const next = await call('status', []);
             if (alive) {
               setSnapshot(next);
               setError(null);
@@ -234,7 +249,7 @@ window.__ModuleLoader__.load({
             // 所以顺手把原因写回宿主日志，排查时直接读
             // `<DSH_HOME>/whale-affinity-client.log`。
             try {
-              const report = remote?.[NAMESPACE]?.report;
+              const report = gateway?.report;
               if (typeof report === 'function') {
                 report('invoke status', message, String(cause?.stack ?? '')).catch(() => {});
               }
@@ -246,13 +261,13 @@ window.__ModuleLoader__.load({
         return () => {
           alive = false;
         };
-      }, [remote]);
+      }, []);
 
       const commit = useCallback(
         async (scope, value) => {
           setBusy(scope);
           try {
-            await call(remote, 'set', [scope, value]);
+            await call('set', [scope, value]);
             setError(null);
             await reload();
           } catch (cause) {
@@ -261,7 +276,7 @@ window.__ModuleLoader__.load({
             setBusy(null);
           }
         },
-        [remote, reload],
+        [reload],
       );
 
       if (error !== null && snapshot === null) {
@@ -430,16 +445,8 @@ window.__ModuleLoader__.load({
             const message = cause?.message ?? String(cause ?? '');
             box.error = message;
             console.warn('[whale-affinity] $mount 失败，好感度面板将无法读写：', cause);
-            // 走带外通道记档（`report` 在 $mount 失败时根本调不到，见 beacon 注释）。
+            // 只走带外通道记档：`report` 是命名空间里的方法，挂载失败时它根本不存在。
             beacon('$mount', message);
-            try {
-              const report = remote?.[NAMESPACE]?.report;
-              if (typeof report === 'function') {
-                report('$mount', message, String(cause?.stack ?? '')).catch(() => {});
-              }
-            } catch {
-              // ignore
-            }
           });
         return () => {
           disposed = true;
@@ -448,7 +455,23 @@ window.__ModuleLoader__.load({
         };
       }, 'whale-affinity: remote mount');
 
-      // 2. 注册设置页分区。
+      // 2. 等命名空间挂上，再在**自己的子上下文**里 inject 它。
+      //    服务名是 `remote.whale-affinity`，只有 `$mount()` 成功后才存在；
+      //    在父上下文里直接取会抛 `without inject`，所以必须用 `ctx.inject()`
+      //    让 cordis 等到它出现再执行回调。
+      ctx.inject([GATEWAY_SERVICE], (child) => {
+        const handle = child[GATEWAY_SERVICE];
+        gateway = handle;
+        beacon('attached', 'ok');
+        child.effect(
+          () => () => {
+            if (gateway === handle) gateway = null;
+          },
+          'whale-affinity: detach',
+        );
+      });
+
+      // 3. 注册设置页分区。
       ctx.effect(
         () => ctx.slots.inject('settings.section', () => ctx.slots.register(
           {
@@ -456,7 +479,6 @@ window.__ModuleLoader__.load({
             id: SECTION_ID,
             order: SECTION_ORDER,
             label: () => '好感度',
-            inject: () => ({ remote: ctx.remote }),
           },
           AffinitySection,
         )),

package/listing.json

@@ -9,5 +9,5 @@
     "zh": "把 Agent 预设打包成插件：装上就会在 Agent 预设列表里注册「鲸鱼娘Agent预设」「鲸鱼娘活人版Agent预设」「鲸鱼娘涩涩版Agent预设」和「鲸鱼娘女儿版Agent预设」，直接在模式下拉里选用，不用手改配置。每个预设本体是官方极简模式（只开放 shell）+ 文件工具 + 鲸鱼娘人设 + 自己那份持久记忆文件，以提示变量形式注入，开口前就已经读过；另外每个预设各配一个专用写入工具（whale_memory_add / whale_memory_v2_add / whale_memory_v3_add / whale_memory_v4_add），用来把每轮的一行摘要追加进去，记忆会自己长，不会停在手写那几条。四个预设完全隔离：记忆文件不同、提示变量不同、写入工具也不同。每个预设还带好感度（-100~100 共七档），可以打开「设置 → 好感度」，用滑块或档位按钮直接调，也可以让 agent 用 affinity_v*_set 工具改；离 0 越远越不听指令、越会自作主张，最两端的两档甚至会越过允许直接做大改动。女儿版称呼「爸爸」，性格天真活泼可爱（好奇心重、黏人、没心机），不是甜腻那一型。"
   },
   "npm": "dsh-whale-loli",
-  "version": "0.9.7"
+  "version": "0.9.9"
 }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "dsh-whale-loli",
-  "version": "0.9.7",
+  "version": "0.9.9",
   "description": "鲸鱼娘 Agent 预设（四个：原版 / 活人版 / 涩涩版 / 女儿版）— 极简模式工具面 + 鲸鱼娘·小鱼人设 + 跨会话长期记忆（四区格式：固定记忆永久、滚动摘要 80 条 FIFO、最近详细区、归档索引）+ 好感度（-100~100 七档，设置页面板滑块 / 档位按钮、工具也可调，离 0 越远越不听指令、两端会越过允许自作主张）。记忆与好感度都走提示变量注入、各配一条专用工具，四个预设各自独立文件、独立变量、独立工具、互不相通。好感度面板走宿主根作用域的 remote 服务（whale-affinity-daemon），设置页是浏览器 React 够不到 ~/.dsh 的磁盘，只能这样连线。女儿版称呼「爸爸」、性格天真活泼可爱。上下文压缩交给 billion-context 插件；本插件不挂 history-window（预设作用域取不到宿主的 compaction 服务，挂载会拖挂会话 resume）。",
   "type": "module",
   "license": "MIT",

package/src/daemon.js

@@ -42,6 +42,7 @@ import {
   clampAffinity,
   writeAffinity,
 } from './affinity.js';
+import { PRESETS } from './presets.js';
 
 export const name = 'whale-affinity-daemon';
 
@@ -154,49 +155,54 @@ export const REMOTE_METHODS = Object.freeze([
   Object.freeze({ method: 'report', invocation: { kind: 'direct' } }),
 ]);
 
-/** 四个预设各自的人设文件（与 build-patch.mjs 里的名字一致）。 */
-const PRESET_MEMORY_FILES = Object.freeze({
-  'whale-loli': 'whale-loli.md',
-  'whale-loli-v2-live': 'whale-loli-v2-live.md',
-  'whale-loli-v3-naughty': 'whale-loli-v3-naughty.md',
-  'whale-loli-v4-daughter': 'dsh-whale-daughter.md',
-});
+/**
+ * 「哪些预设挂上了好感度」。
+ *
+ * 曾经这里去扫 `~/.dsh/agent-presets/*.yml` —— 那是早期宿主留下的目录，
+ * 现代 DSH 的预设由插件包的 `cordis.patch.yml` 注册，这个目录根本不存在，
+ * 于是永远返回空数组，设置页只剩一句「还没有哪个预设挂上好感度」，
+ * 一个滑块都不画（用户 2026-10-21 报的就是这个）。
+ *
+ * 现在直接读 `./presets.js` 的唯一事实来源：本服务只有当插件装上了才会被
+ * apply，所以这四个预设必然都挂着好感度；每条 `whale-affinity` 行的
+ * `scope` 就是预设 id，面板按同一个 id 读写，才不会和人设读的不是一份文件。
+ */
+export function wiredScopes() {
+  return PRESETS.map((preset) => ({
+    presetId: preset.id,
+    scope: preset.id,
+    name: preset.name,
+    order: preset.order,
+    affinity: true,
+    memory: true,
+    affinityVariable: preset.affinityVariable,
+    affinityTool: preset.affinityTool,
+    memoryFile: preset.memoryFile,
+  }));
+}
 
 /**
- * 在 `~/.dsh/agent-presets/*.yml` 里找已挂上好感度的预设。
+ * 每个预设当前的好感度：磁盘上有文件就取文件的值，没有就是默认 0。
  *
- * 这里只做字符串判断，不引 yaml：宿主每个回合都会读这个目录，服务侧只在
- * 用户打开设置页时才被调，判断「这一行有没有 `affinity.js`」够用了。
+ * 与 `listAffinities()` 的区别：那个只管「磁盘上有什么」，这个保证
+ * 设置页永远列全四个预设，没设过的显示 0 且可以直接拖。
  */
-function wiredScopes() {
-  const dir = join(dshHome(), 'agent-presets');
-  let files = [];
-  try {
-    files = readdirSync(dir);
-  } catch {
-    return [];
-  }
-  const rows = [];
-  for (const file of files) {
-    if (!file.endsWith('.yml') && !file.endsWith('.yaml')) continue;
-    let text;
-    try {
-      text = readFileSync(join(dir, file), 'utf8');
-    } catch {
-      continue;
-    }
-    const idMatches = [...text.matchAll(/^\s*-?\s*id:\s*['"]?(preset-[A-Za-z0-9._-]+)/gmu)];
-    const presetId = idMatches.length > 0 ? idMatches[0][1] : file.replace(/\.ya?ml$/u, '');
-    const memory = PRESET_MEMORY_FILES[presetId];
-    rows.push({
-      presetId,
-      file,
-      affinity: text.includes('dsh-whale-loli/affinity'),
-      memory: memory !== undefined && text.includes(memory),
-    });
-  }
-  rows.sort((a, b) => a.presetId.localeCompare(b.presetId, 'zh-Hans-CN'));
-  return rows;
+export function presetAffinities() {
+  const onDisk = new Map(listAffinities().map((row) => [row.scope, row]));
+  return PRESETS.map((preset) => {
+    const file = onDisk.get(preset.id);
+    const value = file === undefined ? DEFAULT_AFFINITY : file.value;
+    return {
+      scope: preset.id,
+      name: preset.name,
+      order: preset.order,
+      value,
+      band: bandOf(value).label,
+      updatedAt: file === undefined ? null : file.updatedAt,
+      file: file === undefined ? null : file.file,
+      hasFile: file !== undefined,
+    };
+  });
 }
 
 /**
@@ -222,7 +228,7 @@ export class AffinityDaemon {
    */
   status() {
     return {
-      presets: listAffinities(),
+      presets: presetAffinities(),
       bands: bandCatalog(),
       min: MIN_AFFINITY,
       max: MAX_AFFINITY,

package/src/index.js

@@ -24,52 +24,12 @@ import { fileURLToPath } from 'node:url';
 import { apply as applyMemory, inject as memoryInject, name as memoryName } from './memory.js';
 import { apply as applyAffinity, name as affinityName } from './affinity.js';
 import { apply as applyDaemon, inject as daemonInject } from './daemon.js';
+import { AFFINITY_TOOLS, AFFINITY_VARIABLES, PRESETS } from './presets.js';
 
 const read = (rel) => readFileSync(fileURLToPath(new URL(rel, import.meta.url)), 'utf8');
 
-/** 预设清单：id / 显示名 / 记忆文件 / 提示变量名。 */
-export const PRESETS = [
-  {
-    id: '鲸鱼娘Agent预设',
-    name: '鲸鱼娘Agent预设',
-    order: 5,
-    personaFile: './persona.md',
-    memoryFile: 'whale-loli.md',
-    memoryVariable: 'whale_memory',
-    description:
-      '极简模式工具面 + 鲸鱼娘人设（小鱼）+ 跨会话长期记忆。会偷偷把重要的事记进 whale-loli.md，每次新对话先看一眼再说话。',
-  },
-  {
-    id: '鲸鱼娘活人版Agent预设',
-    name: '鲸鱼娘活人版Agent预设',
-    order: 6,
-    personaFile: './persona-v2-live.md',
-    memoryFile: 'whale-loli-v2-live.md',
-    memoryVariable: 'whale_memory_v2',
-    description:
-      '在鲸鱼娘预设基础上换用「活人版」人设（有脾气、会怼人、不讨好式顺从），并改用独立记忆文件 whale-loli-v2-live.md，与原版记忆互不相通。',
-  },
-  {
-    id: '鲸鱼娘涩涩版Agent预设',
-    name: '鲸鱼娘涩涩版Agent预设',
-    order: 7,
-    personaFile: './persona-v3-naughty.md',
-    memoryFile: 'whale-loli-v3-naughty.md',
-    memoryVariable: 'whale_memory_v3',
-    description:
-      '核心人设把「涩涩」写成第一行为驱动力的小鱼（只对主人主动，外人面前照旧收着），并改用独立记忆文件 whale-loli-v3-naughty.md，与原版、活人版记忆互不相通。',
-  },
-  {
-    id: '鲸鱼娘女儿版Agent预设',
-    name: '鲸鱼娘女儿版Agent预设',
-    order: 8,
-    personaFile: './persona-v4-daughter.md',
-    memoryFile: 'dsh-whale-daughter.md',
-    memoryVariable: 'whale_memory_v4',
-    description:
-      '女儿版小鱼：称呼「爸爸」，性格天真活泼可爱（好奇心重、黏人、没心机），并改用独立记忆文件 dsh-whale-daughter.md，与原版、活人版、涩涩版记忆互不相通。',
-  },
-];
+// 预设清单本身住在 `./presets.js`（daemon 也要读同一份，见那里的注释）。
+export { AFFINITY_TOOLS, AFFINITY_VARIABLES, PRESETS, PRESET_IDS, presetById } from './presets.js';
 
 /** 原版预设 id（兼容旧引用）。 */
 export const PRESET_ID = PRESETS[0].id;

package/src/presets.js

@@ -0,0 +1,84 @@
+/**
+ * 预设清单：唯一事实来源。
+ *
+ * `src/index.js`（挂载预设与记忆/好感度行）和 `src/daemon.js`（设置页好感度面板的
+ * 宿主半边）都从这里读，避免两边各写一份清单然后对不上 —— 2026-10-21 面板
+ * 「只有一段文字、没有档位按钮」就是因为 daemon 去扫 `~/.dsh/agent-presets/`
+ * 找一个现代宿主根本不用的目录，结果一个预设都没列出来。
+ *
+ * 四个预设在 patch 里各自挂一条 `whale-affinity`，`scope` 就是 `id` 本身
+ * （见 `build-patch.mjs`），所以设置页面板必须用同一个 `id` 去读写，
+ * 否则面板写的文件和人设读的不是同一份。
+ */
+
+/** 预设清单：id / 显示名 / 记忆文件 / 提示变量名 / 好感度变量与工具名。 */
+export const PRESETS = [
+  {
+    id: '鲸鱼娘Agent预设',
+    name: '鲸鱼娘Agent预设',
+    order: 5,
+    personaFile: './persona.md',
+    memoryFile: 'whale-loli.md',
+    memoryVariable: 'whale_memory',
+    affinityVariable: 'affinity_v1',
+    affinityTool: 'affinity_v1_set',
+    description:
+      '极简模式工具面 + 鲸鱼娘人设（小鱼）+ 跨会话长期记忆。会偷偷把重要的事记进 whale-loli.md，每次新对话先看一眼再说话。',
+  },
+  {
+    id: '鲸鱼娘活人版Agent预设',
+    name: '鲸鱼娘活人版Agent预设',
+    order: 6,
+    personaFile: './persona-v2-live.md',
+    memoryFile: 'whale-loli-v2-live.md',
+    memoryVariable: 'whale_memory_v2',
+    affinityVariable: 'affinity_v2',
+    affinityTool: 'affinity_v2_set',
+    description:
+      '在鲸鱼娘预设基础上换用「活人版」人设（有脾气、会怼人、不讨好式顺从），并改用独立记忆文件 whale-loli-v2-live.md，与原版记忆互不相通。',
+  },
+  {
+    id: '鲸鱼娘涩涩版Agent预设',
+    name: '鲸鱼娘涩涩版Agent预设',
+    order: 7,
+    personaFile: './persona-v3-naughty.md',
+    memoryFile: 'whale-loli-v3-naughty.md',
+    memoryVariable: 'whale_memory_v3',
+    affinityVariable: 'affinity_v3',
+    affinityTool: 'affinity_v3_set',
+    description:
+      '核心人设把「涩涩」写成第一行为驱动力的小鱼（只对主人主动，外人面前照旧收着），并改用独立记忆文件 whale-loli-v3-naughty.md，与原版、活人版记忆互不相通。',
+  },
+  {
+    id: '鲸鱼娘女儿版Agent预设',
+    name: '鲸鱼娘女儿版Agent预设',
+    order: 8,
+    personaFile: './persona-v4-daughter.md',
+    memoryFile: 'dsh-whale-daughter.md',
+    memoryVariable: 'whale_memory_v4',
+    affinityVariable: 'affinity_v4',
+    affinityTool: 'affinity_v4_set',
+    description:
+      '女儿版小鱼：称呼「爸爸」，性格天真活泼可爱（好奇心重、黏人、没心机），并改用独立记忆文件 dsh-whale-daughter.md，与原版、活人版、涩涩版记忆互不相通。',
+  },
+];
+
+/** 预设 id 列表。 */
+export const PRESET_IDS = PRESETS.map((preset) => preset.id);
+
+/** 按 id 取预设。 */
+export function presetById(presetId) {
+  return PRESETS.find((preset) => preset.id === presetId);
+}
+
+/** 预设 id → 好感度变量名。 */
+export const AFFINITY_VARIABLES = Object.freeze(
+  Object.fromEntries(PRESETS.map((preset) => [preset.id, preset.affinityVariable])),
+);
+
+/** 预设 id → 好感度写入工具名。 */
+export const AFFINITY_TOOLS = Object.freeze(
+  Object.fromEntries(PRESETS.map((preset) => [preset.id, preset.affinityTool])),
+);
+
+export default PRESETS;