前言¶
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
