dsh-whale-loli 0.9.7 → 0.9.8

package/README.md

@@ -44,9 +44,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 +63,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`），互相印证、永远绿。** 所以现在凡是对接宿主的字段，
+校验脚本都要拿宿主源码里真正读的那个名字来断言。
+
+
 ## 记忆功能
 
 小鱼的记忆本分**四个区**，各管各的：

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.8"
 }

package/package.json

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