dsh-whale-live 0.2.1 → 0.2.2

package/CHANGELOG.md

@@ -1,5 +1,13 @@
 # Changelog
 
+## 0.2.2 — 2026-11-12
+
+### Added
+- **Real-time watching.** `whale_live action=watch` starts a 4-second danmaku poll; when new messages arrive the plugin calls the Agent's `followup()` to wake the model, so it can answer while the stream is live. `watch step=stop` (or closing the session) stops it.
+- The plugin now captures the calling Agent from tool execution so it can be woken later.
+
+### Notes
+- If `followup` is unavailable in a future DSH version, the plugin falls back to `inject` (context only, no wake) instead of failing the loop.
 ## 0.2.1 — 2026-11-11
 
 ### Fixed

package/lib/tools.js

@@ -7,6 +7,9 @@
  * 这里只写直播那个“她”的东西；cortex 由本鲸自己动手写。
  */
 
+import fs from 'node:fs';
+import path from 'node:path';
+
 const TEXT_OUTPUT = Object.freeze({
   schema: {
     type: 'object',
@@ -32,6 +35,83 @@ function timeOf(iso) {
 }
 
 export function createTools({ ctx, store, danmaku, voice, avatar, vts, stage, diagnose, config }) {
+  let lastAgent = null;
+  let watchTimer = null;
+  let watchBusy = false;
+
+  function stopWatch() {
+    if (watchTimer) {
+      clearInterval(watchTimer);
+      watchTimer = null;
+    }
+  }
+
+  /** 叫醒本鲸：优先 followup；签名不对就换一种；都不行就 inject（只进上下文不唤醒）。 */
+  function wakeAgent(text) {
+    const agent = lastAgent;
+    if (!agent) return false;
+    try {
+      agent.followup(text);
+      return true;
+    } catch {
+      try {
+        agent.followup({ role: 'user', content: text });
+        return true;
+      } catch {
+        try {
+          agent.inject(text);
+        } catch {
+          /* 叫不醒也不能影响轮询 */
+        }
+        return false;
+      }
+    }
+  }
+
+  async function watchTick() {
+    if (watchBusy || !store.state().session) return;
+    watchBusy = true;
+    try {
+      const { messages } = await danmaku.pollOnce();
+      if (!messages.length) return;
+      for (const message of messages) {
+        store.appendEvent({ kind: 'danmaku', user: message.user, text: message.text, self: message.self === true });
+      }
+      const lines = messages.map((message) => `${message.user}：${message.text}`).join('\n');
+      wakeAgent(`[直播间新弹幕]\n${lines}\n\n（去看看，想接就接；不想接也可以记一笔。）`);
+    } catch {
+      /* 轮询失败下一轮再来 */
+    } finally {
+      watchBusy = false;
+    }
+  }
+
+  /** 探测 Agent 上有什么方法（只记录名字和类型，不调用）。 */
+  function probeAgent(agent) {
+    if (!agent) return;
+    lastAgent = agent;
+    try {
+      const own = Object.getOwnPropertyNames(agent);
+      const proto = Object.getPrototypeOf(agent);
+      const protoNames = proto ? Object.getOwnPropertyNames(proto) : [];
+      const types = {};
+      for (const name of [...new Set([...own, ...protoNames])]) {
+        try {
+          types[name] = typeof agent[name];
+        } catch {
+          types[name] = 'unreadable';
+        }
+      }
+      fs.writeFileSync(
+        path.join(store.paths.dataDir, 'agent-probe.json'),
+        JSON.stringify({ when: new Date().toISOString(), own, proto: protoNames, types }, null, 2),
+        'utf8',
+      );
+    } catch {
+      /* 探测失败不影响正常使用 */
+    }
+  }
+
   const roomName = config.roomName || '直播间';
   const roomId = config.roomId;
 
@@ -84,7 +164,7 @@ export function createTools({ ctx, store, danmaku, voice, avatar, vts, stage, di
       properties: {
         action: {
           type: 'string',
-          enum: ['open', 'status', 'read', 'note', 'listen', 'close', 'propose', 'memory_list', 'commit', 'reject', 'avatar', 'vts', 'stage', 'diagnose'],
+          enum: ['open', 'status', 'read', 'note', 'listen', 'close', 'propose', 'memory_list', 'commit', 'reject', 'avatar', 'vts', 'stage', 'diagnose', 'watch'],
           description: '要做什么。',
         },
         kind: {
@@ -166,7 +246,8 @@ export function createTools({ ctx, store, danmaku, voice, avatar, vts, stage, di
     timeoutMs: 130000,
     presentCall: () => ({ card: 'generic', title: '鲸鱼直播台', kind: 'other' }),
 
-    async execute(args = {}) {
+    async execute(args = {}, exec = {}) {
+      probeAgent(exec?.agent);
       const action = args.action;
 
       if (action === 'open') {
@@ -264,6 +345,22 @@ export function createTools({ ctx, store, danmaku, voice, avatar, vts, stage, di
         return { text: `收到 ${result.messages.length} 条：\n${lines.join('\n')}\n\n接下来看你怎么接。` };
       }
 
+      if (action === 'watch') {
+        const step = args.step || 'start';
+        if (step === 'stop') {
+          stopWatch();
+          return { text: 'watch 已停。' };
+        }
+        if (step === 'test') {
+          const ok = wakeAgent('[测试] 本鲸被叫醒了。');
+          return { text: ok ? '叫醒测试已发出，看看本鲸会不会醒。' : '叫醒失败：没有 agent 或 followup 不可用。' };
+        }
+        if (!store.state().session) return { text: '先 action=open 开一场再 watch。' };
+        stopWatch();
+        watchTimer = setInterval(watchTick, 4000);
+        return { text: 'watch 已开：每 4 秒看一次弹幕，有新话就叫醒本鲸；下播/stop 会停。' };
+      }
+
       if (action === 'close') {
         const meta = store.closeSession({ text: args.text });
         if (!meta) return { text: '现在没有开着的场。' };

package/package.json

@@ -1,6 +1,6 @@
 {
     "name":  "dsh-whale-live",
-    "version":  "0.2.1",
+    "version":  "0.2.2",
     "description":  "Left-sidebar live console for DeepSeek Harness: persona script, stream log, Bilibili danmaku, edge-tts speech, optional VTube Studio/OBS/直播姬 launch helpers and a memory inbox. Windows only.",
     "type":  "module",
     "main":  "./index.js",