dsh-whale-live 0.2.1 → 0.2.3

package/CHANGELOG.md

@@ -1,5 +1,22 @@
 # Changelog
 
+## 0.2.3 — 2026-11-12
+
+### Added
+- **Watch toggle in the panel.** The Prepare tab now has a "Watch chat / Stop watching" button, so the host can start or stop the 4-second danmaku poll without asking the model. The toggle reads the live state from `/state` and writes through `action=watch`.
+- The watch timer is shared between the model tool and the panel, so either side can start/stop it; the model is still the one woken by `followup()`.
+
+### Notes
+- Starting watch requires an open session; it stops when the session closes or the plugin reloads.
+- Falls back to `inject` (context only) if `followup` is unavailable.
+## 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/client.js

@@ -27,6 +27,8 @@ window.__ModuleLoader__.load({
         prepareHint: '开播前先把设备架好：拉起 VTube Studio / OBS / 直播间页面，只准备，不推流；自检会逐项报告缺什么。',
         stageBtn: '架好设备',
         diagnoseBtn: '自检',
+        watchStart: '蹲点',
+        watchStop: '停止蹲点',
         prepareSummary: '{ok}/{total} 通过 · {failed} 项必须修 · {warned} 项可选',
         stageDone: '设备已拉起（没有自动推流）。',
         stateLive: '直播中',
@@ -75,6 +77,8 @@ window.__ModuleLoader__.load({
         prepareHint: 'Set the gear up before going live: VTube Studio, OBS and the room page. Preparation only — nothing starts streaming.',
         stageBtn: 'Set up',
         diagnoseBtn: 'Self-check',
+        watchStart: 'Watch chat',
+        watchStop: 'Stop watching',
         prepareSummary: '{ok}/{total} passed · {failed} required · {warned} optional',
         stageDone: 'Gear is up (streaming was not started).',
         stateLive: 'Live',
@@ -452,6 +456,13 @@ window.__ModuleLoader__.load({
               disabled: diagLoading,
               onClick: loadDiag,
             }, diagLoading ? '…' : t('diagnoseBtn')),
+            h('button', {
+              key: 'watch',
+              type: 'button',
+              className: 'dshwl-btn',
+              disabled: busy !== '' || !session,
+              onClick: () => run('watch', 'watch', { step: state?.watch?.running ? 'stop' : 'start' }),
+            }, state?.watch?.running ? t('watchStop') : t('watchStart')),
             session ? null : h('button', {
               key: 'live',
               type: 'button',

package/index.js

@@ -57,13 +57,14 @@ export async function apply(ctx, config = {}) {
   const vts = createVts(settings, ctx.logger);
   const stage = createStage(settings, avatar, ctx.logger);
   const voice = createVoice(settings, store, ctx.logger, avatar);
-  const tools = createTools({ ctx, store, danmaku, voice, avatar, vts, stage, diagnose, config: settings });
+  const watchApi = {};
+  const tools = createTools({ ctx, store, danmaku, voice, avatar, vts, stage, diagnose, watchApi, config: settings });
 
   ctx.effect(() => {
     const disposers = [];
     try {
       for (const tool of tools) disposers.push(ctx.tools.register(tool));
-      const disposeHttp = registerHttp(ctx, { store, danmaku, voice, avatar, stage, diagnose, config: settings, logger: ctx.logger });
+      const disposeHttp = registerHttp(ctx, { store, danmaku, voice, avatar, stage, watchApi, diagnose, config: settings, logger: ctx.logger });
       if (disposeHttp) disposers.push(disposeHttp);
       disposers.push(() => voice.dispose());
     } catch (error) {

package/lib/http.js

@@ -83,7 +83,7 @@ function sendJson(response, status, value) {
   response.end(JSON.stringify(value));
 }
 
-export function registerHttp(ctx, { store, danmaku, voice, avatar, stage, diagnose, config, logger }) {
+export function registerHttp(ctx, { store, danmaku, voice, avatar, stage, watchApi, diagnose, config, logger }) {
   async function snapshot() {
     const state = store.state();
     const skin = await avatar.status();
@@ -105,6 +105,7 @@ export function registerHttp(ctx, { store, danmaku, voice, avatar, stage, diagno
       recent: state.session ? store.recentEvents(state.session.id, 80) : [],
       voice: voice.status(),
       danmaku: danmaku.status(),
+      watch: watchApi?.status?.() ?? null,
       avatar: skin,
       config: {
         roomId: config.roomId,
@@ -150,6 +151,10 @@ export function registerHttp(ctx, { store, danmaku, voice, avatar, stage, diagno
     if (action === 'stage') {
       return { stage: await stage.stage() };
     }
+    if (action === 'watch') {
+      if (!watchApi?.start) throw Object.assign(new Error('watch 还没就绪'), { code: 'NOT_READY' });
+      return { watch: body.step === 'stop' ? watchApi.stop() : watchApi.start() };
+    }
     if (action === 'diagnose') {
       return { diagnose: await diagnose({ store, danmaku, avatar, stage, config }) };
     }

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',
@@ -31,7 +34,96 @@ function timeOf(iso) {
   }
 }
 
-export function createTools({ ctx, store, danmaku, voice, avatar, vts, stage, diagnose, config }) {
+export function createTools({ ctx, store, danmaku, voice, avatar, vts, stage, diagnose, watchApi, config }) {
+  let lastAgent = null;
+  let watchTimer = null;
+  let watchBusy = false;
+
+  function stopWatch() {
+    if (watchTimer) {
+      clearInterval(watchTimer);
+      watchTimer = null;
+    }
+  }
+
+  /** 叫醒本鲸：followup/inject 都收 UserMessage 对象，绝不能再塞裸字符串（会写坏会话日志）。 */
+  function wakeAgent(text) {
+    const agent = lastAgent;
+    if (!agent) return false;
+    const message = { content: [{ type: 'text', text }], source: { kind: 'user' } };
+    try {
+      agent.followup(message);
+      return true;
+    } catch {
+      try {
+        agent.inject(message);
+      } 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;
+    }
+  }
+
+  // 面板也用它开/关蹲点。
+  if (watchApi) {
+    watchApi.status = () => ({ running: Boolean(watchTimer), hasAgent: Boolean(lastAgent) });
+    watchApi.start = () => {
+      if (watchTimer) return { running: true, already: true };
+      if (!store.state().session) return { running: false, error: '还没开播' };
+      watchTimer = setInterval(watchTick, 4000);
+      return { running: true };
+    };
+    watchApi.stop = () => {
+      stopWatch();
+      return { running: false };
+    };
+    watchApi.wake = wakeAgent;
+  }
+
+  /** 探测 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 +176,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 +258,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 +357,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/lib/watch.js

@@ -0,0 +1,70 @@
+/**
+ * 实时蹲点：轮询弹幕 + 叫醒 Agent。
+ * 共享给工具（模型侧）和面板（用户点开关）。
+ */
+export function createWatch({ danmaku, store, logger = null }) {
+  let timer = null;
+  let agent = null;
+  let busy = false;
+
+  function setAgent(value) {
+    if (value) agent = value;
+  }
+
+  function wake(text) {
+    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 tick() {
+    if (busy || !store.state().session) return;
+    busy = 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');
+      wake(`[直播间新弹幕]\n${lines}\n\n（去看看，想接就接；不想接也可以记一笔。）`);
+    } catch (error) {
+      logger?.warn?.(`whale-live: watch 轮询失败 ${error instanceof Error ? error.message : String(error)}`);
+    } finally {
+      busy = false;
+    }
+  }
+
+  function start() {
+    if (timer) return { running: true, already: true };
+    if (!store.state().session) return { running: false, error: '还没开播，先 open 或点「开播」' };
+    timer = setInterval(tick, 4000);
+    return { running: true };
+  }
+
+  function stop() {
+    if (timer) clearInterval(timer);
+    timer = null;
+    return { running: false };
+  }
+
+  function status() {
+    return { running: Boolean(timer), hasAgent: Boolean(agent) };
+  }
+
+  return { setAgent, wake, start, stop, status, tick };
+}

package/package.json

@@ -1,6 +1,6 @@
 {
     "name":  "dsh-whale-live",
-    "version":  "0.2.1",
+    "version":  "0.2.3",
     "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",