cli-anything-slay-the-spire-ii 是做什么的？
一个状态化的命令行界面，通过本地 STS2_Bridge 模组控制真实的《杀戮尖塔 2》游戏。该 CLI 读取标准化游戏状态，并通过本地 HTTP API（localhost:15526）发送操作命令。
安装
此 CLI 需要一个在游戏进程内运行的桥接模组。CLI 和桥接模组均从同一个仓库分发：
https://github.com/HKUDS/CLI-Anything
1. 安装 CLI
git clone https://github.com/HKUDS/CLI-Anything.git
cd CLI-Anything/slay_the_spire_ii/agent-harness
pip install -e .
2. 构建并安装桥接模组
桥接模组是一个 .NET 9 插件，必须编译并安装到游戏目录。完整说明见仓库 README，简要步骤如下：
cd CLI-Anything/slay_the_spire_ii/agent-harness/bridge/plugin
./build.sh
cd ../install
./install_bridge.sh
如果构建脚本无法自动检测游戏数据目录，请显式设置 STS2_GAME_DATA_DIR：
STS2_GAME_DATA_DIR="/path/to/data_sts2" ./build.sh
3. 启用模组并验证
通过 Steam 启动《杀戮尖塔 2》，在模组管理器中启用 STS2_Bridge 模组，然后验证连接：
cli-anything-sts2 state
如果返回 JSON，则 CLI 和桥接模组已连接。
前提条件：
- Python 3.10+
- 已安装
STS2_Bridge 模组的《杀戮尖塔 2》（Steam）
.NET 9 SDK（仅构建桥接模组时需要）
用法
基本命令
cli-anything-sts2 state
cli-anything-sts2
cli-anything-sts2 --help
命令组
状态检查
| 命令 | 描述 |
|---|
state | 带有 decision 字段的标准化状态 |
raw-state | 原始桥接 JSON |
主菜单
| 命令 | 描述 |
|---|
continue-game | 继续已保存的存档 |
start-game --character IRONCLAD --ascension 0 | 开始新游戏 |
abandon-game | 放弃当前存档 |
return-to-main-menu | 从任何界面返回主菜单 |
角色：IRONCLAD, SILENT, DEFECT, NECROBINDER, REGENT
战斗
| 命令 | 描述 |
|---|
play-card <index> [--target <enemy_id>] | 从手牌打出一张牌 |
use-potion <slot> [--target <enemy_id>] | 使用药水 |
end-turn | 结束当前回合 |
地图与房间流程
| 命令 | 描述 |
|---|
choose-map <index> | 选择地图节点 |
proceed | 离开当前房间 |
奖励
| 命令 | 描述 |
|---|
claim-reward <index> | 领取战斗奖励 |
pick-card-reward <index> | 选择卡牌奖励 |
skip-card-reward | 跳过卡牌奖励 |
claim-treasure-relic <index> | 领取宝箱遗物 |
select-relic <index> | 选择遗物 |
skip-relic-selection | 跳过遗物选择 |
事件与休息处
| 命令 | 描述 |
|---|
event <index> | 选择事件选项 |
advance-dialogue | 推进纯对话事件 |
rest <index> | 选择篝火动作 |
商店
| 命令 | 描述 |
|---|
shop-buy <index> | 从商店购买 |
卡牌/遗物选择覆盖层
| 命令 | 描述 |
|---|
select-card <index> | 在覆盖层中选择卡牌 |
confirm-selection | 确认当前选择 |
cancel-selection | 取消当前选择 |
combat-select-card <index> | 在战斗覆盖层中选择卡牌 |
combat-confirm-selection | 确认战斗卡牌选择 |
原始动作
| 命令 | 描述 |
|---|
action <name> --kv key=value | 发送原始桥接动作 |
决策状态
state 命令返回 JSON，其中包含一个 decision 字段，指示当前游戏画面。根据此值路由下一步命令：
| 决策 | 含义 | 典型后续命令 |
|---|
menu | 主菜单 | continue-game, start-game |
combat_play | 战斗中，你的回合 | play-card, use-potion, end-turn |
hand_select | 卡牌选择覆盖层 | combat-select-card, combat-confirm-selection |
map_select | 地图节点选择 | choose-map |
game_over | 游戏结束 | return-to-main-menu |
combat_rewards | 战斗后奖励 | claim-reward, proceed |
card_reward | 卡牌奖励选择 | pick-card-reward, skip-card-reward |
event_choice | 事件界面 | event, advance-dialogue |
rest_site | 篝火 | rest |
shop | 商店界面 | shop-buy, proceed |
card_select | 卡牌选择界面 | select-card, confirm-selection |
relic_select | 遗物选择 | select-relic, skip-relic-selection |
treasure | 宝箱房间 | claim-treasure-relic, proceed |
配置
| 选项 | 默认值 | 描述 |
|---|
--base-url | http://localhost:15526 | 桥接 API URL |
--timeout | 10.0 | HTTP 超时时间（秒） |
针对 AI 智能体的说明
- 始终先读取
state 以获取 decision 字段
- 每次动作后重新读取状态——战斗中的索引和能量会变化
- 检查返回码——0 表示成功，非零表示错误
- 解析 stdout 以获取 JSON 输出