共享 Bundle

这一页属于 #strong[How-to]：当你想复用 bundle，而不是每次重新 build 时，按这里做。

常用命令

codeiq publish ./dist/bundle.ciq.tgz
codeiq registry download-local "pkg:cargo/tokio@1.43.0"
codeiq registry download "pkg:cargo/tokio@1.43.0" --output ./out
codeiq registry serve --port 8787

这里的前提是：你已经对代码 repo 或 policy repo 执行过 build，因此本地有一个 dist/bundle.ciq.tgz 可以发布。

什么时候用？

• CLI 和 AI 要复用同一份 bundle
• 想按 PURL 下载而不是手工找文件
• 想把 bundle 作为本机共享资产保存

当前会共享什么？

• 普通代码 / 规格 repo 的 CIQ Bundle
• profile: policy-bundle repo 的 CIQ OPA Bundle

这两类产物都会通过同一个本地 registry surface 管理，只是 manifest schema 和内部内容不同。

你会得到什么？

• publish receipt
• 本地 registry metadata
• 物化后的 bundle 文件集

如果你启用了本地 HTTP server，当前最小接口包括：

• GET /health
• POST /api/v1/bundles
• GET /api/v1/bundles/resolve?purl=...
• GET /api/v1/packages/{purl-encoded}/versions
• GET /api/v1/bundles/{bundleId}
• GET /api/v1/bundles/{bundleId}/download

下一步

• PURL 与配置：/docs/config
• MCP / Registry：/docs/runtime-reference