Agent_Minecraft_Launcher

项目概述

Agent Minecraft Launcher（AMCL）是一款把 AI 助手做进界面的 Minecraft 启动器。常规模式保留完整的启动器操作，AI 模式把对话放在主窗口，两个模式共享实例、下载与设置。AI 可以通过工具调用读取游戏日志与崩溃报告、安装 Mod、创建与备份实例，甚至直接向运行中的游戏发送指令，帮助解决实际游玩中的问题。

一个有 AI 帮手的启动器，报错和装 Mod 都能交给它。

主要功能

• AI 助手：内置对话面板，默认接入 DeepSeek，也支持 Ollama 与 LM Studio 本地模型
• 工具调用：AI 能列实例、搜 Mod、读日志、装 Mod、建实例、改设置
• 游戏内 AI：进入游戏输入 /ai 即可问答与发送指令
• 实例管理：按 PCL2 风格组织版本隔离的实例，共享库与资源
• 整合包导入：支持整合包导入、Mod 启停与一键备份
• Mod 管理：Modrinth 中文搜索、版本过滤与推荐列表
• 依赖分析：离线解析实例内 Mod 的依赖与冲突并绘制关系图
• 指令中心：常用指令模板与每个实例自己的指令库
• 配方分析：中文直查配方，展开完整合成树并汇总材料
• 多种登录：支持离线与正版等登录方式

适用人群

• 想借 AI 排查启动报错的玩家
• 常装 Mod 与整合包的玩家
• 使用本地模型的隐私敏感用户
• 需要脚本化启动器操作的进阶用户

快速上手

1. 从 Releases 选择与系统匹配的包，包括 Windows 标准版、Windows 预装本地 AI 版或 Linux 版
2. Windows 标准版直接运行 exe；本地 AI 版解压后运行；Linux 版解压 tar.gz 后运行
3. 在首次引导中选择游戏目录与登录方式
4. 在「设置 → AI」中填写 DeepSeek API Key，或改用 Ollama / LM Studio 本地模型
5. AI 权限默认只读，需要装 Mod 或发指令时切换为「工作区可写」
6. 可选安装 bridge-mod，让游戏内 AI 获得精确的指令与数据通道

核心优势

• AI 真能动手：不只是聊天，AI 可以直接操作启动器完成任务
• 本地模型可选：用 Ollama 或 LM Studio 时数据不出本机
• 权限可控：默认只读，写操作需要显式切换
• 报错有人管：崩溃看门狗与日志分析帮你定位问题

系统要求

项目	要求
操作系统	Windows、Linux x86_64
分发形式	Windows 单文件 exe、预装本地 AI 的 ZIP、Linux tar.gz
运行环境	需安装 Java（启动器可管理）
AI 服务	DeepSeek API Key，或 Ollama / LM Studio 本地模型

注意事项

• Windows 版未做商业代码签名，首次运行可能出现 SmartScreen 提示
• 可下载预装本地 AI 的版本，避免首次联网下载模型
• 本地 AI 版移动文件夹后需重新运行包内的快捷方式脚本
• 提交 Issue 前请检查日志内容，脱敏不能识别所有个人信息