前言¶
DeepSeek Harness 的界面定制通常需要深入修改设计系统的核心文件。如果希望在运行时调整配色、面板透明度或添加背景图,而不触碰原有的主题代码,需要一个独立的配置层。dsh-style-hub 旨在通过一个插件卡片,提供一套无需编写样式表的视觉定制方案。
插件定位¶
这是一个面向 DeepSeek Harness Web GUI 的主题工作室插件,由 Au1314 维护。它是一个组合插件(包含主机端与浏览器端),旨在通过插件卡片提供外观管理能力,而不是替换整个主题系统。该插件遵循 MIT 许可证。
核心功能¶
- 预设样式:内置 8 套配色方案(如 Nord、Dracula、Tokyo Night 等),直接作为一级主题注册,利用设计系统的 token 目录工作,而非覆盖样式表。
- 精细调整:提供品牌强调色和面板透明度滑块,支持将面板设为半透明,从而透出背景。
- 主机端壁纸库:支持上传本地图片至 Host 端,提供封面、透明度、模糊和变暗参数的实时预览。
- 组合插件:同时作用于主机端与浏览器端。
安装与启用¶
在 DSH Desktop 的 Web 配置文件目录下进行操作:
- 解压包到该配置文件目录下的
node_modules,并重命名为插件名:
tar -xzf dsh-style-hub-0.1.0.tgz && mv package dsh-style-hub
- 在该配置文件的
package.json中,将"dsh-style-hub"添加到dependencies和dsh.profile.bundles。 - 重启应用以使配置生效。
典型用法¶
- 打开 设置 → 插件 → 插件配置 → Style Hub。
- 选择一个样式芯片,或保持 Stock 不变以保留原有外观。
- 拖动 Accent(强调色)和 Panel opacity(面板透明度)滑块进行微调。
- 选择或上传壁纸,设置其 Fit(适配方式)、Opacity(不透明度)、Blur(模糊)和 Dim(变暗)参数。
适用场景与注意¶
- 依赖要求:宿主环境需要已安装
dsh-client-ui-settings-plugins、dsh-client-ui-theme和dsh-client-locale。运行时 peer 依赖范围为>=0.1.5-rc.2 <0.2.0。 - 文件限制:支持的壁纸格式为 PNG、JPEG 和 WebP,单文件最大 15MB。
- 安全机制:写入操作要求同源(Same-host Origin/Referer),以防止跨站请求伪造。
- 渲染限制:当壁纸显示时,画布渲染会被限制。
- 开关控制:关闭主开关可恢复至原始外观,该插件不会持久化决定“正常”外观应该是什么。
总结¶
通过 dsh-style-hub,可以在不修改核心主题代码的情况下,快速定制 DeepSeek Harness 的视觉风格。更多细节可参考官方目录或 GitHub 仓库。