炉石传说AI助手：当大语言模型遇上卡牌策略游戏

本文介绍开源项目「炉石对局Agent助手」，这是一款基于Electron框架的桌面应用，通过解析炉石传说游戏日志和屏幕截图，将结构化对局数据发送给大语言模型进行战略分析，核心设计理念为「只读」和「隐私优先」，不进行任何自动化操作，仅提供决策参考。项目由CuZaoo维护，源码托管于GitHub（链接：https://github.com/CuZaoo/hearthstone-agent-assistant），更新时间为2026-06-08。

随着大语言模型（LLM）技术发展，AI已渗透到数字生活各领域。在策略类卡牌游戏中，AI潜力显著。炉石传说作为经典数字卡牌游戏，策略深度复杂，玩家需在对局中做出最优决策。该项目将LLM推理能力与游戏日志解析技术结合，为玩家提供智能化战略建议。

日志解析引擎

项目采用手写状态机解析器处理炉石Power.log日志，识别TAG_CHANGE、SHOW_ENTITY等事件，支持多GB日志处理、SHA1去重、文件轮转及会话日志自动发现。

游戏状态快照

将日志转换为GameStateSnapshot对象，包含回合数、法力水晶、手牌、随从等结构化信息，为AI分析提供基础。

隐私保护机制

数据脱敏处理：移除敏感信息（实体标签、玩家名称、时间戳），仅白名单数据离开设备。

视觉校验系统

通过截图（本地使用，不传输）与dHash算法验证卡牌位置，比对内置卡牌目录确保数据准确性。

多模型兼容

支持OpenAI、DeepSeek、智谱GLM等9+主流AI服务商及本地Ollama部署，用户可按需选择。

双API模式

兼容Responses API和Chat Completions API，适应不同服务商规范。

结构化输出

优先使用json_schema格式，不支持则降级为json_object，本地校验确保合法性。

创新功能

• 并行多模型查询：配置多个模型并行请求，按置信度排序融合结果。
• 采纳率追踪：对比回合状态快照，自动识别玩家采纳的AI建议，追踪各模型历史采纳率。

应用采用三窗口设计：

1. 完整仪表盘窗口：无边框可缩放，展示详细对局分析与AI建议。
2. 透明悬浮窗：始终置顶，显示关键信息便于快速参考。
3. 最小化拖拽球：收缩为可拖拽小球，不干扰游戏视野。 快捷键：Ctrl+Shift+A触发分析，Ctrl+Shift+O切换悬浮窗显示。

四层架构

• core/：纯业务逻辑层，无Electron/React依赖，便于测试复用。
• main/：Electron主进程，负责窗口管理、文件访问等原生功能。
• renderer/：React UI层，处理渲染与交互。
• shared/：共享类型定义与默认配置。

加密凭据存储

API密钥通过Electron safeStorage加密存储（Windows用DPAPI），不明文保存。

应用场景：

• 新手：学习卡牌交互与策略选择。
• 进阶玩家：多角度策略参考，发现致胜路线。
• 内容创作者/分析师：结构化数据用于深度复盘与分析。 项目价值：展示LLM与传统游戏结合的合规范式，「只读」设计保障账号安全与公平竞技。

该项目代表AI应用新模式：增强而非替代人类决策。通过技术将游戏状态转化为AI可理解数据，借助LLM提供建议，最终由玩家决策。此模式在游戏领域前景广阔，也为其他领域AI辅助决策提供参考，未来将有更多AI与人类创造力结合的创新应用。