dsh-theme-aurora

中文文档
1.0.2发布于 2026/11/03MITES Module零依赖

Aurora theme: background pictures, frosted glass, dimming, typography, corner radius and freely placed pictures for the DSH Web client.

原始使用文档
文档目录6 节
  1. 功能
  2. 使用
  3. 存储与隐私
  4. 已知限制
  5. 开发
  6. 许可

Aurora 主题

给 DSH Web 客户端用的外观插件:背景图片、毛玻璃、压暗、字体、圆角,以及可以自由摆放的图片层。

功能

  • 背景图片:会话页与侧边栏可分别设置,支持填充 / 适应 / 拉伸 / 平铺 / 居中五种缩放;未设置侧边栏图片时,一张图连续铺满整个窗口(含标题栏),可整体压暗 0–100%(100% 为纯黑)。
  • 模糊度:背景图可单独加模糊(0–40px),不影响文字。
  • 毛玻璃:侧边栏与会话顶栏各自独立开关、独立模糊度。
  • 字体:正文/代码字体选择(Host 侧读取本机已装字体)、字号、文字颜色。
  • 圆角:整体缩放界面圆角(40%–200%)。
  • 图片层:添加任意张图片,在页面上直接拖动、拖右下角缩放、点 × 删除;只在窗口最大化时显示,绘制在背景之上、会话内容之下。

使用

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

存储与隐私

  • 配置存在浏览器 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。

版本与发布记录

dsh-theme-aurora 共发布 4 个版本,首次发布于 2026/11/03;过去 12 个月发布了 4 个版本。

版本发布日期距今
1.0.2latest2026/11/03今天
1.0.12026/11/03今天
1.0.02026/11/03今天
0.0.0-stage2026/11/03今天

关于 dsh-theme-aurora 的常见问题

dsh-theme-aurora 是什么?

极光主题:背景图片,磨砂玻璃,调光,排版,角半径和自由放置图片为DSH Web客户端。

如何安装 dsh-theme-aurora?

在项目目录运行 npm install dsh-theme-aurora,或使用 pnpm add / yarn add / bun add。

dsh-theme-aurora 支持 TypeScript 吗?

该包的 package.json 没有声明类型入口。需要类型提示时,可以在 npm 上查找社区维护的 @types/dsh-theme-aurora 是否存在。

dsh-theme-aurora 支持 ESM 还是 CommonJS?

以 ES Module 形式发布,推荐使用 import 引入。在 CommonJS 项目中,Node.js 20.19+ / 22.12+ 可以直接 require() 不含顶层 await 的 ES Module,更早的版本需要改用动态 import()。

dsh-theme-aurora 可以商用吗?

dsh-theme-aurora 使用 MIT 许可。宽松许可:允许商业使用、修改和再分发,通常只需在分发时保留原版权与许可声明。以上为概括,不构成法律意见,请以许可原文为准。

dsh-theme-aurora 还在维护吗?

最新版本 1.0.2 发布于 2026/11/03(今天);至今共发布 4 个版本,其中过去 12 个月发布了 4 个;首次发布于 2026/11/03。发布频率只是参考信号:功能稳定的工具可能很少需要更新,建议结合源码仓库的 issue 和提交记录判断。