Skip to content

dsh-theme-aurora

Verified

dsh-theme-aurora · v1.0.4 · MIT · Web UI

Background pictures, dimming, frosted glass, fonts and corner radius, plus freely placed pictures you can move, resize, rotate and mirror, for the DSH Web client.

Install

dsh plugin add dsh-theme-aurora

Confirm the layer applied with dsh --profile default --dump-config — see the install guide.

Source

Tags

Creators

Readme

Aurora 主题

给 DSH Web 客户端用的外观插件:背景图、压暗、毛玻璃、字体、圆角,以及可拖动、缩放、旋转、翻转的图片层。

安装

插件已发布到 npm,包名 dsh-theme-aurora。二选一:

  • 图形界面:设置 → 插件 → 添加插件,输入 dsh-theme-aurora。
  • 命令行:
dsh plugin --profile desktop add dsh-theme-aurora

把 desktop 换成你在用的 profile 名(应用内市场给出的命令里用的是 web)。装完重启 DSH。

不建议用源码方式安装(add github:pmqzienbcka/dsh-theme-aurora):那会装仓库当前 HEAD,可能包含尚未发布到 npm 的改动,只适合开发者自测。

功能

  • 背景图片:会话页与侧边栏可分别设置,支持填充 / 适应 / 拉伸 / 平铺 / 居中五种缩放;未设置侧边栏图片时,一张图连续铺满整个窗口(含标题栏),可整体压暗 0–100%(100% 为纯黑)。
  • 模糊度:背景图可单独加模糊(0–40px),不影响文字。
  • 毛玻璃:侧边栏与会话顶栏各自独立开关、独立模糊度。
  • 字体:正文/代码字体选择(Host 侧读取本机已装字体)、字号、文字颜色。字号同时按比例缩放侧边栏文字(侧边栏字号由自身样式写死,按 14px 基准换算,范围为基准的 75%–160%)。
  • 圆角:整体缩放界面圆角(40%–200%)。
  • 图片层:添加任意张图片,在页面上直接拖动、拖右下角缩放、拖左上角旋转(靠近 0°/±90°/180° 自动吸附)、左下角 ⇄ 水平翻转、× 删除;「变换 · 全部复位」可一次清掉所有旋转与翻转。只在窗口最大化时显示,绘制在背景之上、会话内容之下。位置按会话列的比例保存,收起/展开侧边栏或改变窗口大小时图片会跟着布局移动;贴着右边界(或越过右边界)的图片改为右对齐,收起侧边栏时保持原位、不会被推出窗口。

使用

安装后在 设置 → 主题外观 中调整,改动点「应用」生效。图片层添加后会自动进入布局模式,点底部的「应用布局」保存并退出。

存储与隐私

  • 配置存在浏览器 localStorage,图片以原始字节存在 IndexedDB(不上传、不重编码,仅在绘制时生成屏幕尺寸副本)。
  • 插件的 Host 半边只提供了一个本地路由 GET /aurora/fonts,用于把本机字体列表交给设置页;它不接受外部请求、不写入文件、不联网。

已知限制

  • 字体枚举依赖 Windows 字体目录,非 Windows 环境会回退到内置常用字体列表。
  • 侧边栏字号是「按测量结果逐元素缩放」,行高与图标不跟随:把字号拉到极端值时侧边栏会显得紧凑。
  • 「图片层」只在窗口最大化(或全屏)时显示;窗口缩小时隐藏但配置保留。
  • 图片层保存的是「相对会话列的比例」,图片自身的宽度是固定像素:窗口变得很窄时,位置会一起收拢,必要时会被夹回可视区域边缘。
  • 右对齐的图片只钉住右边,右边界以外的部分刻意不夹回:图片比窗口还宽时,左侧可能被推出可视区。
  • 图片模糊是预烘焙的:修改模糊度并点应用会重新生成一次显示副本。

开发

仓库根目录:

  • index.js / lib/fonts.mjs:Host 半边(字体枚举与路由)。
  • client.js:Client 半边(设置页与运行时样式)。
  • scripts/asar.mjs、scripts/probe.mjs:排查已打包客户端用的临时工具,不随插件发布。

许可

MIT,见 LICENSE。