开发者用LLM为《Balatro》构建OpenTelemetry插桩库

这篇博客文章本该用一个俏皮的笑话来开头，毕竟这是让 Balatro 如此受人喜爱的一大要素。然而我实在想不出什么笑话，所以换个方式开场吧：我着迷于这样一种可能性——我使用的任何软件，理论上都能通过 OpenTelemetry 输出日志、指标和追踪数据。而 Balatro 正是我经常使用的软件。我已经在它上面花了几百个小时，这是我花过最值的那 2 × 10 欧元¹。所以，为 Balatro 实现 OpenTelemetry 是我很久以来就想尝试的副业项目！结果这个项目成了那种我更在意成果、而不在意亲手写代码的项目，于是它完美地成了让 LLM 替我构建的候选对象！

你可能会好奇，Balatro 为什么可以被插桩观测。首先，它是用 LÖVE 构建、以 Lua 编写的，而且已经有了一个 mod 框架 Steamodded。其次，这款游戏是“事务性”的：你打出牌型，它们被计分，你在商店里买东西，如此等等。所以“追踪（trace）”在这里是说得通的——这对所有游戏来说并非理所当然。基于这一点，LLM 可以依照 OpenTelemetry 规范，使用 OpenTelemetry 专用的 agent 技能和 Weaver，为 Balatro 构建出一个插桩库，仓库地址在这里：https://github.com/svrnm/balatro-otel

如果你的电脑上装了 Balatro，可以亲自试试！你可以用 r2modman、Gale 或 imm 之类的 mod 管理器从 Thunderstore 安装这个 mod。手动安装的方式见快速上手指南。

接下来，你需要一个接收遥测数据的后端。仓库里提供了搭建 Jaeger 的说明，不过当然，既然是 OpenTelemetry，你可以把数据发到你偏好的任意后端。默认情况下，这个 mod 会发送到 http://127.0.0.1:4318。你可以在 UI 的 Mods -> OTel Trace -> Config 下修改端点。我在工作中使用 Bronto，用它来长期保存遥测数据以便分析。

把遥测数据存进后端之后，你就可以开始分析自己的对局了：在什么情况下打什么牌型、钱都花在了哪里、哪些 boss blind 最让你头疼。机器人对局一共记录了 112 局、2,000 手牌，其中 1,400 手是 Pair。终结对局次数最多的 boss blind 是 The Mouth 和 The Psychic（各 8 局），而 The Water 是最难的：机器人在 8 次里输给了它 7 次。

一局游戏作为一条追踪：blind、手牌、触发计分的牌

不过，可观测性数据的主要用途并不是分析，而是排障。我希望能够回答这样一个问题：“当出问题时，游戏开发者或 mod 作者需要什么？”为了回答它，除了错误和堆栈追踪之外，这个 mod 还会记录卡顿帧、update 和 draw 耗时、动画队列长度以及其他游戏属性。这样我就确认了一些已知 bug 已经消失，比如 Perkeo 和 Wheel of Fortune 导致的崩溃，该问题在 1.0.1o 中已修复。我也在工具链里遇到了 bug，比如 BalatroBot 中，跳过开启的标签包是一片盲区。最有意思的一个 bug 是 blind 分数对不上：在像 The Psychic 这种封锁手牌的 boss 下，被封锁的手牌计 0 分，但 blind 仍然获得了这些分数。这个问题在 Steamodded 中已经修复，但我的环境锁定了一个较旧的版本，因为 BalatroBot 在较新的版本上无法启动。最后，我还报告了另一个 bug：当 BalatroBot 的响应超出 socket 发送缓冲区时会被截断，导致它在高负载下崩溃。

下载视频：The Psychic 封锁了 Pair of Queens（0 × 0），但回合得分却从 0 跳到了 20

总而言之，为 Balatro 或任何类似的游戏做插桩观测，甚至算不上一个糟糕的主意。这些数据对于分析你自己的对局或机器人的跑局很有用，除此之外，它还能用于找 bug 和测试。如果你想上手玩玩，去看看那个仓库，如果你试过了，或者发现了另一款你做过插桩观测的游戏，欢迎给我发消息！

¹ 我最早是在 Steam 上买的这款游戏，后来发现手机上有一个版本能让我随时随地玩，尤其是在火车和飞机上！在 KubeCon EU 2025 期间它简直是救星——我在第一天就病了，结果半周都待在酒店房间里。↩︎