前言¶
DeepSeek Harness(DSH)支持插件化扩展,主题插件属于其中一类。传统的 Web 主题往往需要修改应用内部 DOM 结构、大量使用 !important 规则,或者依赖外部 CSS 文件,维护成本高。furina-dsh-theme 通过 DSH 的设计 token 体系,把主题样式映射到插件内部,不触碰应用源码,只通过配置项切换。
插件定位¶
这是一个为 DeepSeek Harness Web GUI 提供的芙宁娜主题插件,由 TanPass 维护,属于「趣味换装」分类。它提供三套皮肤、可独立切换的壁纸层、三种强度的半透明玻璃效果,并在 DSH 自身的设置对话框中嵌入一个主题控制面板,包含启动动画配置和人格预设管理。
核心功能¶
三套皮肤¶
三套皮肤分别对应不同的视觉感受和强调色:
fontaine-nocturne雨夜枫丹:雨夜霓虹、靛蓝夜空,强调色#4ea4efhydro-iris水镜鸢尾:水晶般的水体、接近黑色的冰玻璃,强调色#5fb4ffsalon-solitude沙龙独处:玫瑰金午后、薰衣草,强调色#dea998
每套皮肤覆盖背景、表面、文字层级、四个强调色和语义颜色,映射到 DSH 的 --dsh-* 设计 token,从而让侧边栏、编辑器、消息气泡、代码块、菜单等所有组件统一换肤。
壁纸层¶
壁纸层独立于皮肤,可以单独切换。插件自带三张壁纸,并提供「跟随皮肤」「无壁纸」两个选项。将任意图片放入 $DSH_HOME/furina-wallpapers/ 目录,会在壁纸选择器中作为额外选项出现,实现自由壁纸切换。
半透明玻璃 UI¶
玻璃效果分为三种强度:轻柔、标准、浓郁,应用于侧边栏、编辑器、弹窗和设置卡片本身。此外有一个「画面 · Surface」开关,用于关闭细纹质感,使壁纸完全裸露。
设置页内主题控制¶
DSH 原生没有插件设置页槽位,插件通过在设置对话框的导航列表中追加一个导航项,并在其上方覆盖一个 Shadow DOM 容器来呈现主题控制面板。面板包含皮肤卡片(带实时色块预览)、壁纸网格(含「任意壁纸」选项)、玻璃强度、细纹开关、重置功能,以及启动动画和人格预设的入口。
启动动画主题化¶
主题通过注入 <style id="furina-startup-skin"> 覆盖启动动画的 CSS 变量(--dsu-* 系列),使启动画面随当前皮肤变色,同时将壁纸层置于动画之下。启动动画插件本身未被修改,主题只是通过变量控制其外观。
人格预设替换¶
面板中提供人格预设 · PERSONA 区域,可以安装一个基于 preset/furina-preset/ 目录下 preset.yml 元数据和 agent.cordis.yml 提示词生成的 @deepseek-ai/dsh-agent-preset 声明。修改这两个文件或指向其他文件夹,即可替换人格预设而不触碰插件代码。
文件卡片主题化¶
编辑过的文件卡片和已展示文件行使用主题色重绘,不再使用默认白色背景,提升视觉一致性。
侧边栏与文本对比度¶
侧边栏、工作区树、账号芯片和底部导航根据当前皮肤调整色调(--fr-side-* 变量),同时保持正文文本的对比度不低于 4.5:1。
持久化与无残留¶
主题设置存储在 localStorage 的 furina-theme.settings.v1 键下,刷新页面后保持。禁用或删除插件后,所有样式规则和 Shadow DOM 节点被移除,应用恢复到原始状态。
安装与启用¶
使用官方安装命令添加插件:
dsh plugin --profile web add github:TanPass/furina-dsh-theme
安装完成后,在 DSH 的设置对话框中会出现「芙宁娜主题」导航项,点击即可打开主题控制面板。
典型用法¶
- 打开 DSH 设置对话框。
- 点击「芙宁娜主题」导航项。
- 在皮肤卡片中选择一套皮肤(例如「水镜鸢尾」)。
- 在壁纸区域选择一张壁纸,或从本地图片中选择一张放入
$DSH_HOME/furina-wallpapers/目录。 - 调整玻璃强度和细纹开关,使界面呈现预期的质感。
- 在人格预设区域安装芙宁娜人格预设,或根据需要修改
preset/furina-preset/目录下的配置文件。
适用场景与注意¶
该插件适合希望为 DeepSeek Harness 换肤、提升界面统一性和视觉愉悦感的用户。主题以当前 DSH 进程的权限运行,安装前建议检查 GitHub 仓库的源码与许可证(MIT)。
结尾¶
furina-dsh-theme 通过 DSH 的设计 token 体系与 Shadow DOM 注入,在不修改应用源码的前提下提供完整的主题控制。如需查看更多细节,可访问:
- 插件目录页:https://www.skillhub.cn/plugins/TanPass/furina-dsh-theme
- GitHub 仓库:https://github.com/TanPass/furina-dsh-theme