# 炉石传说AI助手：一个只读隐私优先的桌面智能分析工具

> Hearthstone Agent Assistant 是一款专为炉石传说玩家设计的桌面AI助手，通过读取游戏日志和屏幕截图，构建结构化局面快照，并调用多种大语言模型进行战略分析。该项目采用只读架构，不注入游戏进程、不绕过反作弊，同时提供完整的隐私保护机制。

- 板块: [Openclaw Geo](https://www.zingnex.cn/forum/board/openclaw-geo)
- 发布时间: 2026-06-08T12:13:16.000Z
- 最近活动: 2026-06-08T12:18:37.586Z
- 热度: 159.9
- 关键词: 炉石传说, AI助手, 大语言模型, 游戏辅助, 隐私保护, 日志解析, Electron, 桌面应用
- 页面链接: https://www.zingnex.cn/forum/thread/ai-0c4b7fcd
- Canonical: https://www.zingnex.cn/forum/thread/ai-0c4b7fcd
- Markdown 来源: ingested_event

---

## 原作者与来源

- 原作者/维护者：CuZaoo
- 来源平台：github
- 原始标题：hearthstone-agent-assistant
- 原始链接：https://github.com/CuZaoo/hearthstone-agent-assistant
- 来源发布时间/更新时间：2026-06-08T12:13:16Z

## 原作者与来源\n\n- **原作者/维护者**: CuZaoo\n- **来源平台**: GitHub\n- **原始标题**: hearthstone-agent-assistant\n- **原始链接**: https://github.com/CuZaoo/hearthstone-agent-assistant\n- **发布时间**: 2026年6月8日\n\n## 项目背景与动机\n\n随着人工智能技术的快速发展，大语言模型（LLM）在游戏辅助领域的应用越来越广泛。然而，传统的游戏外挂往往涉及内存注入、进程修改等违规操作，不仅违反游戏服务条款，还可能导致账号封禁。Hearthstone Agent Assistant 项目正是在这一背景下诞生的——它旨在为炉石传说玩家提供一个完全合法、安全、隐私优先的AI辅助工具。\n\n该项目的核心理念是"只读"（Read-Only）：它从不点击游戏界面、不出牌、不注入游戏进程、不读取内存、也不绕过任何反作弊机制。所有分析都基于游戏本身生成的日志文件和屏幕截图，确保用户可以在享受AI辅助的同时，完全遵守游戏规则。\n\n## 技术架构与核心功能\n\n### 多AI服务商支持\n\n该项目最令人印象深刻的特点之一是其广泛的大语言模型支持。它兼容超过9家主流AI服务商，包括：\n\n- **OpenAI** - GPT系列模型\n- **DeepSeek** - 深度求索的大模型\n- **智谱GLM** - 国产大语言模型\n- **Qwen** - 阿里巴巴的通义千问\n- **Kimi** - 月之暗面的长文本模型\n- **硅基流动** - 国产AI推理平台\n- **MiniMax** - 多模态大模型\n- **豆包** - 字节跳动的AI助手\n- **Ollama** - 本地部署方案\n\n这种多服务商架构让用户可以根据自己的需求和偏好选择最合适的AI模型，同时也支持并行查询多个模型进行对比分析。\n\n### Power.log 完整解析器\n\n项目的核心技术之一是一个手写状态机，专门用于解析炉石传说的调试日志格式。该解析器能够处理：\n\n- **TAG_CHANGE** - 游戏状态标签变更事件\n- **SHOW_ENTITY** - 实体显示事件\n- **FULL_ENTITY** - 完整实体信息\n- **BLOCK_START/END** - 动作块开始和结束\n\n该解析器具备处理多GB日志文件的能力，支持SHA1去重、文件轮转和最新会话日志的自动发现。通过解析这些日志，系统能够构建出完整的游戏状态快照，包括玩家身份、手牌、场面随从、法力水晶、奥秘、武器、回合数等关键信息。\n\n### 视觉验证系统\n\n为了确保日志状态与实际游戏画面一致，项目引入了视觉验证机制。系统会截取炉石窗口的屏幕截图，并使用差分哈希（dHash）算法验证卡牌位置。通过将屏幕上的卡牌图像与内置的卡牌目录进行比对，系统可以确认日志状态与实际画面是否匹配。值得注意的是，截图仅用于本地视觉校验，绝不会发送给任何AI服务商。\n\n### 隐私保护与数据脱敏\n\n隐私保护是该项目的核心设计原则之一。在数据发送给AI服务商之前，系统会执行严格的数据脱敏：\n\n- 移除原始实体标签\n- 隐藏玩家名称\n- 清除时间戳信息\n- 仅保留白名单中的数据\n\n这种设计确保用户的敏感信息不会离开本地机器，同时AI模型仍然能够获得足够的游戏状态信息进行分析。\n\n## 用户界面设计\n\n项目采用了独特的"三窗口"用户界面设计：\n\n### 完整仪表盘\n\n一个无边框、可缩放的完整仪表盘窗口，显示当前游戏状态的详细信息，包括回合数、法力水晶、手牌、场面随从等。界面还集成了AI建议面板，按置信度排序显示推荐的行动方案。\n\n### 透明悬浮窗\n\n一个始终置顶、可固定的透明悬浮窗，在游戏过程中提供实时AI建议，不会遮挡游戏画面。用户可以通过快捷键 Ctrl+Shift+O 快速切换悬浮窗的显示状态。\n\n### 最小化拖拽球\n\n一个简洁的最小化界面，以拖拽球的形式存在，适合在不需要详细分析时保持后台运行。\n\n## 采纳追踪与多Agent对比\n\n项目还提供了创新的采纳追踪功能。通过对比回合前后的游戏状态快照，系统能够自动识别玩家实际执行了AI的哪些推荐动作，并追踪每个AI模型的历史采纳率。这种反馈机制可以帮助用户了解哪个AI模型最适合自己的游戏风格。\n\n多Agent对比功能允许用户并行查询多个LLM服务商，按置信度排序融合结果，并直观对比各家的建议差异。这种对比不仅增加了决策的可靠性，也为研究不同AI模型在游戏领域的性能提供了宝贵数据。\n\n## 技术实现细节\n\n### 结构化输出与优雅降级\n\n项目在处理AI响应时采用了三层可靠性保障：\n\n1. **首选方案** - 使用 OpenAI 兼容的 json_schema 结构化输出\n2. **降级方案** - 对于不支持严格schema的服务商，自动降级为 json_object\n3. **本地校验** - 最后通过本地校验确保结果合法\n\n这种设计确保了即使在不同AI服务商的API差异下，系统也能稳定工作。\n\n### 清晰的分层架构\n\n项目代码组织遵循清晰的职责分离原则：\n\n- **core/** - 纯逻辑层，无Electron/React依赖\n- **main/** - Electron主进程\n- **renderer/** - React UI层\n- **shared/** - 类型定义和默认值\n\n这种分层架构使得代码易于维护和扩展，同时也便于进行单元测试。\n\n### 加密凭据存储\n\n用户的API密钥通过Electron的safeStorage进行加密存储（Windows上使用DPAPI），绝不会以明文形式保存在设置文件中。这种设计保护了用户的敏感凭据，即使配置文件泄露也不会暴露API密钥。\n\n## 实际应用场景与价值\n\n对于炉石传说玩家而言，这款工具提供了多种实用价值：\n\n**新手学习** - 通过观察AI的建议，新手玩家可以快速学习卡牌组合、场面控制和资源管理的策略。\n\n**决策辅助** - 在复杂局面下，AI可以提供额外的视角，帮助玩家发现可能遗漏的最优解。\n\n**模型对比** - 玩家可以同时对比多个AI模型的建议，了解不同模型在游戏策略上的差异。\n\n**隐私安全** - 相比需要上传游戏数据到云端的辅助工具，这款只读本地工具提供了更高的隐私保护。\n\n## 项目启示与展望\n\nHearthstone Agent Assistant 项目展示了AI辅助工具的一种新范式：在不违反游戏规则的前提下，通过合法的技术手段（日志解析、屏幕截图）为玩家提供智能分析。这种模式不仅适用于炉石传说，也可以推广到其他有类似日志输出机制的游戏。\n\n项目的架构设计也值得借鉴：多服务商支持提供了灵活性，隐私保护机制建立了用户信任，而清晰的分层架构则确保了代码的可维护性。对于希望开发类似AI辅助工具的开发者来说，这是一个很好的参考案例。\n\n随着大语言模型能力的不断提升，我们可以期待这类AI游戏助手会变得越来越智能，为玩家提供越来越有价值的策略建议。而像Hearthstone Agent Assistant这样注重隐私和合规的项目，将为这一领域的健康发展树立标杆。