czzzlq/deepseek-harness-background

DeepSeek Harness Background(主题 Pro)

一个用于 DeepSeek Harness Web UI 的动态 Cordis 主题插件。支持背景(渐变壁纸 / 自定义图片)切换、背景透明度与模糊、强调色、明暗/跟随系统模式,并将设置持久化,跨会话保存。

English

功能特性

- 主题模式:浅色 / 深色 / 跟随系统 三档切换(基于官方 theme 服务)。
- 背景切换:内置 7 种渐变壁纸(默认、海洋、落日、森林、紫罗兰、星空、极光)。
- 自定义背景图片:上传本地图片(≤2MB)作为壁纸,可随时更换。
- 背景透明度:0–100% 滑块,控制壁纸不透明度。
- 背景模糊:0–20px 滑块,营造磨砂玻璃效果。
- 强调色:9 种预设色板 + 自定义取色器,实时修改 --dsw-alias-brand-primary。
- 持久化:设置写入磁盘,插件重新运行时自动恢复。
- 一键重置:恢复默认配置。

目录结构

deepseek-harness-background/
├── host.js      # Host 半:通过 fs 服务持久化设置,暴露 load/save 私有 RPC
├── client.js    # Client 半:主题 UI + 令牌覆盖 + 壁纸样式注入
├── LICENSE      # MIT
└── README.md

使用方法

本插件以 DSH「动态 Cordis 插件」的形式提供:host.js 与 client.js 的内容分别是
cordis_define 的 code.host 与 code.client(纯 JavaScript 函数体,返回一个 Cordis Plugin)。

在 DSH Web GUI 中:

1. 使用动态 Cordis 插件工具(cordis_define),将 host.js 的内容填入 code.host,
将 client.js 的内容填入 code.client。
2. 用 cordis_run 激活。
3. 打开 Web UI 左下角「设置」面板,进入新增的「主题 Pro」页面即可调整。

注意:动态插件是临时的(进程重启后需重新运行)。若要做到「每次启动自动加载」,
需要把它改写为仓库内的持久 Web 插件(写入 host composition 的 web bundle 层)并重建产物。

持久化说明

设置通过 Host 侧的 fs 服务写入 JSON 文件。默认尝试以下位置,按顺序取第一个可写者:

1. C:/Users/33144/.dsh/theme-pro.json(当前开发机的 DSH_HOME 目录)
2. .dsh-theme-pro.json(相对工作区根目录)

请按需修改 host.js 顶部的 paths 数组,将其中的绝对路径替换为你自己的 DSH_HOME 路径
(Windows 通常为 C:/Users//.dsh,macOS/Linux 通常为 ~/.dsh)。

依赖的接口

- Client:theme(令牌覆盖 / 明暗模式)、slots(settings.section 注册设置页)、styles、host、React
- Host:fs(持久化)、harness(私有 RPC)

License

MIT