EAC-skin-loader

DSH UI 皮肤加载器——弱约束公约 dsh.ecosystem.ui-skin-loader/v1 的参考实现：一个加载器加十三款皮肤（2 款内置示例 + 11 款公约化迁移），装入 DSH 后即可在设置里一键换肤、随时彻底还原。 它是什么

0.2.0-rc.2 的适配覆盖全部 13 款皮肤：保留原 adapter、稳定 ID、设置命名空间和视觉源码，增加真实官方发布产物的接口契约测试。此轮验证不等同于新版 Desktop 实机验收；材料版本及验证边界见 docs/api-notes.md 和 docs/verification.md。 加载器（@dsh-eac/ui-skin-loader）：皮肤发现登记、全局互斥切换、持久化与跨重启恢复、故障隔离（激活抛错回滚 / 关闭超时如实标记疑似残留）、跨标签页同步，以及设置页里的换肤控制台（亮暗双案自适应）。 皮肤：一个遵循公约的皮肤插件在未激活时零副作用（只登记元数据），激活后才产生可见副作用，被换走或停用时彻底关闭——宿主观感与它从未激活时逐像素一致。v1.0.0 的五款皮肤经实机验证矩阵逐款验收；v1.1.0 新增的七款迁移皮肤经类型检查、lint、单元测试、构建与打包冒烟验证（实机验收清单见 docs/verification.md）。 皮肤清单（13 款） 十一款迁移皮肤的内容取自不可变 Git 对象：十款来自 DSH-EAC/DSH-Desktop-EAC 提交 26841f5ee83c154a9768cc0a9cec1d70078f0ddf，深鲸来自 GGBond2424648901/deep-whale-day-night-theme@3f6c4f14716d1e500f585be0c0d3c139c7a8a90b；每包 THIRD-PARTY-NOTICES.md 记录上游包名与版本、固定 commit 与许可文本。许可边界：包工程骨架（清单 / 公约接线 / 会话适配 / 构建 / 测试）为 MIT，随包观感内容按其上游许可分发。 未纳入本次发布（deferred） 安装 前置条件 DSH 0.1.7-rc.2 或 0.2.0-rc.2（dsh 命令行可用；仅声明这两个精确版本）； Node.js >= 24（构建安装包时需要 pnpm 11；安装动作本身由 dsh 驱动）。 0. Git 安装（推荐：一条命令 + 自动补齐皮肤）

在目标 profile 里直接添加本仓库，加载器即随仓内嵌制品安装（零构建、零 prepare 脚本）：

安装后加载器自动启动；它会在后台按 packages/loader/skin-manifest.json（固定版本的制品清单， 含逐包 SHA256 与字节数）检查并补齐缺失的皮肤——下载到加载器自有缓存目录、校验通过后经 宿主 pluginManager 安装，不会切换你当前使用的观感，也不会覆盖你已有的任何皮肤/启用状态。

控制台（设置 → 皮肤）底部的「皮肤自动补齐」分区如实展示逐包状态（已就绪 / 安装中 / 失败 / 已有其他版本 / 不再自动补回），并提供失败重试与自动补齐开关。分发契约、宿主安装机制实测 与遗留风险见 docs/git-distribution.md。 边界提示：皮肤制品清单指向 GitHub Release 资产。该 Release 发布前，补齐状态会如实 显示失败原因（网络/404），加载器本体不受影响——类型检查与隔离验证不能代替这一步的 实机验收。 1. 构建安装包

克隆本仓后在工作区根执行依赖安装与构建，再对十三个包逐个 npm pack：

得到 14 个 tarball：加载器 1 个 + 皮肤 13 个。

2. 逐包装入 DSH

对每个 tarball 执行一次 dsh plugin add（profile 按需命名；皮肤包依赖加载器，建议先装加载器）：

安装形态说明（tarball 链路实测）： tarball 以复制方式装入 profile（依赖随包装入，dsh.profile.bundles 自动追加），安装即启用； 同路径同名重装需先 dsh plugin --profile web remove 再 add（包管理器对相同 file: 规格会跳过重装）； v1.0.0 验证战役（V2 项）以该命令序列在全新隔离环境装入六包、boot 零 error/warn，全过程见 docs/verification.md。 3. 使用：打开设置 → 皮肤控制台

启动（或重启）DSH 后，打开 设置 → 皮肤 即见换肤控制台： 卡片墙列出全部已安装皮肤（未激活的皮肤零副作用，只显示元数据与封面）； 点击卡片激活（全局互斥：任意时刻至多一款皮肤生效），hero 区的「恢复默认」一键回到宿主原生观感； 选择跨重启自动恢复；激活抛错自动回滚并在卡内呈现错误原文，关闭异常会如实标记「疑似残留」； 带自定义设置的皮肤（极光之夜）激活后，在 设置 → 极光之夜 提供其自有设置分区；无设置皮肤不被区别对待。 画廊