>-

用途：cli-anything-sts2 是一个有状态的命令行工具，用于控制真实的《Slay the Spire 2》游戏。它通过游戏进程内的本地 STS2_Bridge 模组提供的 HTTP API（默认 http://localhost:15526）读取规范化游戏状态并发送操作命令。

主要能力：state 命令返回带 decision 字段的规范化状态，用于判断当前界面；raw-state 返回原始桥接 JSON。命令覆盖主菜单（continue-game、start-game --character IRONCLAD --ascension 0、abandon-game、return-to-main-menu）、战斗（play-card、use-potion、end-turn）、地图与房间（choose-map、proceed）、奖励（claim-reward、pick-card-reward、skip-card-reward、claim-treasure-relic、select-relic、skip-relic-selection）、事件与休息点（event、advance-dialogue、rest）、商店（shop-buy）、卡牌/遗物选择浮层（select-card、confirm-selection、cancel-selection、combat-select-card、combat-confirm-selection）以及原始动作 action <name> --kv key=value。角色包括 IRONCLAD、SILENT、DEFECT、NECROBINDER、REGENT。

使用方式：需 Python 3.10+、Steam 版游戏并启用 STS2_Bridge 模组，构建桥接模组还需 .NET 9 SDK。安装 CLI：git clone https://github.com/HKUDS/CLI-Anything.git，cd CLI-Anything/slay_the_spire_ii/agent-harness，pip install -e .。构建安装桥接模组：cd CLI-Anything/slay_the_spire_ii/agent-harness/bridge/plugin，./build.sh，cd ../install，./install_bridge.sh；若无法自动检测游戏数据目录，设置 STS2_GAME_DATA_DIR="/path/to/data_sts2" ./build.sh。启动游戏并启用模组后，用 cli-anything-sts2 state 验证连接。可配置 --base-url 与 --timeout（默认 10.0 秒）。

适用场景：面向 AI 智能体或脚本自动化操作游戏流程。建议先读 state 获取 decision，再按对应命令路由；每次操作后重新读取状态，因为战斗中的索引和能量会变化；检查返回码（0 成功，非零错误）并解析 stdout 的 JSON。

限制：依赖游戏内桥接模组与本地 HTTP 服务，必须安装并启用 STS2_Bridge；构建桥接需要 .NET 9 SDK；资料未提供其他平台支持、收费或效果信息。