dsh-theme-picker

English | 中文

为什么叫 picker 而不是 manager：dsh-theme-manager 这个名字在 npm 上已被 runcat-tommy 的同类插件占用（58 个内置主题）。这里换一个不冲突的名字，装的时候别装错。

一个开关管所有主题：装多个主题包也不会互相打架，随时切换、立即生效、首帧不闪。

安装

dsh plugin add dsh-theme-picker
dsh plugin add dsh-theme-dracula-pack   # 再装至少一个主题包

重启一次，然后 设置 → 通用 → 主题。

怎么工作

• 宿主半 扫 node_modules 里所有声明了 dsh.theme 的包，把每个包的 CSS 作为独立 <style> 注入页面（各自 scoped 到 body[data-dsh-theme="<id>"]），再把目录和当前选择写进一段首帧脚本。
• 客户端半 在「设置 → 通用」注册一行主题选择，点一下改 <body data-dsh-theme> 并写 localStorage。

所有主题的样式一开始就在页面里，切换只是改一个属性——没有重新加载、没有网络请求、没有闪烁。

顺带处理了一个坑：Windows 上标题栏那三个窗口按钮由 Electron titleBarOverlay 绘制，桌面壳的取色探针只监听 data-ds-dark-theme 和 style，切换主题后不会自己重测。这里在切换后写一个一次性内联属性把它唤醒，标题栏才会跟着变色。

装一个主题包

在 ~/.dsh/profiles/node_modules/（或任何能按包名解析到的位置）放一个包：

{
  "name": "dsh-theme-solarized",
  "dsh": {
    "bundle": { "patch": "./dsh.bundle.patch.yml" },
    "theme": {
      "id": "solarized",
      "name": "Solarized",
      "colorScheme": "dark",
      "css": "./theme/theme.css",
      "swatches": ["#002b36", "#b58900", "#268bd2"],
      "fonts": { "terminal": "JetBrainsMono NFM, Consolas, monospace" }
    }
  }
}

CSS 自己负责 scope，选择器写成 :root:root body[data-dsh-theme="solarized"]（重复 root 是为了把特异度提到 (0,3,1)，压过内置调色板）。

fonts 是可选字段，按 text / code / terminal 三个角色声明字体栈。终端的字体由 xterm 从主题服务的 store 读取，CSS 变量够不着，所以选择该主题时 picker 会通过 ctx.theme.setFontFamily() 真正写进服务，切走时再交还默认值。

放进去后刷新页面即可，管理器每 2 秒最多重扫一次目录，不用重启 Host。

自带主题

| id | 名称 | 来源 | | --- | --- | --- | | dracula | Dracula | dsh-theme-dracula-pack，配色移植自 PuerJJJ/dsh-theme-dracula-pack（MIT） |

背景图

同一个设置行里还能给界面铺一张背景图：

• 选择图片… 读本地文件，缩到 ≤1920px 后存成 data URL（不进网络、不占大内存）
• 图片 URL 直接贴地址
• 压暗 滑块控制图片上那层 scrim，太亮就往右拉
• 每日必应 / 随机壁纸 两个预置来源

两个预置都是活的：再点一次 每日必应 或 随机壁纸，即使已经选中也会重新取图，随机那张每次点都换一张。选中每日之后，页面每小时核对一次，窗口从后台回来时也会核对，所以跨过零点不用刷新、不用重启就会换图；随机那张会一直留着，直到你再点一次。

文字表面（卡片、输入框、菜单）保持主题色，只有页面底和侧栏透出图片，所以消息区不会被洗白。

两个预置来源的解析发生在宿主进程：cn.bing.com 与 wallhaven.cc 的 API 都不发 CORS 头，浏览器里直接 fetch 会 Failed to fetch。宿主在模块加载时（top-level await）把图片直链解析好写进首帧脚本，并额外提供 /plugins/theme-picker/source?kind=bing 给已经打开的页面；客户端只读直链、把它当 CSS 背景用——图片加载本来就不受 CORS 限制。解析结果缓存到 ~/.dsh/.dsh-theme-picker-sources.json，离线时沿用上一次的图。

注意

• 不要同时安装上游 dsh-theme-dracula-pack 插件本体：它自带 data-dsh-dracula 属性和独立开关，会和这里的 data-dsh-theme 叠色。
• 选择存在 localStorage 的 dsh-theme:active；清掉它就回到 DSH 原生配色。