dsh-mc-agent 🧱

让 AI 陪你玩 Minecraft：DeepSeek Harness 里的 AI 代理，能自主生存、探索、挖矿、聊天、看地图——顺便把启动器（版本下载 + 微软登录 + 游戏启动）也一起做了。 UNOFFICIAL — 非官方项目，与 Mojang Studios / Microsoft 无任何关联。

📖 项目简介

dsh-mc-agent 是 DeepSeek Harness（DSH）的一个正式 bundle 插件，让「AI 玩 Minecraft」成为 DSH 的一等公民：

• AI 代理：通过 LAN 协议直连游戏，驱动真实的 Mineflayer 机器人——自主生存（采集/探索/岩浆水逃生）、挖矿砍树、游戏内聊天、实时地图；另有截图/识图/键鼠控制（视觉 + 控制闭环）。
• AI 工具：把游戏数据与能力暴露为 mc_* 工具，让 DSH 的 agent 能通过对话指挥机器人、分析崩溃、查询存档与模组。
• 内置启动器：宿主进程负责版本清单、文件下载、Microsoft 登录与 Java 游戏进程的启动；游戏目录默认 ~/.minecraft，与官方启动器完全兼容（已有版本、存档、资源直接复用）。
• 双界面模式：默认作为 DSH 聊天界面里的一个 "Minecraft" 标签页（保留全部 AI 能力）；也可切换为全屏启动器。

✨ 功能特性

• ✅ 官方版本清单（release / snapshot / 远古版本），已安装自动标记
• ✅ 一键安装：client jar + libraries（natives 自动解压）+ assets，断点续传（已存在且大小匹配的文件跳过）
• ✅ 启动游戏：按版本 JSON 组装 Java 命令（自动展开 ${natives_directory}、${classpath} 等占位符）
• ✅ Java 自动探测：优先使用官方启动器下载的 ~/.minecraft/runtime/**/bin/java，其次 PATH 中的 java
• ✅ Microsoft 账号登录：设备码流程（默认，可靠，推荐）；浏览器授权码登录（PKCE）需额外配置回调地址，作为高级备选
• ✅ 中文界面 + 新手引导：默认中文；首次使用弹出四步引导（配置 client id → 登录 → 选版本安装 → 开始游戏）
• ✅ Agent 工具集：mc_list_versions / mc_install / mc_launch / mc_kill / mc_logs / mc_status——AI 通过对话操作启动器
• ✅ AI 崩溃分析：mc_analyze_crash 读取崩溃报告与日志，交给 LLM 诊断并给修复建议
• ✅ AI 游戏助手：mc_world_info（存档时长/死亡）、mc_mods（模组清单）、mc_version_advice（版本建议）
• ✅ AI 自主生存（框架）：mc_set_goals / mc_goals / mc_complete_goal——AI 根据用户人设自动设立 ≥20 个目标并逐个推进、持久化到磁盘
• ✅ 视觉 + 控制（端到端）：mc_screenshot（X11 截图游戏窗口）+ mc_see（DashScope Qwen-VL 视觉理解画面）+ mc_control（xdotool 模拟键鼠）——AI 能"看"画面、理解处境、"操作"游戏
• ✅ Mineflayer 机器人（快速模式）：mc_bot_* 工具通过 LAN 协议直连游戏，实时读内存数据（位置/背包/血量/周围方块）+ 精确控制（移动/挖掘/放置/转向），比截图快几个数量级
• ✅ 双界面：标签页模式（与 AI 聊天共存，默认）或全屏启动器模式；可单独开关"会话中是否显示 Minecraft 标签"
• ✅ 主题自定义：5 套预设（森林/石板/海洋/末地/熔岩）+ 自定义强调色，即时生效
• ✅ 版本选择框：下拉分组选择（已安装/Release/Snapshot/Old），不再被超长列表占据版面
• ✅ 登录引导：未登录时醒目标语横幅 + 点 PLAY 直接唤起登录
• ✅ 游戏日志实时显示、停止游戏、内存/分辨率/Java 路径等设置

⚖️ 法律合规（请先阅读）

本项目以 Mojang EULA（Minecraft 最终用户许可协议） 与 微软服务协议 为合规基线，设计要点：

事项	本项目做法
第三方工具许可	EULA 明确允许开发工具/插件/启动器，前提是"看起来不是官方项目"——本项目在界面与文档中显著标注 UNOFFICIAL，不模仿官方启动器外观，不使用 Mojang 官方徽标
游戏文件分发	本项目不包含、不分发任何 Mojang 游戏内容；所有游戏文件均由启动器从 Mojang 官方服务器（launchermeta.mojang.com、piston-meta.mojang.com、resources.download.minecraft.net）下载，符合"所有游戏下载和更新都来自我们授权的来源"
账号要求（必须）	不提供离线模式。游玩必须使用用户自己的微软账号登录（设备码流程）——EULA 规定使用游戏的前提是"您购买我们的游戏后"，绕过账号验证的启动方式（如离线模式）不在本项目范围内。首次使用会弹出 EULA 同意确认
商标	"Minecraft" 仅作兼容性指称（nominative use）；界面文字为纯文本样式，不使用官方 logo/资产
Microsoft 登录	使用你自己注册的 Azure 应用 client id（见下），不使用他人注册的 client id——这是微软应用条款的要求
隐私	无遥测、无第三方统计；账号 token 仅保存在本机 ~/.dsh-mc/account.json（权限 600）

⚠️ 本项目不用于规避付费、分发盗版或冒充官方。请尊重 Mojang 的知识产权与社区规则；未购买 Minecraft 请勿使用本启动器。

注册自己的 Azure client id（登录必需）

1. 打开 Azure 门户 → App registrations → New registration
   • 名称随意；Supported account types 选 "Accounts in any organizational directory and personal Microsoft accounts"
2. 进入新应用 → Authentication → 勾选 "Allow public client flows" → Save
3. 复制 Application (client) ID → 填入启动器 设置 → Microsoft client id
4. 点 Sign in，按弹窗提示在浏览器打开链接并输入设备码即可

🚀 快速开始

环境要求：Node.js 18+（含全局 dsh CLI，v0.1.0-rc.6）、DSH 宿主环境、Java（启动游戏需要；可自动探测 ~/.minecraft/runtime）。

方式 A：安装进已有 DSH profile（简单）

# 1. 克隆插件
git clone https://github.com/hellosky983/dsh-mc-agent.git
cd dsh-mc-agent

…