#交付捆绑包

agent-bundle build 让每个 target 目录都可独立分发。构建之后没有额外的打包步骤，也没有逐宿主的 重新打包脚本：target 目录就是你复制、发布或交给宿主 CLI 的那个单位。

npx agent-bundle build --root . --output artifact

#流水线

构建在写出任何东西之前就已经校验过项目，因此针对源码单独运行一次 validate 更像是快速的预检，而不是 必需的阶段。真正有意思的是校验产物，因为它完全不需要项目源码。

#一个 target 目录里发布了什么

每个已构建 target 都包含一份生成的 INSTALL.md，其中使用捆绑包真实的插件名与市场名——而不是 占位符——因此这份文件可以逐字照做。多宿主的 plugin target 还带有一份生成的 AGENTS.md，说明如何把它 安装到各个宿主。

Claude 与 Codex target 始终包含本地市场清单，正是这一点让它们的公开 CLI 能够直接安装输出的目录。 Cursor、portable 与组合 target 则包含一个独立的 install.mjs，因为 Cursor 提供了市场管理能力，却没有 非交互式的插件安装动词。

agent-bundle.manifest.json 记录每个输出文件及其 SHA-256，因此校验比对的是真实字节，而不是检查某个 路径是否存在。各 target 自身的布局在项目结构中介绍。

#面向 npm 的那一半

同时作为 npm 包发布的项目还有第二份输出：dist/bin/<name>.js 可执行文件与一个库入口，见 包入口。当包输出与至少一个宿主包被一起构建时，框架还会输出一个 相对包的安装器 bin ——见宿主安装。

agent-bundle prepack 是这一半的门禁：它运行发布构建、以不执行脚本的方式 dry-run npm pack，并核实 打包后的输出、产物哈希、bin 与版本号。

#本章内容

• 产物校验 —— 源码与产物校验，以及各宿主自有工具的贡献。
• 宿主安装 —— 安装到 Claude、Codex 与 Cursor，以及各自接受的安装作用域。
• 预览包 —— 目前代替 npm 的 pkg.pr.new 发布通道。