概览
dsh-minecraft-theme
README / ZH
插件文档
目录摘要
dsh.pub 核对固定版本的组合包契约、运行时事实与分发语义；完整 README 请查看源仓库。
在 GitHub 阅读完整 READMELIMITATIONS
已知限制
- **渲染效果未由机器验证**：从命令行安装并校验（CSS 可解析、模块可加载、插槽已注册、资源路由 200/404、构建产物语法通过、自检脚本全绿），但像素级视觉与听感需要人眼人耳确认。 - 5 个音效样本随包发布（Mojang 素材，不在 MIT 许可内）；若它们被移除，插件会自动使用**合成音效**，功能不受影响。 - 音乐与额外壁纸不随仓库发布（版权原因），需要使用者自备或界面上传。 - 依赖 DSH 的主题令牌与 `data-ds-dark-theme`、`data-dsh-surface` 等语义属性；DSH 大版本改版后若令牌更名，需同步调整 `src/10-store.js` 的 `MC_STOCK_PROBE` 列表（缺失时自动退回内置兜底色）。 - HUD 的微调是启发式的：输入框布局若大改，最多回到固定右下角，不会错位到屏幕中间。 - `shell.overlay` 是点击穿透层，HUD 与弹窗已显式 `pointer-events: auto`。 - 未发生任何点击/按键前不会创建 AudioContext，这是浏览器策略而非缺陷。 - 上传的壁纸与音乐存在浏览器 IndexedDB：换浏览器、清站点数据、无痕窗口关闭后会丢失；插件目录里的文件不受影响。 - BGM 曲目按文件名排序；目录清单在页面加载时拉取，新放进目录的文件刷新后才出现（界面上传的立刻出现）。 - 浏览器对 ogg/opus、部分 flac 的 `decodeAudioData` 支持有限（Safari 尤其），解码失败会跳过该曲并 warn。 ---