dsh-conversation-aurora 0.2.1 → 0.2.5

package/README.md

@@ -30,12 +30,13 @@
 
 | 快捷键 | 作用 |
 | --- | --- |
-| `Alt+T` | 换下一个背景（8 个循环，选择会记住） |
+| `Alt+T` | 换到下一个背景，并**固定**住（8 个循环，选择会记住） |
+| `Alt+R` | 回到**随机**，并立刻换一个（清掉固定值） |
 | `Alt+D` | 浅色 / 深色主题互换（走宿主 `theme.setTheme`，与「设置 → 外观」同步） |
 
 **它只在"你干活"的时候出现**：任何工具在跑、或回合进行中，背景才播放；空闲、切会话、窗口隐藏时立刻停掉 `requestAnimationFrame` 并淡出，两侧恢复普通白纸。
 
-**每次开始干活随机换一个主题**（8 个里随机，且不会连着重复）。按过 `Alt+T` 之后会变成全局固定主题；想恢复"每会话自动"，删掉 `localStorage` 里的 `dsh.conversation-aurora.theme` 即可。
+**每个回合随机一个主题**：你发一条消息、我把这一轮做完 = 一个回合；回合内背景不变（中间停顿多久都不换），下一个回合重新随机，且不会和上一个重复。`Alt+T` 固定某个主题，`Alt+R` 回到随机并换一个。固定值存在 `localStorage` 的 `dsh.conversation-aurora.theme`。
 
 ---
 

package/client.js

@@ -28,6 +28,10 @@ window.__ModuleLoader__.load({
       remountWindowMs: 2000,
       /** 切会话后的静默期，避免把上一轮的残留行当成"正在工作"。 */
       switchQuietMs: 600,
+      /** Alt+T 换主题。 */
+      themeKey: 't',
+      /** Alt+R 回到随机，并给这个回合换一个。 */
+      randomKey: 'r',
     };
 
     const NS = 'dsh-stage';
@@ -786,9 +790,28 @@ function themeWarp(g) {
         if (previous !== canvas) resetForSwitch(previous !== null);
       }
 
+      /**
+       * 回合的起点：新的 [data-streaming] / [data-chat-running] 元素出现，
+       * 或者从空闲重新开工。两者任一成立就算新回合，换一个主题。
+       */
+      const turnMarks = new WeakSet();
+
+      function turnIsNew(running) {
+        let fresh = false;
+        const list = document.querySelectorAll('[data-streaming], [data-chat-running]');
+        for (let i = 0; i < list.length; i += 1) {
+          const el = list[i];
+          if (!turnMarks.has(el)) {
+            turnMarks.add(el);
+            fresh = true;
+          }
+        }
+        return running && (fresh || !busy);
+      }
+
       /**
        * 切会话：上一轮的工具行可能还挂着，历史里的失败行也会被当成新事件。
-       * 清空跟踪表、静默一小段时间，等新会话渲染稳定。
+       * 清空跟踪表、静默一小段时间，等新会话渲染稳定；顺便取该对话的主题。
        */
       function resetForSwitch(quiet) {
         tracked.clear();
@@ -799,6 +822,7 @@ function themeWarp(g) {
         }
         quietUntil = quiet ? Date.now() + TUNE.switchQuietMs : 0;
         sessionKey = host ? host.getAttribute('data-conversation-session') || '' : null;
+        activeTheme = '';
         syncStage();
       }
 
@@ -863,18 +887,32 @@ function themeWarp(g) {
       /* ---------- 背景播放 ---------- */
 
       /**
-       * 每次开工重新挑一个主题（随机，且不和上一次重复）。
-       * 按 Alt+T 固定过主题时，就一直用它。
+       * 主题跟着「回合」走：一个回合一个主题，回合内怎么停顿都不变，
+       * 下一个回合（你发新消息）重新随机。
+       * 按 Alt+T 固定过主题时，所有回合都用它。
        */
-      function pickTheme() {
+      let lastAssigned = '';
+
+      function themeIds() {
         const ids = [];
         for (let i = 0; i < STAGE_THEMES.length; i += 1) ids.push(STAGE_THEMES[i].id);
-        if (forcedTheme && ids.indexOf(forcedTheme) >= 0) return forcedTheme;
+        return ids;
+      }
+
+      /** 随机挑一个，尽量不要和上一个回合重复。 */
+      function randomThemeId() {
+        const ids = themeIds();
         let id = ids[(Math.random() * ids.length) | 0];
-        if (ids.length > 1 && id === activeTheme) id = ids[(ids.indexOf(id) + 1) % ids.length];
+        if (ids.length > 1 && id === lastAssigned) id = ids[(ids.indexOf(id) + 1) % ids.length];
+        lastAssigned = id;
         return id;
       }
 
+      /** 这个回合该用哪个主题（固定值优先）。 */
+      function themeForTurn() {
+        return forcedTheme || activeTheme || (activeTheme = randomThemeId());
+      }
+
       function stopStage() {
         if (stageRaf) window.cancelAnimationFrame(stageRaf);
         stageRaf = 0;
@@ -900,8 +938,9 @@ function themeWarp(g) {
         const pal = stagePalette();
         ctx.globalCompositeOperation = pal.blend;
 
-        const id = activeTheme || pickTheme();
+        const id = themeForTurn();
         activeTheme = id;
+        stage.dataset.theme = id;
         let factory = STAGE_THEMES[0];
         for (let i = 0; i < STAGE_THEMES.length; i += 1) {
           if (STAGE_THEMES[i].id === id) factory = STAGE_THEMES[i];
@@ -936,21 +975,34 @@ function themeWarp(g) {
           return;
         }
         stage.dataset.on = '1';
-        if (!stageRaf) {
-          activeTheme = pickTheme();
-          startStage();
-        }
+        if (!stageRaf) startStage();
       }
 
+      /** Alt+T：手动切到下一个，并固定住。 */
       function cycleTheme() {
-        const ids = [];
-        for (let i = 0; i < STAGE_THEMES.length; i += 1) ids.push(STAGE_THEMES[i].id);
-        let at = ids.indexOf(activeTheme);
-        if (at < 0) at = ids.indexOf(forcedTheme);
+        const ids = themeIds();
+        let at = ids.indexOf(forcedTheme);
+        if (at < 0) at = ids.indexOf(activeTheme);
         if (at < 0) at = 0;
         forcedTheme = ids[(at + 1) % ids.length];
         writeStore(STORAGE.theme, forcedTheme);
         activeTheme = forcedTheme;
+        restartIfPlaying();
+      }
+
+      /** Alt+R：回到随机，并给这个回合换一个新的。 */
+      function randomTheme() {
+        forcedTheme = '';
+        try {
+          window.localStorage.removeItem(STORAGE.theme);
+        } catch {
+          /* 隐私模式：本来就没写进去 */
+        }
+        activeTheme = randomThemeId();
+        restartIfPlaying();
+      }
+
+      function restartIfPlaying() {
         if (stageRaf || busy) {
           stopStage();
           if (busy && !document.hidden) startStage();
@@ -978,7 +1030,15 @@ function themeWarp(g) {
           }
 
           prune();
-          setBusy(detectBusy());
+          const running = detectBusy();
+          if (turnIsNew(running)) {
+            activeTheme = forcedTheme || randomThemeId();
+            if (stageRaf) {
+              stopStage();
+              startStage();
+            }
+          }
+          setBusy(running);
         } catch {
           /* 任何一步失败都只是不生效，不影响宿主 */
         }
@@ -1032,8 +1092,12 @@ function themeWarp(g) {
 
       function onKeyDown(event) {
         if (!event.altKey || event.ctrlKey || event.metaKey || event.shiftKey) return;
-        if (String(event.key || '').toLowerCase() !== TUNE.themeKey) return;
-        cycleTheme();
+        const key = String(event.key || '').toLowerCase();
+        if (key === TUNE.themeKey) {
+          cycleTheme();
+          return;
+        }
+        if (key === TUNE.randomKey) randomTheme();
       }
 
       /* ---------- 启动 ---------- */

package/locale/en.json

@@ -1,6 +1,6 @@
 {
   "meta": {
     "title": "Conversation Backgrounds",
-    "description": "Full-canvas animated backgrounds: starfield / code rain / circuit / cat / girl / racer / snow / bubbles, a new one each time the agent starts working. Alt+T next theme, Alt+D light/dark."
+    "description": "Full-canvas animated backgrounds: starfield / code rain / circuit / cat / girl / racer / snow / bubbles. One random theme per turn, stable within the turn. Alt+T pins a theme, Alt+R back to random, Alt+D light/dark."
   }
 }

package/locale/zh.json

@@ -1,6 +1,6 @@
 {
   "meta": {
     "title": "对话区动效背景",
-    "description": "对话区整屏动效背景：星空 / 代码雨 / 电路 / 小猫 / 小女生 / 赛车 / 飘雪 / 肥皂泡，每次开始干活随机换一个。快捷键 Alt+T 换背景、Alt+D 切明暗；只在 Agent 干活时播放。"
+    "description": "对话区整屏动效背景：星空 / 代码雨 / 电路 / 小猫 / 小女生 / 赛车 / 飘雪 / 肥皂泡。每个回合随机一个，回合内不变。Alt+T 固定主题、Alt+R 回到随机，Alt+D 切明暗。"
   }
 }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "dsh-conversation-aurora",
-  "version": "0.2.1",
+  "version": "0.2.5",
   "description": "Full-canvas animated backgrounds for the DSH conversation pane: starfield, code rain, circuits, cat, girl, racer, snow, bubbles.",
   "type": "module",
   "license": "MIT",