前言¶
DeepSeek Harness (DSH) 是一個編程 Agent 工具。其標準 Web 界面功能完備，但視覺風格較爲通用。dsh-theme-minecraft 插件將 DSH 的 Web UI 重新設計爲 Minecraft Java Edition 的風格。它不修改 DSH 核心源碼，而是通過現有 API 掛載一層 UI 變換，提供沉浸式的像素風交互體驗。
插件定位¶
- 項目名稱:
dsh-theme-minecraft - 維護者: 10086ggqq
- 開源協議: MIT
- 核心價值: 將 DSH 的會話管理、Agent 預設、工具調用與審批流程，映射爲 Minecraft 的世界存檔、遊戲模式、物品卡片與紅石機關。
- 零侵入: 不修改 DSH 源碼，僅通過插件機制擴展。經典 DSH 界面原樣保留，可一鍵切回。
核心功能¶
該插件將 DSH 的核心能力遊戲化，具體映射如下：
-
主菜單與全景
- 使用 WebGL 渲染旋轉全景背景，配合像素 Logo 與閃字效果。
- 會話列表以“世界存檔”形式呈現，支持重命名與歸檔（調用真實 API）。
-
模式選擇與 Agent 預設
- 四種 Minecraft 遊戲模式（生存/創造/冒險/專家）對應四種 DSH Agent 預設（standard/ptc/minimal/cordis）。
-
世界內交互
- 聊天台: 在世界內以 HUD 形式展示對話，實時顯示模型與 Token 使用情況。
- 工具卡片: 將
tool/call與tool/result渲染爲像素風格物品卡片。 - 思考跑酷: 當 AI 處於思考或流式輸出狀態時，觸發 Chrome 離線小恐龍跑酷小遊戲（T-Rex Runner）。
- 危險操作審批: 審批面板彈出時跑酷暫停，操作完成後恢復。
- 村民提問: AI 的澄清問題以村民對話氣泡呈現。
-
視聽與特效
- 音效: 使用 WebAudio 合成 8-bit 復古音效。
- 音樂: 支持導入 MP3/WAV/OGG 等格式背景音樂。
- 桌寵: 提供美西螈、貓等互動桌寵與紅石粒子特效。
- 設置中心: 分爲遊戲/AI/世界/音頻/視覺五頁，配置持久化存儲。
安裝與啓用¶
環境要求¶
- Node.js
^22.19或>=24 - 已安裝並配置好的 DeepSeek Harness
安裝命令¶
通過 DSH 的插件管理器安裝：
dsh plugin --profile web add dsh-theme-minecraft
啓動與登錄¶
安裝後，主題隨 dsh web 自動掛載。啓動服務：
dsh web
終端會打印帶有 ?token= 參數的登錄 URL，訪問該 URL 完成登錄。
回退方案¶
若需使用原版 DSH 界面，直接訪問 http://<host>:<port>/index.html。
典型用法¶
-
配置 API Key
- 在主菜單進入“設置”，將 API Key 保存至 DSH 憑據庫。
- 或在環境變量
.env中提供DEEPSEEK_API_KEY。
-
選擇模式
- 在主菜單點擊模式圖標，選擇對應的 Agent 預設（如“生存模式”對應 standard 預設）。
-
操作審批
- 當 Agent 需要執行危險操作（如刪除文件）時，審批面板彈出，跑酷小遊戲自動暫停。允許後恢復。
注意事項¶
- 版權聲明: 本項目以 MIT 協議開源。Minecraft 名稱與官方素材版權歸 Mojang AB / Microsoft 所有。本主題僅作非商用粉絲使用，請勿用於商業產品。
- 運行機制: 插件通過 DSH 的 JSON-RPC/WebSocket API 獲取真實數據，界面上的狀態均爲真實數據來源，無僞造內容。
- 適用人羣: 適合希望將 DSH 界面定製爲 Minecraft 風格的開發者與用戶。
