@taosee258/dsh-client-ui-skin-qingxiao 0.1.4 → 0.2.3

package/LICENSE

@@ -1,25 +1,25 @@
-Creative Commons Attribution-NonCommercial-ShareAlike 4.0 International (CC BY-NC-SA 4.0)
-
-Copyright (c) 2026 the qingxiao skin authors
-
-You are free to:
-
-  Share — copy and redistribute the material in any medium or format
-  Adapt — remix, transform, and build upon the material
-
-Under the following terms:
-
-  Attribution — You must give appropriate credit, provide a link to the
-  license, and indicate if changes were made.
-
-  NonCommercial — You may not use the material for commercial purposes.
-
-  ShareAlike — If you remix, transform, or build upon the material, you
-  must distribute your contributions under the same license as the original.
-
-Full license text: https://creativecommons.org/licenses/by-nc-sa/4.0/legalcode
-
-Note: the bundled artwork (assets/qx.jpg) depicts the character 清宵 (Qingxiao)
-from Wuthering Waves (Kuro Games). It is included for personal, non-commercial
-decoration only and is not covered by the code license above; all rights
-belong to their respective owners.
+Creative Commons Attribution-NonCommercial-ShareAlike 4.0 International (CC BY-NC-SA 4.0)
+
+Copyright (c) 2026 the qingxiao skin authors
+
+You are free to:
+
+  Share — copy and redistribute the material in any medium or format
+  Adapt — remix, transform, and build upon the material
+
+Under the following terms:
+
+  Attribution — You must give appropriate credit, provide a link to the
+  license, and indicate if changes were made.
+
+  NonCommercial — You may not use the material for commercial purposes.
+
+  ShareAlike — If you remix, transform, or build upon the material, you
+  must distribute your contributions under the same license as the original.
+
+Full license text: https://creativecommons.org/licenses/by-nc-sa/4.0/legalcode
+
+Note: the bundled artwork (assets/qx.jpg) depicts the character 清宵 (Qingxiao)
+from Wuthering Waves (Kuro Games). It is included for personal, non-commercial
+decoration only and is not covered by the code license above; all rights
+belong to their respective owners.

package/README.md

@@ -1,99 +1,100 @@
-# 清宵 · 弦凝清霄 — DSH 美化包
-
-以《鸣潮》角色**清宵**（3.6 版本登场的五星气动·迅刀共鸣者，瑝珑「镇玄司骑」，琴剑双修的隐世剑仙）为主题的 DeepSeek Harness (DSH) Web 界面皮肤。
-
-> 「弦凝千古寂，剑起满天清」
-
-配色调色板取自清宵的形象：**冰蓝**（发色）、**青碧**（发饰流苏）、**月白**（衣装）、**玄夜蓝**（暗色形态）、**鎏金**（金饰点缀）。
-
-![亮色 · 清昼庭院](preview/screen-light.png)
-
-![暗色 · 玄夜剑鸣](preview/screen-dark.png)
-
-## 这个皮肤有什么
-
-- **背景画卷**：默认铺一张清宵插画当背景，亮色、暗色模式都能透出它。可以在设置面板里分别为两种模式换成你自己的图（PNG / JPG / WebP / GIF，7MB 以内），也能一键换回默认。
-- **全套配色重制**：侧边栏、按钮、输入框、对话区、代码块、滚动条……界面每一处都按清宵的配色重新调过；暗色模式是专门的「玄夜剑鸣」氛围。
-- **毛玻璃效果**：打开插件的小窗口（比如用量统计）、左右两侧面板、设置弹窗时，窗口背后的画面会被柔和地虚化掉——壁纸的轮廓透得出来，但绝不跟文字打架。想多糊可以多糊（0–30 档随意调），不想要可以整体关掉，也可以只关插件窗或只关侧栏。
-- **字永远看得清**：文字颜色专门为「压在插画背景上」调校过——正文浓黑/亮白，次要文字也比 DSH 原生的灰色深两档；背景还有可调浓度的柔光遮罩兜底。
-- **剑气流光**：可选的粒子装饰，青碧或鎏金两种色调；系统开了「减少动态效果」会自动静止。
-- **亮暗切换动画**：切换主题时有一抹剑光扫过屏幕的小动画，浏览器标签栏颜色和图标也会跟着换。
-- **新会话迎宾页**：打开空会话时，屏幕中央浮现「清 宵 · 镇玄司骑 · 徒儿，你来了……」的题字，开始对话后自动退场。
-- **设置跟着账号走**：所有偏好保存在 DSH 的数据目录里，换个浏览器、重启电脑都还在。
-
-## 设置面板
-
-点界面右上角的**清宵剑钰圆形按钮**打开调色盘。按钮可以拖到任意位置，位置会记住；面板底部有「回到右上角」一键复位。
-
-| 分区 | 能调什么 |
-| --- | --- |
-| 背景画卷 | 亮/暗两种模式的背景图更换与复原 |
-| 阅读清晰度 | 文字柔光开关 · 背景遮罩浓淡 · 面板实透 · 正文字号大小 |
-| 界面琉璃 | 对话区宽度 · 面板磨砂底 |
-| 毛玻璃虚化 | 总开关 · 插件窗/侧栏面板分开控制 · 虚化强度 0–30（0＝关） |
-| 剑气流光 | 开关 · 粒子数量 · 流动速度 |
-| 复原 | 全部恢复默认 |
-
-## 版本
-
-各版本改动见 [CHANGELOG.md](CHANGELOG.md)。
-
-## 安装
-
-### 懒人版
-
-直接对你的 DSH 说：
-```
-安装一下这个皮肤包：@taosee258/dsh-client-ui-skin-qingxiao
-```
-
-### 手动安装
-
-**命令行安装**（任选其一）：
-
-```sh
-# 方式 A（推荐）：从 npm 安装
-dsh plugin --profile web add @taosee258/dsh-client-ui-skin-qingxiao
-```
-
-```sh
-# 方式 B：用 git URL 安装（始终对应仓库最新版）
-dsh plugin --profile web add https://github.com/taoser258/dsh-client-ui-skin-qingxiao
-```
-
-```sh
-# 方式 C：先克隆到本地任意位置，再把实际路径交给 dsh
-git clone https://github.com/taoser258/dsh-client-ui-skin-qingxiao.git
-dsh plugin --profile web add /path/to/dsh-client-ui-skin-qingxiao
-```
-
-**手动放置安装**：把本包整个文件夹复制到 DSH 的 `profiles/web/node_modules/@taosee258/dsh-client-ui-skin-qingxiao/` 下，然后在 profile 的 `cordis.patch.yml` 里追加一条（与本包自带的 `cordis.patch.yml` 保持一致）：
-
-```yaml
-- insert:
-    - id: ui-skin-qingxiao
-      name: '@taosee258/dsh-client-ui-skin-qingxiao'
-```
-
-重启 DSH 即可。
-
-## 兼容性
-
-- DSH Web：0.1.0-rc.6 至 0.1.2-alpha.1
-- 平台：Web
-- 最近验证：2026-09-04（亮/暗两种模式真机实测）
-
-## 版权所有人
-
-| 版权所有人 | 版权所有内容 |
-|---|---|
-| Kuro Games（库洛游戏） | 「鸣潮」游戏作品及清宵（Qingxiao）角色形象原作 |
-| Fumi（pixiv） | 默认背景插画（`assets/qx.jpg`）原作 |
-| taoser | 皮肤实现（配色、毛玻璃、粒子装饰与界面逻辑） |
-
-\*本皮肤为同人创作，与 Kuro Games 无关联。
-
-## 署名与许可
-
-- 默认背景插画来自 **pixiv 画师 Fumi** 的《鸣潮》清宵同人插画（`assets/qx.jpg`），角色设定与游戏内容版权归库洛游戏所有。本皮肤仅供个人美化学习使用，与官方无关，请勿商用。
-- 插件代码与结构在 CC BY-NC-SA 4.0 下发布，请勿用于商业用途。
+# 清宵 · 弦凝清霄 — DSH 美化包
+
+以《鸣潮》角色**清宵**（3.6 版本登场的五星气动·迅刀共鸣者，瑝珑「镇玄司骑」，琴剑双修的隐世剑仙）为主题的 DeepSeek Harness (DSH) Web 界面皮肤。
+
+> 「弦凝千古寂，剑起满天清」
+
+配色调色板取自清宵的形象：**冰蓝**（发色）、**青碧**（发饰流苏）、**月白**（衣装）、**玄夜蓝**（暗色形态）、**鎏金**（金饰点缀）。
+
+![亮色 · 清昼庭院](preview/screen-light.png)
+
+![暗色 · 玄夜剑鸣](preview/screen-dark.png)
+
+## 这个皮肤有什么
+
+- **背景画卷**：默认铺一张清宵插画当背景，亮色、暗色模式都能透出它。可以在设置面板里分别为两种模式换成你自己的图（PNG / JPG / WebP / GIF，7MB 以内），也能一键换回默认。
+- **全套配色重制**：侧边栏、按钮、输入框、对话区、代码块、滚动条……界面每一处都按清宵的配色重新调过；暗色模式是专门的「玄夜剑鸣」氛围。
+- **毛玻璃效果**：打开插件的小窗口（比如用量统计）、左右两侧面板、插件页/自动化任务页等整页视图、设置弹窗乃至窗口顶栏，背后的画面都会被柔和地虚化掉——壁纸的轮廓透得出来，但绝不跟文字打架。想多糊可以多糊（0–30 档随意调），不想要可以整体关掉，也可以只关插件窗或只关侧栏。
+- **字永远看得清**：文字颜色专门为「压在插画背景上」调校过——正文浓黑/亮白，次要文字也比 DSH 原生的灰色深两档；背景还有可调浓度的柔光遮罩兜底。
+- **剑气流光**：可选的粒子装饰，青碧或鎏金两种色调；系统开了「减少动态效果」会自动静止。
+- **亮暗切换动画**：切换主题时有一抹剑光扫过屏幕的小动画，浏览器标签栏颜色和图标也会跟着换。
+- **新会话迎宾页**：打开空会话时，屏幕中央浮现「清 宵 · 镇玄司骑 · 徒儿，你来了……」的题字，开始对话后自动退场。
+- **设置跟着账号走**：所有偏好保存在 DSH 的数据目录里，换个浏览器、重启电脑都还在。
+
+## 设置面板
+
+点界面右上角的**清宵剑钰圆形按钮**打开调色盘。按钮可以拖到任意位置，位置会记住；面板底部有「回到右上角」一键复位。
+
+| 分区 | 能调什么 |
+| --- | --- |
+| 背景画卷 | 亮/暗两种模式的背景图更换与复原 |
+| 阅读清晰度 | 文字柔光开关 · 背景遮罩浓淡 · 面板实透 · 正文字号大小 |
+| 界面琉璃 | 对话区宽度 · 面板磨砂底 |
+| 毛玻璃虚化 | 总开关 · 插件窗/侧栏面板分开控制 · 虚化强度 0–30（0＝关） |
+| 剑气流光 | 开关 · 粒子数量 · 流动速度 |
+| 复原 | 全部恢复默认 |
+
+## 版本
+
+各版本改动见 [CHANGELOG.md](CHANGELOG.md)。
+
+## 安装
+
+### 懒人版
+
+直接对你的 DSH 说（桌面端、网页端都适用，会装进当前档案）：
+```
+安装一下这个皮肤包：@taosee258/dsh-client-ui-skin-qingxiao
+```
+
+### 手动安装
+
+**命令行安装**（任选其一；`--profile` 按目标填：桌面端 `desktop`、网页端 `web`）：
+
+```sh
+# 方式 A（推荐）：从 npm 安装
+dsh plugin --profile desktop add @taosee258/dsh-client-ui-skin-qingxiao
+```
+
+```sh
+# 方式 B：用 git URL 安装（始终对应仓库最新版）
+dsh plugin --profile desktop add https://github.com/taoser258/dsh-client-ui-skin-qingxiao
+```
+
+```sh
+# 方式 C：先克隆到本地任意位置，再把实际路径交给 dsh
+git clone https://github.com/taoser258/dsh-client-ui-skin-qingxiao.git
+dsh plugin --profile desktop add /path/to/dsh-client-ui-skin-qingxiao
+```
+
+**手动放置安装**：把本包整个文件夹复制到 DSH 的 `profiles/<档案名>/node_modules/@taosee258/dsh-client-ui-skin-qingxiao/` 下（桌面端档案为 `desktop`），然后在 profile 的 `cordis.patch.yml` 里追加一条（与本包自带的 `cordis.patch.yml` 保持一致）：
+
+```yaml
+- insert:
+    - id: ui-skin-qingxiao
+      name: '@taosee258/dsh-client-ui-skin-qingxiao'
+```
+
+重启 DSH 即可。
+
+## 兼容性
+
+- DSH Web / 桌面端：0.1.0-rc.6 至 0.2.0-rc.2
+- 自 0.2.0 起针对官方桌面端 0.2.0-rc.2 深度适配：字号令牌新基准、顶栏毛玻璃横带与原生窗口按钮融合、插件/任务等整页视图毛玻璃背板、开关与徽章配色对齐
+- 平台：Web / Windows 桌面端（设置保存在各自档案的 `data/` 目录下）
+- 最近验证：2026-10-01（0.2.0-rc.2 桌面端亮/暗两态真机实测）
+
+## 版权所有人
+
+| 版权所有人 | 版权所有内容 |
+|---|---|
+| Kuro Games（库洛游戏） | 「鸣潮」游戏作品及清宵（Qingxiao）角色形象原作 |
+| Fumi（pixiv） | 默认背景插画（`assets/qx.jpg`）原作 |
+| taoser | 皮肤实现（配色、毛玻璃、粒子装饰与界面逻辑） |
+
+\*本皮肤为同人创作，与 Kuro Games 无关联。
+
+## 署名与许可
+
+- 默认背景插画来自 **pixiv 画师 Fumi** 的《鸣潮》清宵同人插画（`assets/qx.jpg`），角色设定与游戏内容版权归库洛游戏所有。本皮肤仅供个人美化学习使用，与官方无关，请勿商用。
+- 插件代码与结构在 CC BY-NC-SA 4.0 下发布，请勿用于商业用途。

package/lib/client.js

@@ -13,7 +13,7 @@ window.__ModuleLoader__.load({
 
 		var SKIN_OWNER = "qingxiao";
 		// 与 package.json 的 version 保持一致（面板页脚会展示）。
-		var SKIN_VERSION = "0.1.4";
+		var SKIN_VERSION = "0.2.3";
 		var SKIN_TITLE = "清宵 · DeepSeek Harness";
 		var SKIN_SYSTEM_CHROME_COLOR_LIGHT = "#EEF7FB";
 		var SKIN_SYSTEM_CHROME_COLOR_DARK = "#0B1E2E";
@@ -30,67 +30,82 @@ window.__ModuleLoader__.load({
 		];
 
 		// ── 正文字号缩放：DSH markdown 字体令牌表 ──
-		// 每一项对应 DSH 皮肤层里的一条令牌，格式是 font 简写：
-		//   [基名, 基准字号px, 基准行高px, 字重("" = 不写), 字族, 是否斜体]
-		// 基准值取自 @deepseek-ai/dsh-client-ui-theme 的令牌定义，改这里就等于
-		// 改「100% 时长什么样」；滑块只做等比缩放。
+		// 基准取自 @deepseek-ai/dsh-client-ui-theme 0.2.0-rc.2 的令牌定义：
+		//   base 系   : var(--dsh-content-font-size, 14px) / calc(24px + delta)
+		//   h1/h2/h3  : (21/19/18px + delta) / (30/28/26px + delta)
+		//   small 系  : 12px / 20px
+		//   table 系  : var(--dsh-content-font-size-secondary, 13px) / calc(22px + delta2)
+		//   code 系   : 12/19 · 11/19 · 11/16
+		// delta 是官方设置里的正文字号偏移（--dsh-content-font-delta，body 上
+		// 定义为 calc(内容字号 - 14px)）。缩放把整个表达式乘上 S，官方偏移在皮肤
+		// 缩放下继续生效；100% 时与官方令牌逐字节一致。
+		// 每项：[名, 字重("" = 不写), 是否斜体, 字族, 字号表达式, 行高表达式]，
+		// 表达式里的 $S 生成时替换为缩放字面量（如 1.05），再整体包进 calc()。
+		// calc 包 var 的写法与官方令牌同构（官方 shorthand 本就带 calc+var）；
+		// 不要退回纯 px 字面量——那会把官方的字号偏移一并抹掉。
+		var QX_DELTA = "var(--dsh-content-font-delta, 0px)";
+		var QX_DELTA_2 = "var(--dsh-content-font-delta-secondary, 0px)";
+		var QX_CONTENT_SIZE = "var(--dsh-content-font-size, 14px)";
+		var QX_CONTENT_SIZE_2 = "var(--dsh-content-font-size-secondary, 13px)";
 		var QX_FONT_TOKENS = [
-			["base", 16, 28, "", "text", false],
-			["base-strong", 16, 28, "600", "text", false],
-			["base-italic", 16, 28, "", "text", true],
-			["base-strong-italic", 16, 28, "600", "text", true],
-			["h1", 24, 34, "700", "text", false],
-			["h2", 22, 32, "700", "text", false],
-			["h3", 20, 30, "700", "text", false],
-			["h4", 16, 28, "600", "text", false],
-			["small", 14, 24, "", "text", false],
-			["small-strong", 14, 24, "600", "text", false],
-			["small-italic", 14, 24, "", "text", true],
-			["small-strong-italic", 14, 24, "600", "text", true],
-			["table", 15, 25, "", "text", false],
-			["table-head", 15, 25, "500", "text", false],
-			["code", 14, 22, "", "code", false],
-			["code-block", 13, 22, "", "code", false],
-			["code-block-small", 12, 18, "", "code", false]
+			["base", "", false, "text", QX_CONTENT_SIZE + " * $S", "(24px + " + QX_DELTA + ") * $S"],
+			["base-strong", "600", false, "text", QX_CONTENT_SIZE + " * $S", "(24px + " + QX_DELTA + ") * $S"],
+			["base-italic", "", true, "text", QX_CONTENT_SIZE + " * $S", "(24px + " + QX_DELTA + ") * $S"],
+			["base-strong-italic", "600", true, "text", QX_CONTENT_SIZE + " * $S", "(24px + " + QX_DELTA + ") * $S"],
+			["h1", "700", false, "text", "(21px + " + QX_DELTA + ") * $S", "(30px + " + QX_DELTA + ") * $S"],
+			["h2", "700", false, "text", "(19px + " + QX_DELTA + ") * $S", "(28px + " + QX_DELTA + ") * $S"],
+			["h3", "700", false, "text", "(18px + " + QX_DELTA + ") * $S", "(26px + " + QX_DELTA + ") * $S"],
+			["h4", "600", false, "text", QX_CONTENT_SIZE + " * $S", "(24px + " + QX_DELTA + ") * $S"],
+			["small", "", false, "text", "12px * $S", "20px * $S"],
+			["small-strong", "600", false, "text", "12px * $S", "20px * $S"],
+			["small-italic", "", true, "text", "12px * $S", "20px * $S"],
+			["small-strong-italic", "600", true, "text", "12px * $S", "20px * $S"],
+			["table", "", false, "text", QX_CONTENT_SIZE_2 + " * $S", "(22px + " + QX_DELTA_2 + ") * $S"],
+			["table-head", "500", false, "text", QX_CONTENT_SIZE_2 + " * $S", "(22px + " + QX_DELTA_2 + ") * $S"],
+			["code", "", false, "code", "12px * $S", "19px * $S"],
+			["code-block", "", false, "code", "11px * $S", "19px * $S"],
+			["code-block-small", "", false, "code", "11px * $S", "16px * $S"]
 		];
-		var QX_FONT_SCOPE = "body[data-dsh-qingxiao] :is([data-slot='conversation'], [data-conversation-scroll])";
+		var QX_FONT_SCOPE = "body[data-dsh-qingxiao] :is([data-slot='main.conversation'], [data-slot='conversation'], [data-conversation-scroll])";
 
 		function qxPx(value) {
 			return Math.round(value * 100) / 100;
 		}
 
-		// 生成字号缩放表：全部写成具体 px 字面量（不用 calc、不用 var 参与简写），
-		// 这样 DSH 的 font:var(--dsw-font-markdown-*) 才能正常解析。
-		// 同时补一组 font-size/line-height 长属性兜底：万一 DSH 改了令牌名，
-		// 正文仍然会跟着缩放，且 px 字面量在嵌套 markdown 里不会二次放大。
+		// 生成字号缩放表：基准表达式乘缩放字面量后包进 calc()，var()/delta 原样
+		// 保留，这样 DSH 的 font:var(--dsw-font-markdown-*) 正常解析且官方字号
+		// 偏移不被抹掉。同时补一组 font-size/line-height 长属性兜底：万一 DSH
+		// 改了令牌名，正文仍然会跟着缩放，且 calc 值在嵌套 markdown 里不会二次放大。
 		function buildFontScaleCss(scale) {
 			var decls = [];
 			var out = {};
+			var s = qxPx(scale);
 			QX_FONT_TOKENS.forEach(function(spec) {
 				var name = spec[0];
-				var size = qxPx(spec[1] * scale);
-				var lh = qxPx(spec[2] * scale);
-				var weight = spec[3];
-				var family = spec[4] === "code" ? "var(--ds-font-family-code)" : "var(--dsw-font-family)";
-				out[name] = [size, lh];
-				decls.push("--dsw-font-markdown-" + name + ": " + (spec[5] ? "italic " : "") + (weight ? weight + " " : "") + size + "px/" + lh + "px " + family + ";");
-				decls.push("--dsw-font-markdown-" + name + "-font-size: " + size + "px;");
-				decls.push("--dsw-font-markdown-" + name + "-line-height: " + lh + "px;");
+				var weight = spec[1];
+				var italic = spec[2];
+				var family = spec[3] === "code" ? "var(--ds-font-family-code)" : "var(--dsw-font-family)";
+				var size = "calc(" + spec[4].replace("$S", String(s)) + ")";
+				var line = "calc(" + spec[5].replace("$S", String(s)) + ")";
+				out[name] = { size: size, line: line };
+				decls.push("--dsw-font-markdown-" + name + ": " + (italic ? "italic " : "") + (weight ? weight + " " : "") + size + "/" + line + " " + family + ";");
+				decls.push("--dsw-font-markdown-" + name + "-font-size: " + size + ";");
+				decls.push("--dsw-font-markdown-" + name + "-line-height: " + line + ";");
 			});
-			var css = QX_FONT_SCOPE + "{--qx-font-scale:" + qxPx(scale) + ";\n" + decls.join("\n") + "\n}";
-			css += "\n" + QX_FONT_SCOPE + " [class*='_markdown']{font-size:" + out.base[0] + "px;line-height:" + out.base[1] + "px;}";
+			var css = QX_FONT_SCOPE + "{--qx-font-scale:" + s + ";\n" + decls.join("\n") + "\n}";
+			css += "\n" + QX_FONT_SCOPE + " [class*='_markdown']{font-size:" + out.base.size + ";line-height:" + out.base.line + ";}";
 			["h1", "h2", "h3"].forEach(function(h) {
-				css += "\n" + QX_FONT_SCOPE + " [class*='_markdown'] " + h + "{font-size:" + out[h][0] + "px;line-height:" + out[h][1] + "px;}";
+				css += "\n" + QX_FONT_SCOPE + " [class*='_markdown'] " + h + "{font-size:" + out[h].size + ";line-height:" + out[h].line + ";}";
 			});
-			css += "\n" + QX_FONT_SCOPE + " [class*='_markdown'] :is(h4,h5,h6){font-size:" + out["base-strong"][0] + "px;line-height:" + out["base-strong"][1] + "px;}";
-			css += "\n" + QX_FONT_SCOPE + " [class*='_markdown'] :is(th,td){font-size:" + out.table[0] + "px;line-height:" + out.table[1] + "px;}";
+			css += "\n" + QX_FONT_SCOPE + " [class*='_markdown'] :is(h4,h5,h6){font-size:" + out.base.size + ";line-height:" + out.base.line + ";}";
+			css += "\n" + QX_FONT_SCOPE + " [class*='_markdown'] :is(th,td){font-size:" + out.table.size + ";line-height:" + out.table.line + ";}";
 			return css;
 		}
 
 		// 实测对话正文当前的像素字号：给面板做自校验用。
 		function measureConversationFont() {
 			var el = document.querySelector("[data-conversation-scroll] [class*='_markdown']")
-				|| document.querySelector("[data-slot='conversation'] [class*='_markdown']");
+				|| document.querySelector(":is([data-slot='main.conversation'], [data-slot='conversation']) [class*='_markdown']");
 			if (!el || typeof getComputedStyle !== "function") return null;
 			var size = parseFloat(getComputedStyle(el).fontSize);
 			return isFinite(size) ? Math.round(size * 100) / 100 : null;
@@ -112,7 +127,7 @@ window.__ModuleLoader__.load({
 			scrimOpacity: 55,
 			panelOpacity: 45,
 			contentWidth: 880,
-			particleCount: 60,
+			particleCount: 25,
 			particleSpeed: 100,
 			fontScale: 100,
 			frostMaster: true,
@@ -199,6 +214,14 @@ body[data-dsh-qingxiao][data-ds-dark-theme] {
 	   与皮肤配色统一，也避免黑底突兀。文本仍走皮肤深色，够清晰。 */
 	--dsw-alias-button-primary-fill: #2E9E98;
 	--dsw-alias-button-primary-hover: #26837E;
+	/* 主按钮文字：0.2.0 的按钮类用 --dsw-alias-label-primary-foreground 取字色，
+	   皮肤的全局按钮墨色规则把它压掉了（青碧底配深墨字，发闷）。这里统一
+	   回月白：青碧底 + 月白字，亮暗两态都干净。 */
+	--dsw-alias-label-primary-foreground: #F4F9FC;
+	/* 品牌主色：DSH 把它定义成反色墨/白（亮色模式近黑、暗色模式近白），
+	   开关 ON 轨道和复选框 accent 都读它——暗色下开关全是白轨，与皮肤不搭。
+	   改为清宵青碧后一并对齐；ON 旋钮走上面的月白，正好是青碧底月白钮。 */
+	--dsw-alias-brand-primary: #2E9E98;
 }
 /* 对话区淡灰字（用户反馈）：DSH 的次级/三级标签令牌在画卷底上太淡
    （浅色 #61666b/#81858c 的工具行标题、时间戳、卡片描述灰成一片）。
@@ -207,10 +230,14 @@ body[data-dsh-qingxiao][data-ds-dark-theme] {
 body[data-dsh-qingxiao]:not([data-ds-dark-theme]) {
 	--dsw-alias-label-secondary: #232d36;
 	--dsw-alias-label-tertiary: #3a4550;
+	/* 业务信息色：DSH 用 DeepSeek 蓝，信息标签（「实验性」徽章）、
+	   输入聚焦边框等都读它，改成清宵青碧深色调。 */
+	--dsw-alias-state-business-primary: #1F7E86;
 }
 body[data-dsh-qingxiao][data-ds-dark-theme] {
 	--dsw-alias-label-secondary: #dde1e5;
 	--dsw-alias-label-tertiary: #c4cad1;
+	--dsw-alias-state-business-primary: #7FE0D6;
 }
 body[data-dsh-qingxiao] [id=root] {
 	background: transparent;
@@ -286,10 +313,13 @@ body[data-dsh-qingxiao] [class*='sidebarCol'] {
    的 ::after 伪元素上，且用 z-index:-1 垫在半透明面板之下、正文之上；
    ::after 不包含任何 portal，所以不困浮层，正文也保持清晰，只有底下的
    画卷被磨砂。 */
-body[data-dsh-qingxiao][data-qx-blur='on']:not([data-qx-frost='off']) :is([data-pane='sidebar'], [class*='sidebarCol'], [class*='_centerCol'], [class*='detailsCol']) {
+/* 0.2.0-rc.2 起布局把旧 detailsCol 更名为 rightbarCol（CSS Modules 前缀
+   BynINW_，类名本体仍含列名后缀，子串匹配不受影响）；detailsCol 选择器保留
+   兼容旧版布局。 */
+body[data-dsh-qingxiao][data-qx-blur='on']:not([data-qx-frost='off']) :is([data-pane='sidebar'], [class*='sidebarCol'], [class*='_centerCol'], [class*='detailsCol'], [class*='rightbarCol']) {
 	position: relative;
 }
-body[data-dsh-qingxiao][data-qx-blur='on']:not([data-qx-frost='off']) :is([data-pane='sidebar'], [class*='sidebarCol'], [class*='_centerCol'], [class*='detailsCol'])::after {
+body[data-dsh-qingxiao][data-qx-blur='on']:not([data-qx-frost='off']) :is([data-pane='sidebar'], [class*='sidebarCol'], [class*='_centerCol'], [class*='detailsCol'], [class*='rightbarCol'])::after {
 	content: "";
 	position: absolute;
 	inset: 0;
@@ -299,7 +329,8 @@ body[data-dsh-qingxiao][data-qx-blur='on']:not([data-qx-frost='off']) :is([data-
 	-webkit-backdrop-filter: blur(5px) saturate(1.1);
 }
 body[data-dsh-qingxiao] [class*='_centerCol'],
-body[data-dsh-qingxiao] [class*='detailsCol'] {
+body[data-dsh-qingxiao] [class*='detailsCol'],
+body[data-dsh-qingxiao] [class*='rightbarCol'] {
 	background: rgba(var(--qx-panel-rgb), calc(var(--qx-panel-alpha) * 0.72));
 }
 body[data-dsh-qingxiao] [class*='_centerCol'] > * {
@@ -310,9 +341,10 @@ body[data-dsh-qingxiao] [class*='_centerCol'] > * {
 }
 /* ── 对话区宽度 + 正文字号缩放：接到真正的对话内容上 ──
    旧选择器只作用于 centerCol 的直接子元素，没命中更深的对话内容，所以
-   拖这两个滑块没反应。对话内容在 [data-slot='conversation'] > *（滚动的
-   wSkVaW_root），正文用 [data-conversation-scroll] 定位。 */
-body[data-dsh-qingxiao] [data-slot='conversation'] > * {
+   拖这两个滑块没反应。对话内容在 [data-slot='main.conversation'] > *
+   （0.1.x 为 [data-slot='conversation']，滚动容器 [data-conversation-scroll]
+   两代同名），正文用 [data-conversation-scroll] 定位。 */
+body[data-dsh-qingxiao] :is([data-slot='main.conversation'], [data-slot='conversation']) > * {
 	/* DSH 的对话列宽走 --dsh-chat-content-width（正文列、输入卡、表格溢出都读它），
 	   只在容器上写 max-width 到 748px 就被 DSH 自己的令牌卡住，所以这里一并覆盖。 */
 	--dsh-chat-content-width: var(--qx-content-width);
@@ -374,10 +406,13 @@ body[data-dsh-qingxiao][data-qx-charms='on'] :is([data-pane='sidebar'], [class*=
 		radial-gradient(120% 90% at 50% 128%, rgba(var(--qx-cyan-rgb), 0.18), transparent 62%),
 		radial-gradient(60% 40% at 18% 118%, rgba(var(--qx-gold-rgb), 0.16), transparent 70%);
 }
-body[data-dsh-qingxiao][data-qx-charms='on'] [data-dsh-sidebar-root] {
+/* 0.1.x 侧栏根带 data-dsh-sidebar-root；0.2.0-rc.2 起该属性取消，侧栏根只剩
+   CSS Modules 哈希类（*_root），只能用 [class*='sidebarCol'] [class*='_root']
+   在栏内定位——conversation 的 *_root 不在 sidebarCol 内，不会误伤。 */
+body[data-dsh-qingxiao][data-qx-charms='on'] :is([data-dsh-sidebar-root], [class*='sidebarCol'] [class*='_root']) {
 	position: relative;
 }
-body[data-dsh-qingxiao][data-qx-charms='on'] [data-dsh-sidebar-root]::after {
+body[data-dsh-qingxiao][data-qx-charms='on'] :is([data-dsh-sidebar-root], [class*='sidebarCol'] [class*='_root'])::after {
 	content: "";
 	position: absolute;
 	inset: auto 0 0 0;
@@ -886,7 +921,8 @@ body[data-dsh-qingxiao][data-qx-frost='on'][data-qx-frost-plugin='on'] .qx-frost
 /* 3) 原生面板虚化：左侧会话栏 + 右侧详情栏 + 图二文件面板（better-sidebar）。
       CSS Modules 前缀是构建哈希，只能用 [class*='后缀'] 子串匹配；
       _centerCol（对话正文列）与 _frame 绝不要碰。
-      detailsCol 自身是 static，补 position:relative 让伪元素锚定在本列——
+      detailsCol 是旧版布局的右详情列，0.2.0-rc.2 更名 rightbarCol，两条并列；
+      它们自身是 static，补 position:relative 让伪元素锚定在本列——
       relative 不产生 fixed 包含块，弹窗照样铺得开（v0.1.2 塌缩教训）。
       文件面板并不在 detailsCol 内（t7 纠正 t1 §1 的错误前提）：它是
       div[data-dsh-panel]（position:absolute、z=40，底色 --dsw-alias-bg-layer-1
@@ -906,10 +942,10 @@ body[data-dsh-qingxiao][data-qx-frost='on'][data-qx-frost-plugin='on'] .qx-frost
       与旧「面板磨砂玻璃」共用 ::after：两列那条与旧规则同特异度 (0,4,2)，
       靠本块在 THEME_CSS 里排在后面取胜；面板这条独立成 (0,5,2)。
       同开时由虚化强度接管，不会叠成两层模糊。 */
-body[data-dsh-qingxiao][data-qx-frost='on'][data-qx-frost-native='on'] :is([data-pane='sidebar'], [class*='sidebarCol'], [class*='detailsCol']) {
+body[data-dsh-qingxiao][data-qx-frost='on'][data-qx-frost-native='on'] :is([data-pane='sidebar'], [class*='sidebarCol'], [class*='detailsCol'], [class*='rightbarCol']) {
 	position: relative;
 }
-body[data-dsh-qingxiao][data-qx-frost='on'][data-qx-frost-native='on'] :is([data-pane='sidebar'], [class*='sidebarCol'], [class*='detailsCol'])::after,
+body[data-dsh-qingxiao][data-qx-frost='on'][data-qx-frost-native='on'] :is([data-pane='sidebar'], [class*='sidebarCol'], [class*='detailsCol'], [class*='rightbarCol'])::after,
 body[data-dsh-qingxiao][data-qx-frost='on'][data-qx-frost-native='on'] [data-dsh-panel-host] > [data-dsh-panel]::after,
 body[data-dsh-qingxiao][data-qx-frost='on'][data-qx-frost-native='on'] [data-dsh-panel-host] > [data-dsh-bottom-panel]::after {
 	content: "";
@@ -925,10 +961,10 @@ body[data-dsh-qingxiao][data-qx-frost='on'][data-qx-frost-native='on'] [data-dsh
    增强只挑 p/li/td，而面板与列表文字几乎全是 span/div，等于没管到。
    浅色白晕托深色字，暗色墨晕衬亮字；底色一丝未动，纯字体处理。
    挂在既有的「文字对比度增强」开关下（默认 on），调色盘可关。 */
-body[data-dsh-qingxiao][data-qx-contrast='on']:not([data-ds-dark-theme]) :is(.qx-frost, [class*='sidebarCol'], [class*='detailsCol'], [data-dsh-panel], [data-dsh-bottom-panel]) {
+body[data-dsh-qingxiao][data-qx-contrast='on']:not([data-ds-dark-theme]) :is(.qx-frost, [class*='sidebarCol'], [class*='detailsCol'], [class*='rightbarCol'], [data-dsh-panel], [data-dsh-bottom-panel]) {
 	text-shadow: 0 0 1px rgba(255, 255, 255, 0.95), 0 0 3px rgba(255, 255, 255, 0.7), 0 0 6px rgba(255, 255, 255, 0.4);
 }
-body[data-dsh-qingxiao][data-qx-contrast='on'][data-ds-dark-theme] :is(.qx-frost, [class*='sidebarCol'], [class*='detailsCol'], [data-dsh-panel], [data-dsh-bottom-panel]) {
+body[data-dsh-qingxiao][data-qx-contrast='on'][data-ds-dark-theme] :is(.qx-frost, [class*='sidebarCol'], [class*='detailsCol'], [class*='rightbarCol'], [data-dsh-panel], [data-dsh-bottom-panel]) {
 	text-shadow: 0 0 1px rgba(2, 8, 14, 0.9), 0 0 3px rgba(2, 8, 14, 0.6), 0 0 6px rgba(2, 8, 14, 0.35);
 }
 /* 5) 对话/设置弹窗背板（用户：设置页字看不清）：弹窗结构是 fixed 满视口
@@ -946,6 +982,80 @@ body[data-dsh-qingxiao]:not([data-ds-dark-theme]) [role='dialog'] {
 body[data-dsh-qingxiao][data-ds-dark-theme] [role='dialog'] {
 	background: rgba(var(--qx-panel-rgb), 0.74);
 }
+
+/* ── 0.2.0 桌面端标题栏：毛玻璃横带 + 消除原生按钮色块 ──
+   html[data-windows-titlebar] 下，框架::before 是整条拖拽横带（应用/编辑
+   菜单与窗口控件都浮在上面），中列另被卡片化（16px 圆角）——画卷在顶栏处
+   被切成一条与下方内容分层异色的横带。这里：
+   1) 横带改为面板色玻璃底 + 毛玻璃虚化（虚化受「毛玻璃虚化」总开关控制），
+      与侧栏玻璃同源，顶部与下方内容连贯；
+   2) 中列卡片圆角取消；
+   3) 窗口控制按钮的原生实心底色来自 Electron titleBarOverlay（OS 级绘制，
+      CSS 画不到，且不接受透明度——皮肤原先的半透明 sidebar-fill 被拆成
+      不透明色块，就是按钮后面那块补丁）。preload 会测量一个读
+      var(--dsw-specific-sidebar-fill) 的隐藏探针元素并经 IPC 发给
+      setTitleBarOverlay；皮肤用 !important 把探针背景压成全透明（探针是
+      body 下唯一内联引用该令牌的 span，!important 可压过内联样式），preload
+      读到 rgba(0,0,0,0) 后 overlay 即变透明，三个窗口按钮成为浮在玻璃
+      横带上的纯符号。 */
+html[data-windows-titlebar] body[data-dsh-qingxiao] [class*='_frame']::before {
+	background: rgba(var(--qx-panel-rgb), calc(var(--qx-panel-alpha) * 0.9));
+}
+html[data-windows-titlebar] body[data-dsh-qingxiao][data-qx-frost='on'] [class*='_frame']::before {
+	backdrop-filter: blur(var(--qx-frost-blur)) saturate(1.12);
+	-webkit-backdrop-filter: blur(var(--qx-frost-blur)) saturate(1.12);
+}
+html[data-windows-titlebar] body[data-dsh-qingxiao] [class*='_centerCol'] {
+	border-radius: 0;
+}
+body[data-dsh-qingxiao] > span[style*='--dsw-specific-sidebar-fill'] {
+	background-color: transparent !important;
+}
+
+/* ── 整页视图毛玻璃背板（插件 / 自动化任务等 _page 页面）──
+   0.2.0 的插件页、自动化任务页等整页视图是 [data-slot='main'] 下的
+   SECTION[class*='_page']，直接铺在画卷上，文字没有任何垫底（浅色模式下
+   尤其糊）。两层处理：
+   1) 半透明面板底写在 _page 自身——它是滚动容器，元素背景不随内容滚动，
+      常驻生效，不依赖任何开关；
+   2) 毛玻璃虚化挂在其非滚动父层 [data-slot='main'] 的 ::before 上（页面
+      容器自身滚动，伪元素挂它身上会被卷走）。:has 限定只有 _page 视图才
+      挂，不碰会话区；position+z-index:0 让 main 自成层叠上下文，-1 伪元素
+      落在 main 内容之下、画卷之上；backdrop-filter 只在伪元素上，无后代、
+      不困浮层。虚化受「毛玻璃虚化」总开关控制（默认开），底色不受。
+      背板必须用 > 直接子选择器：裸 [class*='_page'] 会连 pageTitle/pageHead
+      这类类名一起命中，背板叠背板会浮出一块块白芯片。 */
+body[data-dsh-qingxiao] [data-slot='main'] > [class*='_page'] {
+	background: rgba(var(--qx-panel-rgb), calc(var(--qx-panel-alpha) * 0.88));
+}
+body[data-dsh-qingxiao][data-qx-frost='on'] [data-slot='main']:has(> [class*='_page']) {
+	position: relative;
+	z-index: 0;
+}
+body[data-dsh-qingxiao][data-qx-frost='on'] [data-slot='main']:has(> [class*='_page'])::before {
+	content: "";
+	position: absolute;
+	inset: 0;
+	z-index: -1;
+	pointer-events: none;
+	backdrop-filter: blur(var(--qx-frost-blur)) saturate(1.12);
+	-webkit-backdrop-filter: blur(var(--qx-frost-blur)) saturate(1.12);
+}
+
+/* ── 主按钮文字颜色还原 ──
+   全局按钮墨色规则 (0,2,2) 会盖掉按钮类的
+   var(--dsw-alias-label-primary-foreground)（0,2,0），青碧主按钮的字被涂成
+   深墨、发闷。用 (0,3,2) 还回令牌；令牌值已在上面统一为月白。 */
+body[data-dsh-qingxiao] [id=root] button[class*='_primary'] {
+	color: var(--dsw-alias-label-primary-foreground);
+}
+
+/* ── markdown 任务复选框 ──
+   DSH 把对话里任务列表的勾选框 accent 设成了次级灰，勾上后灰扑扑的；
+   对齐到品牌主色（上面已改为清宵青碧），与整页勾选控件一致。 */
+body[data-dsh-qingxiao] [id=root] [class*='_markdown'] input[type='checkbox'] {
+	accent-color: var(--dsw-alias-brand-primary);
+}
 `;
 
 		// ═══════════════════════════════════════════════════════════════
@@ -1606,7 +1716,8 @@ body[data-dsh-qingxiao][data-ds-dark-theme] [role='dialog'] {
 				'<div class="qx-hero-quote">「徒儿，你来了……」</div>';
 			body.append(heroWelcome);
 			function syncHeroWelcome() {
-				var root = document.querySelector("[data-slot='conversation'] > *");
+				// 0.2.0-rc.2 起会话槽位改名为 main.conversation（0.1.x 为 conversation）。
+				var root = document.querySelector(":is([data-slot='main.conversation'], [data-slot='conversation']) > *");
 				var on = !!(root && root.getAttribute("data-phase") === "hero");
 				heroWelcome.dataset.on = on ? "true" : "false";
 			}
@@ -1684,7 +1795,9 @@ body[data-dsh-qingxiao][data-ds-dark-theme] [role='dialog'] {
 				// 侧栏/对话区就摘标（慢挂载的 frame 也能兜住）。
 				var unfrostIfApp = function() {
 					if (disposed) return;	// t4/t5 nit：HMR 重挂后旧实例的迟到复查不得摘新实例刚打的标（摘标是 class 变化，childList-only 观察器看不见）
-					if (el.isConnected && el.querySelector("[data-dsh-sidebar-root], [data-conversation-scroll]")) {
+					// 0.2.0-rc.2 起侧栏根不再带 data-dsh-sidebar-root：改认布局列
+					// [class*='sidebarCol']（应用主框必含布局列，插件窗不含）。
+					if (el.isConnected && el.querySelector("[data-conversation-scroll], [class*='sidebarCol']")) {
 						el.classList.remove(QX_FROST_CLASS, QX_FROST_SOLID);
 					}
 				};

package/lib/index.js

@@ -1,178 +1,190 @@
-import { existsSync, mkdirSync, readFileSync, renameSync, rmSync, writeFileSync } from "node:fs";
-import { homedir } from "node:os";
-import { join } from "node:path";
-import { fileURLToPath } from "node:url";
-
-const name = "@taosee258/dsh-client-ui-skin-qingxiao";
-const inject = ["webServer"];
-const SETTINGS_ROUTE = "/api/dsh-qingxiao/settings";
-const DEFAULT_BG_ROUTE = "/api/dsh-qingxiao/default-background";
-const SETTINGS_DIR = "dsh-client-ui-skin-qingxiao";
-const SETTINGS_FILE = "settings.json";
-const DEFAULT_BG_FILE = fileURLToPath(new URL("../assets/qx.jpg", import.meta.url));
-const MAX_BODY_BYTES = 15 * 1024 * 1024;
-const MAX_BACKGROUND_BYTES = 7 * 1024 * 1024;
-
-const BOOLEAN_KEYS = [
-	"textContrastBoost", "panelBlur", "goldTrim",
-	"particles", "lightCharms", "darkCharms",
-	// v0.1.4 毛玻璃虚化：总开关 + 插件窗/原生面板两个分项
-	"frostMaster", "frostPlugin", "frostNative"
-];
-const NUMBER_RANGES = {
-	scrimOpacity: [20, 95],
-	panelOpacity: [30, 100],
-	contentWidth: [500, 1000],
-	particleCount: [0, 60],
-	particleSpeed: [20, 200],
-	fontScale: [85, 125],
-	// 虚化强度 0–30px（0 = 关闭等效，前端把 0 视作总开关 off）
-	frostBlur: [0, 30]
-};
-
-function profileName() {
-	const profile = process.env.DSH_DESKTOP_PROFILE;
-	return profile && /^[A-Za-z0-9_-]+$/.test(profile) ? profile : "web";
-}
-
-function profileDir() {
-	return join(process.env.DSH_HOME || join(homedir(), ".dsh"), "profiles", profileName());
-}
-
-function settingsPath() {
-	return join(profileDir(), "data", SETTINGS_DIR, SETTINGS_FILE);
-}
-
-function isLoopback(req) {
-	const address = req.socket && req.socket.remoteAddress;
-	return address === "127.0.0.1" || address === "::1" || address === "::ffff:127.0.0.1";
-}
-
-function sendJson(res, status, value) {
-	const data = Buffer.from(JSON.stringify(value), "utf8");
-	res.writeHead(status, {
-		"content-type": "application/json; charset=utf-8",
-		"cache-control": "no-store",
-		"content-length": String(data.length)
-	});
-	res.end(data);
-}
-
-function isBackground(value) {
-	if (value === null) return true;
-	return typeof value === "string" && /^data:image\/(?:png|jpe?g|webp|gif);base64,/i.test(value) && Buffer.byteLength(value, "utf8") <= MAX_BACKGROUND_BYTES;
-}
-
-function sanitizeSettings(value) {
-	if (!value || typeof value !== "object" || Array.isArray(value)) return null;
-	const clean = {};
-	for (const key of BOOLEAN_KEYS) {
-		if (typeof value[key] === "boolean") clean[key] = value[key];
-	}
-	for (const [key, range] of Object.entries(NUMBER_RANGES)) {
-		if (typeof value[key] !== "number" || !Number.isFinite(value[key]) || value[key] < range[0] || value[key] > range[1]) continue;
-		clean[key] = value[key];
-	}
-	for (const key of ["lightBackground", "darkBackground"]) {
-		if (isBackground(value[key])) clean[key] = value[key];
-	}
-	return clean;
-}
-
-function readSettings() {
-	const path = settingsPath();
-	if (!existsSync(path)) return {};
-	try {
-		return sanitizeSettings(JSON.parse(readFileSync(path, "utf8"))) || {};
-	} catch {
-		return {};
-	}
-}
-
-function writeSettings(settings) {
-	const clean = sanitizeSettings(settings);
-	if (clean === null) throw new Error("invalid settings");
-	const path = settingsPath();
-	const dir = join(profileDir(), "data", SETTINGS_DIR);
-	mkdirSync(dir, { recursive: true });
-	const temporary = path + ".tmp";
-	writeFileSync(temporary, JSON.stringify(clean), "utf8");
-	try { renameSync(temporary, path); } catch {
-		rmSync(path, { force: true });
-		renameSync(temporary, path);
-	}
-	return clean;
-}
-
-function readBody(req) {
-	return new Promise((resolve, reject) => {
-		let size = 0;
-		const chunks = [];
-		req.on("data", (chunk) => {
-			size += chunk.length;
-			if (size > MAX_BODY_BYTES) {
-				req.destroy();
-				reject(new Error("payload too large"));
-				return;
-			}
-			chunks.push(chunk);
-		});
-		req.on("end", () => resolve(Buffer.concat(chunks).toString("utf8")));
-		req.on("error", reject);
-	});
-}
-
-async function handleSettingsRoute(req, res) {
-	if (!isLoopback(req)) {
-		res.writeHead(403);
-		res.end("forbidden");
-		return;
-	}
-	if (req.method === "GET") {
-		sendJson(res, 200, { ok: true, settings: readSettings() });
-		return;
-	}
-	if (req.method !== "PUT") {
-		res.writeHead(405, { allow: "GET, PUT" });
-		res.end();
-		return;
-	}
-	try {
-		const parsed = JSON.parse(await readBody(req));
-		const settings = writeSettings(parsed && parsed.settings);
-		sendJson(res, 200, { ok: true, settings });
-	} catch (error) {
-		sendJson(res, 400, { ok: false, message: String((error && error.message) || error) });
-	}
-}
-
-let defaultBgCache = null;
-function handleDefaultBackgroundRoute(req, res) {
-	if (req.method !== "GET" && req.method !== "HEAD") {
-		res.writeHead(405, { allow: "GET, HEAD" });
-		res.end();
-		return;
-	}
-	try {
-		if (defaultBgCache === null || !defaultBgCache.length) {
-			defaultBgCache = readFileSync(DEFAULT_BG_FILE);
-		}
-	} catch {
-		res.writeHead(404);
-		res.end("default background missing");
-		return;
-	}
-	res.writeHead(200, {
-		"content-type": "image/jpeg",
-		"cache-control": "no-store",
-		"content-length": String(defaultBgCache.length)
-	});
-	res.end(req.method === "HEAD" ? undefined : defaultBgCache);
-}
-
-function apply(ctx) {
-	ctx.webServer.register({ kind: "exact", path: SETTINGS_ROUTE, handler: handleSettingsRoute });
-	return ctx.webServer.register({ kind: "exact", path: DEFAULT_BG_ROUTE, handler: handleDefaultBackgroundRoute });
-}
-
-export { apply, inject, name };
+import { existsSync, mkdirSync, readFileSync, renameSync, rmSync, writeFileSync } from "node:fs";
+import { homedir } from "node:os";
+import { isAbsolute, join } from "node:path";
+import { fileURLToPath } from "node:url";
+
+const name = "@taosee258/dsh-client-ui-skin-qingxiao";
+const inject = ["webServer"];
+const SETTINGS_ROUTE = "/api/dsh-qingxiao/settings";
+const DEFAULT_BG_ROUTE = "/api/dsh-qingxiao/default-background";
+const SETTINGS_DIR = "dsh-client-ui-skin-qingxiao";
+const SETTINGS_FILE = "settings.json";
+const DEFAULT_BG_FILE = fileURLToPath(new URL("../assets/qx.jpg", import.meta.url));
+const MAX_BODY_BYTES = 15 * 1024 * 1024;
+const MAX_BACKGROUND_BYTES = 7 * 1024 * 1024;
+
+const BOOLEAN_KEYS = [
+	"textContrastBoost", "panelBlur", "goldTrim",
+	"particles", "lightCharms", "darkCharms",
+	// v0.1.4 毛玻璃虚化：总开关 + 插件窗/原生面板两个分项
+	"frostMaster", "frostPlugin", "frostNative"
+];
+const NUMBER_RANGES = {
+	scrimOpacity: [20, 95],
+	panelOpacity: [30, 100],
+	contentWidth: [500, 1000],
+	particleCount: [0, 60],
+	particleSpeed: [20, 200],
+	fontScale: [85, 125],
+	// 虚化强度 0–30px（0 = 关闭等效，前端把 0 视作总开关 off）
+	frostBlur: [0, 30]
+};
+
+function profileName() {
+	// 0.1.x 桌面端主进程注入 DSH_DESKTOP_PROFILE；0.2.0 起改用 dsh 统一的
+	// DSH_PROFILE / DSH_PROFILE_DIR（SKILL.md 所载），主进程自身不再注入名字，
+	// 而是把档案固定为 profiles/desktop（app.asar 里 resolveDesktopPaths 的
+	// join(dshHome, "profiles", "desktop")）。按新→旧顺序解析。
+	const profile = process.env.DSH_PROFILE || process.env.DSH_DESKTOP_PROFILE;
+	return profile && /^[A-Za-z0-9_-]+$/.test(profile) ? profile : null;
+}
+
+function profileDir() {
+	const home = process.env.DSH_HOME || join(homedir(), ".dsh");
+	const direct = process.env.DSH_PROFILE_DIR;
+	if (direct && isAbsolute(direct)) return direct;
+	const name = profileName();
+	if (name) return join(home, "profiles", name);
+	// 0.2.0 桌面端不给插件进程留 profile 环境变量：desktop 目录存在即视为桌面端。
+	const desktop = join(home, "profiles", "desktop");
+	if (existsSync(desktop)) return desktop;
+	return join(home, "profiles", "web");
+}
+
+function settingsPath() {
+	return join(profileDir(), "data", SETTINGS_DIR, SETTINGS_FILE);
+}
+
+function isLoopback(req) {
+	const address = req.socket && req.socket.remoteAddress;
+	return address === "127.0.0.1" || address === "::1" || address === "::ffff:127.0.0.1";
+}
+
+function sendJson(res, status, value) {
+	const data = Buffer.from(JSON.stringify(value), "utf8");
+	res.writeHead(status, {
+		"content-type": "application/json; charset=utf-8",
+		"cache-control": "no-store",
+		"content-length": String(data.length)
+	});
+	res.end(data);
+}
+
+function isBackground(value) {
+	if (value === null) return true;
+	return typeof value === "string" && /^data:image\/(?:png|jpe?g|webp|gif);base64,/i.test(value) && Buffer.byteLength(value, "utf8") <= MAX_BACKGROUND_BYTES;
+}
+
+function sanitizeSettings(value) {
+	if (!value || typeof value !== "object" || Array.isArray(value)) return null;
+	const clean = {};
+	for (const key of BOOLEAN_KEYS) {
+		if (typeof value[key] === "boolean") clean[key] = value[key];
+	}
+	for (const [key, range] of Object.entries(NUMBER_RANGES)) {
+		if (typeof value[key] !== "number" || !Number.isFinite(value[key]) || value[key] < range[0] || value[key] > range[1]) continue;
+		clean[key] = value[key];
+	}
+	for (const key of ["lightBackground", "darkBackground"]) {
+		if (isBackground(value[key])) clean[key] = value[key];
+	}
+	return clean;
+}
+
+function readSettings() {
+	const path = settingsPath();
+	if (!existsSync(path)) return {};
+	try {
+		return sanitizeSettings(JSON.parse(readFileSync(path, "utf8"))) || {};
+	} catch {
+		return {};
+	}
+}
+
+function writeSettings(settings) {
+	const clean = sanitizeSettings(settings);
+	if (clean === null) throw new Error("invalid settings");
+	const path = settingsPath();
+	const dir = join(profileDir(), "data", SETTINGS_DIR);
+	mkdirSync(dir, { recursive: true });
+	const temporary = path + ".tmp";
+	writeFileSync(temporary, JSON.stringify(clean), "utf8");
+	try { renameSync(temporary, path); } catch {
+		rmSync(path, { force: true });
+		renameSync(temporary, path);
+	}
+	return clean;
+}
+
+function readBody(req) {
+	return new Promise((resolve, reject) => {
+		let size = 0;
+		const chunks = [];
+		req.on("data", (chunk) => {
+			size += chunk.length;
+			if (size > MAX_BODY_BYTES) {
+				req.destroy();
+				reject(new Error("payload too large"));
+				return;
+			}
+			chunks.push(chunk);
+		});
+		req.on("end", () => resolve(Buffer.concat(chunks).toString("utf8")));
+		req.on("error", reject);
+	});
+}
+
+async function handleSettingsRoute(req, res) {
+	if (!isLoopback(req)) {
+		res.writeHead(403);
+		res.end("forbidden");
+		return;
+	}
+	if (req.method === "GET") {
+		sendJson(res, 200, { ok: true, settings: readSettings() });
+		return;
+	}
+	if (req.method !== "PUT") {
+		res.writeHead(405, { allow: "GET, PUT" });
+		res.end();
+		return;
+	}
+	try {
+		const parsed = JSON.parse(await readBody(req));
+		const settings = writeSettings(parsed && parsed.settings);
+		sendJson(res, 200, { ok: true, settings });
+	} catch (error) {
+		sendJson(res, 400, { ok: false, message: String((error && error.message) || error) });
+	}
+}
+
+let defaultBgCache = null;
+function handleDefaultBackgroundRoute(req, res) {
+	if (req.method !== "GET" && req.method !== "HEAD") {
+		res.writeHead(405, { allow: "GET, HEAD" });
+		res.end();
+		return;
+	}
+	try {
+		if (defaultBgCache === null || !defaultBgCache.length) {
+			defaultBgCache = readFileSync(DEFAULT_BG_FILE);
+		}
+	} catch {
+		res.writeHead(404);
+		res.end("default background missing");
+		return;
+	}
+	res.writeHead(200, {
+		"content-type": "image/jpeg",
+		"cache-control": "no-store",
+		"content-length": String(defaultBgCache.length)
+	});
+	res.end(req.method === "HEAD" ? undefined : defaultBgCache);
+}
+
+function apply(ctx) {
+	ctx.webServer.register({ kind: "exact", path: SETTINGS_ROUTE, handler: handleSettingsRoute });
+	return ctx.webServer.register({ kind: "exact", path: DEFAULT_BG_ROUTE, handler: handleDefaultBackgroundRoute });
+}
+
+export { apply, inject, name };

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@taosee258/dsh-client-ui-skin-qingxiao",
   "description": "Qingxiao (Wuthering Waves) themed skin with ice-blue/jade/moon-white palette, sword-light motes and user-swappable background for the dsh web GUI",
-  "version": "0.1.4",
+  "version": "0.2.3",
   "type": "module",
   "main": "lib/index.js",
   "exports": {
@@ -20,7 +20,8 @@
         "@deepseek-ai/dsh-client-ui-slots"
       ],
       "platform": "web",
-      "version": "0.1.0-rc.6 - 0.1.2-alpha.1"
+      "immediately": true,
+      "version": "0.1.0-rc.6 - 0.2.0-rc.2"
     }
   },
   "license": "CC-BY-NC-SA-4.0",
@@ -33,9 +34,9 @@
   },
   "peerDependencies": {
     "@deepseek-ai/cordis": "^4.0.1",
-    "@deepseek-ai/dsh-client-runtime": ">=0.1.0-rc.6 <0.1.1-0 || >=0.1.1-rc.1 <0.2.0-0",
-    "@deepseek-ai/dsh-client-ui-slots": ">=0.1.0-rc.6 <0.1.1-0 || >=0.1.1-rc.1 <0.2.0-0",
-    "@deepseek-ai/dsh-host-webserver": ">=0.1.0-rc.6 <0.1.1-0 || >=0.1.1-rc.1 <0.2.0-0",
+    "@deepseek-ai/dsh-client-runtime": ">=0.1.0-rc.6 <0.1.1-0 || >=0.1.1-rc.1 <0.2.0-0 || >=0.2.0-rc.0 <0.2.1-0",
+    "@deepseek-ai/dsh-client-ui-slots": ">=0.1.0-rc.6 <0.1.1-0 || >=0.1.1-rc.1 <0.2.0-0 || >=0.2.0-rc.0 <0.2.1-0",
+    "@deepseek-ai/dsh-host-webserver": ">=0.1.0-rc.6 <0.1.1-0 || >=0.1.1-rc.1 <0.2.0-0 || >=0.2.0-rc.0 <0.2.1-0",
     "react": "^18.2.0"
   },
   "files": [

package/skin.json

@@ -1,30 +1,30 @@
-{
-  "id": "qingxiao",
-  "name": "清宵 · 弦凝清霄",
-  "nameEn": "Qingxiao · Strings of the Clear Sky",
-  "author": "taoser",
-  "tagline": "冰蓝青碧配色 · 月白玻璃面板 · 剑气流光装饰 · 弦剑剑仙氛围",
-  "description": "《鸣潮》清宵主题皮肤：以冰蓝、青碧、月白、玄夜蓝构成清冷剑仙调色板，以鎏金与剑气流光作为装饰母题。qx 默认背景可随时在设置面板中更换，遮罩浓度与文字对比增强保证任何背景下文字清晰可读。亮色模式映射月白庭院的清昼氛围，暗色模式映射玄夜剑鸣的深夜氛围。",
-  "tags": [
-    "anime",
-    "wuthering-waves",
-    "qingxiao",
-    "aero",
-    "cyan",
-    "ice-blue",
-    "gold",
-    "sword-immortal"
-  ],
-  "accent": "#56C8C0",
-  "bodyAttr": "data-dsh-qingxiao",
-  "package": "@taosee258/dsh-client-ui-skin-qingxiao",
-  "wiring": {
-    "id": "ui-skin-qingxiao",
-    "bundleWired": false
-  },
-  "preview": {
-    "light": "preview/screen-light.png",
-    "dark": "preview/screen-dark.png"
-  },
-  "order": 9
-}
+{
+  "id": "qingxiao",
+  "name": "清宵 · 弦凝清霄",
+  "nameEn": "Qingxiao · Strings of the Clear Sky",
+  "author": "taoser",
+  "tagline": "冰蓝青碧配色 · 月白玻璃面板 · 剑气流光装饰 · 弦剑剑仙氛围",
+  "description": "《鸣潮》清宵主题皮肤：以冰蓝、青碧、月白、玄夜蓝构成清冷剑仙调色板，以鎏金与剑气流光作为装饰母题。qx 默认背景可随时在设置面板中更换，遮罩浓度与文字对比增强保证任何背景下文字清晰可读。亮色模式映射月白庭院的清昼氛围，暗色模式映射玄夜剑鸣的深夜氛围。",
+  "tags": [
+    "anime",
+    "wuthering-waves",
+    "qingxiao",
+    "aero",
+    "cyan",
+    "ice-blue",
+    "gold",
+    "sword-immortal"
+  ],
+  "accent": "#56C8C0",
+  "bodyAttr": "data-dsh-qingxiao",
+  "package": "@taosee258/dsh-client-ui-skin-qingxiao",
+  "wiring": {
+    "id": "ui-skin-qingxiao",
+    "bundleWired": false
+  },
+  "preview": {
+    "light": "preview/screen-light.png",
+    "dark": "preview/screen-dark.png"
+  },
+  "order": 9
+}