DeepSeek Harness 主题插件 dsh-x9-theme

前言¶

DeepSeek Harness (DSH) 的设计理念是“一切皆插件”。对于开发者或使用者而言，在保持系统功能稳定的前提下调整界面风格，通常需要直接修改源码或使用复杂的开发者工具。dsh-x9-theme 插件通过官方插件机制提供了一套外观定制方案，无需构建前端，且不影响 DSH 源码。

简介¶

dsh-x9-theme 是 DeepSeek Harness WebUI 主题插件（bundle 包）。它提供预设风格、明暗模式切换、分区独立样式定制以及背景管理等功能，支持配置持久化与分享。

安装¶

在终端执行以下命令安装插件：

dsh plugin --profile web add github:X9wd09ncc/dsh-x9-theme

安装完成后，重启 DeepSeek Harness 服务。

核心功能¶

预设风格与明暗模式¶

插件提供极光、午夜、樱花、森林等多种预设风格。同时支持明暗模式，可选择跟随系统、浅色或深色。

分区独立样式¶

侧边栏、输入框、对话气泡（用户/AI）、页面背景等区域可独立定制样式，包括毛玻璃、霓虹描边、浮雕、渐变等效果。

背景定制¶

支持本地上传、本地路径、URL 链接或内置渐变作为背景。
* 本地路径限制：扩展名需在白名单（jpg/jpeg/png/gif/webp/avif/svg/bmp）内，且文件不超过 8 MiB。
* 上传机制：本地上传的图片存入插件 assets 目录，重启不丢失。

自定义 CSS 与透明度¶

• 分区自定义 CSS：提供编辑器，免 F12 即可显示当前区域的实际样式并直接修改。命名空间冲突时，自定义 CSS 优先级较高。
• 四区透明度：主区、侧边栏、卡片浮层、输入区透明度独立调节，支持自动参考值（启用背景后自动调整）。

配置持久化与分享¶

所有设置自动写入插件目录的 config.json。在设置面板的“高级”区可导入、导出配置，方便分享主题给他人。

生效与更新¶

• 生效：修改 lib/client.js（浏览器端）后刷新页面即可生效；修改 lib/index.js（Host 路由）需重启服务。
• 更新：重新执行安装命令即可覆盖更新。

注意事项¶

1. 前置要求：需已安装 DeepSeek Harness。
2. 版本兼容：DSH 大版本升级后，CSS 类名可能发生变化，自定义 CSS 需相应更新。
3. 背景模式：背景风格层（如赛博网格、星空）均为深色底，选择后会自动切换深色模式以保证可读性。
4. 配置重置：删除插件目录下的 config.json 或在面板“高级”区点击“重置全部”可恢复默认。