mtgacoach——基于人工智能的MTGA教练
《魔术：集结竞技场》的实时人工智能教练。通过原生Windows桌面应用程序观看您的现场游戏并提供口头战略建议，该应用程序具有直接绘制在MTGA之上的游戏内覆盖层。
2.1有什么新功能
- 游戏内覆盖 --透明的点击式覆盖层位于MTGA之上，上面有最新的教练建议、卡片计数管道指示器和每张卡片的突出显示环，用于自动驾驶仪建议的操作。从建议小组的四个角中选择任何一个；当你想要一个无遮挡的视图时，隐藏整个覆盖层。
- BepInEx的地面实况卡位置 --该插件投影每个可见的
DuelScene_CDC通过MTGACamera.MainCamera.WorldToScreenPoint，因此突出显示会精确地落在实际卡片上，而不是从布局启发式中猜测。DPI已校正，因此所有内容在高DPI显示器上都能正确调整大小。 - 带有Draftsmith风格得分的草稿覆面 --每张选秀卡上的徽章显示了等级（弱/青铜/银/金/火）和综合得分。受unexpland.gg方法的启发，每对颜色对得分：每张卡都对所有10对双色对进行评分，并找出最合适的一对。在可用的情况下使用17lands格式的颜色对获胜率，当一组还不在17lands时，则回落到稀有性+CMC+统计数据。
- 自动驾驶不再窃取鼠标 （默认）--当GRE网桥无法提交操作时，autopilot现在会发出
MANUAL REQUIRED: ...建议而不是点击鼠标。新的 回退：建议/回退：鼠标 切换按钮允许您根据需要选择返回鼠标回退。 - 更好的计划稳定性 -计划的温度0（确定性），告诉LLM“你已经提出了X-保持承诺”，以及一个修复的名称错误，该错误放弃了有效的“攻击：Lluwen，不完美的自然主义者”式计划，并回到第一次法律行动。
- 通过网桥选择N/搜索库 --Lluwen风格的ETB搜索现在直接通过网桥提交，而不是按列表索引点击（这是经典的“卡住选择n循环”的原因）。
- 快速/健谈的建议风格 --以前为“简明/详细”；现在的提示实际上不同了。快速是一个祈使句；健谈是一种理性和权衡的对话。
- 错误报告中的截图 --单击调试报告会将教练窗口和MTGA窗口捕获为PNG，将其存储在本地错误报告文件夹中，并在GitHub问题正文中引用它们。
- 封顶桥回退遥测 --当自动驾驶仪错过桥牌时，事件会被缓冲，在比赛结束时，多达5个随机采样的事件会自动无声地报告给GitHub（标记
auto-reported)因此，我们积累了关于哪些动作类型需要桥接支持的覆盖率。 - 草稿包排序 --草稿型检测器（Premier、Quick、Traditional、PickTwo、Sealed和PickTwos变体）现在是唯一的真相来源；对普通草稿的建议是“取X”，而不是旧的“取X或Y”
- 调试报告UX --点击按钮一次；本地报告已保存，路径立即复制到剪贴板。然后，第二个对话框会询问您是否要上传到GitHub，并附上可选的描述。
- 重新启动按钮实际重新启动 --之前向一个无法重新启动的垂死进程发送了一个管道命令。现在，正确停止+重新启动教练，无阻塞，这样你的UI就不会卡顿。
- 启动时控制台不再闪烁 --所有引导子流程调用都使用
CREATE_NO_WINDOW. - 日志过滤器 --查看→ Show Debug Logging现在重新呈现历史记录；默认情况下，自动驾驶仪的运行噪音被降级为调试，具有战略意义
PLAN:摘要保持可见。
特性
- 本机Windows应用程序 --PySide6桌面GUI，深色主题，无控制台窗口
- 游戏内覆盖 --建议面板+使用地面实况Unity位置直接在MTGA上绘制的突出显示环
- 实时辅导 --AI可以看到你的牌、手、生命总数和法律行为
- 语音输出 --Kokoro神经TTS，语音+速度选项
- 语音输入 --在游戏进行到一半时，鼓励提问
- 草稿助手 --按颜色对评分、等级徽章、每张卡叠加
- 自动驾驶 --AI通过BepInEx GRE桥为您播放，无鼠标干扰
- 快速/健谈的建议风格 --简短的命令或解释
- 回放录制 --用于调试和赛后分析的自动比赛记录
- 赛后分析 --每场比赛后的详细回顾
- 自动错误报告遥测 --每场比赛最多5个随机桥接回退事件
- 本地模型支持 --与Ollama或LM Studio一起跑步，享受免费离线游戏
快速入门（Windows）
安装
- 安装 Python 3.10+ （勾选“将Python添加到PATH”）
- 下载 mtgacoach-Setup.exe 从最新版本
- 运行安装程序--它将安装到
Program Files\mtgacoach - 从桌面快捷方式或“开始”菜单启动
- 首次启动：点击“修复”选项卡中的“配置运行时”以创建Python环境
该应用程序在启动时自动启动教练，并自动连接到MTGA。
BepInEx Bridge（游戏内叠加和自动驾驶所需）
GRE桥接插件支持直接访问游戏状态、桥接动作提交和叠加的地面实况卡位置。“修复”选项卡可以为您安装它：
- 打开 修理 标签
- 点击 安装BepInEx （如果尚未安装）
- 点击 安装插件 部署MtgaCoachBridge.dll
- 重新启动MTGA
AI后端
| 模式 | 设置 | 成本 |
|---|---|---|
| 在线的 | 订阅地址： mtgacoach.com，在设置 | 订阅中输入密钥 |
| 本地 | 安装 奥拉玛 | 免费 |
使用在模式之间切换 在线/本地 应用程序中的按钮。
应用程序控制
核心
| 按钮 | 按键 | 动作 |
|---|---|---|
| 在线/本地 | 切换AI后端 | |
| 型号 | 循环可用型号 | |
| 快速/健谈 | F2 | 切换建议风格（简短与对话） |
| 屏幕 | F3 | 通过VLM分析当前屏幕截图 |
| 静音 | F5 | 切换语音输出 |
| 语音 | F6 | 循环TTS语音 |
| 速度 | F8 | 循环TTS速度 |
| 调试报告 | F7 | 保存本地错误报告+可选GitHub上传（截图） |
| 重新启动 | 重新启动教练引擎（非阻塞） |
自动驾驶
| 按钮 | 按键 | 动作 |
|---|---|---|
| AP:OFF/ON | F12 | 切换自动驾驶仪 |
| AP取消 | F1 | 取消当前自动驾驶计划 |
| AP中止 | F4 | 立即中止自动驾驶执行 |
| 回退：建议/鼠标 | 当网桥无法提交操作时，要么发出警告（默认），要么回退到鼠标点击 | |
| 获胜计划 | 读取当前获胜概率 |
叠加层
| 按钮 | 操作 |
|---|---|
| 叠加 | 完全显示/隐藏游戏中的叠加 |
| 建议角 | 循环建议面板浏览MTGA的四个角 |
| 匹配口径 | 在插件检测到的每张卡周围绘制诊断大纲（关闭点击） |
| 卡片 | 在草稿包上切换每张卡片徽章 |
| Calib | 诊断拔模包网格对齐 |
聊天指令
在Coach选项卡底部的聊天框中键入：
| 命令 | 操作 |
|---|---|
| 任何文本 | 问教练一个关于当前比赛的问题 |
/analyze | 对最近一场比赛进行赛后分析 |
/deck | 生成或回忆甲板策略简报 |
/chance | 估计获胜概率 |
/bugreport | 保存+上传错误报告 |
| `/key | |
| ` | 设置您的mtgacoach.com许可证密钥 |
/online, /local | 切换后端 |
故障排除
- 错误的玩家/建议是倒退的 --点击“重新启动”以重新检测座位
- 无语音输出 --TTS型号在首次通话时自动下载（约340MB）。等待下载。
- Ollama连接被拒绝 --确保Ollama正在跑步：
ollama serve - BepInEx/桥接插件丢失 --打开修复选项卡，使用安装BepInEx+安装插件
- 覆盖层不可见 --确保MTGA是带窗口的或无边框的（不是独占全屏）。点击“叠加”进行切换。点击“匹配口径”绘制诊断大纲。
- 叠加位置已关闭 --通常是DPI/缩放变化；单击“重新启动”以刷新几何图形
- 自动驾驶偷鼠标 --确保“回退：建议”是模式（仅限桥接）。如果“回退：鼠标”，当桥无法提交时，自动驾驶仪将点击。
- 运行诊断程序 —
python -m arenamcp.diagnose - 复制调试日志 --点击“调试报告”以保存包含完整游戏状态、重播数据、自动驾驶诊断和屏幕截图的错误报告
发展
对于在repo工作的开发人员：
# Install Python dependencies
python -m pip install -e .[dev,full]
# Run tests
pytest tests -q
# Build the BepInEx plugin
cd bepinex-plugin/MtgaCoachBridge
dotnet build -c Release
# Build the installer (Windows, requires Inno Setup)
iscc installer/mtgacoach.iss许可证
麻省理工学院