shatterfish

Shatterfish 是一个开源项目，旨在为 Shattered Pixel Dungeon (SPD) 扩展高级自动化和分析能力，其设计模式参考了国际象棋引擎 Stockfish。它作为 SPD 的下游分叉运行，在保持兼容性的同时增加了四个核心组件：用于快速、可重复运行的无头游戏框架 (headless game harness)；一个仅使用可观察游戏状态进行游戏的符号 AI “大脑” (brain)；一个通过 SPRT 比较来评估变更的统计测试装置 (rig)；以及一个允许用户在实际游戏过程中观看、暂停或接管机器人的游戏内叠加层 (overlay)。 该项目严格执行“信息对等”原则 —— 机器人只能使用人类玩家在屏幕上能看到的内容，例如渲染的视觉效果、日志和日志条目。它无法访问隐藏的游戏状态，如 RNG 种子或未鉴定物品的身份。这种公平性约束通过单一的 Observer 接口来强制执行，且每次变更都伴随有泄漏测试。 本项目基于 JDK 21 构建，不需要 Android SDK 或 Xcode。代码库组织在 shatterfish/ 模块下（包括 api, harness, codex, brain, rig, overlay），并提供详细文档，涵盖上游版本锁定 (v3.3.8)、构建指令和开发方法论 (BMAD Method)。所有贡献均采用 GPL-3.0-or-later 许可，与 SPD 的许可一致。该项目明确声明与 SPD 的原作者没有隶属关系。