# @aviaratech/ai-delivery 中文文档

规范地址：https://npmcn.com/package/%40aviaratech/ai-delivery/

版本：0\.3\.41
npm 元数据更新时间：2026-11-02T17:43:48.758Z
中文译文更新时间：2026-11-07T08:03:34.531Z
软件包许可：MIT

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

原始 npm 页面：https://www.npmjs.com/package/%40aviaratech/ai-delivery
原文对照：https://npmcn.com/package/%40aviaratech/ai-delivery/?lang=original
项目主页：https://github.com/aviaratech/ai-delivery#readme
源码仓库：https://github.com/aviaratech/ai-delivery

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

- 包体积（解压后）：6.6 MB，317 个文件
- 模块格式：ES Module
- TypeScript 类型：包内自带
- Node.js 要求：\>=24\.21\.0 \<25 \|\| 26\.2\.0
- 运行依赖：9 个
- 首次发布：2026-09-25T18:00:14.482Z
- 最新版本发布：2026-11-02T17:43:48.337Z
- 近 30 天下载量：4033（2026-10-07 至 2026-11-05，npm 官方下载统计）
- 已发布版本数：46（近 12 个月 46 个）

## 中文简介

通用 GitHub 发行并拉动请求交付 CLI 和 MCP 服务器

## 安装

```sh
npm install @aviaratech/ai-delivery
```

也可以使用：`pnpm add @aviaratech/ai-delivery`、`yarn add @aviaratech/ai-delivery`、`bun add @aviaratech/ai-delivery`

## README

# (ai) 交付

ai- 交付手柄 **GitHub 问题、调取请求和独立审查** 通过CLI,stdio MCP服务器和Codex/Claude代码插件. GitHub拥有关系,项目跟踪,检查和审查资格. 主办单位要做好工作树种,检查,承诺,推倒和清理.

明确 `--repo owner/name` 或 MCP 程序 `repo: "owner/name"` 在基特城外工作过 没有它,退票 `origin` 选择仓库。 仅 `github.com` 被支持。 运行时间读取操作员拥有的JSON;它从来不执行消耗性存储器的政策或检查.

## 安装和运行时间

使用节点 **24.21.0 国家** 页:1 **11.19.0 (简体中文)** 用于CLI/MCP和贡献者检查;公共图书馆消费者也支持节点 **26.2.0 (中文(简体) )**。安装合格的出版版本或已审查的档案。 这个 [完整插件](https://npmcn.com/package/%40aviaratech/ai-delivery/plugins/ai-delivery/README.md) cLI/SDK/MCP的切入点.

```sh
npm install --global @aviaratech/ai-delivery@<qualified-version>
ai-delivery plugin install --host codex --scope user --version <qualified-version> --json
ai-delivery plugin doctor --host codex --scope user --json
ai-delivery --repo example/widget info --issue 17
ai-delivery mcp:serve
```

使用 `--host claude-code` 用于支持 Claude 代码 `user`, (中文(简体) ), `project` 财务报告和审定财务报表 `local` 范围; 代码支持 `user`。选择一个带有 `--repo-root`。在恢复错误上保留管理状态;从不默默替换另一个版本.

## 用户配置

使用 `~/.config/aviaratech-ai/ai-delivery.json`,或绝对值 `AI_DELIVERY_CONFIG` 路径。 消耗性寄存器不需要 AI 交付文件 。 示例设置 :

```json
{
  "schemaVersion": "ai-delivery.user@1",
  "roles": {
    "author": {
      "identity": "host-author",
      "authSource": "personal",
      "credentialEnv": { "token": "GH_TOKEN" }
    },
    "reviewer": {
      "identity": "delivery-reviewer",
      "authSource": "app",
      "appId": 12345,
      "installationId": 67890,
      "actorLogin": "your-reviewer-app[bot]",
      "provider": "openai"
    }
  },
  "project": 7,
  "checkoutRoots": ["/absolute/path/to/clones"]
}
```

将全权证书置于来源控制之外。 没有常规 `GH_TOKEN` 选择当前活动 `gh` 个人会话; 一个空/无效值不切换账户而失败 。 自定义符号引用需要它们的精确值 。 审查者使用其独特的配置App,没有个人倒置. 读取 [全权证书和准备情况](https://npmcn.com/package/%40aviaratech/ai-delivery/plugins/ai-delivery/README.md#credentials-and-readiness),包括GUI环境限制,遗留的 App 参考和所选关键源.

插图审查器配置文件读取未加密的 RSA PEM 从 `GH_PRIVATE_KEY_DELIVERY_REVIEWER` 何时 `credentialSource` 省略。 提供它通过你现有的秘密机制。 可选的内存/文件/命令来源跟随 [配置计划a](https://npmcn.com/package/%40aviaratech/ai-delivery/src/config/deliveryConfig.ts);一个失败的源从不选择另一个.

## 5分钟审查员设置

用 `contents:read` 财务报告和审定财务报表 `pull_requests:write`,其实际身份/提供者,以及一个支持证书来源。 认证并不证明得到批准。 跟着 [独立审查员命令](https://npmcn.com/package/%40aviaratech/ai-delivery/plugins/ai-delivery/README.md#independent-reviewer-command) 财务报告和审定财务报表 [审查计划](https://npmcn.com/package/%40aviaratech/ai-delivery/src/review.ts)。严格 `review submit` 要求所要求的/有效的模型元数据和提供者的相容性;从不编造未暴露的元数据。 常设单位 `pr:review --artifact` 路线.

## GitHub 有固定寿命周期

创建/更新有问题、结果、接受/防守、非目标、本土问题类型和点的打出的问题。 重写时保留历史. 准备,开放,解锁的问题可以开始;单独准备不能启动工作.

```sh
ai-delivery --repo example/widget ready:check --issue 17
ai-delivery --repo example/widget start --issue 17
# Host: prepare worktree, implement, check, commit and push.
ai-delivery --repo example/widget pr:create --issue 17 --body-file pr-body.md
# Independent reviewer submits its own exact-head verdict/artifact.
ai-delivery --repo example/widget pr:create --issue 17 --ready
ai-delivery --repo example/widget pr:checks --pr 23
gh pr merge 23 --repo example/widget --squash --match-head-commit <sha>
```

GitHub目前需要的检查,计数审查,阻断和合并资格规范准确的头/当前底. 建造者从来不批准自己的作品. 在重试前读取不确定的文字; 尊重明确的提供者/只读请求和实际主机拒绝.

GitHub删除合并后的头部分支;主机删除了自己的工作树.

对于部分交付, `--non-closing` 打开一个从身体开始的草案 `References owner/repo#number`GitHub 将 PR 从 `issue/N` 分支作为关闭,因此工具在返回前删除了该链接。 一个完整的可执行孩子可以正常地关闭,而其父母则保持开放.

## 命令和工具映射

这些都是可执行的路径;小组/帮助旗被省略. 破折叠意味着没有匹配的表面。 使用每条路线 `--help` 和已出版的MCP计划供投入.

| 宪章/工作 | 国 际 | MCP 磁共振 |
| --- | --- | --- |
| 问题:创建/启动 | `create`, (中文(简体) ), `start` | `issue_create`, (中文(简体) ), `issue_start` |
| 问题:查找/阅读 | `list`, (中文(简体) ), `search`, (中文(简体) ), `info`, (中文(简体) ), `ready:check` | `issue_list`, (中文(简体) ), `issue_search`, (中文(简体) ), `issue_info`, (中文(简体) ), `issue_ready_check` |
| 问题:编辑/批次 | `update`, (中文(简体) ), `batch:update` | `issue_update`, (中文(简体) ), `issue_batch_update` |
| 问题:期刊 | —— 说 | `issue_comment` |
| 调取请求 | `pr:create`, (中文(简体) ), `pr:info` | `issue_pr_create`, (中文(简体) ), `issue_pr_info` |
| 拉动请求:观察 | `pr:list`, (中文(简体) ), `pr:checks` | —— 说 |
| 审查:文物 | `pr:review` | `issue_pr_review` |
| 审查:概况/核查 | `review doctor`, (中文(简体) ), `review submit` | —— 说 |
| 执行支持:插件 | `plugin install`, (中文(简体) ), `plugin doctor`, (中文(简体) ), `plugin preview`, (中文(简体) ), `plugin update`, (中文(简体) ), `plugin rollback`, (中文(简体) ), `plugin remove` | —— 说 |
| 所有:设置/运输 | `config:resolve`, (中文(简体) ), `mcp:serve` | —— 说 |

合同是 `ai-delivery.mcp@2`· ; [工具计划](https://npmcn.com/package/%40aviaratech/ai-delivery/src/mcp/tools.ts) 和国别学习 `--help` 提供完整的投入。 结果保留警告、历史和恢复领域;MCP `verbose: true` 或 CLI 状态 `--json --verbose` 要求满载有效载荷。 日刊 `status` 与项目状态分开.

## 升级主机

选择一个明确限定的版本; 历史 **0.3.35 (中文(简体) )** 已检查示例 **2026-10-22 (英语)**不是今天最新消息的保证 保存更新符合克劳德代码 **2.1.296 (中文(简体) )** 和 Codex CLI 代码 **0.162.1 (中文(简体) )** 只有这个 Claude的降级仍然不合格;Codex回滚选择它之前录制的版本.

被安装的元数据,单独的医生启动和活动对话所装入的MCP版本是截然不同的. 记录未曝光已装入的版本为未验证. 遵循主机的激活引导,在操作员批准重启前保留活动任务. Windows命令证书来源和被保护文件许可等同性仍然不合格.

## 插件安装

遗留独立 MCP 支持至少持续时间 **两次稳定释放,90天** 在经过合格移民后,第一个船只;锚仍不明。 预览/博士没有资格迁移或启动该时钟 。 移民申请、登记退休和设置回滚仍然无法使用;见 [116号](https://github.com/aviaratech/ai-delivery/issues/116)。公共 npm / 本地目录发行不建立插件目录录入.

## 捐助者检查和释放

[捐款额](https://npmcn.com/package/%40aviaratech/ai-delivery/CONTRIBUTING.md) 拥有被钉入的工具,有重点的局部检查,完整的GitHub检查和放行程序. 普通的公关检查不包括放行装置/存档案例;快速/重点突出的成功绝不符合一揽子计划。 通过 `AI_DELIVERY_NODE26_EXECUTABLE` 必要时.

发布仍需要准确的强制性档案清单、完整的发布/消费者/清理证明、保密审查和TruffleHog扫描。 干库存、固定安装、惰性再包装或包装不是当前存档/内存-采纳证明。 出版物使用独立接受的来源/版本/开发以及成功的原始文物;核实实际登记字节、完整性、加密出处和 `latest` 后结. 永远不要以后置重运行替换缺失的证明 .

发行是手动的,只使用主机,并使用 npm 信任的出版. 一个被包的README编辑修改了发行对象:保留被接受的档案,并在发送前独立地对新的准确出处/存档进行限定.

源版本 **0.3.41 (中文(简体) )** 绿色公关检查没有确定资格 [199号](https://github.com/aviaratech/ai-delivery/issues/199). 包装和工作流程定义不能证明 [200块](https://github.com/aviaratech/ai-delivery/issues/200)是因为 **60秒以下定期检查/5分钟以下合格** 目标。 功能清除和剩余文件义务保持不变 [#201号](https://github.com/aviaratech/ai-delivery/issues/201)。 。 。 .

## 常见问题

### @aviaratech/ai-delivery 是什么？

通用 GitHub 发行并拉动请求交付 CLI 和 MCP 服务器

### 如何安装 @aviaratech/ai-delivery？

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

### @aviaratech/ai-delivery 支持 TypeScript 吗？

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

### @aviaratech/ai-delivery 支持 ESM 还是 CommonJS？

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

### @aviaratech/ai-delivery 需要什么版本的 Node\.js？

package\.json 的 engines 字段要求 Node\.js \>=24\.21\.0 \<25 \|\| 26\.2\.0。版本不符时 npm 默认只给出警告，开启 engine-strict 后会拒绝安装。

### @aviaratech/ai-delivery 可以商用吗？

@aviaratech/ai-delivery 使用 MIT 许可。宽松许可：允许商业使用、修改和再分发，通常只需在分发时保留原版权与许可声明。以上为概括，不构成法律意见，请以许可原文为准。

### @aviaratech/ai-delivery 的下载量有多少？

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

### @aviaratech/ai-delivery 还在维护吗？

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