常见问题

H5 Game AI Inspector 使用中的常见问题与处理办法。

DevTools 标签名：H5 AI Inspector（左侧检视 + 右侧 AI 助手）
当前文档对应版本：1.0.19（以扩展「说明」或 chrome://extensions 中版本为准）
安装步骤见快速开始；功能说明见核心功能；更新记录见版本更新

快速跳转： 安装与加载 · 连接与引擎检测 · 检视与操作 · 注入 / 日志 / 报错 · AI 助手 · 骨骼与抓帧 · 与其他工具 · 获取帮助

iframe 嵌套与切换调试目标详见核心功能。

安装与加载

控制台报 `js/engine.js` / `js/inspector.js` 404，检测不到游戏

常见于 本地加载了错误目录。

必须加载 商店包 / 官网 ZIP 解压后的根目录，或源码构建后的 dist/
- 不要选仓库根目录、extension/、未构建的工程目录
从源码安装时执行完整构建：npm run build（不要只跑 build:static）
在 chrome://extensions/ 重新加载扩展（版本应与包内 manifest.json 一致）
刷新游戏页面（F12 已开时也要刷新标签页）

确认加载目录下存在 js/engine.js、js/inspector.js、js/content.js、js/devpanel.js；源码构建时 dist/inspect-build.json 应为 phase3-devpanel。

找不到 H5 AI Inspector 标签

在 chrome://extensions/ 确认扩展已启用
DevTools 标签较多时向右滚动，或打开 » 更多菜单
关 F12 → 重载扩展 → 刷新游戏页 → 再开 F12

解压后加载失败 / 找不到 manifest.json

ZIP 解压后，根目录应直接包含 manifest.json（同级通常还有 js/、css/、icons/）。若多套了一层文件夹，请选到真正含 manifest.json 的那一层。

商店版和官网 ZIP 有什么区别？

功能主体一致。商店版随 Chrome 更新、审核渠道分发；官网 ZIP 便于本地加载 / 跟进打包版本。官网直下载包可能含用量统计模块，Chrome 商店包不含。隐私说明见隐私政策。

连接与引擎检测

控制台报 `Extension context invalidated`

扩展在 DevTools 仍打开 时被重载，面板与 background 连接会断开，常表现为「检测不到游戏」或面板异常。

正确顺序：

先关闭 当前页整个 DevTools（关掉 F12，不是只切标签）
chrome://extensions/ → 重新加载扩展
刷新游戏页面
再按 F12 → 打开 H5 AI Inspector

切勿在 DevTools 仍打开时点「重新加载扩展」。

场景树一直为空 / 显示未找到引擎

确认页面使用支持的引擎（Egret / Laya / Cocos Creator / FairyGUI），且引擎全局已就绪（如 window.cc / Laya / egret）
游戏在 iframe 内时稍等探针；仍空则刷新页面
多个 frame 时，在顶栏 检视目标 下拉中切换到含引擎的那一帧（见核心功能 · iframe）
打开顶栏「说明」可对照引擎支持级别
混淆严重、非标准入口或其它引擎暂时无法检出属预期限制

可在游戏页 Console 自行检查：typeof cc、typeof Laya、typeof egret 是否为对象。

游戏在 iframe 里，能调试吗？如何切换目标？

可以。扩展对全 frame 注入桥接脚本，iframe 内的游戏与顶层游戏一样可检视。

检测到多个 frame 时，顶栏会出现 检视目标 下拉（形如 frame N · 引擎 · 域名）
在下拉中切换后，场景树、属性、注入等会针对当前选中的 frame
只有一个目标时下拉可能隐藏；树为空时优先检查是否选错了 frame

打开面板很久才出树

引擎脚本晚于页面加载时，探针会轮询等待。可先等数秒；仍无结果再刷新游戏页。部分项目需等进主场景后再开面板。

提示有新版本？

面板可能请求 https://copilot.egret.uk/version.json 做版本比较（仅读 JSON，不执行远程脚本）。可按提示前往 Chrome 网上应用店或官网下载更新。

检视与操作

点不到游戏对象 / 选不中节点

勾选「点击高亮选中」后再在游戏画面点击
需要挡玩法点击时，勾选「阻止点击」
点击树上方刷新按钮；确认当前检视的是游戏所在 frame（iframe 游戏尤其重要）

改了属性画面没变

常见原因（不一定是插件坏了）：

逻辑尺寸 vs 缩放：如 Laya 的 width/height 与 scaleX / sizeGrid 同时影响视觉
引擎暂停：部分 Egret 项目在 DevTools 失焦时走 lifecycle → ticker.pause()
改的是非渲染字段，或节点被父级遮罩 / 透明度为 0
FairyGUI：优先改 GObject（尺寸用 setSize / setXY），不要只改宿主 displayObject

可用「查看修改」确认本会话改了哪些字段。

暂停 / 下一帧无效

顶栏控制依赖劫持 requestAnimationFrame / 定时器。若游戏自建主循环，可能覆盖不全。可先在引擎官方 Demo 上验证是否正常。

右键没有「导出骨骼」或「复制 ID」

菜单项按引擎与节点数据 动态显示。无引擎 ID、或不支持骨骼的引擎 / 节点上，对应项不会出现。

搜索找不到节点

确认搜索关键字匹配树标签 / 名称；可尝试 UID。复杂层级可先展开父节点再搜。快捷键见面板内提示（如 Ctrl+F）。

注入 / 日志 / 报错

注入脚本有 `console.log` 但运行日志没有

展开底部 运行日志 区域
确认扩展已完整加载并 刷新过游戏页（采集经 inspector.js 安装）
过滤条件勿只开「页面」而漏掉「注入」；Log 级别未关闭
插件运行日志与游戏页 Console 一般都能看到；error 时徽标会累加

普通网站也出现「报错」浮标

当前版本应在 检测到游戏引擎后 才显示页面报错角标。若仍出现：更新到最新版 → 按上文顺序重载扩展 → 刷新页面。也可在「游戏报错」弹窗中关闭「游戏页报错提示」。

游戏报错列表为空，但 Console 有错

仅捕获扩展挂钩之后的页面错误；历史错误不会回溯。打开面板后再触发一次错误。部分跨域 / Worker / 未进入页面的错误可能捕不到。

点击报错路径无法打开 Sources

需在 Chrome DevTools 中操作（本扩展的跳转依赖 DevTools API）。路径需能对应到页面已加载的脚本资源；压缩合并后的单行文件可能只能跳到文件开头附近。

DevTools 控制台出现 TrustedHTML / Trusted Types

少数环境下 DevTools 文档启用 Trusted Types，旧版写 innerHTML 可能被拦截。请升级到 1.0.19+ 并按正确顺序重载扩展。若仍复现，请反馈 Chrome 版本与操作步骤。

AI 助手

AI 无回复 / 请求失败

检查 API Key、Base URL（或完整 URL）、模型名是否与服务商文档一致
需 OpenAI 兼容 Chat Completions；Anthropic 等通常要自备兼容网关
在 chrome://extensions → 本扩展 → Service Worker 查看报错
网络、跨域、厂商额度不足也会失败
配置步骤见 AI Key 配置

AI 执行代码报错

优先区分：

上下文隔离：游戏对象只在页面 MAIN world；应通过面板 / AI 执行路径（inspectedWindow.eval），不要在扩展隔离世界直接读 window.egret
混淆 / 变量变更：先在场景树选中节点，或用动态扫描找单例

反馈问题时请附上 游戏页 Console 完整堆栈。

自动执行太危险？

在右侧「配置」里把执行模式改为 确认后执行 或禁用。新手建议先用确认模式，审查代码再跑。

对话记录在哪？会不会上传？

对话按游戏名存在本机（chrome.storage.local），可在界面清空。扩展无自有聊天后端；发消息时内容（及可选上下文 / 报错）直达你配置的 AI 服务商。API Key 以明文存本地，公用电脑请用受限 Key 或用毕删除。详见隐私政策。

附带上下文会发送什么？

开启后可能包含：引擎名与版本、游戏页 URL、选中节点与属性摘要、最近游戏报错等。可随时关闭「附带上下文」「附带报错」。

骨骼与抓帧

骨骼资源列表为空

当前页需存在已加载的 Spine / DragonBones 运行时实例
点「刷新列表」；确认引擎在支持范围内
资源尚未加载完成时先玩到出现骨骼动画再扫

导出 ZIP 缺少骨骼原始文件

部分项目仅内存中有运行时数据、无原始 .skel / .json。此时可能只导出贴图与 _runtime_summary.json 等摘要，属能力限制而非单纯失败。

抓帧 / Shader 看不到内容

需游戏使用 WebGL 渲染且扩展能挂钩绘制。先点「重新抓取」；部分引擎或自定义渲染管线支持不完整。可在官方 Demo 上对比验证。

与其他工具

与 cc-inspector / GameInspect / Egret Inspector 同时安装

一般可共存（本扩展使用独立命名空间）。建议一次只操作一个 DevTools 检视面板，避免同时改同一节点。

高亮遮罩、场景拾取与「阻止点击」仅在 H5 AI Inspector 面板可见时启用；切到其它标签或关闭面板后会清除遮罩并放开游戏点击。

Edge / 其他 Chromium 浏览器

基于 Chromium 的浏览器通常可加载同一安装包，以实测为准。商店分发与审核以 Chrome 网上应用店为准。

获取帮助

渠道	地址
Chrome 网上应用店	https://chromewebstore.google.com/detail/h5-game-ai-inspector/hgjkfcojmobceiihkjifeioioffcmond
文档站	https://copilot.egret.uk/
隐私政策	https://copilot.egret.uk/privacy_policy.html
社区论坛	https://bbs.egret.uk/
邮箱	[email protected]
QQ 群	见扩展内顶栏「说明」弹窗

提问时请尽量提供：

扩展版本号（商店 / 本地）
引擎名称与版本
复现步骤与游戏 URL（若可公开）
游戏页 Console 与 DevTools Console 完整堆栈
是商店安装还是本地 ZIP / dist/

相关文档：快速开始 · 核心功能 · AI Key 配置 · 支持的引擎

常见问题 ​

安装与加载 ​

控制台报 js/engine.js / js/inspector.js 404，检测不到游戏 ​

找不到 H5 AI Inspector 标签 ​

解压后加载失败 / 找不到 manifest.json ​

商店版和官网 ZIP 有什么区别？ ​

连接与引擎检测 ​

控制台报 Extension context invalidated ​

场景树一直为空 / 显示未找到引擎 ​

游戏在 iframe 里，能调试吗？如何切换目标？ ​

打开面板很久才出树 ​

提示有新版本？ ​

检视与操作 ​

点不到游戏对象 / 选不中节点 ​

改了属性画面没变 ​

暂停 / 下一帧无效 ​

右键没有「导出骨骼」或「复制 ID」 ​

搜索找不到节点 ​

注入 / 日志 / 报错 ​

注入脚本有 console.log 但运行日志没有 ​

普通网站也出现「报错」浮标 ​

游戏报错列表为空，但 Console 有错 ​

点击报错路径无法打开 Sources ​

DevTools 控制台出现 TrustedHTML / Trusted Types ​

AI 助手 ​

AI 无回复 / 请求失败 ​

AI 执行代码报错 ​

自动执行太危险？ ​

对话记录在哪？会不会上传？ ​

附带上下文会发送什么？ ​

骨骼与抓帧 ​

骨骼资源列表为空 ​

导出 ZIP 缺少骨骼原始文件 ​

抓帧 / Shader 看不到内容 ​

与其他工具 ​

与 cc-inspector / GameInspect / Egret Inspector 同时安装 ​

Edge / 其他 Chromium 浏览器 ​

获取帮助 ​