扩展排障
先确认你是在调本地 pack、公开 Registry,还是公开插件市场页面。三者的失败路径不同。
validate 失败
标题为“validate 失败”的章节| 错误 | 处理 |
|---|---|
jarvis-pack.yaml not found |
命令参数应指向 pack 根目录 |
| contribution path missing | 检查 manifest 中的相对路径 |
| command collision | 换一个 slash command 名称 |
| secret-like env value | 把真实值移出 profile,只在 manifest 声明 secret 名称 |
registry disabled
标题为“registry disabled”的章节main/stable 默认启用 Registry。看到该错误通常说明本机 .env 或设置覆盖中显式关闭了 registry,或当前是 gated 构建。需要安装公共 catalog 条目时,移除关闭项或设置:
JARVIS_EXTENSION_REGISTRY_ENABLED=1gated 构建会强制关闭这个开关,不能通过 .env 绕过。
catalog 可见但不能安装
标题为“catalog 可见但不能安装”的章节查看 catalog 中的 installability。如果状态是 native_artifact_unavailable、pack_artifact_unavailable 或 blocked,本机安装应该失败。这是设计行为,不是 UI bug。
公开站点显示旧内容
标题为“公开站点显示旧内容”的章节插件市场和文档都托管在 jarvis.xcos.dev,不新增独立的插件子域名:
- 插件市场:
/plugins - 旧别名:
/extensions会跳转到/plugins - 文档:
/doc/extensions/...
如果部署后页面仍旧,先看 Cloudflare Pages workflow 的 docs smoke 和 plugin directory smoke 是否通过。