README
dsh-theme-miyabi · 霜月雅刃
《绝区零》星见雅(Hoshimi Miyabi)主题的 DeepSeek Harness Web UI 皮肤插件。
霜蓝冷调令牌层 × 新艾利都街头复古未来的 CRT 身份层,配一套可调的氛围挂件。
《绝区零》星见雅(Hoshimi Miyabi)主题的 DeepSeek Harness Web UI 皮肤插件。 霜蓝冷调令牌层 × 新艾利都街头复古未来的 CRT 身份层,配一套可调的氛围挂件。

总体效果 —— 桌面客户端、出厂默认设置(界面不透明度 40% / 立绘不透明度 100%)。 这是仓库里唯一一张真实截图;下文其余图片都是示意图。
霜 ── 霜蓝 × 冷紫 × 金线 唯一模式
| 包名 | dsh-theme-miyabi |
| 主题 id / loader 行 id | dsh-theme-miyabi |
| 版本 | 4.1.3 |
| 适配 | DeepSeek Harness 的 Web GUI 与桌面客户端(同一份代码,dsh.client.platform 只有 web 一个合法取值) |
仓库名、包名、主题 id 三者同名(
dsh-theme-miyabi),安装时 profile 的依赖键、 loader 行 id 与ctx.theme里注册的主题 id 都是这一个名字,不会出现「按包名找不到行」的困惑。 4.0.0 之前叫@local/ui-skin-miyabi/ui-skin-miyabi,改名的影响见 CHANGELOG(已有安装需要重装并重启)。
⚠️ 素材版权(先看这一节)
本仓库包含米哈游的版权素材,它们不在 MIT 许可范围内:
| 文件 | 内容 | 权利 |
|---|---|---|
assets/miyabi-wallpaper.jpg |
星见雅「1 月月历壁纸(PC 版)」,2560×1440 | 版权归 miHoYo / HoYoverse |
assets/ref/emblem-source.png |
烈霜位图,2048×2048 | 同上 |
docs/cover.jpg |
仓库顶部那张总体效果图(真实截图,画面里有同一张壁纸与立绘) | 同上 |
-
miyabi-wallpaper.jpg会以 base64 内嵌进构建产物client.js,所以client.js里也带着它。 -
想要一个不含版权素材的版本(推荐分发给别人时用这个):
rm -rf assets/miyabi-wallpaper.jpg assets/ref node tools/build.mjs清空后
client.js从约 1.4 MB 掉到约 130 KB,立绘层自动隐藏(不报错、不留白框), 烈霜仍然在 —— 它走的是assets/emblem.json里的纯轮廓坐标,与位图无关。 细节见assets/README.md。
代码与自制素材(底纹、噪点、警示条、HUD、月相、刀光、粒子运动)随 MIT 分发。
图示

配色板 —— src/30-palette.js 的全部设计色,夜档与昼档。表面色下面垫了浅色棋盘格,
用来显通透度(不然深色低 alpha 的表面在深底上就是一块黑);↓0.92 这类标注是那张表面的
alpha 下限 —— 「界面不透明度」调到 40% 时它不再跟着变透,菜单与代码块才压得住壁纸。
斜纹块表示那一条不是色值(例如描边透明度阶梯 lineA)。
特性
- 令牌层:116 个
--dsw-*设计令牌各给浅深两档取值。夜档是「霜月」,宿主机切浅色时 自动变成昼档「白霜」,不会串成不可读的配色 - 身份层:CRT 扫描线、录像带噪点(
feTurbulence)、暗角与色散边、信号故障、 HUD 四角括号与警示条、斜切网格底纹 —— 全部pointer-events: none - 挂件层(三处纯新增槽位,不动宿主任何东西):
shell.overlay:氛围浮层 + 可拖动的快速控制条(主题开关、强度、霜点档、真实月相)settings.section:「霜月雅刃」控制页settings.general.item:通用设置里的一行速切
- 强度 0–100 无级调节:0 = 只换配色(面板不透明、无氛围),100 = 完整氛围 + 通透面板
- 界面不透明度 40–100%(默认 40%) 与**立绘不透明度 4–100%(默认 100%)**两个独立旋钮 —— 出厂就是「壁纸优先」的样子
- 立绘位置四选一:无 / 贴左(默认)/ 贴右 / 右侧水印
- 烈霜(雪花图样)的形状由
tools/trace-emblem.mjs从位图矢量化而来(回栅格 IoU 0.9981),路径不含颜色,颜色在渲染时给 - 无声音、无网络请求、不收集任何数据:音效模块已整体移除, 所有图形是本地 data URI、无跨域
- 关闭主题即完整还原宿主外观(含把外观偏好还回去)
安装
需要 DeepSeek Harness(dsh)已可用。仓库是插件源码,不需要构建 ——
client.js 已随仓库提交。
1. 拿到源码
git clone https://github.com/InkDemon911/dsh-theme-miyabi.git
2. 以 link 方式装进某个 profile
# <profile> 换成你要用的 profile 名,例如 web、tauri
dsh plugin --profile <profile> add "link:<clone 下来的绝对路径>"
Windows PowerShell 例子:
dsh plugin --profile web add "link:D:\plugins\dsh-theme-miyabi"
3. 确认 bundle 已启用
包声明了 dsh.bundle.patch,装好后应当出现在 profile 的 bundle 列表里:
dsh --profile <profile> --dump-config
应当能看到:
- id: dsh-theme-miyabi
name: 'dsh-theme-miyabi'
disabled: false
如果没有,用插件管理器把这一行启用。
4. 重启 Harness
⚠️ 改 bundle 的启用状态需要重启进程(startup profile 的语义),刷新页面不够。 之后只改
client.js内容才由宿主 HMR 热更新。桌面客户端请整个退出再开。
5. 确认装上了
打开 设置 → 霜月雅刃,能看到控制页即成功。 控制条默认在右下角,是一枚月相小按钮。
卸载
dsh plugin --profile <profile> remove dsh-theme-miyabi
或者只关主题不卸包:设置 → 霜月雅刃 → 关闭并还原宿主外观(幂等,随时开回来)。
使用
| 位置 | 是什么 |
|---|---|
| 设置 → 霜月雅刃 | 控制页:开关、强度、界面不透明度、立绘位置与浓淡、动效与氛围六项、控制条形态、彩蛋、恢复默认 |
| 设置 → 通用 → 霜月雅刃 | 一行速切开关 |
| 右下角快速控制条 | 默认「图标」态:月相小按钮,点开变成长条 |
长条上是:霜 / ·(开关主题)· − 78% + 调强度 · 烈霜按钮循环霜点档 ·
月相按钮(点一下放刀光)· ☰ 快速设置弹层 · — 收回图标态。
按住长条空白处可拖动,位置记进配置,窗口缩小后自动夹回可视区。
可访问性
ESC收起快速设置弹层- 所有控件都是真
<button>/<input type="range">:开关role="switch" aria-checked, 分段控件aria-pressed,滑杆吃原生键盘行为,焦点环走--dsw-focus-ring-color - 系统开启「减少动态效果」时动效一律按关闭处理,霜点与故障层直接不渲染(不是靠 CSS 藏)
- 正文对比度实测:正文/强调文字最差 5.39:1,次级文字最差 3.48:1, 填色按钮文字 6.69–18.51:1,代码高亮最差 4.84:1
- 没有替换系统光标:只改焦点环与选区色(自定义光标需要位图,且在文本/拖拽场景伤可用性)
彩蛋(可关)
- 发送消息时一道斜向刀光(260ms,只动
transform/opacity;动效关闭时不出现) - 在输入框里只输入
miyabi/shimotsuki/霜月/虚狩/星见雅再回车 → 刀光 + 一行「虚狩 · 出雲」浮字 - 面板上的月相是真实月相(按平均朔望月从 2000-01-06 18:14 UTC 那次朔推算),
受光形状用半短轴为
R·|cos 2πp|的椭圆画出来,朔/望/上下弦都退化成正确形状
配置项
全部配置存在浏览器 localStorage,键 dsh-theme-miyabi:cfg:v2(一份 JSON)。
不收集、不上传任何数据,也不使用 IndexedDB。
为什么不用宿主设置文档:第三方令牌层没有写入宿主 settings 的通道 (
ctx.theme.setTheme()只持久化内建偏好light/dark/system), 所以皮肤自己持有状态 —— 这也是生态里其它主题插件的通行做法。
更多「主题与皮肤」插件
dsh-qq2006
作者 laplaceyoung
DSH (DeepSeek Harness) 的 QQ2006 皮肤插件:注册 qq2006 主题、镜像 body[data-ds-skin]、全局皮肤表与完整素材
dsh-beauty-skins
作者 xierw
给 DeepSeek Harness 用的美女系列皮肤:设置里从 哲风壁纸 拉预览网格,点一张即应用,配色从壁纸提取。支持动态壁纸,也保留自定义选图。
deepseek-harness-skin
作者 heigeai
DeepSeek Harness 换肤系统:21 套内置皮肤 + 一张图生成整套配色的自定义皮肤。数据源驱动,保对比度推导,构建期校验可读性。
whaleisle
作者 chisaalter
鲸屿 Whale Isle · DeepSeek Harness 开源社区桌面版:AI 对话、终端与 Git、鲸桥 API/订阅接入、主题壁纸、鲸鱼娘桌宠、用量统计与手机远程连接。Community-enhanced DeepSeek Harness desktop client.
