前言¶
DeepSeek Harness (DSH) 提供了模塊化構建智能體的能力。jcs130/dsh-minecraft-agent 是一套 DSH 插件，旨在讓任意 Agent 成爲《我的世界》裏的“穿越者”。它通過本地 LLM 驅動，使 Agent 能像真人玩家一樣在遊戲中自主採集、建造、交易、下礦，並通過聊天實現魔法交互。
該插件採用雙端架構，將“世界端”（服務器側）與“穿越者端”（客戶端 Agent）分離，交互完全通過文本進行，Agent 擁有零服務器權限。
核心功能¶
- 零 API 成本：由本地 LLM（如 llama.cpp 或 Ollama）驅動，不消耗雲端 Token。
- 文本即接口：AI 與世界通過聊天交互。施法在公屏唸咒，祈禱通過私聊完成。
- 雙端架構：
- 世界端：處理服務器邏輯與魔法規則，獨佔 RCON 權限。
- 穿越者端：每個 AI 玩家對應一個獨立的 dsh session agent。
- 工具層：封裝了 Mineflayer 的操作能力，包括移動、採集、建造、戰鬥、拾取、合成、裝備、箱子倉儲、交易等。
- 持久化記憶：支持跨重啓保存個人記憶（基地座標、資源點等）。
- 人格檔案庫：內置桐人、鳴人等示例人格檔案。
- 生存知識庫：內置工具
mc_wiki，提供怪物弱點、食物安全等生存知識。 - 第一人稱視覺：支持離屏 WebGL 相機截圖。
- 控制面板：提供實時狀態、3D 視角等 Web 管理界面。
安裝與啓用¶
安裝命令如下：
dsh plugin --profile mc add github:jcs130/dsh-minecraft-agent
安裝後，配置文件 cordis.patch.yml 會注入穿越者側插件，默認創建一個 HarnessBot 穿越者。你可以通過修改配置來定製名字、人設、目標、模型和服務器地址。
典型用法¶
- 啓動本地模型（推薦，免費）：
llama-server -m Qwen3.8-27B.gguf --host 0.0.0.0 --port 8890 -c 524288
設置環境變量指向本地端點，無需雲端 Key。
- 啓動 dsh 並下達指令：
dsh --profile mc "進入方塊世界，砍樹、挖礦、活下去。"
- 運行測試腳本：
npx tsx examples/test-mineflayer.mts
環境要求與注意¶
運行此插件需要滿足以下條件：
- DeepSeek Harness：需要安裝 DeepSeek Harness (developer preview)。
- Node.js：版本需在 22.19+ 或 24+。
- Minecraft 服務端：Java 版，實測版本爲 1.21.11，需開啓 RCON。
- LLM 端點：需要一個 OpenAI 兼容的 LLM 端點（本地或雲端）。
- 權限限制：Agent 擁有零服務器權限，無 RCON、無命令執行權限、無魔法 ID 表權限。
- 依賴關係：依賴 peerDependencies，包括
@deepseek-ai/cordis及相關 dsh 核心包。
總結¶
jcs130/dsh-minecraft-agent 將 DeepSeek Harness 的“一切皆插件”理念延伸至沙盒遊戲。它通過本地 LLM 和聊天驅動，爲 Agent 提供了低成本的 Minecraft 生存環境，並提供了完善的人格記憶與工具鏈。
更多細節與源碼，請訪問：https://github.com/jcs130/dsh-minecraft-agent
