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 伺服器，支援外部代理整合。
• 故障恢復機制：自動電路斷路器與指數退避機制，防止故障時陷入無限循環。