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