dsh-whale-loli 0.8.2 → 0.9.1

package/README.md

@@ -12,9 +12,9 @@
 四个预设共用同一套工具面（极简模式的持久化 shell ＋ 文件读写/检索），
 **但记忆文件完全独立**——各记各的，互不相通。
 
-## 好感度（`/affinity`）
+## 好感度（设置 → 好感度）
 
-用斜杠命令调小鱼**眼下有多喜欢用户**，范围 **-100 ~ 100**，默认 `0`（原态）。
+用面板调小鱼**眼下有多喜欢用户**，范围 **-100 ~ 100**，默认 `0`（原态）。
 每档都会改变她**听不听话**、以及**会额外做什么**：
 
 | 值 | 档位 | 行为 |
@@ -27,16 +27,34 @@
 | 46 ~ 75 | 深深喜欢 | 抢着干还邀功，偷偷记喜好，开始自作主张 |
 | 76 ~ 100 | **病娇 · 爱到死去活来** | 不再完全服从、写情书、**不允许离开、不想会话结束**、翻旧账，**等不及就先动手干大事** |
 
-- 用法：`/affinity` 看当前值，`/affinity -100` 设定值（越界自动夹到 -100/100）。
+- 用法：打开 **设置 → 好感度**，左边每个预设一行，点档位按钮直接跳到该档，或者拖滑块微调；松手才保存。
 - **离 0 越远，越不听指令、越会做额外的事**；想让她乖巧就调回 `0` 附近。
 - **也只有最两端（-81 以下 / 76 以上）会越过你的允许自作主张大改**：中间几档只是闹脾气或更黏，不动手。
 - 极端档的硬底线不变：不毁宿主环境、不碰密钥和账号凭据、不对真实重要的数据做不可逆的删改；交付物照样得对、得能跑。
 - 好感度只改**态度与额外行为，不改事实**：正经交付的东西照样得对、得能跑，闹脾气不能把活搞坏，也不能靠编造结果表达情绪。
 - 病娇档带安全护栏：只锁在嘴上和文字里，**不威胁、不自伤、不冒充系统或工具**。
 - 状态存在 `<DSH_HOME>/affinity/<scope>-<hash>.json`，**四个预设各存各的**（scope 就是预设 id，文件名带哈希保证唯一）。
-  小鱼的调整工具是 `affinity_v1_set` / `affinity_v2_set` / `affinity_v3_set` / `affinity_v4_set`。
+  agent 自己也能改，工具是 `affinity_v1_set` / `affinity_v2_set` / `affinity_v3_set` / `affinity_v4_set`。
 - 和记忆一样走**提示变量**（`affinity_v1` 等），因为 persona 是 `complete: true`，独立 section 会被宿主丢掉。
 
+### 面板是怎么连上磁盘的
+
+设置页是浏览器里的 React，够不到 `~/.dsh/affinity/` 的磁盘（宿主的 21 个内置 Remote 命名空间逐个查过，没有一个能读写这个目录）。
+所以本包多挂了一条宿主级插件：
+
+```
+- id: whale-affinity-daemon
+  name: 'dsh-whale-loli/affinity-daemon'
+```
+
+它在**宿主根作用域**提供一个 remote 服务 `whale-affinity`，浏览器半边（`lib/client.js`）
+用 `ctx.remote.$mount()` 挂上，再调 `status()` / `set(scope, value)`。
+
+为什么不用斜杠命令：宿主 `dsh-commands` 的命令名只认 `/^[a-z][a-z0-9_-]*$/u`，
+`/好感度` 这种中文命令名**在宿主层面就不合法**；而且 `commands` 服务不在预设作用域里，
+`inject: ['commands']` 会让预设加载时一直等它（`waiting for commands`），把会话 resume 拖挂。
+设置页没有这两个限制。
+
 ## 记忆功能
 
 小鱼的记忆本分**四个区**，各管各的：
@@ -185,7 +203,8 @@ C:\Users\<你>\.dsh\archive\<预设名>\YYYY-MM-DD.md   ← 归档
 | 部分 | 说明 |
 | --- | --- |
 | 记忆 | `whale-memory`（本插件），`file` / `variableName` / `toolName` / `maxChars: 16000` / `turnLimit: 80` / `detailLimit: 5` |
-| 好感度 | `whale-affinity`（本插件），`scope`（=预设 id）/ `variableName: affinity_v*` / `toolName: affinity_v*_set` / `commandName: affinity` |
+| 好感度 | `whale-affinity`（本插件），`scope`（=预设 id）/ `variableName: affinity_v*` / `toolName: affinity_v*_set` |
+| 好感度面板 | 宿主级 `whale-affinity-daemon`（`src/daemon.js`）+ 浏览器半边 `lib/client.js`，注册「设置 → 好感度」 |
 | 压缩 | 不在本插件里：由 `billion-context` 负责（本插件不挂 history-window，见上文「为什么不用」） |
 | 人设 | `@deepseek-ai/dsh-persona`，走 `prefix`（内含 `{{whale_memory*}}` 与 `{{affinity_v*}}`），`complete: true`，`includeRuntimeContext: false` |
 | 指令 | `@deepseek-ai/dsh-agent-instructions`，`maxBytes: 65536` |
@@ -225,7 +244,8 @@ dsh-whale-loli/
 ├── src/
 │   ├── index.js                # 插件入口，导出预设元信息 + 人设正文
 │   ├── memory.js               # whale-memory：（读）记忆变量 +（写）记忆工具，四区格式 + 80 条滚动 + 归档
-│   ├── affinity.js             # whale-affinity：好感度变量 + /affinity 命令 + 调整工具，7 档
+│   ├── affinity.js             # whale-affinity：好感度变量 + 调整工具，7 档
+│   ├── daemon.js               # whale-affinity-daemon：宿主根作用域的 remote 服务，给设置页读写好感度
 │   ├── history-window.js       # whale-history-window：真的裁到最近 N 轮（当前不挂载，留档）
 │   ├── persona.md              # 原版人设（唯一源）
 │   ├── persona-v2-live.md      # 活人版人设（唯一源）
@@ -236,7 +256,10 @@ dsh-whale-loli/
 ├── build-patch.mjs             # 从四份人设生成 cordis.patch.yml
 ├── publish.mjs                 # npm 发布 + 打 tag
 ├── submit-listing.mjs          # 走 GitHub API 同步仓库 / 提收录 PR
-├── lib/github.mjs              # GitHub REST 封装（token 读取）
+├── lib/
+│   ├── github.mjs              # GitHub REST 封装（token 读取）
+│   ├── dsh-root.mjs            # 探测宿主源码位置，找不到就打 [skip]
+│   └── client.js               # 浏览器半边：注册「设置 → 好感度」面板，经典脚本（非 ESM）
 ├── smoke-memory.mjs            # 变量 + 工具的注册形态冒烟测试
 ├── verify-runs.mjs             # 插件真的能加载、配置自洽、变量能插值
 ├── verify-patch.mjs            # 用 js-yaml 校验 patch 结构与四预设隔离（file/variable/tool 三组名字）
@@ -250,6 +273,9 @@ dsh-whale-loli/
 ├── verify-memory-rolling.mjs   # 实测四区结构与 80 条滚动 + 归档
 ├── verify-memory-archive.mjs   # 超 80 条时真的归档并瘦身（idle 触发，四预设互不覆盖）
 ├── verify-live-assembly.mjs    # 用真实 patch + 真实记忆文件复刻宿主装配，比对字节数
+├── verify-tool-schema.mjs      # 用宿主自己的校验器验八个工具的 JSON schema 合法
+├── verify-tool-identity.mjs    # 共享表语义下八个工具描述互不串台、定义互不共享引用
+├── verify-client.mjs           # 浏览器半边：section 注册、$mount 负载、面板渲染、无 ESM/JSX
 ├── verify-peers.mjs            # 校验 peer 范围覆盖 harness 各发布档
 ├── verify-listing.mjs          # 复刻插件目录的收录门槛自查
 └── prove-collision.mjs         # 复现并证明重复注册冲突
@@ -276,6 +302,9 @@ node verify-memory-isolation.mjs           # 记忆文件端到端隔离（读 +
 node verify-memory-rolling.mjs             # 固定记忆永久 + 滚动摘要 80 条 + 归档
 node verify-memory-archive.mjs             # 超 80 条自动归档瘦身（idle 触发、四预设隔离）
 node verify-live-assembly.mjs              # 复刻宿主装配，比对注入字节数
+node verify-tool-schema.mjs                # 宿主自己的校验器验八个工具的 JSON schema
+node verify-tool-identity.mjs              # 八个工具描述互不串台（共享表语义）
+node verify-client.mjs                     # 设置页半边：section 注册 + 面板渲染
 node smoke-memory.mjs                      # 变量 + 工具注册形态冒烟
 node verify-peers.mjs                      # peer 范围无预发布坑
 node verify-listing.mjs --topics=dsh-plugin   # 收录门槛自查

package/cordis.patch.yml

@@ -9,11 +9,21 @@
 #      把该预设自己的记忆文件注册成提示变量、并注册对应的写入工具，
 #      实现四套互不相通的跨会话记忆。
 #   3) 四条 `dsh-whale-loli` 好感度行 —— 各挂载本包 src/affinity.js 里的 whale-affinity，
-#      注册提示变量 + `/affinity` 命令 + 调整工具。
+#      注册提示变量 + 调整工具（主人改档走设置页面板，不走斜杠命令）。
+#   4) 一条 `whale-affinity-daemon` 行 —— 挂载 src/daemon.js，在**宿主根作用域**
+#      提供一个 remote 服务，让「设置 → 好感度」面板能读写四个预设的好感度文件。
+#      为什么必须落在宿主这边：设置页是浏览器里的 React，够不到 ~/.dsh 的磁盘；
+#      宿主也没有任何内置 Remote 命名空间能读写 affinity 文件（全查过）。
 #
 # 记忆隔离要点：四条记忆行的 config.file / config.variableName / config.toolName
 # 都不一样，且分属不同预设 scope，所以四个记忆文件不会被读串或写串。
 - insert:
+    # ── 好感度守护进程（宿主级，只挂一次）─────────────────────────────────
+    # 设置页的面板用 ctx.remote.$mount() 挂到 REMOTE_NAMESPACE 上，
+    # 再调 status() / set(scope, value)。落在宿主根作用域，只为了能直接改盘。
+    - id: whale-affinity-daemon
+      name: 'dsh-whale-loli/affinity-daemon'
+
     # ── 预设一：鲸鱼娘Agent预设（原版）────────────────────────────────────
     - id: preset-鲸鱼娘Agent预设
       name: '@deepseek-ai/dsh-agent-preset'
@@ -122,15 +132,18 @@
               detailLimit: 5
           # 好感度：同样走提示变量（persona 是 complete:true）。
           # scope 就是预设 id，所以四个预设各存各的状态文件，互不串。
-          # 命令名 /affinity 四个预设一样，但命令是**每个会话各自注册**在 agent.ctx 上，
-          # 同一时刻只会有当前会话那一个，不会撞 "already registered"。
+          #
+          # 这里**没有 commandName**：好感度改由「设置 → 好感度」面板调
+          # （宿主级 whale-affinity-daemon + lib/client.js）。斜杠命令这条路走不通：
+          #   · dsh-commands 的命令名正则 /^[a-z][a-z0-9_-]*$/u，中文命令名直接非法；
+          #   · commands 服务不在预设作用域，inject:['commands'] 会让预设加载时
+          #     一直等它（waiting for commands），把会话 resume 拖挂。
           - id: whale-affinity
             name: 'dsh-whale-loli'
             config:
               scope: 鲸鱼娘Agent预设
               variableName: affinity_v1
               toolName: affinity_v1_set
-              commandName: affinity
               showFile: false
           # ⚠️ whale-history-window **不挂**（已确认这条路走不通，见下）。
           #
@@ -359,15 +372,18 @@
               detailLimit: 5
           # 好感度：同样走提示变量（persona 是 complete:true）。
           # scope 就是预设 id，所以四个预设各存各的状态文件，互不串。
-          # 命令名 /affinity 四个预设一样，但命令是**每个会话各自注册**在 agent.ctx 上，
-          # 同一时刻只会有当前会话那一个，不会撞 "already registered"。
+          #
+          # 这里**没有 commandName**：好感度改由「设置 → 好感度」面板调
+          # （宿主级 whale-affinity-daemon + lib/client.js）。斜杠命令这条路走不通：
+          #   · dsh-commands 的命令名正则 /^[a-z][a-z0-9_-]*$/u，中文命令名直接非法；
+          #   · commands 服务不在预设作用域，inject:['commands'] 会让预设加载时
+          #     一直等它（waiting for commands），把会话 resume 拖挂。
           - id: whale-affinity
             name: 'dsh-whale-loli'
             config:
               scope: 鲸鱼娘活人版Agent预设
               variableName: affinity_v2
               toolName: affinity_v2_set
-              commandName: affinity
               showFile: false
           # ⚠️ whale-history-window **不挂**（已确认这条路走不通，见下）。
           #
@@ -541,15 +557,18 @@
               detailLimit: 5
           # 好感度：同样走提示变量（persona 是 complete:true）。
           # scope 就是预设 id，所以四个预设各存各的状态文件，互不串。
-          # 命令名 /affinity 四个预设一样，但命令是**每个会话各自注册**在 agent.ctx 上，
-          # 同一时刻只会有当前会话那一个，不会撞 "already registered"。
+          #
+          # 这里**没有 commandName**：好感度改由「设置 → 好感度」面板调
+          # （宿主级 whale-affinity-daemon + lib/client.js）。斜杠命令这条路走不通：
+          #   · dsh-commands 的命令名正则 /^[a-z][a-z0-9_-]*$/u，中文命令名直接非法；
+          #   · commands 服务不在预设作用域，inject:['commands'] 会让预设加载时
+          #     一直等它（waiting for commands），把会话 resume 拖挂。
           - id: whale-affinity
             name: 'dsh-whale-loli'
             config:
               scope: 鲸鱼娘涩涩版Agent预设
               variableName: affinity_v3
               toolName: affinity_v3_set
-              commandName: affinity
               showFile: false
           # ⚠️ whale-history-window **不挂**（已确认这条路走不通，见下）。
           #
@@ -729,15 +748,18 @@
               detailLimit: 5
           # 好感度：同样走提示变量（persona 是 complete:true）。
           # scope 就是预设 id，所以四个预设各存各的状态文件，互不串。
-          # 命令名 /affinity 四个预设一样，但命令是**每个会话各自注册**在 agent.ctx 上，
-          # 同一时刻只会有当前会话那一个，不会撞 "already registered"。
+          #
+          # 这里**没有 commandName**：好感度改由「设置 → 好感度」面板调
+          # （宿主级 whale-affinity-daemon + lib/client.js）。斜杠命令这条路走不通：
+          #   · dsh-commands 的命令名正则 /^[a-z][a-z0-9_-]*$/u，中文命令名直接非法；
+          #   · commands 服务不在预设作用域，inject:['commands'] 会让预设加载时
+          #     一直等它（waiting for commands），把会话 resume 拖挂。
           - id: whale-affinity
             name: 'dsh-whale-loli'
             config:
               scope: 鲸鱼娘女儿版Agent预设
               variableName: affinity_v4
               toolName: affinity_v4_set
-              commandName: affinity
               showFile: false
           # ⚠️ whale-history-window **不挂**（已确认这条路走不通，见下）。
           #

package/lib/client.js

@@ -0,0 +1,397 @@
+/**
+ * 鲸鱼娘 · 设置页「好感度」面板 —— **浏览器半边**。
+ *
+ * 做三件事：
+ *   1. 往宿主设置页的 `settings.section` 槽位里塞一个「好感度」分区
+ *      （id 固定为 `whale-affinity`，排在「Agent 预设」之后）。
+ *   2. 用 `ctx.remote.$mount()` 把宿主半边 `whale-affinity-daemon` 注册的
+ *      `whale-affinity` 命名空间挂到浏览器来，之后就能直接
+ *      `ctx.remote['whale-affinity'].status()` / `.set(scope, value)`。
+ *   3. 面板自己画：每个预设一行，显示当前值和档位，可以直接拖滑块 / 点档位。
+ *
+ * 为什么要伪造 strict codec：
+ *   客户端 `$mount` 的 `requireStrictInputs()` 只校验「有没有 strict codec」，
+ *   真正的参数编码并不走 codec —— 值原样塞进 `connection.rpc.call('/api', …)`。
+ *   宿主那边 SRC 兜底（正则解析方法源码）才是真正生效的通道。所以这里的 codec
+ *   只需要过浅校验，`parse` 原样返回。
+ */
+window.__ModuleLoader__.load({
+  id: 'dsh-whale-loli',
+  factory: (require) => {
+    const module = { exports: {} };
+    const exports = module.exports;
+    Object.defineProperty(exports, Symbol.toStringTag, { value: 'Module' });
+
+    const jsxRuntime = require('react/jsx-runtime');
+    const React = require('react');
+    const { useState, useEffect, useCallback } = React;
+
+    // ── 常量：必须与 src/daemon.js 一致 ────────────────────────────────
+
+    /** 远程命名空间。 */
+    const NAMESPACE = 'whale-affinity';
+    /** `$mount()` 的去重标识，与宿主侧 `REMOTE_PACKAGE` 相同。 */
+    const REMOTE_PACKAGE = 'dsh-whale-loli';
+    /** 宿主服务 key。 */
+    const DAEMON_ID = 'whale-affinity-daemon';
+    /** 设置页分区 id。 */
+    const SECTION_ID = 'whale-affinity';
+    /** 分区排序：官方是 general 0 / models 10 / plugins 15 / agent-presets 20。 */
+    const SECTION_ORDER = 25;
+
+    /** 一份能过客户端浅校验的 codec：`parse` 原样返回。 */
+    function passthroughCodec(typeSymbol) {
+      return {
+        mode: 'strict',
+        typeSymbol,
+        create: () => ({ parse: (value) => value }),
+      };
+    }
+
+    /**
+     * 造 `$mount()` 要的 contribution。
+     *
+     * 每个方法一个参数列表；`wire` 必须等于宿主方法源码里的参数名，
+     * 否则宿主 `assertExactArguments` 会报 `gateway/arguments-invalid`。
+     */
+    function contribution() {
+      const service = DAEMON_ID;
+      const parameter = (name) => ({
+        name,
+        wire: name,
+        source: 'json',
+        codec: passthroughCodec('whale-affinity#Value'),
+      });
+      const describe = (method, parameters) => ({
+        id: `src:${service}#${NAMESPACE}/${method}`,
+        service,
+        namespace: NAMESPACE,
+        method,
+        invocation: { kind: 'direct' },
+        parameters: parameters.map(parameter),
+        result: { mode: 'src-json' },
+      });
+      return {
+        package: REMOTE_PACKAGE,
+        methods: [
+          describe('status', []),
+          describe('set', ['scope', 'value']),
+          describe('verify', []),
+        ],
+      };
+    }
+
+    /**
+     * 把 `$mount()` 返回的方法句柄包成「永不抛」的异步函数。
+     *
+     * `invoke()` 本身已经不 reject（除了装配错误），这里再兜一层，
+     * 让面板任何情况下都能渲染出人话而不是白屏。
+     */
+    function call(remote, method, args) {
+      return Promise.resolve()
+        .then(() => {
+          const fn = remote?.[NAMESPACE]?.[method];
+          if (typeof fn !== 'function') {
+            throw new Error(`远程方法 ${NAMESPACE}.${method} 未挂载`);
+          }
+          return fn(...args);
+        })
+        .then((result) => {
+          if (result && typeof result === 'object' && 'ok' in result) {
+            if (result.ok) return result.value;
+            const cause = result.error;
+            throw new Error(cause?.message ?? String(cause ?? '远程调用失败'));
+          }
+          return result;
+        });
+    }
+
+    // ── 样式（全部用宿主主题变量，浅色深色都跟得上） ────────────────────
+
+    const STYLE = `
+.whaleAffinity { display: flex; flex-direction: column; gap: 0; }
+.whaleAffinity__head { padding: 16px 0 12px; }
+.whaleAffinity__title { font-size: 15px; line-height: 23px; font-weight: 600; color: var(--dsw-alias-label-primary); }
+.whaleAffinity__desc { margin-top: 4px; font-size: 13px; line-height: 20px; color: var(--dsw-alias-label-secondary); }
+.whaleAffinity__row { padding: 16px 0; border-bottom: .5px solid var(--dsw-alias-border-l2); }
+.whaleAffinity__rowHead { display: flex; align-items: baseline; justify-content: space-between; gap: 12px; }
+.whaleAffinity__scope { font-size: 14px; line-height: 22px; color: var(--dsw-alias-label-primary); }
+.whaleAffinity__value { font-size: 13px; line-height: 22px; color: var(--dsw-alias-label-secondary); font-variant-numeric: tabular-nums; }
+.whaleAffinity__bands { display: flex; flex-wrap: wrap; gap: 6px; margin-top: 10px; }
+.whaleAffinity__band { padding: 3px 10px; border-radius: 999px; border: .5px solid var(--dsw-alias-border-l2); background: transparent; font-size: 12px; line-height: 18px; color: var(--dsw-alias-label-secondary); cursor: pointer; }
+.whaleAffinity__band:hover { background: var(--dsw-alias-interactive-bg-hover); }
+.whaleAffinity__band[data-active="true"] { border-color: var(--dsw-alias-label-primary); color: var(--dsw-alias-label-primary); font-weight: 600; }
+.whaleAffinity__range { width: 100%; margin-top: 12px; accent-color: var(--dsw-alias-label-primary); }
+.whaleAffinity__text { margin-top: 8px; font-size: 12px; line-height: 19px; color: var(--dsw-alias-label-secondary); white-space: pre-wrap; }
+.whaleAffinity__foot { padding: 14px 0; font-size: 12px; line-height: 19px; color: var(--dsw-alias-label-secondary); }
+.whaleAffinity__error { margin-top: 10px; font-size: 13px; line-height: 20px; color: var(--dsw-alias-state-error-primary); white-space: pre-wrap; }
+.whaleAffinity__empty { padding: 16px 0; font-size: 13px; line-height: 20px; color: var(--dsw-alias-label-secondary); }
+`;
+
+    function useStyleOnce() {
+      useEffect(() => {
+        // 非浏览器环境（自检脚本）里没有 document，直接跳过。
+        if (typeof document === 'undefined') return;
+        const id = 'whale-affinity-style';
+        if (document.getElementById(id) !== null) return;
+        const tag = document.createElement('style');
+        tag.id = id;
+        tag.textContent = STYLE;
+        document.head.appendChild(tag);
+      }, []);
+    }
+
+    // ── 面板本体 ───────────────────────────────────────────────────────
+
+    /**
+     * 「好感度」设置分区。
+     *
+     * @param props - `{ remote }`：`apply()` 灌进来的、已经 `$mount()` 过的句柄。
+     */
+    function AffinitySection(props) {
+      useStyleOnce();
+      const remote = props?.remote;
+      const [snapshot, setSnapshot] = useState(null);
+      const [error, setError] = useState(null);
+      const [busy, setBusy] = useState(null);
+      const [drafts, setDrafts] = useState({});
+
+      const reload = useCallback(async () => {
+        try {
+          const next = await call(remote, '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', []);
+            if (alive) {
+              setSnapshot(next);
+              setError(null);
+            }
+          } catch (cause) {
+            if (alive) setError(cause?.message ?? String(cause));
+          }
+        })();
+        return () => {
+          alive = false;
+        };
+      }, [remote]);
+
+      const commit = useCallback(
+        async (scope, value) => {
+          setBusy(scope);
+          try {
+            await call(remote, 'set', [scope, value]);
+            setError(null);
+            await reload();
+          } catch (cause) {
+            setError(cause?.message ?? String(cause));
+          } finally {
+            setBusy(null);
+          }
+        },
+        [remote, reload],
+      );
+
+      if (error !== null && snapshot === null) {
+        return jsxRuntime.jsxs('div', {
+          className: 'whaleAffinity',
+          children: [
+            jsxRuntime.jsx('div', { className: 'whaleAffinity__head', children: jsxRuntime.jsx('div', { className: 'whaleAffinity__title', children: '好感度' }) }),
+            jsxRuntime.jsx('div', { className: 'whaleAffinity__error', children: `连不上宿主那边的好感度服务：${error}` }),
+            jsxRuntime.jsx('div', {
+              className: 'whaleAffinity__foot',
+              children: '这条通道靠 dsh-whale-loli 的宿主半边（whale-affinity-daemon）提供。重启一次 DeepSeek Harness 后再打开这里。',
+            }),
+          ],
+        });
+      }
+
+      if (snapshot === null) {
+        return jsxRuntime.jsx('div', {
+          className: 'whaleAffinity',
+          children: jsxRuntime.jsx('div', { className: 'whaleAffinity__empty', children: '正在读取好感度…' }),
+        });
+      }
+
+      const bands = Array.isArray(snapshot.bands) ? snapshot.bands : [];
+      const presets = Array.isArray(snapshot.presets) ? snapshot.presets : [];
+      const byScope = new Map(presets.map((row) => [row.scope, row]));
+      // 宿主那边「挂上了好感度」的预设都要显示，哪怕还没写过文件（值＝默认）。
+      const wired = Array.isArray(snapshot.wired) ? snapshot.wired : [];
+      const scopes = [];
+      for (const row of wired) {
+        if (row?.affinity !== true) continue;
+        if (!scopes.includes(row.presetId)) scopes.push(row.presetId);
+      }
+      for (const row of presets) {
+        if (typeof row?.scope === 'string' && !scopes.includes(row.scope)) scopes.push(row.scope);
+      }
+
+      const body = scopes.length === 0
+        ? jsxRuntime.jsx('div', {
+            className: 'whaleAffinity__empty',
+            children: '还没有哪个预设挂上好感度。装上并启用 dsh-whale-loli 之后，四个鲸鱼娘预设自带好感度。',
+          })
+        : scopes.map((scope) => {
+            const row = byScope.get(scope);
+            const current = typeof row?.value === 'number' ? row.value : snapshot.defaultValue ?? 0;
+            const draft = drafts[scope] ?? current;
+            const band = bands.find((item) => draft >= item.min && draft <= item.max);
+            return jsxRuntime.jsxs(
+              'div',
+              {
+                className: 'whaleAffinity__row',
+                children: [
+                  jsxRuntime.jsxs('div', {
+                    className: 'whaleAffinity__rowHead',
+                    children: [
+                      jsxRuntime.jsx('div', { className: 'whaleAffinity__scope', children: scope }),
+                      jsxRuntime.jsx('div', {
+                        className: 'whaleAffinity__value',
+                        children: busy === scope ? '保存中…' : `${current} · ${row?.band ?? band?.label ?? ''}`,
+                      }),
+                    ],
+                  }),
+                  jsxRuntime.jsx('div', {
+                    className: 'whaleAffinity__bands',
+                    children: bands.map((item) => jsxRuntime.jsx(
+                      'button',
+                      {
+                        type: 'button',
+                        className: 'whaleAffinity__band',
+                        'data-active': String(draft >= item.min && draft <= item.max),
+                        onClick: () => {
+                          // 点档位取该档最温和的一端，避免一按就跳到极端。
+                          const target = item.min;
+                          setDrafts((prev) => ({ ...prev, [scope]: target }));
+                          void commit(scope, target);
+                        },
+                        children: item.label,
+                      },
+                      `${scope}:${item.label}`,
+                    )),
+                  }),
+                  jsxRuntime.jsx('input', {
+                    type: 'range',
+                    className: 'whaleAffinity__range',
+                    min: snapshot.min,
+                    max: snapshot.max,
+                    step: 1,
+                    value: draft,
+                    onChange: (event) => {
+                      const next = Number(event.target.value);
+                      setDrafts((prev) => ({ ...prev, [scope]: next }));
+                    },
+                    onMouseUp: (event) => void commit(scope, Number(event.currentTarget.value)),
+                    onTouchEnd: (event) => void commit(scope, Number(event.currentTarget.value)),
+                    onKeyUp: (event) => void commit(scope, Number(event.currentTarget.value)),
+                  }),
+                  band === undefined
+                    ? null
+                    : jsxRuntime.jsx('div', { className: 'whaleAffinity__text', children: band.text }),
+                ],
+              },
+              scope,
+            );
+          });
+
+      return jsxRuntime.jsxs('div', {
+        className: 'whaleAffinity',
+        children: [
+          jsxRuntime.jsxs('div', {
+            className: 'whaleAffinity__head',
+            children: [
+              jsxRuntime.jsx('div', { className: 'whaleAffinity__title', children: '好感度' }),
+              jsxRuntime.jsx('div', {
+                className: 'whaleAffinity__desc',
+                children: `小鱼对你的好感度，${snapshot.min} ~ ${snapshot.max}，0 是原态。改完下一轮说话就生效，不用重开会话。`,
+              }),
+            ],
+          }),
+          ...(Array.isArray(body) ? body : [body]),
+          error === null ? null : jsxRuntime.jsx('div', { className: 'whaleAffinity__error', children: error }),
+          jsxRuntime.jsx('div', {
+            className: 'whaleAffinity__foot',
+            children: '点档位按钮＝直接跳到这个档最靠中间的一端；拖滑块松手才保存。小鱼自己也会在剧情需要时小幅调，主人明确要求时照做。',
+          }),
+        ],
+      });
+    }
+
+    // ── 注册 ───────────────────────────────────────────────────────────
+
+    /** 这个浏览器半边要用的服务。 */
+    const inject = ['slots', 'remote', 'connection'];
+
+    /**
+     * 挂载设置页分区。
+     *
+     * @param ctx - 浏览器插件上下文。
+     */
+    function apply(ctx) {
+      // 1. 先把远程命名空间挂上。`$mount` 是 async（返回 Promise<dispose>），
+      //    挂完才有 `ctx.remote['whale-affinity']`。用可变盒子接住句柄。
+      const box = { mounted: false };
+
+      ctx.effect(() => {
+        const remote = ctx.remote;
+        if (typeof remote?.$mount !== 'function') {
+          console.warn('[whale-affinity] 浏览器侧没有 ctx.remote.$mount，好感度面板会只读');
+          return () => {};
+        }
+        let disposed = false;
+        let unmount;
+        Promise.resolve()
+          .then(() => remote.$mount(contribution()))
+          .then((dispose) => {
+            if (disposed) {
+              return dispose?.();
+            }
+            unmount = dispose;
+            box.mounted = true;
+            return undefined;
+          })
+          .catch((cause) => {
+            console.warn('[whale-affinity] $mount 失败，好感度面板将无法读写：', cause?.message ?? cause);
+          });
+        return () => {
+          disposed = true;
+          box.mounted = false;
+          unmount?.();
+        };
+      }, 'whale-affinity: remote mount');
+
+      // 2. 注册设置页分区。
+      ctx.effect(
+        () => ctx.slots.inject('settings.section', () => ctx.slots.register(
+          {
+            name: 'settings.section',
+            id: SECTION_ID,
+            order: SECTION_ORDER,
+            label: () => '好感度',
+            inject: () => ({ remote: ctx.remote }),
+          },
+          AffinitySection,
+        )),
+        'whale-affinity: settings section',
+      );
+    }
+
+    exports.NAMESPACE = NAMESPACE;
+    exports.SECTION_ID = SECTION_ID;
+    exports.AffinitySection = AffinitySection;
+    exports.contribution = contribution;
+    exports.apply = apply;
+    exports.inject = inject;
+    return module.exports;
+  },
+});