@iasiv5/dsh-skins 1.5.3 → 1.5.5

package/README.en.md

@@ -1,4 +1,4 @@
-# dsh-skins — Skin pack for DSH Web
+# dsh-skins — Skin pack for DSH
 
 [![Release](https://img.shields.io/github/v/release/iasiv5/dsh-skins?label=Release&sort=semver)](../../releases)
 [![CI](https://img.shields.io/github/actions/workflow/status/iasiv5/dsh-skins/ci.yml?branch=main&label=CI)](../../actions/workflows/ci.yml)
@@ -8,7 +8,7 @@
 
 English · [中文](./README.md)
 
-Hot-swappable brand skins for DeepSeek Harness Web — with a one-click path back to the official interface.
+Hot-swappable brand skins for DeepSeek Harness — installable on both the Web and Desktop profiles, with a one-click path back to the official interface.
 
 ![凡人修仙传 · 美人志 — factory wallpaper "Yuntai Gathering"](docs/assets/preview-meirenzhi-1.webp)
 
@@ -38,6 +38,8 @@ dsh plugin --profile web update @iasiv5/dsh-skins    # update
 dsh plugin --profile web remove @iasiv5/dsh-skins    # uninstall
 ```
 
+**DSH Desktop app**: install from the app's built-in plugin page, or run `dsh plugin --profile desktop add @iasiv5/dsh-skins`, then restart the app.
+
 With the [dsh-m](https://github.com/iasiv5/dsh-m) plugin marketplace installed, you can also install / uninstall this plugin with one click inside the DSH Web UI.
 
 <details>
@@ -55,7 +57,7 @@ If the install fails, send me the command output verbatim and retry at most once
 
 </details>
 
-## Four appearances
+## Three skins and the official look
 
 This section answers: which skins exist and what each feels like.
 
@@ -105,9 +107,9 @@ Every skin's key visuals are open to adjustment. Click the gear button on a skin
 |---|---|---|
 | **Wallpaper** | Pick from the skin's built-in artwork, or upload your own images into a personal library | Each skin's default artwork |
 | **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 |
+| **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: Web 35%, Desktop 55%; openbmc / uefi-harness: 55% in both |
 
-> **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.
+> **Desktop profile**: the shell is the solid skin base color and the wallpaper shows only inside the conversation area — see "The Desktop profile" below.
 
 ![Personalization panel — meirenzhi shown: built-in wallpaper grid, library upload, zh/en slogans and the translucency knob](docs/assets/preview-personalization.webp)
 
@@ -122,16 +124,25 @@ Every skin's key visuals are open to adjustment. Click the gear button on a skin
 
 - Any change in the panel applies immediately and is written automatically after a brief (~0.5s) debounce.
 - Two tabs sync within about a second; while offline, write controls disable themselves so edits are never lost silently.
-- Reset-to-default is the one guarded action: it lists the settings it will reset, and after you confirm it returns to factory values and persists automatically.
+- Reset-to-default lists the settings it will reset; after confirmation it returns to factory values and persists automatically. On Desktop, destructive actions use an in-page confirmation to avoid the Electron input-focus issue after native JavaScript dialogs; Web keeps the browser's native confirm.
 - While the panel is open, clicking another skin's card moves the panel straight to that skin's settings.
 
 ### Where settings live, and whether they survive
 
-- Configuration and the library live under `$DSH_HOME/dsh-skins/`, physically isolated from the plugin install directory: plugin upgrades (via the dsh-m marketplace or `dsh plugin`) only replace the plugin install directory and cannot touch it.
+- Web stores configuration and the library under `$DSH_HOME/dsh-skins/`; since v1.5.4 Desktop stores them under `$DSH_HOME/dsh-skins-desktop/`. On first launch Desktop copies existing settings and images from the legacy directory once, **without removing or rewriting the old directory**; the two stores then evolve independently. Both are separate from the plugin installation directory, which upgrades replace.
 - Only overrides are stored: untouched fields automatically follow the new version's defaults, and leftovers of retired skins or fields are cleaned up at load (the v1.4.0 tgcf removal rides this path).
 - A damaged state file triggers recovery mode: indexes are rebuilt and bad files quarantined — your images are never wiped.
 - Uploads pass magic-number validation and size caps; concurrent writes merge per field and never clobber each other.
 
+## The Desktop profile
+
+In the **DSH Desktop app**, 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 profile keeps the original fully translucent form on every surface; the two environments are independent.
+
+![Desktop profile — solid chrome + wallpaper in the conversation area (meirenzhi · dark)](docs/assets/preview-desktop-1.webp)
+
+- Verified with dsh Desktop `0.2.0-rc.2` (Windows); macOS / Linux Desktop currently follow the Web form and will be adapted in a later release.
+- The right panel in fullscreen is the solid skin base color; the wallpaper is not shown through it.
+
 ## The skin switcher
 
 This section answers: what lives in the switcher and how to use it.
@@ -164,6 +175,9 @@ Update duty has moved to the dsh-m marketplace and the DSH CLI (ADR-0008); the s
 **Which DSH Web versions are supported?**
 Verified with DSH Web `0.2.0-rc.2`. Later rc builds of the same series are expected to work, but unverified versions carry no promise.
 
+**Is the Desktop profile supported?**
+Yes. The DSH Desktop app and the Web profile are installed independently and do not affect each other; the desktop form (solid chrome + wallpaper in the conversation area) is described under "The Desktop profile". Verified with dsh Desktop `0.2.0-rc.2` (Windows).
+
 **Does my appearance preference sync across browsers?**
 In the browser on the DSH host machine (loopback), the preference is persisted by the DSH Host and shared naturally. Other remote browsers keep the preference in their own `localStorage` — independent per browser, never overwritten.
 
@@ -175,7 +189,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).
+- Windows Desktop known limits: the fullscreen right panel is the solid skin base color; the wallpaper is not shown through it.
 
 ## 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: f2874ac75adc7a7d2fbd8fc7970d7452ce2b0b15
-README.en.md: c00ca57444786f77a611dd385f15dfcced37eb99
+README.md: 00a34bf2d930204da3aff8299779b931719ee5cd
+README.en.md: d741fa3991323516fe07e4b81c4f6862c6800456

package/README.md

@@ -1,4 +1,4 @@
-# dsh-skins — DSH Web 多皮肤插件
+# dsh-skins — DSH 多皮肤插件
 
 [![Release](https://img.shields.io/github/v/release/iasiv5/dsh-skins?label=Release&sort=semver)](../../releases)
 [![CI](https://img.shields.io/github/actions/workflow/status/iasiv5/dsh-skins/ci.yml?branch=main&label=CI)](../../actions/workflows/ci.yml)
@@ -8,7 +8,7 @@
 
 [English](./README.en.md) · 中文
 
-为 DeepSeek Harness Web 换上可热切换的品牌皮肤，随时一键回到官方界面。
+为 DeepSeek Harness 换上可热切换的品牌皮肤——Web 与 Desktop 两种 profile 均可安装使用，随时一键回到官方界面。
 
 ![凡人修仙传 · 美人志 — 内置默认壁纸「云台雅集」](docs/assets/preview-meirenzhi-1.webp)
 
@@ -38,6 +38,8 @@ dsh plugin --profile web update @iasiv5/dsh-skins    # 更新
 dsh plugin --profile web remove @iasiv5/dsh-skins    # 卸载
 ```
 
+**DSH Desktop 应用**：在应用自带的插件页安装，或执行 `dsh plugin --profile desktop add @iasiv5/dsh-skins`，重启应用后生效。
+
 安装了 [dsh-m](https://github.com/iasiv5/dsh-m) 插件市场的话，也可以直接在 DSH Web 界面里一键安装 / 卸载本插件。
 
 <details>
@@ -55,7 +57,7 @@ dsh plugin --profile web remove @iasiv5/dsh-skins    # 卸载
 
 </details>
 
-## 四款外观
+## 三款皮肤与官方界面
 
 本节回答：有哪些皮肤、各是什么气质。
 
@@ -105,9 +107,9 @@ dsh plugin --profile web remove @iasiv5/dsh-skins    # 卸载
 |---|---|---|
 | **壁纸** | 从皮肤自带的「内置精选」里挑，或上传自己的图片进「个人图库」 | 各皮肤的默认画作 |
 | **标语** | 新会话页的引导语，中文、英文各一份 | 皮肤出厂标语 |
-| **通透度** | 0–100% 单值联动三个视觉层：面板底色、壁纸遮罩、模糊。0% 纯壁纸完全透出，100% 完全遮蔽 | meirenzhi 35，openbmc / uefi-harness 55 |
+| **通透度** | 0–100% 单值联动三个视觉层：面板底色、壁纸遮罩、模糊。0% 纯壁纸完全透出，100% 完全遮蔽 | 美人志：Web 35%、Desktop 55%；openbmc / uefi-harness：两端均 55% |
 
-> **Windows Desktop（dsh Desktop 应用）上的形态**：桌面端外壳——侧栏、顶栏条、右栏面板与窗口按钮——为**不透明的皮肤本色**，不随通透度变化；壁纸在会话区（内容列）显露，通透度联动会话区内的表面底色、遮罩与模糊。Web 端维持全表面透纱的原有形态，两端互不影响。
+> **Desktop profile**：外壳为实色皮肤本色、壁纸只在会话区显露——详见下方「Desktop profile 上的形态」。
 
 ![个性化面板 — 以美人志为例：内置壁纸网格、图库上传、中英标语与通透度旋钮](docs/assets/preview-personalization.webp)
 
@@ -122,16 +124,25 @@ dsh plugin --profile web remove @iasiv5/dsh-skins    # 卸载
 
 - 面板内任何修改立即生效，停顿约半秒自动写入配置。
 - 双标签页约 1 秒内自动同步；离线时写入控件自动禁用，不会静默丢改动。
-- 「恢复默认」是唯一带二次确认的操作：先列出将被重置的设置，确认后立即回出厂并自动保存。
+- 「恢复默认」会先列出将被重置的设置，确认后立即回出厂并自动保存。Desktop 的破坏性操作使用页面内确认弹窗，避免 Electron 原生确认框关闭后输入区失焦；Web 保留浏览器原生确认框。
 - 面板展开时点击其他皮肤卡片，面板会随即切到该皮肤的设置。
 
 ### 配置存在哪、会不会丢
 
-- 配置与图库存于 `$DSH_HOME/dsh-skins/`，与插件安装目录物理隔离：插件升级（经 dsh-m 市场或 `dsh plugin`）只替换插件安装目录，碰不到它。
+- Web profile 的配置与图库存于 `$DSH_HOME/dsh-skins/`；Desktop profile 自 v1.5.4 起存于 `$DSH_HOME/dsh-skins-desktop/`。Desktop 首次启动会从旧目录复制一次既有配置与图库，**不删除或改写旧目录**，此后两端独立。两处都与插件安装目录物理隔离：插件升级只替换插件安装目录。
 - 配置只存「改过什么」：未改动的字段自动跟随新版本的默认值，已下线皮肤或字段的残留会在加载时自动清理（v1.4.0 移除 tgcf 皮肤即走这条路径）。
 - 配置文件损坏时进入恢复模式：只重建索引、隔离坏文件，绝不清除你的图片。
 - 上传走魔数校验与尺寸上限；并发写入按字段合并，互不覆盖。
 
+## Desktop profile 上的形态
+
+**DSH Desktop 应用**中，外壳——侧栏、顶栏条、右栏面板与窗口按钮——为**不透明的皮肤本色**，不随通透度变化；壁纸在会话区（内容列）显露，通透度联动会话区内的表面底色、遮罩与模糊。Web profile 维持全表面透纱的原有形态，两端互不影响。
+
+![Desktop profile — 实色外壳 + 会话区壁纸（美人志 · 深色）](docs/assets/preview-desktop-1.webp)
+
+- 已在 dsh Desktop `0.2.0-rc.2`（Windows）验证；macOS / Linux Desktop 当前跟随 Web 形态，后续版本适配。
+- 右栏面板全屏时为实色皮肤底、不透出壁纸；面板「收起/关闭」后的空轨道行为属宿主布局。
+
 ## 皮肤切换器
 
 本节回答：切换器里有什么、怎么用。
@@ -164,6 +175,9 @@ URL 也能切皮肤：`/?skin=official`、`/?skin=openbmc`、`/?skin=uefi-harnes
 **支持哪些 DSH Web 版本？**
 已使用 DSH Web `0.2.0-rc.2` 验证。同系列 rc 版本理论上兼容，未经验证的版本不作承诺。
 
+**支持 Desktop profile 吗？**
+支持。DSH Desktop 应用与 Web profile 各自独立安装、互不影响；桌面形态（实色外壳 + 会话区壁纸）见「Desktop profile 上的形态」。已使用 dsh Desktop `0.2.0-rc.2`（Windows）验证。
+
 **外观偏好在不同的浏览器间同步吗？**
 在 DSH 所在机器的浏览器（loopback）上，偏好由 DSH Host 持久化，天然共享。其他远程浏览器由插件将偏好存入本地 `localStorage`，各浏览器独立、互不覆盖。
 
@@ -175,7 +189,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 已知边界：右栏面板「收起/关闭」后，宿主保留一条空轨道（显示外壳深色底，会话区不扩展）——宿主布局行为，非皮肤可控；全屏面板为实色皮肤底、不带壁纸模糊（会模糊面板内全部内容，故不做）。
+- Windows Desktop 已知边界：全屏的右栏面板为实色皮肤底，不透出壁纸。
 
 ## License
 

package/lib/client.js

@@ -125,17 +125,18 @@
       ]
     }
   };
-  function getSkinSchema(skinId) {
+  function getSkinSchema(skinId, profile = "web") {
     const entry = SKINS[skinId];
     if (entry === void 0) return null;
-    return { skinId, fields: entry.fields, builtinAssets: entry.builtinAssets };
+    const fields = profile === "desktop" && skinId === "meirenzhi" ? entry.fields.map((field) => field.key === "panelOpacity" ? { ...field, default: 55 } : field) : entry.fields;
+    return { skinId, fields, builtinAssets: entry.builtinAssets };
   }
   function getField(skinId, key) {
     return SKINS[skinId]?.fields.find((field) => field.key === key) ?? null;
   }
-  function defaultsFor(skinId) {
+  function defaultsFor(skinId, profile = "web") {
     const values = {};
-    for (const field of SKINS[skinId]?.fields ?? []) values[field.key] = field.default;
+    for (const field of getSkinSchema(skinId, profile)?.fields ?? []) values[field.key] = field.default;
     return values;
   }
   function isSameOverrideValue(a, b) {
@@ -245,8 +246,8 @@
     })) return { ok: false, code: "BAD_SHAPE" };
     return { ok: true };
   }
-  function mergeValues(skinId, overrides, metaProvider) {
-    const schema = getSkinSchema(skinId);
+  function mergeValues(skinId, overrides, metaProvider, profile = "web") {
+    const schema = getSkinSchema(skinId, profile);
     if (schema === null) return { values: {}, issues: [] };
     const provider = typeof metaProvider === "function" ? metaProvider : void 0;
     const values = {};
@@ -358,13 +359,13 @@
     });
   }
   function projectSkin(skin, rawOverrides, context = {}) {
-    const schema = getSkinSchema(skin.id);
+    const schema = getSkinSchema(skin.id, context.profile);
     if (schema === null) {
       return { effects: null, issues: [], degraded: "failed" };
     }
     const project2 = skin.project;
     const attempt = (overrides) => {
-      const { values, issues } = mergeValues(skin.id, overrides, context.metaProvider);
+      const { values, issues } = mergeValues(skin.id, overrides, context.metaProvider, context.profile);
       const resolvedAssets = {};
       for (const field of schema.fields) {
         if (field.type !== "image") continue;
@@ -387,7 +388,7 @@
     };
     const first = safeAttempt(rawOverrides ?? {});
     if (first.normalized !== null) return { effects: first.normalized, issues: first.issues, degraded: "none" };
-    const second = safeAttempt(defaultsFor(skin.id));
+    const second = safeAttempt(defaultsFor(skin.id, context.profile));
     if (second.normalized !== null) return { effects: second.normalized, issues: first.issues, degraded: "defaults" };
     return { effects: null, issues: first.issues, degraded: "failed" };
   }
@@ -444,7 +445,7 @@
     }
     return lines.join("\n");
   }
-  function createSkinRuntime() {
+  function createSkinRuntime({ profile = "web" } = {}) {
     const skins = /* @__PURE__ */ new Map();
     const order = [];
     let ctx = null;
@@ -519,6 +520,7 @@
     }
     function projectionContext() {
       return {
+        profile,
         assetResolver: personalization?.assetResolver,
         metaProvider: personalization?.metaProvider
       };
@@ -866,8 +868,13 @@ ${darkSelector}{${dark.join(";")}}`;
       "personalization.title": "个性化",
       "personalization.collapse": "收起个性化面板",
       "personalization.reset": "恢复默认",
-      "personalization.resetJoin": "、",
-      "personalization.resetConfirm": "以下设置将恢复为出厂默认：\n{fields}\n此操作立即生效，确认继续吗？",
+      "personalization.confirmTitle": "确认操作",
+      "personalization.confirm": "确认",
+      "personalization.cancel": "取消",
+      "personalization.resetJoin": "\n• ",
+      "personalization.resetConfirm": "以下设置将恢复为出厂默认：\n\n{fields}\n\n此操作立即生效，确认继续吗？",
+      "personalization.resetConfirmIntro": "以下设置将恢复为出厂默认：",
+      "personalization.resetConfirmOutro": "此操作立即生效，确认继续吗？",
       "personalization.light": "浅色",
       "personalization.dark": "深色",
       "personalization.builtin": "内置画作",
@@ -934,8 +941,13 @@ ${darkSelector}{${dark.join(";")}}`;
       "personalization.title": "Personalize",
       "personalization.collapse": "Collapse personalization panel",
       "personalization.reset": "Restore defaults",
-      "personalization.resetJoin": ", ",
-      "personalization.resetConfirm": "These settings will be reset to factory defaults:\n{fields}\nThis takes effect immediately. Continue?",
+      "personalization.confirmTitle": "Confirm action",
+      "personalization.confirm": "Confirm",
+      "personalization.cancel": "Cancel",
+      "personalization.resetJoin": "\n• ",
+      "personalization.resetConfirm": "These settings will be reset to factory defaults:\n\n{fields}\n\nThis takes effect immediately. Continue?",
+      "personalization.resetConfirmIntro": "These settings will be reset to factory defaults:",
+      "personalization.resetConfirmOutro": "This takes effect immediately. Continue?",
       "personalization.light": "Light",
       "personalization.dark": "Dark",
       "personalization.builtin": "Built-in artwork",
@@ -1098,6 +1110,17 @@ ${darkSelector}{${dark.join(";")}}`;
     ".dsh-skins-pz-danger{color:var(--dsw-alias-error-text,var(--dsw-static-red-500,#d33));border-color:var(--dsw-alias-error-text,var(--dsw-static-red-500,#d33))}",
     ".dsh-skins-pz-fields-locale{flex-direction:row;gap:6px}",
     ".dsh-skins-pz-fields-locale .dsh-skins-pz-input{flex:1;min-width:0}",
+    // HTML <dialog>.showModal() stays inside the renderer's top layer: unlike
+    // window.confirm(), it never opens the Windows/Electron JavaScript dialog
+    // that can leave the Desktop window unfocused after dismissal.
+    ".dsh-skins-pz-dialog{box-sizing:border-box;width:min(480px,calc(100vw - 32px));max-height:calc(100vh - 32px);padding:20px;border:1px solid var(--dsw-alias-border-l2);border-radius:14px;background:var(--dsw-alias-bg-elevated,var(--dsw-alias-bg-overlay));color:var(--dsw-alias-label-primary);box-shadow:var(--dsw-shadow-lv3,0 8px 24px rgba(0,0,0,.25));font:inherit}",
+    ".dsh-skins-pz-dialog::backdrop{background:rgba(0,0,0,.45)}",
+    ".dsh-skins-pz-dialog-message{margin:0 0 20px;white-space:pre-line;line-height:1.6;font-size:14px}",
+    ".dsh-skins-pz-dialog-intro{margin:0;font-size:14px;line-height:1.6}.dsh-skins-pz-dialog-outro{margin:0 0 20px;font-size:14px;line-height:1.6}",
+    ".dsh-skins-pz-dialog-tags{display:flex;flex-wrap:wrap;gap:8px;margin:12px 0 16px;padding:0;list-style:none}",
+    ".dsh-skins-pz-dialog-tag{box-sizing:border-box;display:inline-flex;align-items:center;gap:7px;max-width:100%;padding:6px 10px;border:1px solid var(--dsw-alias-border-l2);border-color:color-mix(in srgb,var(--dsw-alias-brand-primary) 42%,transparent);border-radius:999px;background:var(--dsw-alias-bg-layer-1);background:color-mix(in srgb,var(--dsw-alias-brand-primary) 10%,var(--dsw-alias-bg-overlay));color:var(--dsw-alias-label-primary);font-size:13px;line-height:18px;font-weight:600;white-space:normal}",
+    '.dsh-skins-pz-dialog-tag::before{content:"";flex:none;width:6px;height:6px;border-radius:50%;background:var(--dsw-alias-brand-primary)}',
+    ".dsh-skins-pz-dialog-actions{display:flex;justify-content:flex-end;gap:8px}",
     // Stacked (<904px) resets MUST come after the rules they override — the
     // array order is the cascade order among equal-specificity selectors.
     "@media (max-width:904px){.dsh-skins-pz-thumbs{grid-template-columns:repeat(4,1fr)}}"
@@ -1175,30 +1198,42 @@ ${darkSelector}{${dark.join(";")}}`;
         }) })
       ] });
     }
-    function WallpaperSection({ skinId, field, value, onValue, state, disabled }) {
+    function WallpaperSection({ skinId, field, value, onValue, state, disabled, requestConfirm }) {
       const uploadRef = useRef(null);
       const [message, setMessage] = useState(null);
       const [deletingId, setDeletingId] = useState(null);
+      const [clearing, setClearing] = useState(false);
       const [visible, setVisible] = useState(PAGE_SIZE);
       const schema = getSkinSchema(skinId);
       const builtins = schema?.builtinAssets ?? {};
       const liveAssets = builtinAssetsFor(skinId);
       const choices = field.builtinChoices ?? [];
       const library = state.library;
-      const removeAsset = async (asset) => {
-        if (deletingId !== null) return;
-        const references = state.references[asset.id] ?? [];
-        const names = references.map((entry) => `${labelFor(entry.skinId)} · ${entry.key}`).join("\n");
-        const confirmed = references.length === 0 || window.confirm(`${tr("personalization.library.deleteConfirm")}
-${names}`);
-        if (!confirmed) return;
+      const deleteAsset = async (asset) => {
         setMessage(null);
         setDeletingId(asset.id);
-        const result = await configClient.deleteImage(asset.id);
-        setDeletingId(null);
-        setMessage(result.error ? tr("personalization.library.deleteFailed") : tr("personalization.library.deleted", { name: asset.displayName }));
+        try {
+          const result = await configClient.deleteImage(asset.id);
+          setMessage(result.error ? tr("personalization.library.deleteFailed") : tr("personalization.library.deleted", { name: asset.displayName }));
+        } catch {
+          setMessage(tr("personalization.library.deleteFailed"));
+        } finally {
+          setDeletingId(null);
+        }
       };
-      const clearLibrary = async () => {
+      const removeAsset = (asset) => {
+        if (deletingId !== null || clearing) return;
+        const references = state.references[asset.id] ?? [];
+        if (references.length === 0) return deleteAsset(asset);
+        const names = references.map((entry) => `${labelFor(entry.skinId)} · ${entry.key}`).join("\n");
+        requestConfirm(
+          `${tr("personalization.library.deleteConfirm")}
+${names}`,
+          () => deleteAsset(asset)
+        );
+      };
+      const clearLibrary = () => {
+        if (clearing || deletingId !== null || library.length === 0) return;
         const pairs = /* @__PURE__ */ new Map();
         for (const asset of library) {
           for (const entry of state.references[asset.id] ?? []) {
@@ -1206,19 +1241,27 @@ ${names}`);
           }
         }
         const names = [...pairs.keys()].join("、");
-        const confirmed = window.confirm(tr("personalization.library.clearConfirm", {
+        requestConfirm(tr("personalization.library.clearConfirm", {
           count: library.length,
           names: names === "" ? "—" : names
-        }));
-        if (!confirmed) return;
-        for (const asset of [...library]) {
-          const result = await configClient.deleteImage(asset.id);
-          if (result.error) {
+        }), async () => {
+          setClearing(true);
+          try {
+            for (const asset of [...library]) {
+              const result = await configClient.deleteImage(asset.id);
+              if (result.error) {
+                setMessage(tr("personalization.library.clearFailed"));
+                void configClient.refetch();
+                return;
+              }
+            }
+          } catch {
             setMessage(tr("personalization.library.clearFailed"));
-            configClient.refetch();
-            return;
+            void configClient.refetch();
+          } finally {
+            setClearing(false);
           }
-        }
+        });
       };
       return jsx("div", { className: "dsh-skins-pz-row", children: [
         jsx("span", { className: "dsh-skins-pz-label", children: tr(field.labelKey) }),
@@ -1258,7 +1301,7 @@ ${names}`);
                   jsx("button", {
                     type: "button",
                     className: `dsh-skins-pz-del${deletingId === asset.id ? " dsh-skins-pz-del-busy" : ""}`,
-                    disabled: disabled || deletingId !== null,
+                    disabled: disabled || deletingId !== null || clearing,
                     "aria-label": `${tr("personalization.library.delete")}: ${asset.displayName}`,
                     onClick: () => removeAsset(asset),
                     children: deletingId === asset.id ? jsx("span", { className: "dsh-skins-spinner", "aria-hidden": "true" }) : "×"
@@ -1281,14 +1324,14 @@ ${names}`);
               jsx("button", {
                 type: "button",
                 className: "dsh-skins-pz-btn",
-                disabled: disabled || deletingId !== null,
+                disabled: disabled || deletingId !== null || clearing,
                 onClick: () => uploadRef.current?.click(),
                 children: tr("personalization.library.upload")
               }),
               library.length > 0 ? jsx("button", {
                 type: "button",
                 className: "dsh-skins-pz-btn dsh-skins-pz-danger",
-                disabled: disabled || deletingId !== null,
+                disabled: disabled || deletingId !== null || clearing,
                 onClick: clearLibrary,
                 children: tr("personalization.library.clear")
               }) : null
@@ -1363,8 +1406,39 @@ ${names}`);
     }
     return function PersonalizationPanel({ skinId, onCollapse }) {
       const state = useConfigState();
-      const schema = getSkinSchema(skinId);
+      const desktopProfile = typeof location !== "undefined" && location.protocol === "dsh-app:" && location.hostname === "app";
+      const profile = desktopProfile ? "desktop" : "web";
+      const schema = getSkinSchema(skinId, profile);
       const headerRef = useRef(null);
+      const dialogRef = useRef(null);
+      const confirmationRef = useRef(null);
+      const [confirmation, setConfirmation] = useState(null);
+      const requestConfirm = (message, accept, { detailItems = null } = {}) => {
+        if (!desktopProfile) {
+          if (window.confirm(message)) void accept();
+          return;
+        }
+        if (confirmationRef.current !== null) return;
+        const next = { message, accept, detailItems };
+        confirmationRef.current = next;
+        setConfirmation(next);
+      };
+      const cancelConfirm = () => {
+        confirmationRef.current = null;
+        setConfirmation(null);
+      };
+      const acceptConfirm = () => {
+        if (confirmationRef.current !== confirmation) return;
+        confirmationRef.current = null;
+        setConfirmation(null);
+        const current = configClient.getState();
+        if (current.status === "synced" && current.mode !== "recovery") {
+          void confirmation.accept();
+        }
+      };
+      useEffect(() => {
+        if (confirmation !== null) dialogRef.current?.showModal?.();
+      }, [confirmation]);
       const wideLayout = typeof window !== "undefined" && window.innerWidth >= 905;
       useEffect(() => {
         headerRef.current?.focus?.(wideLayout ? { preventScroll: true } : void 0);
@@ -1372,7 +1446,7 @@ ${names}`);
       if (schema === null) return null;
       const writesBlocked = state.status !== "synced" || state.mode === "recovery";
       const overrides = configClient.effectiveOverrides(skinId);
-      const { values } = mergeValues(skinId, overrides);
+      const { values } = mergeValues(skinId, overrides, void 0, profile);
       const hasAnyOverride = Object.keys(overrides).length > 0;
       const fieldRows = schema.fields.map((field) => {
         const value = values[field.key];
@@ -1390,7 +1464,8 @@ ${names}`);
               ...common,
               key: field.key,
               skinId,
-              state
+              state,
+              requestConfirm
             });
           default:
             return null;
@@ -1462,12 +1537,12 @@ ${names}`);
             disabled: writesBlocked,
             onClick: () => {
               const affected = schema.fields.filter((field) => overrides[field.key] !== void 0).map((field) => tr(field.labelKey));
-              const confirmed = window.confirm(tr("personalization.resetConfirm", {
-                fields: affected.length > 0 ? affected.join(tr("personalization.resetJoin")) : "—"
-              }));
-              if (!confirmed) return;
-              for (const field of schema.fields) configClient.previewReset(skinId, field.key);
-              void configClient.flushNow();
+              requestConfirm(tr("personalization.resetConfirm", {
+                fields: affected.length > 0 ? `• ${affected.join(tr("personalization.resetJoin"))}` : "—"
+              }), () => {
+                for (const field of schema.fields) configClient.previewReset(skinId, field.key);
+                void configClient.flushNow();
+              }, { detailItems: affected });
             },
             children: tr("personalization.reset")
           }) : null,
@@ -1484,7 +1559,40 @@ ${names}`);
         statusCluster.length > 0 ? jsx("div", {
           className: "dsh-skins-pz-actions",
           children: jsx("div", { className: "dsh-skins-pz-cluster dsh-skins-pz-cluster-status", children: statusCluster })
-        }) : null
+        }) : null,
+        confirmation === null ? null : jsx("dialog", {
+          ref: dialogRef,
+          className: "dsh-skins-pz-dialog",
+          "aria-labelledby": "dsh-skins-confirm-title",
+          onCancel: (event) => {
+            event.preventDefault();
+            cancelConfirm();
+          },
+          children: [
+            jsx("div", { id: "dsh-skins-confirm-title", className: "dsh-skins-pop-title", children: tr("personalization.confirmTitle") }),
+            confirmation.detailItems === null ? jsx("p", { className: "dsh-skins-pz-dialog-message", children: confirmation.message }) : jsx("div", { children: [
+              jsx("p", { className: "dsh-skins-pz-dialog-intro", children: tr("personalization.resetConfirmIntro") }),
+              confirmation.detailItems.length > 0 ? jsx("ul", { className: "dsh-skins-pz-dialog-tags", children: confirmation.detailItems.map((label) => jsx("li", { className: "dsh-skins-pz-dialog-tag", children: label }, label)) }) : jsx("p", { className: "dsh-skins-pz-dialog-message", children: "—" }),
+              jsx("p", { className: "dsh-skins-pz-dialog-outro", children: tr("personalization.resetConfirmOutro") })
+            ] }),
+            jsx("div", { className: "dsh-skins-pz-dialog-actions", children: [
+              jsx("button", {
+                type: "button",
+                className: "dsh-skins-pz-btn",
+                autoFocus: true,
+                onClick: cancelConfirm,
+                children: tr("personalization.cancel")
+              }),
+              jsx("button", {
+                type: "button",
+                className: "dsh-skins-pz-btn dsh-skins-pz-danger",
+                disabled: writesBlocked,
+                onClick: acceptConfirm,
+                children: tr("personalization.confirm")
+              })
+            ] })
+          ]
+        })
       ] });
     };
   }
@@ -1781,7 +1889,7 @@ ${names}`);
           closeShell();
         };
         const onKey = (event) => {
-          if (event.key === "Escape") closeShell();
+          if (event.key === "Escape" && !document.querySelector?.("dialog.dsh-skins-pz-dialog[open]")) closeShell();
         };
         document.addEventListener("pointerdown", onPointer, true);
         window.addEventListener("keydown", onKey);
@@ -2006,6 +2114,7 @@ ${names}`);
   function createConfigClient(options = {}) {
     const fetchImpl = options.fetchImpl ?? (typeof fetch === "function" ? fetch : null);
     const baseUrl = options.baseUrl ?? "/dsh-skins";
+    const profile = options.profile === "desktop" ? "desktop" : "web";
     const timeoutMs = options.timeoutMs ?? FETCH_TIMEOUT_MS;
     const uploadTimeoutMs = options.uploadTimeoutMs ?? UPLOAD_TIMEOUT_MS;
     if (typeof fetchImpl !== "function") throw new Error("config client requires a fetch implementation");
@@ -2238,7 +2347,7 @@ ${names}`);
       const composite = `${skinId} ${key}`;
       const storedOverride = snapshot.skins[skinId]?.[key];
       const previewed = previews.get(composite);
-      if (isSameOverrideValue(value, defaultsFor(skinId)[key])) {
+      if (isSameOverrideValue(value, defaultsFor(skinId, profile)[key])) {
         if (storedOverride === void 0 && previewed === void 0) return;
         if (previewed === null) return;
         return previewReset(skinId, key);
@@ -3460,7 +3569,8 @@ body[data-dsh-uefi-harness][data-ds-dark-theme] .lc-tip {
       const jsxRuntime = require2("react/jsx-runtime");
       const react = require2("react");
       const reactDom = require2("react-dom");
-      const runtime = createSkinRuntime();
+      const profile = window.location?.protocol === "dsh-app:" && window.location?.hostname === "app" ? "desktop" : "web";
+      const runtime = createSkinRuntime({ profile });
       const skinById = /* @__PURE__ */ new Map();
       for (const factory of [createOpenBmcHarness, createUefiHarness, createMeirenzhiSkin]) {
         const skin = factory(jsxRuntime);
@@ -3472,7 +3582,7 @@ body[data-dsh-uefi-harness][data-ds-dark-theme] .lc-tip {
         skinById.set(skin.id, skin);
         runtime.register(skin);
       }
-      const configClient = typeof fetch === "function" ? createConfigClient({ contextActive: () => runtime.active() }) : null;
+      const configClient = typeof fetch === "function" ? createConfigClient({ profile, contextActive: () => runtime.active() }) : null;
       if (configClient !== null) {
         const assetResolver = (ref) => {
           if (ref.kind === "builtin") {

package/lib/index.js

@@ -1,6 +1,7 @@
 // src/index.js
 import { homedir } from "node:os";
-import { join as join2 } from "node:path";
+import { cpSync, existsSync as existsSync2, mkdtempSync, readdirSync as readdirSync2, renameSync as renameSync3, rmSync } from "node:fs";
+import { dirname as dirname2, join as join2, resolve } from "node:path";
 
 // src/host/personalization/store.js
 import { createHash, randomUUID } from "node:crypto";
@@ -277,10 +278,11 @@ var SKINS = {
     ]
   }
 };
-function getSkinSchema(skinId) {
+function getSkinSchema(skinId, profile = "web") {
   const entry = SKINS[skinId];
   if (entry === void 0) return null;
-  return { skinId, fields: entry.fields, builtinAssets: entry.builtinAssets };
+  const fields = profile === "desktop" && skinId === "meirenzhi" ? entry.fields.map((field) => field.key === "panelOpacity" ? { ...field, default: 55 } : field) : entry.fields;
+  return { skinId, fields, builtinAssets: entry.builtinAssets };
 }
 function getField(skinId, key) {
   return SKINS[skinId]?.fields.find((field) => field.key === key) ?? null;
@@ -288,9 +290,9 @@ function getField(skinId, key) {
 function listAssetFields(skinId) {
   return SKINS[skinId]?.fields.filter((field) => field.type === "image") ?? [];
 }
-function defaultsFor(skinId) {
+function defaultsFor(skinId, profile = "web") {
   const values = {};
-  for (const field of SKINS[skinId]?.fields ?? []) values[field.key] = field.default;
+  for (const field of getSkinSchema(skinId, profile)?.fields ?? []) values[field.key] = field.default;
   return values;
 }
 function isSameOverrideValue(a, b) {
@@ -483,6 +485,7 @@ function createPersonalizationStore(options = {}) {
   }
   const fs = options.fs ?? defaultFs();
   const now = options.now ?? Date.now;
+  const profile = options.profile === "desktop" ? "desktop" : "web";
   const stateFile = join(dataDir, STATE_FILE);
   const assetsDir = join(dataDir, ASSETS_DIR);
   const quarantineDir = join(dataDir, QUARANTINE_DIR);
@@ -611,7 +614,7 @@ function createPersonalizationStore(options = {}) {
         continue;
       }
       const section = state.skins[skinId];
-      const defaults = defaultsFor(skinId);
+      const defaults = defaultsFor(skinId, profile);
       for (const key of Object.keys(section)) {
         if (!validateOverride(skinId, key, section[key], provider).ok) {
           delete section[key];
@@ -1181,14 +1184,46 @@ function mountPersonalizationRoutes(host, options) {
 
 // src/index.js
 var name = "@iasiv5/dsh-skins";
+function expandHomePath(path) {
+  if (path === "~") return homedir();
+  if (path.startsWith("~/") || path.startsWith("~\\")) return join2(homedir(), path.slice(2));
+  return path;
+}
 function dshHome() {
-  return process.env.DSH_HOME?.trim() || join2(homedir(), ".dsh");
+  const configured = process.env.DSH_HOME?.trim();
+  return resolve(expandHomePath(configured || join2(homedir(), ".dsh")));
+}
+function hostProfileFor(root, cwd = process.cwd()) {
+  const normalized = (path) => process.platform === "win32" ? resolve(path).toLowerCase() : resolve(path);
+  return normalized(cwd) === normalized(join2(expandHomePath(root), "profiles", "desktop")) ? "desktop" : "web";
+}
+function dataDirForProfile(root, profile) {
+  root = resolve(expandHomePath(root));
+  const legacy = join2(root, "dsh-skins");
+  if (profile !== "desktop") return legacy;
+  const desktop = join2(root, "dsh-skins-desktop");
+  if (existsSync2(desktop) || !existsSync2(legacy)) return desktop;
+  const stage = mkdtempSync(join2(root, ".dsh-skins-desktop-migrate-"));
+  try {
+    for (const name2 of readdirSync2(legacy)) {
+      cpSync(join2(legacy, name2), join2(stage, name2), { recursive: true, force: false, errorOnExist: true });
+    }
+    renameSync3(stage, desktop);
+  } catch (error) {
+    if (!existsSync2(desktop)) throw error;
+  } finally {
+    if (dirname2(resolve(stage)) !== resolve(root)) throw new Error("unsafe Desktop migration staging path");
+    if (existsSync2(stage)) rmSync(stage, { recursive: true, force: true });
+  }
+  return desktop;
 }
 function apply(ctx) {
   ctx.inject(["webServer", "webRuntime"], (hostContext) => {
     const root = dshHome();
+    const profile = hostProfileFor(root);
     const personalization = createPersonalizationStore({
-      dataDir: join2(root, "dsh-skins")
+      dataDir: dataDirForProfile(root, profile),
+      profile
     });
     hostContext.effect(() => {
       return mountPersonalizationRoutes(hostContext, {
@@ -1200,5 +1235,7 @@ function apply(ctx) {
 }
 export {
   apply,
+  dataDirForProfile,
+  hostProfileFor,
   name
 };

package/package.json

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