# @agentproto/driver-cli 中文文档

规范地址：https://npmcn.com/package/%40agentproto/driver-cli/

版本：0\.3\.1
npm 元数据更新时间：2026-11-01T13:57:25.781Z
中文译文更新时间：2026-11-06T05:15:28.500Z
软件包许可：Apache-2\.0

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

原始 npm 页面：https://www.npmjs.com/package/%40agentproto/driver-cli
原文对照：https://npmcn.com/package/%40agentproto/driver-cli/?lang=original
项目主页：https://agentproto.sh/docs/aip-29
源码仓库：https://github.com/agentproto/ts

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

- 包体积（解压后）：51.9 kB，6 个文件
- 模块格式：ES Module
- TypeScript 类型：包内自带
- 运行依赖：2 个
- 首次发布：2026-06-20T19:13:21.632Z
- 最新版本发布：2026-11-01T13:57:25.464Z
- 近 30 天下载量：4930（2026-10-05 至 2026-11-03，npm 官方下载统计）
- 已发布版本数：15（近 12 个月 15 个）

## 中文简介

a. 代理proto/cli-runtime——AIP-29CLI供应商专业。 Sugar over @ agentproto/ driver 用于命令行二进制: argv turplating, 子进程引用, 退出码映射, 输出解析 。 v0.1 船舶子进程引用;OS级沙箱执行

## 安装

```sh
npm install @agentproto/driver-cli
```

也可以使用：`pnpm add @agentproto/driver-cli`、`yarn add @agentproto/driver-cli`、`bun add @agentproto/driver-cli`

## README

# @ agentproto/ driver-cli (英语)

参考实施CLI提供者的专门化 [**AIP-30 DRIVER.md (英语)**](https://agentproto.sh/docs/aip-30) `defineDriver` —— 说 `defineCliDriver` 将二进制包成符合的提供者: argv 调制 反对 `${input.X}` 编号 : `${secrets.X}`,子进程产卵,出站码 → 语义 错误映射, 以及文本/ JSON 输出解析 .

```ts
import { defineCliDriver } from "@agentproto/driver-cli"

const ghCli = defineCliDriver({
  id: "gh-cli",
  name: "GitHub CLI",
  description: "Wraps gh for PR operations.",
  kind: "cli",
  bin: "gh",
  implements: [
    {
      tool: "./tools/create-pr/TOOL.md",
      version: "^1",
      metadata: { cli: { argv: ["pr", "create", "--title", "${input.title}"] } },
    },
  ],
})
```

## 工作目录

`CliDriverDefinition.cwd` (可选的,绝对的)设置产入子进程的 工作目录。 保留未设置, 子进程继承任意目录 _东道主_ 进程恰好在运行中——对于独立的进程是正确的 TS授权驱动程序直接引用,但并非应用捆绑的DRIVER.md 通常意味着.

**应用捆绑的 cli 驱动程序解析中的相对路径 根号**而不是守护神自己的cwd。 当这个驱动程序从应用程序上载时 通过捆绑 `@agentproto/app`是因为 `loadAppBundledTools`, (中文(简体) ), `cwd` 设置为 app root( 目录包含 `.agentproto/`自动,除非 DRIVER. MD's (英语) `metadata.cli.cwd` 超越它——它本身相对于 app root, 如果在程序外解决, 则在装入时被拒绝 树根.

## 完成、超时和孤儿

一个呼叫完成 在产卵子进程自己的 `exit`从来没有在它的stdio `close` ——直取子孙 `exit` 只取决于自己的寿命,而 `close` 也等待它的出出出出出出出出出出出出出出出出出出出出出出出出出出出出出出出出出出出出出出出出出出出出出出出出出出出出出出出出出出出出出出出出出出出出出出出出出出出出出出出出出出出出出出出出出出出出出出出出出出出出出出出出出出出出出出入出出出出出出出出出出出出出出出出出出出出出出出出出出出出出出出出出出出出出出出出出出出出出出出出出出出出出出出出出出出出出出出出出出出出出出出出出出出出出出出出出出出出出出出出出出出出出出出出出出出出出出出出出出出出出出出出出出出出出出出出出出出出出出出出出出出出出出出出出出出出出 产卵的二进制 拥有继承或管状结构(例如无头的Chrome)的孩子可以离开 一个孤儿在二进制完成后很久 拿着管子打开 (孤儿甚至可以重现为第1名) `close` 永远,即使工具自称成功。 短排水窗口 之后 `exit` 仍然给任何已经上飞机的人机会 在降落之前 溪流被撕毁.

子进程被产出脱落(它自己的进程组). 跑步时 取消信号中止, 或在呼叫方暂停( 见 `@agentproto/workflow-runtime`按步数 `timeout_ms`,将每个 `tool` 步骤发送——这个软件包本身没有超时,WHOLE 进程组通过 `process.kill(-pid)` (SIGTERM,升级为 SIGKILL,如果幸存者在短暂的宽限期后仍然活着)——而不仅仅是 直接的孩子——这样一个孤儿分享这个群体不会超过这个呼声.

## 光谱

见 [AIP-29 (英语)](https://agentproto.sh/docs/aip-29) cLI 供应商 专业和 [AIP-30 (中文(简体) )](https://agentproto.sh/docs/aip-30) 基数 `defineDriver` 合同。 此软件包是 TypeScript 引用 执行.

## 常见问题

### @agentproto/driver-cli 是什么？

a\. 代理proto/cli-runtime——AIP-29CLI供应商专业。 Sugar over @ agentproto/ driver 用于命令行二进制: argv turplating, 子进程引用, 退出码映射, 输出解析 。 v0\.1 船舶子进程引用;OS级沙箱执行

### 如何安装 @agentproto/driver-cli？

在项目目录运行 npm install @agentproto/driver-cli，或使用 pnpm add / yarn add / bun add。

### @agentproto/driver-cli 支持 TypeScript 吗？

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

### @agentproto/driver-cli 支持 ESM 还是 CommonJS？

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

### @agentproto/driver-cli 可以商用吗？

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

### @agentproto/driver-cli 的下载量有多少？

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

### @agentproto/driver-cli 还在维护吗？

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