dsh-theme-palette 1.3.0 → 1.3.1

package/README.md

@@ -7,6 +7,48 @@ DSH Web / Desktop 的主题配色插件：**4 套配色 × 明暗两模式**，
 
 当前版本 **0.8.2**（0.8.1 按深色专项审计重做深色侧，0.8.2 把强调色换成设计稿标准值；见 §修订记录）。
 
+## 为什么配色会自己跳回默认（v1.3.1）
+
+现象：设了暖砂，用了一阵（跑模型操作、切窗口、长时间放着），**突然变成黑白**，但设置页里
+「暖砂」还是选中的。原因在宿主的 override 生命周期：
+
+```js
+// ThemeRuntime（宿主）
+overrideTokens(source, tokens) {
+  const layer = { seq: this.overrideSeq++, tokens: validateOverrides(source, tokens) }
+  this.overrides.set(source, layer)
+  this.publish()
+  return () => { if (this.overrides.get(source) !== layer) return; this.overrides.delete(source); this.publish() }
+}
+```
+
+而插件侧拿到的是被 runner 包装过的版本 —— **每一层的 disposer 都被挂在调用方的 fiber 上**：
+
+```js
+const dispose = Reflect.apply(method, target, [id, tokens])
+ctx.effect(() => dispose, 'cordis-client-runner: dynamic theme override layer')
+```
+
+也就是说：**这一层的生命周期 = 插件 fiber 的生命周期**。插件被卸载/重载、或 fiber 的
+effect 被清理时，层就没了；`composeActive` 在 `overrides.size === 0` 时直接返回内置主题，
+于是页面**静默**变回默认色 —— localStorage 里的选择还在，设置页自然还显示暖砂。
+
+会触发 fiber 重载的典型情况：动态插件被宿主重载（改过插件文件/profile、宿主自我更新）、
+渲染进程恢复、以及某些"模型操作"引起的插件重载。
+
+**v1.3.1 的处理**：加了一个自愈环。窗口重新可见 / 获焦 / `pageshow` / `theme/change` /
+每 4 秒，回读 `body` 上的 5 个关键 token；不在了就把最后一层重放：
+
+```
+[dsh-theme-palette] 配色层不见了（visibility），已重放第 1 次
+```
+
+设置页顶部会显示"配色层被宿主丢过一次，已自动恢复 N 次"；健康时不产生任何写入。
+
+**另一种可能**（值得先分辨）：如果是 **localStorage 被清**（换 profile、清缓存），设置页会回到
+「黑白」选中态 —— 那种情况自愈救不回来，因为连"你想用哪套"都丢了。判据就是**设置页里选中的
+是不是你原来那套**。
+
 ## 设置页重排（v1.3.0）
 
 原来的设置页是六行"工程参数"堆在一起、每行都是同一种小药丸。v1.3.0 重做成四段：
@@ -570,6 +612,10 @@ dsh plugin --profile desktop add "E:\Documents\deepseek-harness\default-workspac
 - 苔绿强调 `155°→165°` —— 与底色（h≈152）从 2° 拉开到 13°，链接不再只靠明度识别
 - 深色对比度：正文 14.40–14.98、三级 4.79 起、链接 4.65 起（0 处低于下限）
 
+**1.3.1**
+- 自愈：override 层被宿主丢掉时（插件 fiber 重载等）自动重放，设置页显示恢复次数
+- 触发点：visibilitychange / focus / pageshow / theme/change / 4s 定时；健康时零写入
+
 **1.3.0**
 - 设置页重排：2×2 缩略图卡片（随明暗切换）+ 段落式设置行 + 分段控件 + 版本徽标
 - 样式从内联改为独立注入的 `settings.css`（支持 hover / 窄屏 / `body[data-ds-dark-theme]`）

package/client.js

@@ -27,7 +27,7 @@ window.__ModuleLoader__.load({
     const React = require('react')
     const h = React.createElement
 
-    const PLUGIN_VERSION = '1.3.0'
+    const PLUGIN_VERSION = '1.3.1'
     const STORE_KEY = 'dsh-theme-palette.v1'
     const OVERRIDE_SOURCE = 'dsh-theme-palette'
 
@@ -1119,6 +1119,11 @@ body[data-ds-dark-theme] .dsh-tp-check{background:var(--t-accent-d);color:var(--
         row(txt.sidebar, txt.sidebarSub, seg(SIDEBAR_MODES, sidebarMode, props.setSidebarMode)),
         row(txt.rightbar, txt.rightbarSub, seg(RIGHTBAR_MODES, rightbarMode, props.setRightbarMode)),
         health && !health.ok && h('p', { className: 'dsh-tp-status is-bad' }, txt.bad),
+        health && health.ok && health.reapplies > 0 && h(
+          'p',
+          { className: 'dsh-tp-status' },
+          (isZh() ? '配色层被宿主丢过一次，已自动恢复 ' : 'Palette layer was dropped by the host; restored ') + health.reapplies + (isZh() ? ' 次' : 'x'),
+        ),
         h('button', {
           type: 'button',
           className: 'dsh-tp-more',
@@ -1210,7 +1215,13 @@ body[data-ds-dark-theme] .dsh-tp-check{background:var(--t-accent-d);color:var(--
 
         let disposeLayer = () => {}
         /** 按当前配色 + 侧栏档位重建覆盖层（换配色与换侧栏档位走同一条路）。 */
-        const applyAll = () => {
+        // 最近一次成功应用的 token 表与原因：自愈时据此重放，也用来解释"为什么又变回去了"。
+        let lastTokens = null
+        let lastAppliedAt = 0
+        let lastReason = 'init'
+        let reapplyCount = 0
+
+        const applyAll = (reason) => {
           const scheme = SCHEMES.find((s) => s.id === current) || SCHEMES[0]
           const tokens = buildTokens(scheme, sidebarMode, textMode, rightbarMode, scrollMode, controlMode, mdMode)
           let next = () => {}
@@ -1226,8 +1237,38 @@ body[data-ds-dark-theme] .dsh-tp-check{background:var(--t-accent-d);color:var(--
           const prev = disposeLayer
           disposeLayer = next
           prev()
+          if (reason !== undefined) lastReason = reason
+          lastTokens = tokens
+          lastAppliedAt = Date.now()
           scheduleProbe(tokens)
         }
+        /**
+         * 自愈。
+         *
+         * 宿主的 theme.overrideTokens 把每一层的 disposer 挂在**调用方 fiber** 上
+         * （`ctx.effect(() => dispose, ...)`）：插件被卸载/重载、或 fiber 的 effect 被清理时，
+         * 这一层就没了 —— 表现正是"配色自己跳回默认"，而 localStorage 里的选择还在。
+         * 这里定期（以及窗口重新可见/获焦时）回读 body：token 不在了就把最后一层重放。
+         */
+        const ensureApplied = (reason) => {
+          if (lastTokens === null) return
+          if (Date.now() - lastAppliedAt < 900) return
+          let missing = false
+          try {
+            const style = getComputedStyle(document.body)
+            for (const name of TOKEN_PROBE) {
+              if (!(name in lastTokens)) continue
+              if (style.getPropertyValue(name).trim() === '') { missing = true; break }
+            }
+          } catch (err) {
+            missing = true
+          }
+          if (!missing) return
+          reapplyCount += 1
+          console.info('[dsh-theme-palette] 配色层不见了（' + reason + '），已重放第 ' + reapplyCount + ' 次')
+          applyAll('self-heal:' + reason)
+        }
+
         let health = null
         const healthListeners = new Set()
         const getHealth = () => health
@@ -1243,7 +1284,7 @@ body[data-ds-dark-theme] .dsh-tp-check{background:var(--t-accent-d);color:var(--
             const next = probeApplied(tokens)
             if (next === null) return
             if (health !== null && health.ok === next.ok && health.checked === next.checked) return
-            health = next
+            health = { ...next, reapplies: reapplyCount }
             if (!next.ok) console.warn('[dsh-theme-palette] 有 token 没写进 body，宿主可能改名了')
             emitHealth()
           }
@@ -1321,11 +1362,36 @@ body[data-ds-dark-theme] .dsh-tp-check{background:var(--t-accent-d);color:var(--
           console.warn('[dsh-theme-palette] dev hook attach 失败：', err)
         }
 
+        // 自愈的触发点：窗口回前台、获焦、页面恢复、主题事件、以及一个低频定时器。
+        const heal = (why) => () => { try { ensureApplied(why) } catch (err) { /* 自愈失败不影响主流程 */ } }
+        const healOnVisible = heal('visibility')
+        const healOnFocus = heal('focus')
+        const healOnShow = heal('pageshow')
+        const healOnTheme = heal('theme-change')
+        let healTimer = null
+        try {
+          document.addEventListener('visibilitychange', healOnVisible)
+          window.addEventListener('focus', healOnFocus)
+          window.addEventListener('pageshow', healOnShow)
+        } catch (err) { /* 无 DOM 时跳过 */ }
+        try { ctx.on('theme/change', healOnTheme) } catch (err) { /* 事件名变了就只靠定时器 */ }
+        try { healTimer = setInterval(() => ensureApplied('interval'), 4000) } catch (err) { /* 无定时器环境 */ }
+
         ctx.effect(() => {
-          applyAll()
+          applyAll('boot')
           const removeStyle = installRightbarStyle()
           const removeSettings = installSettingsStyle()
-          return () => { disposeLayer(); removeStyle(); removeSettings() }
+          return () => {
+            disposeLayer()
+            removeStyle()
+            removeSettings()
+            try {
+              document.removeEventListener('visibilitychange', healOnVisible)
+              window.removeEventListener('focus', healOnFocus)
+              window.removeEventListener('pageshow', healOnShow)
+            } catch (err) { /* 同上 */ }
+            if (healTimer !== null) { clearInterval(healTimer); healTimer = null }
+          }
         }, 'dsh-theme-palette: token layer + 右栏样式')
 
         ctx.slots.inject('settings.section', () =>

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "dsh-theme-palette",
-  "version": "1.3.0",
+  "version": "1.3.1",
   "description": "DSH 主题配色：4 套配色 × 明暗两模式，OKLCH 色域安全重建 + 真实承载面对比度求解，可调强度与面板表面。",
   "type": "module",
   "main": "index.js",