前言¶
DSH 的插件机制允许扩展 Web 界面。如果你希望把 DSH 界面改成 Minecraft 像素风，同时保留纹理管理和本地音乐播放，下面介绍 SuperLS-X 维护的 dsh-minecraft-theme。先说明它解决什么，再给出安装、用法和需要注意的资源边界。
这是什么¶
dsh-minecraft-theme 是面向 DeepSeek Harness（DSH）的 Minecraft 主题插件。它为 DSH Web 界面提供方块纹理背景、像素字体、MC 风格按钮与点击音效，并提供纹理导入/管理和音乐播放器。维护者是 SuperLS-X，许可证为 MIT。
核心功能¶
主题¶
- 提供 21 种官方 Minecraft 方块纹理背景，可一键切换。
- 纹理大小可选：
64 / 96 / 128 / 192 / 256 px。 - 像素字体使用中文 Zpix 与英文 Silkscreen，全界面生效。
- 按钮为 MC 风格灰色浮雕按钮，点击播放 Minecraft 官方
click.ogg音效。 - 漂浮方块粒子为装饰元素，可开关。
纹理管理¶
- 内置 21 个方块与导入/自制纹理放在统一列表，可一键应用。
- 管理操作包括改名、删除（可恢复）、调整顺序（上移 / 下移）。
- 导入纹理支持粘贴图片（
Ctrl+V）、拖入图片、输入本地图片路径 /data URI。 - 自定义纹理、改名和排序保存到本地，重启不丢。
音乐播放器¶
- 内置 16 首 Minecraft 官方原声。
- 播放控制包括播放/暂停、上一首/下一首、音量、可拖动进度条、自动连播。
- 支持选择本地音乐文件夹导入自己的音乐，格式为
ogg / mp3 / wav / flac，数量不限；直接在本地播放，不上传。 - 默认音乐与本地音乐分组显示。
- 内置音乐缓存最多 6 首（LRU），本地音乐流式播放。
安装与启用¶
先确认依赖环境。package.json 声明的 peerDependencies 为：
@deepseek-ai/cordis ^4.0.1
然后按 README 给出的方式安装。下面是资料中的安装指令，直接发送给 DSH：
安装https://github.com/SuperLS-X/dsh-minecraft-theme
经过上面的步骤后，按提示进行确认即可。
典型用法¶
- 侧边栏底部会出现“纹理”与“音乐”两个按钮。
- 点击“纹理”：切换背景纹理、导入/管理自定义纹理。
- 点击“音乐”：选择曲目播放、导入本地音乐文件夹。
- 点击任意按钮都会播放 MC 点击声；打开纹理面板可调整纹理大小、开关粒子。
资源与接口边界¶
这个插件是 DSH rc.7 静态插件（static plugin）。主机端通过 cordis.patch.yml 以 profile bundle 行挂载，浏览器端由 /plugins/<id>/client.js 提供。主机端在 ctx.webServer 上注册 /mc/rpc 路由，供浏览器端 fetch 调用。
本地资源（纹理、字体、音效、音乐）全部在主机进程内读取，不上传。在线时无需任何本地资源即可完整使用。资源加载优先级如下：
- 工作区：
<workspace>/mc-textures/
- 包内自带默认资源。
- CDN 兜底。
如需离线优化，可把资源放进工作区：
<workspace>/mc-textures/zpix.ttf
<workspace>/mc-textures/music/*.ogg
自定义纹理与设置会保存到：
<workspace>/mc-textures/custom-textures.json
适用场景与注意¶
适合在 DSH Web 界面中使用，并需要 Minecraft 风格主题、纹理管理或本地音乐播放的使用者。
安装前注意：
- 插件以当前 DSH 进程权限运行，安装前应先检查源码与许可证。
- 本插件许可证为 MIT。
- Minecraft 是 Mojang Studios 的商标；本插件与 Mojang 无关。
- 默认音乐、音效、纹理来自
InventivetalentDev/minecraft-assets（非商业学习用途），相关版权归其所有者。 - 包内随插件分发的字体 Silkscreen 与 DotGothic16 采用
SIL OFL 1.1协议；Zpix 版权归其作者，仅通过 CDN 按需加载，不随包分发。
结尾¶
dsh-minecraft-theme 的价值在于把 DSH Web 界面改成可切换的 Minecraft 风格，并把纹理和音乐管理收进侧边栏；本地资源在主机进程内读取，不上传。GitHub 地址：
https://github.com/SuperLS-X/dsh-minecraft-theme
