使用 GitHub 登录
ZH

Claude Code 的 JumPHP 面板

在 Claude 编写你的游戏时，看看它在做什么：对话旁边的面板会显示正在运行的测试、它正在查看的游戏画面，并且让你可以随时介入。它是 Claude Code 的一个 mod，名为 jumphp-live，随 JumPHP 一起提供。

安装

在 Claude Code 中（在终端里），输入：

/plugin install jumphp-live --marketplace davidnurdin/jumPhp

回答 y 以添加来源，然后选择作用范围（“user”：适用于你所有的项目）。在 shell 中也可以运行：claude plugin install jumphp-live --marketplace davidnurdin/jumPhp。

使用方法

在你的 JumPHP 项目中（包含 bin/jumphp 的文件夹），启动 Claude Code 并输入 /jumphp <游戏>，例如 /jumphp pong。面板会在右侧打开（窗口需要足够宽，至少 110 列）。当 Claude 第一次运行 bin/jumphp test 或 bin/jumphp shot 时，它也会自动打开。

它会显示：

  • 实时检查：当 Claude 运行 bin/jumphp test 时，输出会在面板中滚动，每个步骤会随进度被勾选：✔ php -l ✔ phpstan … phpunit smoke test。结束时会显示 PHPUnit 的摘要和失败的内容（失败的测试、PHP 警告和错误）。
  • 实时的游戏画面（● live）：在 bin/jumphp test（其 smoke test）或 bin/jumphp shot 运行游戏时，面板会随帧显示游戏画面（引擎会不断重写 var/live/frame.png，对应选项 JUMPHP_LIVE）。无窗口运行比实时更快：JUMPHP_REALTIME=1 会把它放慢到游戏的速度。在这个选项出现之前创建的项目，可以通过 git pull jumphp main 获得它（原始的 JumPHP 仓库以 jumphp 为名保存）。
  • 亲眼看测试玩游戏：会玩游戏的测试在运行时就会显示（⏳，然后是 ✔ / ✘），当前测试的名称显示在实时画面上方；之后点击某个测试即可查看它的最后一帧。按钮 🐢 Game speed / ⏩ Fast（r）用于选择速度：游戏的速度（默认，这样能看到球拍移动）或尽可能快。
  • 画面：bin/jumphp shot 或 siteshot 刚刚截取的图，以及 Claude 为查看游戏而打开的每一张图，都会显示在面板中。
  • 在任何终端中显示图像：默认情况下，图像会用小色块绘制（▦ Blocks），任何支持真彩色的终端都能显示（GNOME Terminal、Konsole、Windows Terminal、VS Code……）：为此，引擎会在每个 PNG 旁边写入一个原始的小副本（.rgb）。在 kitty、Ghostty 或 iTerm2 中，面板会显示 PNG 本身（🖼 HD）；按 p 键切换。按钮 🖼 Open（o）会用你桌面的图片查看器（xdg-open，macOS 上是 open）以实际大小打开当前显示的图像。
  • playground：当 Claude 使用 MCP 服务器时，显示网站上的 PHPUnit 测试（run_tests、get_test_run）和发布（sync_project）的结果。

你可以做的事：

  • ▶ Tests（t 键）和 📸 Shot（s）：不经过 Claude，直接运行测试或截图；输出会在面板中滚动。
  • 🛠 Ask Claude to fix（f），在失败之后：Claude 会收到失败的内容并进行修复。
  • Tell Claude：一个可以给它写话的输入框（“跳得再高一点”、“Boss 太难了”）；它在完成当前步骤后就会读到。

它如何跟踪 Claude

Claude 的一条运行 bin/jumphp test、shot、siteshot 或 webshot 的 Bash 命令会被原样执行，其输出同时会被复制到一个面板跟踪的临时文件中（{ export JUMPHP_LIVE=1; 命令 } 2>&1 | tee …，并保留退出码）。其他命令不会被改动。任何内容都不会被发送到别处。