CharTyr/STS2-Agent

解决的问题

本项目为 Slay the Spire 2 提供基于 AI 的伙伴和自主游戏模组。玩家可以选择让 LLM 自动运行游戏，或在合作模式下与 AI 队友协作，同时还能通过游戏内聊天界面获得战略建议。

工作原理

该模组集成一个基于 C# 的游戏内覆盖层（可通过 F8 访问），连接到任何 OpenAI 兼容的 LLM 端点（如 DeepSeek、OpenAI 或通过 Ollama 运行的本地模型）。它使用一个紧凑的状态引擎，将游戏数据（如卡牌、能量、敌人意图）转换为 AI 可理解的格式。在自主运行模式下，AI 评估实时状态并发出操作指令。在合作模式下，模组会启动第二个隔离的游戏实例，作为 AI 的角色。此外，还包含 FastMCP 服务器和本地 HTTP API，允许外部代理（如 Cursor 或 Claude Desktop）与游戏交互。

适用人群

• 希望实验 AI 代理自主运行卡牌构建游戏的 玩家。
• 寻找可通过自然语言协作的 AI 队友的 合作玩家。
• 希望将游戏作为测试 AI 代理及其工具调用能力环境的 开发者。

主要亮点

• 自主自动运行：使用纯文本或视觉增强模型，完成全部流程（战斗、选牌、路径选择）。
• 本地合作 AI 队友：一键启动独立游戏实例，快速获得协作型 AI 伙伴。
• 游戏内覆盖层 UI：游戏内直接配置和控制的窗口。
• 预算保护机制：内置令牌和请求计数功能，防止意外的 API 费用。
• 开发者工具：提供本地 HTTP API 和 FastMCP 服务器，支持外部代理集成。
• 故障恢复机制：自动电路断路器和指数退避机制，防止故障时陷入无限循环。