dsh-claude-style 0.11.0 → 0.11.1

package/CHANGELOG.md

@@ -2,6 +2,20 @@
 
 All notable changes to `dsh-claude-style` are documented here, newest first.
 
+## [0.11.1] - 2026-10-06
+
+[中文](#cn-0.11.1) | [English](#en-0.11.1)
+
+<h3 id="cn-0.11.1">新增功能</h3>
+
+- **与皮肤中心交接**：DSH 皮肤中心把本主题列为可选皮肤。选中它即把整页交给本插件，换选其他皮肤、官方默认或壁纸在跑时页面自动交还，无需刷新。判定读皮肤中心注入服务端 HTML 的 `html[data-dsh-skin]` 与壁纸插件的 `body[data-we-wallpaper]`，两者任一存在即让路：让路期间不挂样式表、不安装功能、不占用任何文档属性，只保留设置页与偏好。构建在 `body` 上盖 `data-dsh-claude-style-handoff` 标记自己支持让路。
+
+<h3 id="en-0.11.1">New Features</h3>
+
+- **Skin center handoff**: the DSH Skin Center offers this theme as a selectable skin. Selecting it hands the whole page to this plugin; selecting another skin, the official default, or a running wallpaper takes the page back without a reload. The verdict reads the `html[data-dsh-skin]` attribute the Skin Center injects into the served document and the wallpaper plugin's `body[data-we-wallpaper]`; either one means yielding, and while yielded the theme mounts no stylesheet, installs no feature and claims no document attribute, keeping only its settings page and preferences. A build stamps `data-dsh-claude-style-handoff` on `body` to say it can do this.
+
+**Full Changelog**: [v0.11.0...v0.11.1](https://github.com/Nwflower/dsh-claude-style/compare/v0.11.0...v0.11.1)
+
 ## [0.11.0] - 2026-10-06
 
 [中文](#cn-0.11.0) | [English](#en-0.11.0)

package/README.en.md

@@ -123,6 +123,20 @@ To enable the Anthropic fonts, choose one of the following:
 
 > The Anthropic Sans and Serif fonts are the property of Anthropic, licensed for personal use only, and are not covered by this project's MIT license.
 
+## Skin center handoff
+
+This theme is also offered as a **skin** in the DSH Skin Center. Selecting it there hands the whole page to this
+plugin; selecting anything else - another skin, the official default, or a running wallpaper - takes the page back
+without a reload.
+
+- The answer holds from the first frame: the Skin Center stamps `html[data-dsh-skin]` into the served document, so a
+  page that boots with a skin already painting never flashes a frame of this theme first.
+- While another owner has the page this theme mounts no stylesheet, installs no feature and claims no document
+  attribute at all. It takes the page back on a real flip, and gives it back when an owner returns.
+- The settings page and every stored preference survive the handoff. A skin taking the screen does not uninstall
+  anything, and closing the Skin Center does not throw away what you configured here.
+- `data-dsh-claude-style-handoff` on `body` marks a build that can do this; the Skin Center offers the row only
+  while it is there.
 ## Installation
 
 1. From the official plugin page, add the plugin below and it installs.

package/README.md

@@ -123,6 +123,17 @@ Anthropic 字体启用（二选一）：
 
 ② 免安装——把 `.ttf` 复制到插件包的 `fonts/` 目录。完成后刷新页面生效。
 
+## 皮肤中心交接
+
+在 DSH 皮肤中心里，这套主题同时以**皮肤**的身份出现。选它即把整页交给本插件；换选别的皮肤、官方默认，
+或者壁纸在渲染时，页面都会在不需要刷新的情况下交还回来。
+
+- 判定从第一帧就成立：皮肤中心把 `html[data-dsh-skin]` 注入服务端 HTML，因此带着皮肤启动的页面不会先闪过
+  一帧本主题。
+- 页面另有属主时，本主题不挂样式表、不安装任何功能、不占用任何文档属性；属主离开时立刻接管，属主回来
+  时再次让出。
+- 交接期间设置页与所有偏好都还在：别的皮肤占屏不等于卸载，关掉皮肤中心也不丢这里配过的东西。
+- `body` 上的 `data-dsh-claude-style-handoff` 标记支持交接的构建；皮肤中心只在这一属性存在时才提供该选项。
 ## 安装
 
 1. 官方插件页，添加以下插件即可快速安装

package/docs/decisions/D49-visual-yield.md

@@ -0,0 +1,30 @@
+# D49. 让路：宿主另有属主时收掉整套视觉，留下设置页
+
+- **状态**：已实施
+- **关联**：D12、D29、D30、D32、D33、D40
+- **迁移**：无
+
+## 决定
+
+- 两个属性回答「这一页现在归谁」：`html[data-dsh-skin]`（皮肤中心在皮肤作画时盖上，值是皮肤 id）与 `body[data-we-wallpaper]`（壁纸插件渲染壁纸期间盖上）。任一存在即让路。`src/shared/visual-owner.js` 读它们，`apply()` 开头同步读一次，之后由一个 MutationObserver 跟随真实翻转；判定每次重算，不跨翻转缓存。
+- 让路时：保留 `setHostContext`、`adoptSettingsForm` 与 `ctx.inject(['configForms'])`、`loadModelCopy` / `loadUsername` / `loadHdsl`、`adoptPrefs`，只安装 `settings` 一个功能；不盖 `data-dsh-claude-style`、不挂样式表、不跑调度器。模块作用域的 `parkForeignSheets()` 照常运行（兄弟包的样式表不能等本皮肤）。
+- 抢回页面时（`own()`）：盖上 `data-dsh-claude-style` 与 `data-dsh-claude-style-handoff`、重新 `adoptPrefs`、挂样式表、装齐功能、装调度器；已在装的功能不重复安装。交还页面时（`release(keep)`）：跑完每个功能的 teardown、撤掉本包在 body 上的全部属性与样式表，`keep` 名单里的功能留下。
+- 宿主运行时收到 teardown 仍是唯一的一次性拆卸器：`teardown()` 先停归属观察，再 `release()`，再停对话插件观察与偏好绑定。
+- `data-dsh-claude-style-handoff` 是能力标记：它在 `body` 上与存活标记同时出现，表示这一版能让路。皮肤中心据此才把本主题当作可选皮肤列出来；没有它的旧版本不会被选用。
+
+## 理由
+
+- 皮肤中心把它注入服务端 HTML，所以第一帧就有答案；而 D32 已经用同样的「两路信号 + 观察者」形状处理过另一个插件，重复发明一套形状不如沿用。
+- 让路的粒度是整页而不是单个功能：只关掉功能表会漏掉样式表、无开关的功能、`adoptPrefs` 打在 body 上的属性，以及独立安装的调度器与座位键（D12 的隔离不等于整页交还）。
+- 收掉视觉不是卸载：读者的设置页与偏好必须继续在，别人的皮肤不该顺手删掉本包的东西。
+
+## 代价
+
+- 在 D40 落地前多一个常驻观察者（D40 只豁免了 head 的 childList 那一个）。
+- 让路期间整页惰性：设置页以宿主样式渲染，页面上的其他本包行为全部停摆。
+- 翻转会带来一次可见的重新挂载；判定在观察者回调里重算，不缓存。
+
+## 重审条件
+
+- 宿主提供主题层接口时改接宿主的（D30 已带着这一条）。
+- 皮肤中心提供可注入的主题服务时，判定改走服务，属性只留作第一帧的先验。

package/docs/decisions/README.md

@@ -62,6 +62,7 @@
 | [D27](D27-context-stats.md) | 会话数字收进上下文弹层 | 已实施 |
 | [D32](D32-chat-interactions.md) | 搬来的聊天区交互：自己的前缀、自己的偏好、对上游让位 | 已实施 |
 | [D34](D34-turn-navigator.md) | 对话导航：皮肤画导航条，跳转按宿主自己的刻度 | 已实施 |
+| [D49](D49-visual-yield.md) | 让路：宿主另有属主时收掉整套视觉，留下设置页 | 已实施 |
 
 ## 分发与流程
 
@@ -73,4 +74,4 @@
 
 ## 作废的编号
 
-D1（由 D36 取代）、D2（由 D43 取代）、D6（由 D40 取代）、D8（由 D46 取代）、D13（由 D42 取代）、D18（由 D46 取代）。
+D1（由 D36 取代）、D2（由 D43 取代）、D6（由 D40 取代）、D8（由 D46 取代）、D13（由 D42 取代）、D18（由 D46 取代）。

package/lib/client.js

@@ -21,6 +21,7 @@
  *   - src/shared/chat-dom.js
  *   - src/shared/scroll-ease.js
  *   - src/shared/peer-plugin.js
+ *   - src/shared/visual-owner.js
  *   - src/features/selection/selection.js
  *   - src/features/composer/composer.js
  *   - src/features/copy/copy.js
@@ -670,6 +671,26 @@ window.__ModuleLoader__.load({
      * document and the stylesheet switches on this attribute.
      */
     const WINDOW_BLUR_ATTR = 'data-dsh-window-blur'
+    /**
+     * The handoff marker: stamped on `body` while this build is live AND able
+     * to give the page back (D49). Its presence is a capability another
+     * package can read without running anything: a skin that lists this theme
+     * as one of its looks has to know the page can come back, and a build from
+     * before D49 does not stamp it.
+     */
+    const HANDOFF_ATTR = 'data-dsh-claude-style-handoff'
+    /**
+     * The document attribute the skin center stamps while a skin is painting
+     * (D49). It is read at boot and watched afterwards: the value is the skin
+     * id, and the presence means the page belongs to a skin.
+     */
+    const SKIN_STAMP_ATTR = 'data-dsh-skin'
+    /**
+     * The document attribute the delegated wallpaper plugin stamps while it
+     * renders (D49). Two plugins cannot own one shell, so a wallpaper outranks
+     * this theme exactly as a skin does.
+     */
+    const WALLPAPER_ACTIVE_ATTR = 'data-we-wallpaper'
     /**
      * On the host's scroller around the settings page while the page is
      * mounted (src/features/settings/settings.js): the stylesheet keeps the
@@ -8442,7 +8463,7 @@ window.__ModuleLoader__.load({
     // ============================================================================
     // 构建编号（由 scripts/build.mjs 按产物内容生成） (Build id)
     // ============================================================================
-    var BUILD_ID = '6dbb4b9c8819'
+    var BUILD_ID = '30e63fef2abb'
 
     // ============================================================================
     // Deepy 帧图内容戳（由 scripts/build.mjs 按帧图字节生成） (Deepy sheet stamps)
@@ -10208,6 +10229,62 @@ window.__ModuleLoader__.load({
       }
     }
 
+    /**
+     * The other owner of this page, and whether it is on it right now.
+     *
+     * Two documented attributes answer it, and either one is enough:
+     *
+     *   html[data-dsh-skin]      the skin center stamps it while a skin is
+     *                             painting. The skin center injects it into
+     *                             the served document, so the answer holds
+     *                             from the first frame (D49).
+     *   body[data-we-wallpaper]  the delegated wallpaper plugin stamps it while
+     *                             a wallpaper renders (D49).
+     *
+     * The skin center does not stamp its attribute for this theme's own row:
+     * selecting this theme means the page has no skin on it, which is what
+     * leaves the page free for the theme to take.
+     */
+    function externalOwnerActive() {
+        const doc = document
+        if (doc.documentElement?.hasAttribute(SKIN_STAMP_ATTR) === true) return true
+        return doc.body?.hasAttribute(WALLPAPER_ACTIVE_ATTR) === true
+    }
+
+    /**
+     * Watch the other owner, and hear when it arrives or leaves.
+     *
+     * Both attributes are read; nothing is written. The callback fires once
+     * immediately with the current answer, so a page that boots while a skin
+     * or a wallpaper already owns it never paints a frame of this theme first,
+     * then only on a real flip. The observer is the third exception to the
+     * single-scheduler rule (D40): it waits on two attributes of the
+     * document, outside this package's own subtree.
+     *
+     * @param {function(boolean): void} listener called with the new answer
+     * @returns {function(): void} unsubscribe
+     */
+    function subscribeExternalOwner(listener) {
+        let last = externalOwnerActive()
+        const observer = new MutationObserver(() => {
+            const next = externalOwnerActive()
+            if (next === last) return
+            last = next
+            listener(next)
+        })
+        observer.observe(document.documentElement, {
+            attributes: true,
+            attributeFilter: [SKIN_STAMP_ATTR],
+        })
+        if (document.body !== null) {
+            observer.observe(document.body, {
+                attributes: true,
+                attributeFilter: [WALLPAPER_ACTIVE_ATTR],
+            })
+        }
+        return () => observer.disconnect()
+    }
+
     /**
      * Text selection has two paints and CSS cannot tell them apart: gray on
      * black while the browser window is unfocused, blue on white while it is
@@ -28246,35 +28323,72 @@ window.__ModuleLoader__.load({
       let offSwitches = null
       /** Keeps the other chat plugin's presence watch alive; set once the features install. */
       let offPeerWatch = null
+      /** Watches the other owner of the page (a skin, a wallpaper); D49. */
+      let offOwnerWatch = null
       /** Unmounts this generation's stylesheet; set once the sheet is mounted. */
       let stopStylesheet = null
       let disposed = false
+      /** True while another plugin owns the page and this theme stands down (D49). */
+      let yielded = externalOwnerActive()
 
       /**
-       * Undo everything this generation installed. Idempotent: the host runs it
-       * on dispose (the effect below), and apply() runs it itself when the
-       * scheduler cannot be installed.
+       * Take the page: stamp, mount the sheet, install the features, schedule.
+       *
+       * Idempotent over what is already installed, so taking the page back
+       * after a yield leaves the settings section alone (D49).
+       */
+      function own() {
+        body.setAttribute('data-dsh-claude-style', BUILD_ID)
+        // The handoff marker rides the live stamp: its presence is what lets the
+        // skin center offer this theme as a selectable look (D49).
+        body.setAttribute(HANDOFF_ATTR, BUILD_ID)
+        adoptPrefs(prefs)
+        if (stopStylesheet === null) stopStylesheet = mountStylesheet()
+        for (const feature of FEATURES) {
+          if (installed.some(entry => entry.name === feature.name)) continue
+          if (switched.includes(feature)) applySwitch(feature)
+          else install(feature)
+        }
+        if (offSwitches === null) {
+          offSwitches = subscribePrefs(() => {
+            // A preference flip while yielded must not install a feature back
+            // onto a page another owner is painting (D49).
+            if (yielded) return
+            for (const feature of switched) applySwitch(feature)
+            if (typeof ui.schedule === 'function') ui.schedule()
+          })
+        }
+        if (installed.some(entry => entry.name === 'scheduler')) return
+        if (!install({ name: 'scheduler', install() { return installScheduler(ctx, ui, handleNames) } })) teardown()
+      }
+
+      /**
+       * Give the page back, keeping whatever the caller names.
+       *
+       * A yield keeps the settings section and the preference binding: the
+       * reader must still reach the plugin's own page, and nothing is
+       * uninstalled by another plugin taking the screen (D49).
+       *
+       * @param {Array<string>} keep install names that survive this call
        */
-      function teardown() {
-        if (disposed) return
-        disposed = true
-        // First, so no preference flip installs a feature mid-teardown.
+      function release(keep) {
+        // First, so no preference flip installs a feature mid-release.
         if (offSwitches !== null) {
           offSwitches()
           offSwitches = null
         }
-        if (offPeerWatch !== null) {
-          offPeerWatch()
-          offPeerWatch = null
-        }
+        const kept = []
         for (let i = installed.length - 1; i >= 0; i--) {
+          if (keep !== undefined && keep.includes(installed[i].name)) {
+            kept.push(installed[i])
+            continue
+          }
           // One teardown must not block the rest (D12); a failing one is reported.
           try { installed[i].stop() } catch (error) { reportError(error) }
         }
-        installed = []
-        setHostContext(null)
-        disposePrefsBinding()
+        installed = kept.reverse()
         body.removeAttribute('data-dsh-claude-style')
+        body.removeAttribute(HANDOFF_ATTR)
         body.removeAttribute(BRAND_ATTR)
         body.removeAttribute(PALETTE_ATTR)
         body.removeAttribute(TYPEFACE_ATTR)
@@ -28287,7 +28401,31 @@ window.__ModuleLoader__.load({
         body.removeAttribute(WINDOW_BLUR_ATTR)
         // This generation's own sheet, handed over rather than taken away when a
         // newer generation has mounted after it (mountStylesheet).
-        if (stopStylesheet !== null) stopStylesheet()
+        if (stopStylesheet !== null) {
+          stopStylesheet()
+          stopStylesheet = null
+        }
+      }
+
+      /**
+       * Undo everything this generation installed. Idempotent: the host runs it
+       * on dispose (the effect below), and own() runs it itself when the
+       * scheduler cannot be installed.
+       */
+      function teardown() {
+        if (disposed) return
+        disposed = true
+        if (offOwnerWatch !== null) {
+          offOwnerWatch()
+          offOwnerWatch = null
+        }
+        release()
+        if (offPeerWatch !== null) {
+          offPeerWatch()
+          offPeerWatch = null
+        }
+        setHostContext(null)
+        disposePrefsBinding()
       }
 
       // Registered before anything is installed: registered last, a feature that
@@ -28373,9 +28511,6 @@ window.__ModuleLoader__.load({
         }
       }
 
-      // The value is the build id (scripts/build.mjs): the stylesheet keys on
-      // the attribute alone, and a live page reads which lib/client.js it runs.
-      body.setAttribute('data-dsh-claude-style', BUILD_ID)
       setHostContext(ctx)
       // Bind the official settings form before anything reads a preference:
       // the host serves namespaces through `ctx.configForms`. Bound once here,
@@ -28390,13 +28525,10 @@ window.__ModuleLoader__.load({
       // Preferences are read asynchronously from the host settings namespace;
       // applying the defaults first keeps every gated rule in a defined state
       // for the frames before that read settles, and is exactly the shipped
-      // behaviour when it never does.
+      // behaviour when it never does. This runs while yielded too: the reader
+      // must still reach the settings page and see their own values (D49).
       adoptPrefs(prefs)
 
-      // The sheet carries this package's own tags and is unmounted by the
-      // teardown below; the features install onto a page that already wears it.
-      stopStylesheet = mountStylesheet()
-
       /**
        * Every feature the skin installs, in install order. `name` is the label
        * the failure report and the teardown use; `handle` is the name it
@@ -28441,25 +28573,36 @@ window.__ModuleLoader__.load({
       ]
 
       const switched = FEATURES.filter(feature => Object.hasOwn(FEATURE_PREF_DEFAULTS, feature.pref ?? ''))
-      for (const feature of FEATURES) {
-        if (switched.includes(feature)) applySwitch(feature)
-        else install(feature)
-      }
-      offSwitches = subscribePrefs(() => {
-        for (const feature of switched) applySwitch(feature)
-        if (typeof ui.schedule === 'function') ui.schedule()
-      })
+      // The scheduler's passes read the `ui` handles lazily, so its pass order is
+      // the feature order, skipping handles that do not exist or have no `sync`.
+      const handleNames = FEATURES.map(feature => feature.handle || feature.name)
       // Keep the presence watch alive for the page's lifetime, whether or not a
       // feature subscribes on its own: the ported chat features decide on it, and
       // another plugin arriving or leaving re-runs the preference stream
       // (src/shared/peer-plugin.js). The subscription itself carries no logic.
       offPeerWatch = subscribePeerPresence(() => {})
 
-      // Last: its passes read the `ui` handles lazily. Without it nothing syncs,
-      // and a live stylesheet over overrides that never run is worse than no
-      // skin at all — so if it cannot install, the whole skin rolls back.
-      const handleNames = FEATURES.map(feature => feature.handle || feature.name)
-      if (!install({ name: 'scheduler', install() { return installScheduler(ctx, ui, handleNames) } })) teardown()
+      if (yielded) {
+        // Another owner already has this page (D49). The settings section is the
+        // one feature that stays: the reader still has to reach this theme's own
+        // page, and a skin taking the screen must not uninstall anything.
+        const settings = FEATURES.find(feature => feature.name === 'settings')
+        install(settings)
+        // adoptPrefs above stamped this theme's own body attributes; a yielded
+        // page carries none of them, so the release strips exactly what it
+        // stamped and leaves the section alone.
+        release(['settings'])
+        // The owner can arrive later or leave; a flip re-runs the whole pass, and
+        // the verdict is read again rather than remembered across the flip.
+        offOwnerWatch = subscribeExternalOwner(active => {
+          if (active === yielded) return
+          yielded = active
+          if (active) release(['settings'])
+          else own()
+        })
+        return
+      }
+      own()
     }
 
     exports.apply = apply

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "dsh-claude-style",
   "description": "Claude Code Desktop theme for DeepSeek Harness (dsh) web GUI — visual & interaction overhaul",
-  "version": "0.11.0",
+  "version": "0.11.1",
   "type": "module",
   "main": "host/index.js",
   "icon": "lib/claude-mark.svg",