使用 Cursor 智能体对 Godot 4 游戏进行试玩测试
在 Claude Code 或 Cursor 中为智能体提供 Godot 4 试玩测试功能：真实捕获游戏画面，像玩家一样进行点击操作，且不污染 src/ 目录。任务：建议落地方案：使用 Cursor 或 Claude Code 配合 godot-studio-playtest 插件自动化测试 Godot 4 游戏。智能体通过 CLI 使用 JSON 流程与 Godot 交互，模拟点击和映射动作等玩家输入，且不修改源代码或创建测试场景。所有辅助文件隔离在 res://agent/ 中，以防止污染 src/ 目录。人类开发者定义测试标准和调试场景；智能体执行这些预定义流程，并根据真实游戏捕获结果报告 PASS/FAIL。；工具：Cursor。人工角色：原始帖子没有说明人如何参与。；局限：前提条件包括通过 ./install.sh 安装插件，并确保 Godot 二进制文件可访问（通过 PATH 或 GODOT= 环境变量）。捕获/流程命令需要窗口化环境。关键约束：智能体不得创建场景、使用未映射的键码或修改 InputMap/资源。如果 class_name 缓存错误在 --import 后仍然存在，智能体返回 CACHE_STALE。来源可靠性为次要；请验证插件与您特定 Godot 4 版本的兼容性。。
工具
Agent Work Atlas 发布日期:
概述
在 Claude Code 或 Cursor 中为智能体提供 Godot 4 试玩测试功能：真实捕获游戏画面，像玩家一样进行点击操作，且不污染 src/ 目录。
工作流程
建议落地方案：使用 Cursor 或 Claude Code 配合 godot-studio-playtest 插件自动化测试 Godot 4 游戏。智能体通过 CLI 使用 JSON 流程与 Godot 交互，模拟点击和映射动作等玩家输入，且不修改源代码或创建测试场景。所有辅助文件隔离在 res://agent/ 中，以防止污染 src/ 目录。人类开发者定义测试标准和调试场景；智能体执行这些预定义流程，并根据真实游戏捕获结果报告 PASS/FAIL。
原文报告的结果
来源未报告此工作流的测量结果或成功指标。它描述了预期行为：如果缺少调试场景，智能体返回 NEED_SETUP；如果发生脚本错误或未映射输入，则返回 FAIL。可衡量的验收检查是验证智能体能否成功执行示例流程（如 boot_smoke.json），并在 res://agent/out/ 中生成 PNG 捕获，同时不修改 res://agent/ 之外的任何文件。
人工角色
原始帖子没有说明人如何参与。
局限
前提条件包括通过 ./install.sh 安装插件，并确保 Godot 二进制文件可访问（通过 PATH 或 GODOT= 环境变量）。捕获/流程命令需要窗口化环境。关键约束：智能体不得创建场景、使用未映射的键码或修改 InputMap/资源。如果 class_name 缓存错误在 --import 后仍然存在，智能体返回 CACHE_STALE。来源可靠性为次要；请验证插件与您特定 Godot 4 版本的兼容性。
试一试
作为使用 Cursor 的 Godot 4 试玩测试智能体。我的项目位于 [可替换项目路径]。我已安装 godot-studio-playtest 插件。请执行以下步骤： 1. 验证插件已激活且 res://agent/ 目录存在。 2. 加载切片 [可替换切片 ID，例如 F1] 的测试标准，该切片针对场景 [可替换场景路径，例如 res://debug/boot.tscn]。 3. 检查场景是否存在。如果不存在，立即返回 NEED_SETUP。 4. 如果场景存在，在 res://agent/flows/ 中生成一个 JSON 流程，模拟玩家操作：[可替换操作，例如按下 'start' 动作，等待 2 秒，点击 'menu' 按钮]。 5. 使用 CLI 命令执行流程：addons/agent_kit/cli.sh [项目路径] flow --flow=[流程名称].json --fail-on-error。 6. 捕获结果。如果 Godot 记录 ERROR 或 SCRIPT ERROR，返回 FAIL 及日志片段。如果成功，返回 PASS 及 res://agent/out/ 中 PNG 的路径。 7. 不要修改 res://agent/ 之外的任何文件。不要创建新场景。 在运行完整测试之前，先对示例切片 'boot_smoke.json' 进行试运行，并向我展示输出以供确认。
来源报告未经独立核验。发布日期为本站案例发布日期，并非原始文章日期。