spire-ctl

想让 AI 或自动化 harness 真正「动手」玩《杀戮尖塔 2》，常见做法是截图、视觉识别或模拟点击——脆弱、难核对，还容易在状态变化后仍用旧的手牌索引出牌。spire-ctl 走的是另一条路：通过本地 Mod 读取结构化游戏状态，只执行游戏自己广告出来的合法动作，用 JSON 状态契约和一套不重放的执行层，把「读局面」和「落子」变成可脚本化、可核对的事务。

它的价值更体现在出错时怎么停：旧状态标识会立刻失效，同一端口只允许一个写者，发送失败或结果无法确认时持久停止、绝不自动重试；每个动作都要读回确认，非法选项发不出去，算不清或遇到致命未知意图就交还给你，而不是猜。

核心能力包括读取 state 与合法动作、单步 act、按卡牌 id 而非位置的 seq 整回合提交、可选 plan 与 battle/advance 等机械或快速决策循环，同时可作为 DSH 插件暴露 spire_state、spire_act 等工具；运行时本身不绑 DSH，纯 CLI 在其他 harness 里同样可用。

适合需要把杀戮尖塔 2 接进 agent 工作流、又要求执行可审计、可停、不冒充通关机器人的开发者与研究者——决策仍由你或模型负责，spire-ctl 只保证「定下来的动作被合法、可核对地执行」。