dsh-theme-miyabi

使用

位置	是什么
设置 → 霜月雅刃	控制页：开关、强度、界面不透明度、立绘位置与浓淡、动效与氛围六项、控制条形态、彩蛋、恢复默认
设置 → 通用 → 霜月雅刃	一行速切开关
右下角快速控制条	默认「图标」态：月相小按钮，点开变成长条

长条上是：霜 / ·（开关主题）· − 78% ＋ 调强度 · 烈霜按钮循环霜点档 · 月相按钮（点一下放刀光）· ☰ 快速设置弹层 · — 收回图标态。 按住长条空白处可拖动，位置记进配置，窗口缩小后自动夹回可视区。

可访问性

• ESC 收起快速设置弹层
• 所有控件都是真 /：开关 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）， 所以皮肤自己持有状态 —— 这也是生态里其它主题插件的通行做法。

键	取值	默认	说明
cfgRev	整数	4	设计基线版本。基线字段升版时自动拉回新默认，用户偏好不动
enabled	bool	true	总开关。关闭 = 摘掉 data-miyabi-skin、撤样式表、卸令牌层、把外观偏好还给宿主
intensity	0–100	78	0 = 只换配色（面板不透明、无氛围）；100 = 完整氛围 + 通透面板。一个变量驱动全部效果层与面板 alpha
panelOpacity	40–100	40	界面不透明度（默认 40%）。只调氛围面板：100% = 设计值，越小画布／侧栏／卡片／气泡／输入框越透、壁纸越清楚。弹层、代码块、选区带 alpha 下限，不会被调到压不住壁纸
art	none left right watermark	left	立绘位置。贴左／贴右按高度贴合并坐在底边，水印是右侧竖直居中；横向超出由窗口裁掉。none 只关立绘、不关主题
artOpacity	4–100	100	立绘浓度（默认 100%）。夜档原样生效，昼档内部乘 0.5 天花板，防止照片压穿浅底文字
motion	full lite off	full	完整（含滚动亮带与故障闪烁）/ 轻微（霜点静止）/ 关闭。系统 prefers-reduced-motion 命中时强制为 off
particles	off low mid high	mid	霜点 0 / 14 / 34 / 64 片，再按视口面积缩放（窄屏自动减量）
scanlines	bool	true	CRT 扫描线（3px 周期一根暗线）
grain	bool	true	录像带噪点（feTurbulence 生成的 SVG，steps(4) 位移闪烁）
vignette	bool	true	暗角 + 左右色散边
glitch	bool	true	信号故障（7.3s 周期里错位闪一下，只在 motion=full 时生效）
hud	bool	true	HUD 四角括号、顶部警示条、虚狩 / 第6課 / H.S.O.S.6 标签
console	off tab bar	tab	快速控制条形态
consolePos	{x,y} 或 null	null	拖动后的位置；null = 右下角 18px
followHostAppearance	bool	false	关（默认）时主题夺取外观偏好、锁夜档；开时让位给宿主：宿主浅色 → 昼档「白霜」，深色 → 夜档
easterEgg	bool	true	发送刀光、暗号浮字、可点的月相

坏值会被归一化（枚举回默认、数值夹到区间、非法坐标丢弃），不会流进样式层。

关于「外观偏好被夺取」：主题切到自己的 id 后，设置 → 外观 里的浅/深/跟随系统 选择框会显示为未选中。想让宿主自己管浅深色，打开 跟随宿主浅深色偏好； 想完全交还控制权，直接关主题。

---