leo-aba/dsh-skins

AI 生成声明：本仓库所有内容（代码、文档、配色方案）均由 AI 生成。

dsh-skins

DeepSeek Harness web 界面皮肤插件集合（DSH web UI 的客户端插件主题）。

每个皮肤是一个独立的 client 插件包，放在 skins/ 下，注册 --dsw-alias- token 覆盖，并在设置的一级菜单提供「皮肤中心」切换入口。

皮肤列表

| 皮肤 | 目录 | 说明 | 状态 |
| --- | --- | --- | --- |
| 樱花 Sakura | skins/sakura | 樱花粉/暖色，含浅色 sakura 与深色 sakura-dark 双主题（纯换色、无壁纸） | ✅ 可用 |
| 银狼 Silver Wolf | skins/silverWolf | 星穹铁道银狼，赛博银蓝配色，竖图立绘壁纸背景，含深色 silverwolf 与浅色 silverwolf-light 双主题 | ✅ 可用 |
| 蕾米艾尔 Remielle Dan | skins/RemielleDan | 樱粉配色，横图立绘壁纸背景（base 表面半透明透出立绘），含深色 remielledan 与浅色 remielledan-light 双主题 | ✅ 可用 |

带壁纸的皮肤将选择持久化在浏览器 localStorage（dsh-skin-.preference）：host settings API 只对浏览器暴露显式 allowlist 命名空间，第三方插件注册的命名空间会被 settings-not-exposed 静默拒绝，因此持久化不走 host settings。

安装

以 skins/sakura 为例（任意皮肤通用）：

1. 把皮肤包装进 web profile（等价于在 profile 目录执行 pnpm add）
dsh plugin --profile web add

2. 在 ~/.dsh/profiles/web/cordis.patch.yml 的 insert 段追加一行
- insert:
- id: skin-sakura
name: dsh-skin-sakura

dsh plugin add 时 client 插件输出 declares no dsh.bundle — installed as a plain dependency 属正常现象（client 插件没有 host bundle 层）。若运行中的服务器未自动重载（loader 会监听 patch 变更并热重载），重启 dsh web 生效。

卸载

以 skins/RemielleDan 为例（任意皮肤通用，把 skin-remielledan / dsh-skin-remielledan 换成目标皮肤的 id/包名）：

1. 从 ~/.dsh/profiles/web/cordis.patch.yml 的 insert 段删除这两行：
- insert:
- id: skin-remielledan
name: dsh-skin-remielledan

2. 从 web profile 移除插件包（等价于在 profile 目录执行 pnpm remove）
dsh plugin --profile web remove dsh-skin-remielledan

3. 重启 dsh web 生效

- 卸载后该皮肤的 client bundle 不再由 /plugins 路由提供：正在运行中的页面刷新后皮肤消失，主题注册随插件 dispose 回落到内置偏好，壁纸/样式层一并移除。
- 可选清理：皮肤选择持久化在浏览器 localStorage，卸载后残留两个键（dsh-skin-.preference、dsh-skin-.initialized），不影响功能，如需彻底清理可在浏览器 DevTools → Application → Local Storage 里删除。

新增一个皮肤

完整创作指南见 skins 技能文档（含包结构、构建、安装、验证流程与全部踩坑经验），参考实现：

- skins/silverWolf：竖图暗色壁纸皮肤（壁纸内联、scrim、localStorage 持久化、boot 竞态处理）；
- skins/RemielleDan：横图亮色壁纸皮肤（像素分析法定构图与配色、占位符防重复内联）；
- skins/sakura：纯换色、无壁纸的最简实现。

原理

- 皮肤 = 浏览器侧 client 插件，通过 theme 服务注册主题：ctx.theme.register({ id, colorScheme, tokens })，tokens 为 --dsw-alias- 别名变量覆盖（未覆盖的 token 回落到基础样式表）。
- 切换入口是设置一级菜单里的「皮肤中心」（settings.section 槽条目，list 槽位，多皮肤共存互不打架）。
- 皮肤选择持久化在浏览器 localStorage（dsh-skin-.preference），启动时重新应用；首次启用默认应用皮肤主题并置 initialized 标志，之后切内置偏好只清选择、不再强加默认值。
- 壁纸图以 base64 内联进 client bundle（host 的 /plugins//client.js 路由不服务包内静态文件），由 body 属性门控 ::before 伪元素层渲染。
- 详见 skins/sakura/README.md 与 skins/RemielleDan/README.md。