@iasiv5/dsh-skins 1.5.2 → 1.5.3

package/README.en.md

@@ -107,6 +107,8 @@ Every skin's key visuals are open to adjustment. Click the gear button on a skin
 | **Slogan** | The new-session guidance line, one Chinese and one English copy | The skin's factory slogan |
 | **Translucency** | 0–100%, one value driving three visual layers: panel tint, wallpaper scrim and blur. 0% is pure, fully visible wallpaper; 100% hides it completely | meirenzhi 35, openbmc / uefi-harness 55 |
 
+> **On the Windows Desktop app (dsh Desktop)**: the shell chrome — sidebar, caption strip, right panel and window buttons — is the **opaque skin base color** and does not follow the translucency knob; the wallpaper is exposed inside the conversation area (center column), where the knob drives surface tint, scrim and blur. The Web keeps the original fully translucent form on every surface; the two environments are independent.
+
 ![Personalization panel — meirenzhi shown: built-in wallpaper grid, library upload, zh/en slogans and the translucency knob](docs/assets/preview-personalization.webp)
 
 ### Upload your own wallpaper (personal library)
@@ -173,6 +175,7 @@ Yes. Configuration and the library live in the `$DSH_HOME/dsh-skins/` data direc
 - Other skin plugins may also touch the body backdrop, brand slots or favicon; avoid enabling multiple visual skin plugins at the same time.
 - The `openbmc` brand slots reuse the OpenBMC project's official logo letterforms and brand gradient, used solely for identification; all rights remain with the OpenBMC project.
 - The `uefi-harness` mark is the UEFI Forum's official trademark (the red cube, from uefi.org's published uefi_logo_red.gif, embedded as vector paths traced via Wikimedia Commons "Logo of the UEFI Forum.svg"); it is used solely to identify the skin, and all rights remain with the UEFI Forum.
+- Windows Desktop known limits: after the right panel is closed/collapsed, the host keeps a reserved empty track (it shows the shell's dark base color and the conversation area does not expand) — host layout behavior, outside skin control; the fullscreen right panel is the solid skin base color without wallpaper blur (blurring would smear the panel's own contents, so it is intentionally omitted).
 
 ## License
 

package/README.i18n.yaml

@@ -2,5 +2,5 @@
 # last confirmed-consistent state. Both languages carry equal authority;
 # after editing either side, bring the other along and re-record with:
 #   node scripts/verify-readme-pairing.mjs --write
-README.md: 53545bb65db679464c7170acb90709ce4dc31ca1
-README.en.md: 34a16de87f2c8d0ce2d0ac8ef9716a6b810c624a
+README.md: f2874ac75adc7a7d2fbd8fc7970d7452ce2b0b15
+README.en.md: c00ca57444786f77a611dd385f15dfcced37eb99

package/README.md

@@ -107,6 +107,8 @@ dsh plugin --profile web remove @iasiv5/dsh-skins    # 卸载
 | **标语** | 新会话页的引导语，中文、英文各一份 | 皮肤出厂标语 |
 | **通透度** | 0–100% 单值联动三个视觉层：面板底色、壁纸遮罩、模糊。0% 纯壁纸完全透出，100% 完全遮蔽 | meirenzhi 35，openbmc / uefi-harness 55 |
 
+> **Windows Desktop（dsh Desktop 应用）上的形态**：桌面端外壳——侧栏、顶栏条、右栏面板与窗口按钮——为**不透明的皮肤本色**，不随通透度变化；壁纸在会话区（内容列）显露，通透度联动会话区内的表面底色、遮罩与模糊。Web 端维持全表面透纱的原有形态，两端互不影响。
+
 ![个性化面板 — 以美人志为例：内置壁纸网格、图库上传、中英标语与通透度旋钮](docs/assets/preview-personalization.webp)
 
 ### 上传自己的壁纸（个人图库）
@@ -173,6 +175,7 @@ URL 也能切皮肤：`/?skin=official`、`/?skin=openbmc`、`/?skin=uefi-harnes
 - 其他皮肤插件也可能修改 body 背景、品牌位或 favicon；应避免同时启用多个视觉皮肤插件。
 - `openbmc` 的品牌位沿用 OpenBMC 项目官方 logo 的字标字形与品牌渐变色，仅作标识用途，权利归 OpenBMC 项目所有。
 - `uefi-harness` 的标志为 UEFI Forum 官方商标（红色立方体，源自 uefi.org 发布的 uefi_logo_red.gif，经 Wikimedia Commons「Logo of the UEFI Forum.svg」矢量描摹嵌入），仅作标识用途，权利归 UEFI Forum 所有。
+- Windows Desktop 已知边界：右栏面板「收起/关闭」后，宿主保留一条空轨道（显示外壳深色底，会话区不扩展）——宿主布局行为，非皮肤可控；全屏面板为实色皮肤底、不带壁纸模糊（会模糊面板内全部内容，故不做）。
 
 ## License
 

package/lib/client.js

@@ -403,6 +403,47 @@
   function datasetAttribute(key) {
     return `data-${key.replace(/[A-Z]/g, (letter) => `-${letter.toLowerCase()}`)}`;
   }
+  function parseRgbaChannels(value) {
+    const match = /^rgba?\(\s*(\d+),\s*(\d+),\s*(\d+),\s*([\d.]+)\s*\)$/i.exec(value ?? "");
+    if (match === null) return null;
+    const channels = [match[1], match[2], match[3], match[4]].map(Number);
+    if (channels.some((channel) => !Number.isFinite(channel))) return null;
+    const [r, g, b, a] = channels;
+    return { r, g, b, a: Math.min(1, Math.max(0, a)) };
+  }
+  function buildShellAlignmentCss(bodyAttribute, opaqueFills, backdrop) {
+    const body = `body[${datasetAttribute(bodyAttribute)}]`;
+    const scoped = `html[data-windows-titlebar] ${body}`;
+    const lines = [
+      "/* dsh-skins shell-frame alignment (ADR-0009): solid chrome + wallpaper in the conversation area on Windows desktop */",
+      'html[data-windows-titlebar] [class*="_frame"]:has(> [class*="_sidebarCol"])::before{background:0 0}',
+      'html[data-windows-titlebar] [class*="_frame"] > [class*="_sidebarCol"]{background:0 0}',
+      'html[data-windows-titlebar] [class*="_sidebarCol"] > [class*="_root"]{background:0 0}'
+    ];
+    if (opaqueFills !== null) {
+      lines.push(
+        `${scoped}{--dsw-specific-sidebar-fill:${opaqueFills.light}!important}`,
+        `${scoped}[data-ds-dark-theme]{--dsw-specific-sidebar-fill:${opaqueFills.dark}!important}`
+      );
+    }
+    if (backdrop !== null && backdrop !== void 0 && backdrop.imageLight !== null && backdrop.imageDark !== null) {
+      lines.push(
+        `${scoped} [class*="_centerCol"]{background-image:${backdrop.imageLight};background-size:cover;background-position:center;background-repeat:no-repeat}`,
+        `${scoped}[data-ds-dark-theme] [class*="_centerCol"]{background-image:${backdrop.imageDark}}`
+      );
+    }
+    if (opaqueFills !== null) {
+      lines.push(
+        `${scoped} [data-rightbar-col] > *{background-color:${opaqueFills.light}!important}`,
+        `${scoped}[data-ds-dark-theme] [data-rightbar-col] > *{background-color:${opaqueFills.dark}!important}`
+      );
+      lines.push(
+        `${scoped} [class*="_pane_"]{background:${opaqueFills.light}!important}`,
+        `${scoped}[data-ds-dark-theme] [class*="_pane_"]{background:${opaqueFills.dark}!important}`
+      );
+    }
+    return lines.join("\n");
+  }
   function createSkinRuntime() {
     const skins = /* @__PURE__ */ new Map();
     const order = [];
@@ -594,6 +635,24 @@ ${darkSelector}{${dark.join(";")}}`;
           const tag = styleTag(`dsh-skins/${skin.id}.css`, effects.staticCss);
           stops.push(() => tag.remove());
         }
+        {
+          const fills = effects.tokenOverrides?.["--dsw-specific-sidebar-fill"] ?? null;
+          const lightFill = fills === null ? null : parseRgbaChannels(fills.light);
+          const darkFill = fills === null ? null : parseRgbaChannels(fills.dark);
+          const opaqueFills = lightFill !== null && darkFill !== null ? {
+            light: `rgb(${lightFill.r}, ${lightFill.g}, ${lightFill.b})`,
+            dark: `rgb(${darkFill.r}, ${darkFill.g}, ${darkFill.b})`
+          } : null;
+          const backdrop2 = effects.backdrop === null ? null : {
+            imageLight: effects.backdrop.imageLight,
+            imageDark: effects.backdrop.imageDark
+          };
+          const tag = styleTag(
+            `dsh-skins/${skin.id}.shell.css`,
+            buildShellAlignmentCss(effects.bodyAttribute, opaqueFills, backdrop2)
+          );
+          stops.push(() => tag.remove());
+        }
         const backdrop = backdropCss(effects);
         if (backdrop !== null) {
           const tag = styleTag(`dsh-skins/${skin.id}.backdrop.css`, backdrop);

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@iasiv5/dsh-skins",
   "description": "DSH Web 皮肤插件：多套品牌皮肤侧栏热切换。",
-  "version": "1.5.2",
+  "version": "1.5.3",
   "homepage": "https://github.com/iasiv5/dsh-skins#readme",
   "repository": {
     "type": "git",