外观定制 Vim0x3c/dsh-skin-appearance

dsh-skin-appearance

语言：中文 | English

这是一个面向 DeepSeek Harness 的外观插件。
它保留 Harness 原生控件，只在设置中增加「外观定制」页面，提供：

- DeepSeek 娘、QQ2008 水晶蓝、云海实验室、山海算境、深海星港、深海鲸歌和两套智能星图，共八套内置主题；
- 本地背景图片选择，并在写入设置前自动缩小压缩；
- 从上传图片自动提取主色、辅色、面板色和文字色，同时生成浅色／深色两套配色；
- 八套内置主题和上传图片都跟随 Harness 原生的「浅色／深色／跟随系统」开关；
- 每套主题都有贴合自身视觉语言的侧栏、新会话按钮、插件入口和输入框；
- 独立的背景透明度和模糊控制，默认透明度 100%、模糊 0 px；
- 由 Host 设置文档支持的跨重启持久化；
- 一键还原原生 Harness 外观。

主题预览

| DeepSeek娘·深海回响 | QQ2008·水晶蓝 |
| DeepSeek娘主题 | QQ2008主题 |
| 云海实验室 | 山海算境 |
| 云海实验室主题 | 山海算境主题 |
| 深海星港 | 深海鲸歌 |
| 深海星港主题 | 深海鲸歌主题 |
| 智能星图·墨 | 智能星图·曦 |
| 智能星图墨主题 | 智能星图曦主题 |

安装

插件是一个 dsh bundle，可以用 Harness CLI 安装到 web profile：

dsh plugin --profile web add /path/to/dsh-skin-appearance
dsh web

包中的 dsh.bundle.patch 会把插件加入 profile 的配置层。下次启动 Web 时，dsh.client 声明会让 Harness 发现浏览器 bundle，设置页面中就会出现「外观定制」。

如果插件已经发布到包仓库，可以把本地路径换成包名：

dsh plugin --profile web add dsh-skin-appearance

实现说明

Node 半边通过 Harness settings 服务注册 appearance 设置命名空间。浏览器半边通过 ctx.theme.overrideTokens 提供浅色和深色双模式 token，通过 settings.section slot 注册设置页，并维护一个覆盖整个应用根节点的背景图片层。八套主题分别提供侧栏、会话列表、新会话按钮、插件入口和输入框的表面样式；QQ2008 额外使用独立的经典蓝色窗口框架。自定义壁纸使用自适应的浅色／深色毛玻璃方案。

上传图片会先解码，再按长边 1600 像素上限压缩成 JPEG data URL；独立的 48 像素采样画布会提取主色、色相分离的辅色，并分别生成浅色和深色的可读面板色、文字色。切换 Harness 原生的浅色、深色或跟随系统设置时，当前皮肤保持不变，只切换对应的表面和 token；选择「默认」会移除插件自己的覆盖并交还原生界面。

背景层本身不使用 backdrop-filter；模糊只应用在有明确边界的界面表面，避免流式输出和滚动时触发整页重复合成。

开发

这个目录采用 Harness 独立 client 插件的构建结构：

pnpm install
pnpm build

要在 Harness 源码 checkout 中联调，先构建 Harness，再把本目录安装到 web profile：

cd /path/to/deepseek-harness
pnpm install
pnpm build
dsh plugin --profile web add /path/to/dsh-skin-appearance
dsh web

Harness 服务被声明为 peer dependency，确保插件和宿主共用同一个 Cordis、settings、theme、React 实例，避免浏览器 bundle 内联出重复的服务身份。

许可证

MIT。