dsh-yoimiya-theme

宵宫主题 · dsh-yoimiya-theme

给 DeepSeek Harness 做的《原神》宵宫主题。

暗色是夏祭夜——烟花在夜色里炸开的暖橙；亮色是和纸昼——和纸米色的暖光。 跟随 DSH 自己的明暗设置切换，不用另外配置。

Web 端和 DSH Desktop 都能装。

效果

左边是首页，右边是对话。注意壁纸的变化：首页时它全亮，一开始对话就自动退到 后面，把屏幕中心让给正文。

亮点

烟花是会动的。 右下角有个烟花按钮。引线带着尾迹升上去，到点炸开，火星受重力 往下落、慢慢熄灭。升起速度、密度、爆炸大小各三档，也可以关掉。

一个装你自己歌单的播放器。 右下角的音乐按钮：封面、播放 / 暂停、上一首 / 下一首、进度条（点击跳转）、音量（记住上次的值），还有可折叠的曲目列表。 曲库就是你电脑上的一个文件夹——把歌丢进去就能播。

壁纸会看你在做什么。 首页全亮，进入对话后退成氛围层，不挡正文。

两档各有各的样子。 亮档不是把暗档反相：夏祭夜是夜里的烟花摊，和纸昼是白天的 和纸与暖光。

画面几乎全是画出来的。 除了那张壁纸，烟花、灯笼、金鱼、波纹、纸纹都是代码 生成的，没有一个像素来自贴图——所以整包很小，换色也只是改数值。

还有几处小的：侧边栏的官方标识换成了自绘的金鱼；选中的会话左边有一道橙色竖条； 输入框的占位文案是宵宫台词。

烟花粒子

点右下角的烟花按钮。

• 升起速度 / 密度 / 爆炸 各三档，另有关闭开关
• 系统开了「减少动态效果」时默认关闭
• 切到别的窗口就停，不在后台耗电
• 面板底部有实时读数（帧率、粒子数）。觉得烟花碍事想关掉之前，可以先看看它到底 占多少

本地音乐播放器

点右下角的音乐按钮。

曲库就是你电脑上的一个文件夹

没有清单文件要维护。一首歌 = 一个音频文件：

<DSH_HOME>/yoimiya-music/
├── 某首歌.mp3
├── 某首歌.jpg        ← 同名图片就是它的封面（可选）
└── 另一首.flac

Windows 上 <DSH_HOME> 默认是 %APPDATA%\dsh-desktop\harness。 打开音乐面板就会显示实际路径，曲库为空时也会显示。

两种添加方式，效果一样

1. 直接拖进去——把音频文件（想配封面就放一张同名的图）丢进上面那个文件夹， 然后收起再打开音乐面板（面板每次打开都会重读目录）
2. 用面板上的「添加歌曲」——选音频（必须）和封面（可选）。封面可以在面板里 拖动、缩放，裁成方图

封面不是必须的：没有封面的歌会显示主题的金鱼。

主题不内置任何音乐。 曲库一开始是空的，里面放什么完全由你决定。

你的文件去哪了

不上传。任何地方都不上传。

「添加歌曲」做的事只有一件：把你选的文件复制进你电脑上的一个文件夹（就是上面 那个 yoimiya-music）。它走的是应用自己的接口，不经过任何第三方服务器。

• 主题不联网——代码里没有任何对外请求，它用到的图片都来自本机
• 你放的歌和封面留在本机，不会被读取、分析或发送到任何服务器
• 卸载主题不会删除你的曲库文件夹——你的文件还是你的
• 唯一的例外是你自己开的远程访问。 主题的接口由 DSH 自己的服务提供，默认只 监听本机；但如果你启用了远程访问，从别的设备打开界面时，播放器读的是 DSH 所在那台机器的曲库。文件仍然没有离开那台机器，只是不再是你手里这台

看着累不累

• 不用纯黑，也不用纯白。 纯黑底配白字，眼睛要在明暗之间反复大幅调节，是长文 阅读最累的一种组合；这里用暖靛黑配暖米白、和纸米配墨棕
• 对比度都量过：暗档正文 13.99:1、亮档 13.28:1。无障碍标准（WCAG AA）要求 4.5:1；次要文字、占位文案、错误 / 成功 / 警告色也各自达标
• 语法高亮是暖色的，换掉了默认那套高饱和的蓝与紫
• 代码块用暖调底色，字体保持等宽，不影响读代码

性能

粒子是唯一一直在跑的东西，所以专门优化过：切到别的窗口自动停，主题被卸载时 相关的东西一并清理干净，画布分辨率会按屏幕大小自动退让——4K 屏上不会白烧电。

这些不用信我说，烟花面板底部有实时帧率和粒子数，自己看一眼就知道。

安装

三种方式任选一种。Web 端与 DSH Desktop 用的是同一个 profile，前两种在两边都 适用；桌面端只是不带 dsh 命令行工具。

应用内插件市场

设置 → 插件 → 搜索 yoimiya → 安装。

条目通过 awesome-dsh-plugin 目录分发；还没上架时，用下面两种方式中的任意一种。

命令行

dsh plugin --profile web add github:CosmerHomura/dsh-yoimiya-theme

（--profile web 指的是 DSH 的 profile 名字，不是"只装给网页版"。）

DSH Desktop 手动安装

桌面端不带 dsh 命令，用仓库里的脚本：

1. 完全退出 DSH Desktop
2. 右键 tools\install-local.ps1 →「使用 PowerShell 运行」
3. 启动 DSH，刷新页面

脚本会先确认 DSH 已退出、备份配置，再执行安装并逐项校验。任一步失败都会停下， 并打印回滚命令。

装好了但界面没变？

1. 先刷新页面（Ctrl+R）
2. 还不行就完全退出 DSH 再启动一次
3. Host 日志里出现这一行就说明装上了：

[yoimiya-theme] Host 半边就绪（9/9 条路由）

卸载

应用内：设置 → 插件 → 找到 dsh-yoimiya-theme → 移除。

命令行：

dsh plugin --profile web remove dsh-yoimiya-theme

手动装的：

& "$env:APPDATA\dsh-desktop\harness\.desktop-bin\pnpm.cmd" `
  --dir "$env:APPDATA\dsh-desktop\harness\profiles\web" `
  remove dsh-yoimiya-theme

卸载后配色与样式会一并撤销，不留残留；曲库文件夹与里面的音乐不受影响。

兼容性

• DSH 0.8.1 及以上
• Web 端与 DSH Desktop 都能用，两边是同一套界面
• 明暗两档跟随 DSH 的 light / dark / system 设置
• 万一粒子画不出来（环境不支持），主题本身照常工作

授权

MIT，见 LICENSE。

角色「宵宫」为米哈游《原神》角色，本主题为非商业同人作品。

---

想改点什么 / 报问题

欢迎 PR，也欢迎提 issue。

这个主题还在继续打磨，已知可以更好的方向：

• 更多意象：更多宵宫相关的配色档，或背景变体
• 播放器：播放模式（单曲循环 / 随机）、歌词
• 粒子：现在这个密度够用了；如果将来想把粒子数做大，渲染方式需要换一种

动代码前有几条值得知道：

• 改 bundle/host.js（本地接口）必须完全重启 DSH 才生效；改 bundle/client.js （样式、粒子、播放器界面）存盘后刷新页面就行
• 改过 assets/ 里的任何图片，要把 bundle/client.js 里的 ASSET_V 加一，否则 新图出不来（浏览器会缓存旧图）
• 明暗两档的标识必须保持同一条鱼——只换颜色，不能只改一份

提交前跑一遍仓库自带的自检：

node tools/verify.mjs          # 配色对比度、禁用项、发布清单、标识几何
node tools/live-check.mjs      # 确认运行中的 DSH 到底在发哪一版
node tools/test-cover-flow.mjs # 封面流程回归
node tools/test-list-songs.mjs # 曲库列举回归

设计推导、改配色与换图的具体步骤，见 DESIGN.md。