dsh-theme-picker
为什么叫 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）把图片直链解析好写进首帧脚本，客户端只读直链、把它当 CSS 背景用——图片加载本来就不受 CORS 限制。解析结果缓存到 ~/.dsh/.dsh-theme-picker-sources.json，离线时沿用上一次的图。
注意
- 不要同时安装上游
dsh-theme-dracula-pack插件本体：它自带data-dsh-dracula属性和独立开关，会和这里的data-dsh-theme叠色。 - 选择存在 localStorage 的
dsh-theme:active；清掉它就回到 DSH 原生配色。