# @defrex/autobuild 中文文档

规范地址：https://npmcn.com/package/%40defrex/autobuild/

版本：1\.6\.0
npm 元数据更新时间：2026-11-11T21:01:20.282Z
中文译文更新时间：2026-11-11T21:12:08.218Z
软件包许可：Apache-2\.0

本文由上游 README 翻译，可能存在偏差，请结合原文核对 API、命令与配置。版权与许可归原作者所有。

原始 npm 页面：https://www.npmjs.com/package/%40defrex/autobuild
原文对照：https://npmcn.com/package/%40defrex/autobuild/?lang=original
源码仓库：https://github.com/defrex/autobuild

## 关键信息（来自 npm 元数据）

- 包体积（解压后）：11.2 MB，528 个文件
- 模块格式：ES Module
- TypeScript 类型：包内自带
- 运行依赖：9 个
- 首次发布：2026-09-16T16:26:03.384Z
- 最新版本发布：2026-11-11T21:01:20.086Z
- 近 30 天下载量：7456（2026-10-12 至 2026-11-10，npm 官方下载统计）
- 已发布版本数：23（近 12 个月 23 个）

## 中文简介

代理驱动的软件从新订票到合并PR

## 安装

```sh
npm install @defrex/autobuild
```

也可以使用：`pnpm add @defrex/autobuild`、`yarn add @defrex/autobuild`、`bun add @defrex/autobuild`

## README

# 自动构建

**入场券,出场券.**

Autobuilding通过固定管道运行编码代理,该管道计划,执行, 并核实每张票,然后合并。 你新郎的门票 审查拉出请求; 代理工作, 和确定性代码保存 他们诚实.

![The autobuild dispatch dashboard with four builds in flight, each partway through the pipeline](https://npmcn.com/package/%40defrex/autobuild/docs/assets/headline-wide.png)

## 快速启动

惠璶 [阿宝](https://bun.sh/), (中文(简体) ), `git`,以及地方条件 您选择的代理运行时间: Claude 代码、 Codex CLI 或 Pi。 GitHub 也伪造 需要认证 [`gh` 国 际](https://cli.github.com/) 或导出 `GITHUB_TOKEN`编号 :`GH_TOKEN`; 本地快活的伪造不需要账户或远程.

从您想要的仓库中安装 Autubuild 作为开发依赖:

```sh
bun add -d --exact @defrex/autobuild@1.6.0
```

没有 `package.json`,安装创建 `package.json` 财务报告和审定财务报表 `bun.lock`, (中文(简体) ), 承诺,与 `node_modules/` 被忽略 .

运行存储器安装的 CLI :

```sh
bun ab init
```

这个卖出可编辑的 `ab-*` 技能,写一个堆栈中性配置,以及 手的寄存器 - 意识设置到编码代理。 这个 [配置参考](https://npmcn.com/package/%40defrex/autobuild/docs/configuration.md) 覆盖每个领域。 礛 启动调度器及其实时仪表板:

```sh
bun ab dispatch
```

然后在你的编码代理中 给第一张票做新郎:

```text
/ab-spec add a retry budget
```

经纪人问出一张可以伪造的票 并存档 在你的追踪器。 从那时起,这种技能就是如何工作.

## 如何运作

有限制 [融合树](https://npmcn.com/package/%40defrex/autobuild/docs/integration-tree.md) 收集相关工作,然后根据您选择的政策将其合并.

### 输油管的工票

```text
spec → plan ⇄ plan-review → implement ⇄ code-review → verify:* → finalize
      epilogue: (pr.conflicted → reconcile → verify:*)* → merged or closed
```

每张工作票在自己的建筑管理者内部经过确定阶段. 每个阶段都是新鲜的代理会话,有文物把它们织在一起.

1.  **光谱** ——调度员要求备妥票单,确定最终票单 切个分枝 标准是以后所有事情的合同.
2.  **计划审查** ——规划人员写出实施计划 独立审查人批准或将调查结果发回.
3.  **执行 qq 代码审查** 承诺的相同形式:执行, 审查,订正。 一个在圆后存活的发现 升级为 而不是永远循环.
4.  **核实:\*** 你们的核查步骤,按照你们宣布的顺序: 通过退出代码判断的 shell 命令, 或返回 a 的代理验证器 判决并可以附加截图等证据.
5.  **最后确定** ——公关开启时有代理写作的描述和 附加的证据,然后是您配置的 PR 后步骤( changlogs, 发布笔记)跑.
6.  **缩略语** ——调度员看公开公关. 返回冲突路径 通过调和和重新核实;构建结束 `merged` 或者说 `closed`。 。 。 .

### 一个调度员产卵

调度员要求准备好车票,并开始为每个车站开一个建筑跑车. 奔跑者被隔离,所有的州都被登录. 特工从不决定哪个阶段 接下来,结果永远不会从模型的打印中推断出来: 通过输入的 CLI 报告到事件日志,测试代码决定 过渡。 木头就是建筑 任何时间都停止进程 调度员从持久状态恢复.

管道语法是故意确定的; `verify:*` 财务报告和审定财务报表 `finalize:*` 这是 扩展点,每个存储器在 `autobuild.toml`为接缝 及其背后的推理 [`docs/architecture.md`](https://npmcn.com/package/%40defrex/autobuild/docs/architecture.md) 财务报告和审定财务报表 [`SPEC.md`](https://npmcn.com/package/%40defrex/autobuild/SPEC.md)。 。 。 .

## 所有本地的,所有远程的, 或任何地方之间的

每个接合器都是适合您的项目的 大楼 管道保持不变.

| 缝合 | 决定 | 适配器 |
| --- | --- | --- |
| 罚单 | 工作来自何处 | 本地文件、 线性文件、 主机、 插件 |
| 调度器 | 开始的构造 | 当地进程 |
| 工作空间 | 建筑物运行的地方 | git 工作树, Vercel Sandbox, 插件 |
| 运行时间 | 谁做的思想 | Claude 代码、代码、 Pi 插件 |
| 伪造 | 代码合并的地方 | 本地 git, GitHub, 插件 |
| 存储 | 国家居住地点 | SQLite, 远程 HTTP 商店 |
| 运算符 | 你看着 | 终端, stdio MCP, 操作员 API |

插件被信任的 Bun 模块声明在 `autobuild.toml` 反对: 已版本 `@defrex/autobuild/plugin-sdk`。 。 。 .

## 建造为吞吐量,而非耐用

一个建筑可能比和代理人聊天需要更长的时间. 交易要多得多 每天合并的变化,可靠性要高得多.

-   **存档然后走开.** 管道里没有东西等着你 你没有 批准工具调用, 粘贴出错, 或者监视终端 。 一个建筑 只有当它真正被封锁的时候,它才会升级.
-   **尽量多建新房.** 并排运行的建筑物,每个在它的 拥有工作空间, 并达到您设定的极限 。 你的注意力已经停止了 天花板; 写好票的速度成为极限.

无头是安全的 因为管道是定型码 不是模型 判决。 状态生活在一个已输入的、仅附加的事件日志、相位过渡中 每个建筑都留下可查询的纸张线索。  合并门永远不会被绕过: 当您需要检查时, 公关会合并 同意它合并.

## 让队列填满自己

一旦门票是接口,任何能写出门票的东西都可以摆出工作 在你们面前.

构建队列本身 。 一个发现潜在错误的执行者,一个 值得重述,或者在其类别之外缺少后续记录 观察(`ab observe`) 继续前进:洞察力得到保持,瞄准镜也逐渐消失 远离公关。 一旦足够堆积,调度员会把它们蒸馏成 拟议罚单,与已经提交的工作相比,并默认 把它们放进分解器 你像自己写的任何一张票一样给她们新婚. 特工们提议 人类派遣.

支持线程,会话笔记,和错误遥测可以以同样的方式提供. 一个特工与 `ab` CLI 或 MCP 服务器可以存档并回答 常规升级,只留下真正的产品呼叫.

## 学多点

-   [自动建设。 运行](https://www.autobuild.run/) 项目现场.
-   [`docs/spec-standard.md`](https://npmcn.com/package/%40defrex/autobuild/docs/spec-standard.md) - 门票是什么 可建:每个发送的光谱必须达到的标准.
-   [`docs/configuration.md`](https://npmcn.com/package/%40defrex/autobuild/docs/configuration.md) - 完全严格 `autobuild.toml` 计划与例子.
-   [`autobuild.toml`](https://npmcn.com/package/%40defrex/autobuild/autobuild.toml) ——这个仓库自己的管线 配置,作为配置表面的一个实例.
-   [`docs/architecture.md`](https://npmcn.com/package/%40defrex/autobuild/docs/architecture.md) ——设计地图如何实现 代码库:内核,端口,流程,和存储.
-   [`docs/remote-store-protocol.md`](https://npmcn.com/package/%40defrex/autobuild/docs/remote-store-protocol.md) - 那个 完成HTTP服务器合同和BuildStore兼容指令.
-   [`SPEC.md`](https://npmcn.com/package/%40defrex/autobuild/SPEC.md) ——设计及其真实来源 术语.

## 许可证

[Apache 许可证 2.0](https://npmcn.com/package/%40defrex/autobuild/LICENSE)。 。 。 .

## 常见问题

### @defrex/autobuild 是什么？

代理驱动的软件从新订票到合并PR

### 如何安装 @defrex/autobuild？

在项目目录运行 npm install @defrex/autobuild，或使用 pnpm add / yarn add / bun add。它还提供命令行工具 ab，可以用 npx ab 直接运行。

### @defrex/autobuild 支持 TypeScript 吗？

支持。包内自带 TypeScript 类型声明（package\.json 声明了 types 入口），安装后即可获得类型提示，无需再安装 @types 包。

### @defrex/autobuild 支持 ESM 还是 CommonJS？

以 ES Module 形式发布，推荐使用 import 引入。在 CommonJS 项目中，Node\.js 20\.19\+ / 22\.12\+ 可以直接 require\(\) 不含顶层 await 的 ES Module，更早的版本需要改用动态 import\(\)。

### @defrex/autobuild 可以商用吗？

@defrex/autobuild 使用 Apache-2\.0 许可。宽松许可：允许商业使用、修改和再分发，并附带明确的专利授权；分发时需保留许可与 NOTICE 文件，修改过的文件要注明改动。以上为概括，不构成法律意见，请以许可原文为准。

### @defrex/autobuild 的下载量有多少？

根据 npm 官方下载统计，@defrex/autobuild 在 2026/10/12 – 2026/11/10 这 30 天内被下载 7,456 次，日均约 249 次。下载量会把 CI 构建、镜像同步和作为其他包依赖的安装一并计入，适合横向比较热度，不能直接等同于使用人数。

### @defrex/autobuild 还在维护吗？

最新版本 1\.6\.0 发布于 2026/11/12（今天）；至今共发布 23 个版本，其中过去 12 个月发布了 23 个；首次发布于 2026/09/17。发布频率只是参考信号：功能稳定的工具可能很少需要更新，建议结合源码仓库的 issue 和提交记录判断。