构建索引

cogna build 是你后续一切操作的起点。只有先构建索引，才能继续做 diff、check、MCP 查询。

典型流程

cogna init
cogna build

构建后会得到什么

dist/ 目录通常包含：

• bundle.ciq.tgz
• declarations.ndjson
• manifest.json
• metadata.json
• checksums.txt

其中最重要的是 bundle.ciq.tgz，它是可复用的标准输入。

常见问题

构建很慢怎么办？

• 先确认 inputs.include 不要过宽。
• 使用本地 cache，避免重复计算。
• 团队场景可接入 HTTP cache（见 远程索引）。

构建失败怎么办？

• 先检查 profile 与仓库类型是否一致。
• 再检查仓库路径、分支和权限。

推荐实践

• 每次发布前固定执行一次 cogna build。
• 把 dist/bundle.ciq.tgz 作为可追溯工件保存。
• 与 diff、check 一起放进 CI。

相关文档

• 配置与 PURL
• 分析变更
• 持续集成