工作方式

解释 Local Registry、PURL 和本地查询运行时分别在用户工作流里扮演什么角色。

工作方式

这一页属于 #strong[Explanation]:它解释系统怎样配合工作,而不是逐条列命令。

三个关键对象

  • Local Registry:负责保存和共享 bundle
  • PURL:负责标识和定位 bundle
  • MCP:负责查询 bundle

如果把完整工作流展开,当前实际上有五个相互配合的层次:

  1. init / build:定义并产出 bundle
  2. diff / check:比较版本并执行本地 policy
  3. publish / registry:共享和物化 bundle
  4. query:一次性读取 bundle
  5. mcp:把 bundle 变成本地 AI / Agent 查询接口

一句话理解

Registry 负责存,PURL 负责找,MCP 负责查。

如果你把 builddiff / check 也算进去,那么更完整的版本是:

Build 负责产出,Diff / Check 负责治理,Registry 负责存,PURL 负责找,Query / MCP 负责查。

为什么这对用户重要?

  • 你会知道该在哪里找 bundle
  • 你会知道为什么 query / MCP 需要 PURL
  • 你会知道 publish、download 和查询分别属于哪一步

当前为什么强调 local-only?

因为当前 repo 的设计重点不是 hosted service,而是:

  • 让一台机器上的 CLI、Local Registry 和 MCP 共享同一份上下文资产;
  • CIQ BundleCIQ OPA BundleCIQ DiffSARIF 成为可以离线复用的标准化产物;
  • 让用户在不引入远端平台的前提下完成 build → diff → check → query → publish 的闭环。

什么时候看这页?

  • 你要共享 bundle
  • 你要按 PURL 下载
  • 你要接入 AI / Agent 查询