跳转到内容

扩展排障

先确认你是在调本地 pack、公开 Registry,还是公开插件市场页面。三者的失败路径不同。

错误 处理
jarvis-pack.yaml not found 命令参数应指向 pack 根目录
contribution path missing 检查 manifest 中的相对路径
command collision 换一个 slash command 名称
secret-like env value 把真实值移出 profile,只在 manifest 声明 secret 名称

main/stable 默认启用 Registry。看到该错误通常说明本机 .env 或设置覆盖中显式关闭了 registry,或当前是 gated 构建。需要安装公共 catalog 条目时,移除关闭项或设置:

终端窗口
JARVIS_EXTENSION_REGISTRY_ENABLED=1

gated 构建会强制关闭这个开关,不能通过 .env 绕过。

查看 catalog 中的 installability。如果状态是 native_artifact_unavailablepack_artifact_unavailableblocked,本机安装应该失败。这是设计行为,不是 UI bug。

插件市场和文档都托管在 jarvis.xcos.dev,不新增独立的插件子域名:

  • 插件市场:/plugins
  • 旧别名:/extensions 会跳转到 /plugins
  • 文档:/doc/extensions/...

如果部署后页面仍旧,先看 Cloudflare Pages workflow 的 docs smoke 和 plugin directory smoke 是否通过。