dsh-theme-gallery 0.4.0 → 0.4.1

package/README.md

@@ -11,7 +11,7 @@
 | 自己做皮肤（或让 AI 做） | 在 `lib/themes/` 加 JSON 后重跑 `npm run embed-themes`，或装 `dsh-theme-skin-author` 技能让 AI 生成 |
 | 贡献一个皮肤给所有人 | 在 `lib/themes/` 放一个 JSON，提 PR |
 
-已随 **0.4.0** 发布 **7 套**皮肤：四套复刻自**蜂链商城**电商新零售系统管理后台
+已随 **0.4.1** 发布 **7 套**皮肤：四套复刻自**蜂链商城**电商新零售系统管理后台
 （[`renjie2026/fenglianshop-open`](https://github.com/renjie2026/fenglianshop-open) 的
 `admin-modular/src/utils/themes.js`），两套是本插件**原创**的宠物主题（同一套造色方法，色相取自中国传统色库），
 另有一套是**「纯色/拼色」配色选择器**卡片（15 个可点色值，见下）。

package/lib/client.js

@@ -599,7 +599,7 @@ window.__ModuleLoader__.load({
      * package.json, and the release workflow fails when re-running the embed step
      * changes a tracked file.
      */
-    const BUNDLED_VERSION = '0.4.0'
+    const BUNDLED_VERSION = '0.4.1'
 
     /**
      * Themes this package contributes, inlined from lib/themes/*.json.
@@ -7350,6 +7350,26 @@ window.__ModuleLoader__.load({
        * only used once the document has demonstrably failed to follow the service.
        */
       const paintAttempts = new Map()
+
+      /**
+       * 观察到"服务已报告、文档未落色"的**时刻**（配合 {@link PAINT_GRACE_MS} 使用）。
+       * @type {{id: string, at: number}|undefined}
+       */
+      let paintSeen
+
+      /**
+       * 判"这次切换丢了"之前要等多久（毫秒）。
+       *
+       * 表现层是异步写 token 的，所以 `setTheme` 之后**一段时间内**文档一定还是旧色 ——
+       * 那不是"错过"，只是"还没轮到表现层"。原先没有这个等待，于是**每点一次配色卡都先跳转
+       * 一次浅色**（用户报的"第一次点击不生效、反而变成浅色主题，再点一次才行"）。
+       *
+       * 为什么不能只按"经过了一次 publish"来判：外壳的 `theme/change` 常常是**延迟送达**的，
+       * 同一次点击里会再来一次 publish（实测读数：一次点击的 `setTheme` 序列是
+       * `…, 'shi-liu-jin', 'light', 'shi-liu-jin'`，中间那对就是跳转）。所以要**按时间**等。
+       * 400ms 足以覆盖表现层的一到两帧，又远小于人再点一次的反应时间。
+       */
+      const PAINT_GRACE_MS = 400
       /**
        * Apply the remembered skin, and confirm it landed.
        *
@@ -7376,6 +7396,7 @@ window.__ModuleLoader__.load({
         }
         if (skinIsPainted(wanted)) {
           paintAttempts.clear()
+          paintSeen = undefined
           noteAmbientEvent('已上色', wanted)
           return
         }
@@ -7394,11 +7415,29 @@ window.__ModuleLoader__.load({
           // Budgeted and cooled down. This branch used to call `setTheme` unconditionally on every
           // publish, with no throttle at all, so the shell putting the active id back to a
           // built-in value made it a perpetual request ↔ publish ping-pong.
+          paintSeen = undefined
           if (requestTheme(wanted)) noteAmbientEvent('置为皮肤', wanted)
           // Give the presenter a chance to land before judging it.
           return
         }
 
+        // ── 先给它一段**时间**的耐心（代码上方那句"要跨过一次 PAUSE 才跳转"原本并没实现）──
+        //
+        // 直接 `setTheme` 之后的那几帧里，文档一定还没落色 —— 那不是"错过"，只是"还没轮到
+        // 表现层"。在这里就跳转的代价是：**每点一次配色卡都先闪一次浅色**，而且跳转里那两次
+        // 写入会和外壳的偏好处理打架（用户报的"第一次点击不生效、反而变成浅色"）。
+        // 第一次只记时刻，过了 {@link PAINT_GRACE_MS} 仍未落色，才说明真的错过了。
+        const now = Date.now()
+        if (paintSeen === undefined || paintSeen.id !== wanted) {
+          paintSeen = { id: wanted, at: now }
+          noteAmbientEvent('等待上色', wanted)
+          return
+        }
+        if (now - paintSeen.at < PAINT_GRACE_MS) {
+          noteAmbientEvent('等待上色', wanted)
+          return
+        }
+
         // The service ALREADY reports this skin, yet the document does not show it: the change
         // was missed by a presenter that had not subscribed yet. Only now is a bounce justified.
         const bounced = paintAttempts.get(wanted) ?? 0

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "dsh-theme-gallery",
-  "version": "0.4.0",
+  "version": "0.4.1",
   "description": "A theme gallery for DeepSeek Harness (DSH): six JSON-defined skins with full-screen coverage and sidebar scenery, plus built-in light/dark cards, switched from the panel under the sidebar's Plugins icon — adding skins needs no code change",
   "author": "renjie2026 (https://github.com/renjie2026)",
   "license": "MIT",