界面皮肤管理 iasiv5/dsh-skins

dsh-skins — DSH 多皮肤插件

English · 中文

给 DeepSeek Harness 换上可热切换的品牌皮肤——Web 与 Desktop 两种配置档都能安装使用，随时一键回到官方界面。

凡人修仙传 · 美人志 — 内置默认壁纸「云台雅集」

30 秒上手

本节回答：怎么装上、怎么换皮肤。

dsh plugin --profile web add @iasiv5/dsh-skins

1. 执行上面的安装命令。
2. 重启 DSH Web（例如 systemctl restart 对应的服务，按你的部署方式而定）。
3. 刷新页面。
4. 点击侧栏底部的「皮肤切换」，挑选皮肤。

首次安装且尚无已保存的选择时，默认启用「OpenBMC Studio」（出厂皮肤，v1.0.6 起；此前为美人志）。需要可复现安装时，固定到精确版本：

dsh plugin --profile web add @iasiv5/dsh-skins@1.0.0

更新与卸载：

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 插件市场的话，也可以直接在 DSH Web 界面里一键安装 / 卸载本插件。

按 DSH 版本选插件版本：

| 你的 DSH 版本 | 插件版本 |
| 0.2.0-rc.1 及以上（web 与 Desktop 通用） | @latest（1.5.9+） |
| 0.1.x | 1.5.7（该线的最后支持版） |

把安装交给智能体（提示词安装法）

把下面这段整体复制给 DSH Web 里的智能体：

帮我安装 DSH 皮肤插件 @iasiv5/dsh-skins：
1. 执行 dsh plugin --profile web add @iasiv5/dsh-skins；
2. 安装成功后重启 DSH Web（若由 systemd 管理，重启对应服务即可）；
3. 最后提醒我刷新页面。
若安装失败，把命令输出原样发给我，最多重试一次。

三款皮肤与官方界面

本节回答：有哪些皮肤、各是什么气质。

| 选择 ID | 类型 | 描述 |
| official | 内置选项 | 素笺玄墨 · 留白生辉 · 本色天成 |
| openbmc | 正式皮肤 · 出厂默认 | 冰绡叠浪 · 风雷入画 · 缥碧盈卷 |
| uefi-harness | 正式皮肤 | 紫电初醒 · 流霞渐染 · 绀青成韵 |
| meirenzhi | 正式皮肤 | 云鬓花颜 · 霞衣夜月 · 凡尘问道 |

- official 恢复 DeepSeek Harness 官方品牌、背景与 favicon，并保留皮肤切换器与官方明暗配色。
- openbmc（OpenBMC Studio）：品牌位沿用 OpenBMC 项目官方 logo 的字标字形与蓝绿品牌渐变，仅作标识用途，权利归 OpenBMC 项目所有；背景铺「左风右雷」风雷原画，冰蓝缥碧亮暗双态，出厂标语「察于未萌 · 治于未乱」。
- uefi-harness（UEFI Studio）：品牌位用 UEFI Forum 官方标志（权利说明见「已知边界」）；背景铺「集成电路」电路板原画，紫电绀青亮暗双态，出厂标语「启于固件 · 行于万象」。
- meirenzhi（凡人修仙传 · 美人志）是非官方粉丝作品，与《凡人修仙传》版权方无关联、未获授权；内置 6 张壁纸均为 AI 生成粉丝画作，掌天瓶站点图标采用产品主人提供的图样，BEAUTY 徽章由 HTML/CSS 绘制，萤火粒子由 CSS 伪元素与径向渐变绘制，均不含官方素材。绯红鎏金亮暗双态，出厂标语「风起凡尘 · 红颜问道」。
- 每套皮肤明暗各一套配色，跟随「外观配色」自动切换。
- tgcf（天官赐福）皮肤已于 v1.4.0 移除：选择过它的浏览器会自动落回出厂皮肤，其残留个性化配置会在加载时自动清理。

界面预览

以下均为浏览器实拍，三套扩展皮肤新旧俱备；图中壁纸随时可在个性化面板里更换（见下一节）。

凡人修仙传 · 美人志

| 云台雅集 · 合照（默认壁纸） | 紫灵（亮色） |
| 南宫阙（深色） | 银月（亮色） |
| 慕沛灵（亮色） | 南宫婉（亮色） |

单人壁纸依次为：紫灵、南宫阙（深色）、银月、慕沛灵、南宫婉；首张为该皮肤默认「云台雅集 · 合照」。

OpenBMC Studio（出厂默认）

左风右雷（出厂壁纸 · 深色）

UEFI Studio

集成电路（出厂壁纸）

个性化：壁纸、标语与通透度

本节回答：能调什么、怎么调、配置存哪。

每套皮肤的关键视觉都开放调整。点击皮肤卡片右侧的齿轮按钮，换肤弹层旁会展开该皮肤的个性化面板（窄窗口时上下堆叠）。三套皮肤（openbmc / uefi-harness / meirenzhi）共用同一组可调项：

| 可调项 | 能做什么 | 出厂值 |
| 壁纸 | 从皮肤自带的「内置精选」里挑，或上传自己的图片进「个人图库」 | 各皮肤的默认画作 |
| 标语 | 新会话页的引导语，中文、英文各一份 | 皮肤出厂标语 |
| 通透度 | 0–100% 单值联动三个视觉层：面板底色、壁纸遮罩、模糊。0% 纯壁纸完全透出，100% 完全遮蔽 | 美人志：Web 35%、Desktop 66%；openbmc / uefi-harness：Web 55%、Desktop 66% |

美人志在 Web 出厂值（35%）及以下不引入任何壁纸模糊与全局玻璃（ADR-0010），壁纸保持原生锐度；模糊自 35% 以上沿铰链曲线平滑爬升，100% 到顶 12px。

Desktop profile：外壳为实色皮肤本色、壁纸只在会话区显露——详见下方「Desktop profile 上的形态」。

个性化面板 — 以美人志为例：内置壁纸网格、图库上传、中英标语与通透度旋钮

上传自己的壁纸（个人图库）

- 支持 PNG / JPEG / WebP / GIF：单张 ≤ 20MB，GIF ≤ 12MP；动画 WebP 与 SVG 不收。
- 支持一次多选，逐张自动上传，逐张播报进度与失败原因。
- 图库没有数量上限，所有皮肤共用一份。
- 删除被引用的图片或清空图库前，会先列出全部受影响的皮肤与字段，确认后才会执行。

即改即存，无需保存

- 面板内任何修改立即生效，停顿约半秒自动写入配置。
- 双标签页约 1 秒内自动同步；离线时写入控件自动禁用，不会静默丢改动。
- 「恢复默认」会先列出将被重置的设置，确认后立即回出厂并自动保存。Desktop 的破坏性操作使用页面内确认弹窗，避免 Electron 原生确认框关闭后输入区失焦；Web 保留浏览器原生确认框。
- 面板展开时点击其他皮肤卡片，面板会随即切到该皮肤的设置。

配置存在哪、会不会丢

- 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 — 实色外壳 + 会话区壁纸（美人志 · 深色）

- 已在 dsh Desktop 0.2.1-rc.2（Windows）验证；macOS / Linux Desktop 当前跟随 Web 形态，后续版本适配。
- 右栏面板全屏时为实色皮肤底、不透出壁纸；面板「收起/关闭」后的空轨道行为属宿主布局。

皮肤切换器

本节回答：切换器里有什么、怎么用。

侧栏底部的「皮肤切换」弹层包含两个区块：

1. 外观配色：浅色、深色、跟随系统。调用官方主题服务，与「设置 → 通用 → 外观」保持同步。
2. 选择皮肤：第一项为 DeepSeek Harness（官方），其后是扩展皮肤。点击立即切换并持久化，弹层保持打开，方便连续预览。

皮肤切换器弹层 — 外观配色与皮肤列表

侧栏收起时，入口收为圆形调色盘图标；多个 sidebar.footer.action 入口会纵向排列、互不遮挡。选择「官方」只撤销扩展皮肤，不动你的明暗偏好。

URL 也能切皮肤：/?skin=official、/?skin=openbmc、/?skin=uefi-harness、/?skin=meirenzhi。

更新

本节回答：插件怎么更新。

插件不自带更新器（ADR-0008）：更新发现与安装交给 dsh-m 市场，或 DSH 官方 CLI——升级用 dsh plugin --profile web update @iasiv5/dsh-skins；回滚 = 重装旧精确版本 dsh plugin add --profile web @iasiv5/dsh-skins@X.Y.Z。npm 上 @iasiv5/dsh-skins 的 latest 精确版本仍是唯一分发形态，版本策略维持严格 X.Y.Z。

FAQ

怎么彻底回到官方界面？ 在皮肤切换器中选择「DeepSeek Harness（官方）」，或访问 /?skin=official。它撤销扩展皮肤的品牌、背景与 favicon，保留皮肤切换器与官方明暗配色，也不会改动你的浅色/深色/跟随系统偏好。

为什么没有「检查更新」按钮？ 更新职责已移交 dsh-m 市场与 DSH CLI（ADR-0008）；皮肤切换器只负责换肤与个性化。

支持哪些 DSH Web 版本？ 已使用 DSH Web 0.2.0-rc.2、0.2.1-rc.3 与 0.2.1-rc.4 验证（1.5.21 全量门禁在 rc.4 上跑绿）；0.2.1-rc.5 为同系列契约面等价重发布（宿主 web-app patch 相对 rc.4 零 diff），rc.4 的核验结论按等价口径覆盖 rc.5。同系列后续 rc 版本理论上兼容，未经验证的版本不作承诺。最低支持 DSH 0.2.0-rc.1：更旧的 DSH 版本会被 peer 依赖门槛挡住，无法升级到 1.5.8+。

支持 Desktop profile 吗？ 支持。DSH Desktop 应用与 Web profile 各自独立安装、互不影响；桌面形态（实色外壳 + 会话区壁纸）见「Desktop profile 上的形态」。已使用 DSH Desktop 0.2.1-rc.5 验证。

外观偏好在不同的浏览器间同步吗？ 在 DSH 所在机器的浏览器（loopback）上，偏好由 DSH Host 持久化，天然共享。其他远程浏览器由插件将偏好存入本地 localStorage，各浏览器独立、互不覆盖。

个性化配置会随升级丢吗？ 不会。配置与图库存放在 $DSH_HOME/dsh-skins/ 数据目录，升级只替换插件安装目录（无论经哪个通道），物理上碰不到它；回滚同样保留。只有磁盘级损坏可能丢失配置——那时恢复模式仍会保住图库图片。

已知边界

- 其他皮肤插件也可能修改 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

MIT

想读源码、自制皮肤或参与开发？请看 docs/developers.md（工作原理、皮肤开发指南、本地验证与调试 API）。