dsh-mc-agent

主要功能

• 驱动 Mineflayer 机器人通过 LAN 协议直连游戏，实现自主生存、挖矿、探索、聊天与实时读取位置/背包/血量等数据
• 提供截图 + Qwen-VL 视觉识别 + xdotool 键鼠模拟的视觉/控制闭环，让 AI 能看画面、做操作
• 内置 Minecraft 启动器：官方版本清单浏览、断点续传下载、Java 自动探测与游戏启动/停止
• 支持 Microsoft 设备码登录，需使用用户自行注册的 Azure client id，不提供离线模式
• AI 崩溃分析、存档信息查询、模组清单、版本建议等辅助工具
• 支持自主目标模式，AI 根据设定人设自动生成并推进 ≥20 个游戏目标，持久化到本地

适合什么时候用

• 想在 DSH 里让 AI 自主玩 Minecraft（挖矿、探索、生存）并通过对话观察/指挥它
• 不想额外装官方启动器，希望在 DSH 内直接下载版本、微软登录并启动游戏
• 游戏遇到崩溃或需要模组/存档信息时，希望 AI 直接读日志给出诊断建议

安装后会多出什么

使用前需要

• 需要 Node.js 18+ 与 DSH 宿主环境（README 标注在 DSH 0.1.0-rc.6 实测）
• 启动游戏需要本机 Java（不同 MC 版本对 Java 版本有要求）
• 必须使用自己购买的 Minecraft 账号，通过自行注册的 Azure 应用 client id 完成 Microsoft 设备码登录，不支持离线模式
• mc_see 视觉识别功能需要 DASHSCOPE_API_KEY（调用 DashScope Qwen-VL）
• 截图/键鼠控制功能依赖系统工具 xdotool / ffmpeg（X11 环境）