跳到正文

故障排查 ​

部署因远程 JavaScript 停止 ​

vf deploy 会阻止 CDN JavaScript、远程 WASM 和远程 Worker 脚本。

常见原因:

  • HTML 中有 <script src="https://cdn...">。
  • 代码中有 await import("https://cdn...")。
  • 可选的本地 AI 提供方被静态 import,即使运行时不用也进入了打包产物。

解决方式:

  • 把依赖打包进本地构建。
  • 从部署构建中移除不用的提供方 / import。
  • AI 通过 hub.ai.generateText(...) 或 hub.ai.chat(...) 调用。

使用 VifuHub capability ​

Agent Runtime 的宿主能力通过 VifuHub 命名空间调用。

ts
await hub.ai.generateText({
  model: "basic",
  messages: [{ role: "user", content: "Give a hint." }]
});

hostConnected 一直是 false ​

  • 确认游戏在 Agent Runtime iframe 中打开。
  • 确认调用了 await hub.ready()。
  • 普通本地浏览器中保持 false 是正常的。
  • 在 VifuHub SDK bridge 初始化后检查 hub.status()。

资源读不到 ​

  • 确认清单中有 data、media 或 bundle.include。
  • 将清单中的 id / path 传给 hub.resources.*。

同一个游戏没有更新 ​

vf deploy 用当前登录的所有者和部署名决定更新目标。

  • 确认登录的是同一个账号 / API 环境。
  • 改变 --name 会被视为另一个游戏。
  • dev 和 production 是不同环境。

清单被拒绝 ​

公开 V1 不写 id、entry、play、runtime、services、devices、resources、permissions、capabilities、browser、security。

请使用 main.url、build.output、ai、data、media、bundle、save 等公开字段。