SuperAPI AI 工具集

wai-play

测试与质量

查看项目

更新于 10-16 04:59

技能介绍

用途:WAI Play 用于对运行中的网页游戏做自动试玩测试,由智能体操作真实浏览器,对游戏目标与关键节点建模并实际游玩,最终给出证据而非主观印象。它区分“游戏质量”与“测试可信度”,测试工具链的强弱不会抬高或压低游戏本身评分。

主要能力:输出五维加权评分——核心流程 0.24、玩法 0.26、界面视觉 0.20、反馈 0.15、技术稳定性 0.15;API 集成完整度、证据完整度、智能体可靠性作为可信度诊断单独报告,不计入上述分数。问题以问题卡形式给出,附状态增量、截图或不超过 20 秒的片段,并只绑定最佳尝试的一份证据、同一缺陷只报一次。提供只读体检 doctor、集成文件静态检查与演示服务器。

使用方式:先收集五项信息——游戏类型(仅支持 survivor_like、arcade_shooter、platformer、puzzle_card、visual_novel 五类)、可访问的 URL、页面是否暴露 window.GameFlowAgentAPI、可选的与部署版本一致的源码 ZIP、DeepSeek 与 Kimi 密钥或明示无密钥路径。随后在 testability、integration、run、report、scenario-gap、ops 六种模式中只选一种,不混合。先做可测性判断再运行测试。

命令: bash .agent-skills/wai-play/scripts/wai-play.sh doctor bash .agent-skills/wai-play/scripts/wai-play.sh doctor /path/to/wai-play python3 .agent-skills/wai-play/scripts/check_integration.py --game-type survivor_like path/to/game-integration.js bash .agent-skills/wai-play/scripts/wai-play.sh demo /path/to/wai-play 8768

doctor 会报告 Python 版本、四个运行时依赖、是否有 Playwright Chromium 构建、哪些 .env 键已设置(只显示名称不显示值),不安装任何内容、不启动测试。check_integration.py 仅用标准库做静态文本检查,输出一个 review 代码块,列出缺失方法、残留模板占位、未实现的 throw 桩和找不到的状态字段,存在阻塞项时退出码为 1。demo 会在前台启动本地静态服务器,属用户可见操作,不应作为后台副作用运行。

关键限制:集成桥接不得伪造状态,未实现的 observe() 或 step() 应抛错而非返回看似合理的数据;不得靠设置单个字段满足关键节点(如只写 elapsed = 360 以进入 boss 阶段),必须初始化完整场景。关键节点不可达时按返回码处理:SCENARIO_PRECONDITION_MISSING 需在 observe() 补充字段后重查;SCENARIO_LOADER_NOT_IMPLEMENTED 需实现初始化器或走自然路径;SCENARIO_UNSAFE_TO_JUMP 应走自然路径;SERVER_AUTHORITATIVE_STATE 应申请测试账号、存档或注入端点;REPAIRER_NOT_IMPLEMENTED 走自然路径。仅可测试自己拥有或已获授权的游戏与源码;上传 ZIP 仅作临时副本分析,运行后应清理。开启 AI 源码建模会把源码摘要发送给配置的第三方模型服务商(DeepSeek、Kimi),在未发布或客户代码上启用前应明确告知。当前版本面向本地使用,公开多用户托管所需的账号、任务队列、配额、远程 URL 限制与测试数据自动清理尚未实现,不应描述为可直接部署。无密钥时为降级模式:无源码建模、无 AI 路径规划、仅规则级建议,应如实说明。分类与价格等信息资料未提供。