READMESource: main@67b9d8de
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。
No comments yet. Be the first to write one.