dsh-conversation-aurora 0.2.0 → 0.2.5

package/README.md

@@ -30,12 +30,13 @@
 
 | 快捷键 | 作用 |
 | --- | --- |
-| `Alt+T` | 换下一个背景（8 个循环，选择会记住） |
+| `Alt+T` | 换到下一个背景，并**固定**住（8 个循环，选择会记住） |
+| `Alt+R` | 回到**随机**，并立刻换一个（清掉固定值） |
 | `Alt+D` | 浅色 / 深色主题互换（走宿主 `theme.setTheme`，与「设置 → 外观」同步） |
 
 **它只在"你干活"的时候出现**：任何工具在跑、或回合进行中，背景才播放；空闲、切会话、窗口隐藏时立刻停掉 `requestAnimationFrame` 并淡出，两侧恢复普通白纸。
 
-**每个会话自动分配不同主题**（按 `data-conversation-session` 哈希）。按过 `Alt+T` 之后会变成全局固定主题；想恢复"每会话自动"，删掉 `localStorage` 里的 `dsh.conversation-aurora.theme` 即可。
+**每个回合随机一个主题**：你发一条消息、我把这一轮做完 = 一个回合；回合内背景不变（中间停顿多久都不换），下一个回合重新随机，且不会和上一个重复。`Alt+T` 固定某个主题，`Alt+R` 回到随机并换一个。固定值存在 `localStorage` 的 `dsh.conversation-aurora.theme`。
 
 ---
 
@@ -82,7 +83,7 @@
 
 ## 已知限制
 
-1. **依赖宿主的 DOM 语义属性**：`[data-conversation-content]` / `[data-tool][data-state]` / `[data-chat-running]` / `[data-streaming]` / `[data-conversation-session]`。DSH 大版本升级后如果这些改名，插件会安静地什么都不做（不会报错、不会挡交互）。
+1. **依赖宿主的 DOM 语义属性**：`[data-conversation-content]` / `[data-tool][data-state]` / `[data-chat-running]` / `[data-streaming]`。DSH 大版本升级后如果这些改名，插件会安静地什么都不做（不会报错、不会挡交互）。
 2. **没有"背景层"插槽**：DSH 目前没有这个扩展点，所以背景层是挂在对话画布元素内部的（`z-index:-1`）。这是刻意偏离「只能注册进 slot」的地方，随插件停用一起消失。
 3. **切会话会静默 600ms**：避免把上一轮残留的工具行当成"正在工作"，看到几秒特效。
 4. **减少动态效果**：系统开启后只画一帧静止画面，不跑 `requestAnimationFrame`。

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';
@@ -97,15 +101,6 @@ body[data-ds-dark-theme] .dsh-stage__veil{
       }
     }
 
-    function hashString(text) {
-      let h = 2166136261;
-      for (let i = 0; i < text.length; i += 1) {
-        h ^= text.charCodeAt(i);
-        h = Math.imul(h, 16777619);
-      }
-      return h >>> 0;
-    }
-
     /** 浅色用墨色 + multiply；深色用亮色 + lighter。 */
     function stagePalette() {
       const dark = document.body.hasAttribute('data-ds-dark-theme');
@@ -760,6 +755,7 @@ function themeWarp(g) {
       let sessionKey = null;
       let quietUntil = 0;
       let forcedTheme = readStore(STORAGE.theme, '');
+      let activeTheme = '';
       let stageRaf = 0;
       let stageTheme = null;
 
@@ -794,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();
@@ -807,6 +822,7 @@ function themeWarp(g) {
         }
         quietUntil = quiet ? Date.now() + TUNE.switchQuietMs : 0;
         sessionKey = host ? host.getAttribute('data-conversation-session') || '' : null;
+        activeTheme = '';
         syncStage();
       }
 
@@ -870,12 +886,31 @@ function themeWarp(g) {
 
       /* ---------- 背景播放 ---------- */
 
-      function stageThemeId() {
-        for (let i = 0; i < STAGE_THEMES.length; i += 1) {
-          if (forcedTheme && STAGE_THEMES[i].id === forcedTheme) return forcedTheme;
-        }
-        const key = (host && host.getAttribute('data-conversation-session')) || 'default';
-        return STAGE_THEMES[hashString(key) % STAGE_THEMES.length].id;
+      /**
+       * 主题跟着「回合」走：一个回合一个主题，回合内怎么停顿都不变，
+       * 下一个回合（你发新消息）重新随机。
+       * 按 Alt+T 固定过主题时，所有回合都用它。
+       */
+      let lastAssigned = '';
+
+      function themeIds() {
+        const ids = [];
+        for (let i = 0; i < STAGE_THEMES.length; i += 1) ids.push(STAGE_THEMES[i].id);
+        return ids;
+      }
+
+      /** 随机挑一个，尽量不要和上一个回合重复。 */
+      function randomThemeId() {
+        const ids = themeIds();
+        let id = ids[(Math.random() * ids.length) | 0];
+        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() {
@@ -903,7 +938,9 @@ function themeWarp(g) {
         const pal = stagePalette();
         ctx.globalCompositeOperation = pal.blend;
 
-        const id = stageThemeId();
+        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];
@@ -941,13 +978,31 @@ function themeWarp(g) {
         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);
+        const ids = themeIds();
         let at = ids.indexOf(forcedTheme);
-        if (at < 0) at = ids.indexOf(stageThemeId());
+        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();
@@ -975,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 {
           /* 任何一步失败都只是不生效，不影响宿主 */
         }
@@ -1029,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. Alt+T next theme, Alt+D light/dark. Plays only while the agent is working."
+    "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.0",
+  "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",