dsh-theme-aurora: Customizing Background, Frosted Glass Effects, and Interactive Image Layers for the DSH Web Client

前言

长时间在 DSH Web 客户端里写 Harness、调会话时,界面往往是默认主题:背景单一、侧边栏与会话区样式不可分、也很难在不影响阅读的前提下加装饰图。改客户端本体不现实,在 DSH「一切皆插件」的思路下,更合适的是装一个只动外观、配置留在本地的主题插件。下面介绍社区维护的 Aurora 主题(pmqzienbcka/dsh-theme-aurora),它针对 Web 客户端提供背景图、压暗、模糊、毛玻璃、字体与圆角,并支持在页面上自由摆放、变换的图片层。

这是什么

dsh-theme-aurora 是给 DSH Web 客户端用的外观插件:背景图、压暗、毛玻璃、字体、圆角,以及可拖动、缩放、旋转、翻转的图片层。维护者为 pmqzienbcka,源码与说明见 GitHub 仓库;社区目录页为 SkillHub 条目(独立站点,与 DeepSeek / 幻方无官方从属关系)。当前 package 版本为 1.0.3,许可为 MIT。

插件在 Host 侧通过 Cordis patch 注入客户端模块(依赖 @deepseek-ai/dsh-client-ui-theme),Client 侧 immediately: true,安装后可在设置里改外观,无需改 Harness 业务代码。

核心功能

背景与压暗

  • 背景图片:会话页与侧边栏可分别设置;缩放方式支持填充、适应、拉伸、平铺、居中五种。未单独设置侧边栏图片时,一张图可连续铺满整个窗口(含标题栏)。
  • 整体压暗:0–100%,100% 为纯黑。
  • 模糊度:背景图可单独加模糊(0–40px),不影响文字清晰度(修改模糊度并点「应用」会重新生成显示副本,属预烘焙方式)。

毛玻璃

侧边栏与会话顶栏各自独立开关、各自独立模糊度,便于只虚化某一区域而不动全局。

字体与圆角

  • 字体:正文/代码字体可在设置页选择(Host 通过本地路由读取本机已装字体)、调整字号与文字颜色。字号会按比例缩放侧边栏文字(侧边栏以 14px 为基准,范围为基准的 75%–160%)。
  • 圆角:整体缩放界面圆角,范围 40%–200%。

图片层

可添加任意张图片,在页面上直接操作:

  • 拖动位置;拖右下角缩放;拖左上角旋转(靠近 0°、±90°、180° 自动吸附)。
  • 左下角 ⇄ 水平翻转;× 删除。
  • 「变换 · 全部复位」可一次清掉所有旋转与翻转。

图片层只在窗口最大化(或全屏)时显示,绘制在背景之上、会话内容之下;窗口缩小时隐藏但配置保留。位置按会话列的比例保存,收起/展开侧边栏或改变窗口大小时会跟着布局移动;贴着右边界(或越过右边界)的图片改为右对齐,收起侧边栏时保持原位。添加图片后会自动进入布局模式,点底部「应用布局」保存并退出。

安装与启用

README 未给出固定 CLI 安装字符串;应从 SkillHub 目录页 或仓库说明按 DSH 插件惯例安装,安装前请自行审阅 源码 与 MIT 许可证。插件以当前 DSH 进程权限运行,仅信任来源明确的包。

启用后,在客户端 设置 → 主题外观 中调整各项,改动点 「应用」 生效。

典型用法

  1. 安装插件并打开 DSH Web 客户端。
  2. 进入 设置 → 主题外观,为会话区、侧边栏分别选背景图与缩放方式;按需打开压暗、背景模糊、毛玻璃开关。
  3. 调整正文字体、代码字体、字号、文字颜色与整体圆角,点 「应用」。
  4. 若需要装饰图:添加图片层,在最大化窗口下拖动、缩放、旋转或翻转,完成后点 「应用布局」 保存。

配置与图片均留在本机:配置在浏览器 localStorage,图片原始字节在 IndexedDB(不上传、不重编码)。Host 侧仅提供 GET /aurora/fonts 供设置页拉取本机字体列表,不接受外部请求、不写入文件、不联网。

适用场景与注意

适合:长期在 Web 客户端工作、希望会话区与侧边栏视觉分离、或需要在界面里放贴纸/水印式装饰(且不改动 Harness 逻辑)的开发者。

已知限制(来自仓库 README):

  • 字体枚举依赖 Windows 字体目录;非 Windows 会回退到内置常用字体列表。
  • 侧边栏字号按测量结果逐元素缩放,行高与图标不跟随;字号极端时侧边栏可能显得紧凑。
  • 图片层宽度为固定像素,窗口很窄时位置会收拢,必要时被夹回可视边缘;右对齐图片只钉住右边,比窗口还宽时左侧可能被推出可视区。

结尾

dsh-theme-aurora 把 DSH Web 客户端的外观拆成可保存、可复现的配置项,并在最大化窗口下提供可布局的图片层,适合作为本地主题方案而不是改客户端本体。进一步了解或安装请查看 SkillHub 目录 与 GitHub:pmqzienbcka/dsh-theme-aurora。

羽毛球分组比赛记分
小程序二维码

欢迎使用《羽毛球分组比赛记分》微信小程序

Xiaoye