# @bastani/atomic-acp 中文文档

规范地址：https://npmcn.com/package/%40bastani/atomic-acp/

版本：0\.0\.16
npm 元数据更新时间：2026-11-04T01:07:11.214Z
中文译文更新时间：2026-11-07T21:58:28.709Z
软件包许可：MIT

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

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

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

- 包体积（解压后）：454 kB，5 个文件
- 模块格式：ES Module
- TypeScript 类型：未声明
- Node.js 要求：\>=20
- 运行依赖：3 个
- peer 依赖：@bastani/atomic \>=0\.9\.39
- 首次发布：2026-10-13T08:15:27.851Z
- 最新版本发布：2026-11-04T01:07:10.813Z
- 近 30 天下载量：2306（2026-10-08 至 2026-11-06，npm 官方下载统计）
- 已发布版本数：17（近 12 个月 17 个）

## 中文简介

ACP 原子编码剂适配器

## 安装

```sh
npm install @bastani/atomic-acp
```

也可以使用：`pnpm add @bastani/atomic-acp`、`yarn add @bastani/atomic-acp`、`bun add @bastani/atomic-acp`

## README

# 原子-原子

**使用 [原子](https://github.com/bastani-inc/atomic) zed和其他会说代理客户协议的编辑器内部的编码代理.**

[**开始吧**](https://npmcn.com/package/%40bastani/atomic-acp/#readme-get-started)  • 妇女  [何谓有效](https://npmcn.com/package/%40bastani/atomic-acp/#readme-what-works)  • 妇女  [工作流量](https://npmcn.com/package/%40bastani/atomic-acp/#readme-workflows)  • 妇女  [配置](https://npmcn.com/package/%40bastani/atomic-acp/#readme-configuration)  • 妇女  [原子文件](https://docs.bastani.ai/)

[![Tests](https://github.com/bastani-inc/atomic-acp/actions/workflows/test.yml/badge.svg)](https://github.com/bastani-inc/atomic-acp/actions/workflows/test.yml) [![ACP v1](https://img.shields.io/badge/ACP-v1-0A7EA4)](https://agentclientprotocol.com/) [![Docs](https://img.shields.io/badge/docs-atomic-blue)](https://docs.bastani.ai/) [![Discord](https://img.shields.io/badge/join%20community-discord-5865F2?logo=discord&logoColor=white)](https://discord.gg/9CvdXUGXR4) [![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](https://npmcn.com/package/%40bastani/atomic-acp/LICENSE)

## 如何运作

您的编辑器开始 `atomic-acp` 和它说话在stdio [非加太集团](https://agentclientprotocol.com/)对于每一个聊天线索, `atomic-acp` 启动一个 `atomic --mode rpc` 处理和翻译两者.

```text
Zed (ACP client) ⇄ atomic-acp ⇄ atomic --mode rpc
```

原子读取文件,编辑代码,运行您机器上的命令,与终端一样. 只有开放的工作空间,你信任.

## 开始吧

你需要20号或更新型的 和0.9.39或更新型的, 签到至少一个模型提供者:

```bash
npm install -g @bastani/atomic @bastani/atomic-acp
atomic   # sign in, then quit
```

`atomic-acp` 使用该 `atomic` 在你身边 `PATH`运行 `atomic-acp --help` 对于它的选项.

### 添加到泽德

在泽德 `settings.json`数字 :

```json
{
  "agent_servers": {
    "Atomic": {
      "type": "custom",
      "command": "atomic-acp",
      "args": [],
      "env": {}
    }
  }
}
```

打开代理面板, 选择 **原子** 并开始一条线。 如果原子没有工作登录, Zed 显示 **认证** 在终端打开原子的横幅. `atomic-acp --terminal-login` 做同样的.

没有全局安装, 使用 `"command": "npx", "args": ["-y", "@bastani/atomic-acp"]`。 。 。 .

## 何谓有效

-   文字和推理流入线程. 工具调用显示其状态和文件,编辑显示diff,而 shell命令显示其输出.
-   线条是原子会话. 他们出现在编辑的历史和 `atomic --resume`,保留其标题,并在重启适配器后幸存。 删除线索删除其会话 .
-   模型和思维拾取者列出了你的原子设置提供的内容,而上下文指示数则显示了背景的完整程度.
-   快速模板、技能`/skill:name`)和扩展命令,例如 `/workflow` 在斜线菜单中显示.
-   当原子要求您选择,确认或输入某种东西时,编辑器会显示一个表格.
-   `ask_user_question` 以一个形式显示其所有问题,包含多个选择.
-   MCP 服务器 编辑器配置到线程的原子过程,其工具可调用为 `mcp__<server>__<tool>`Stdio和HTTP服务器工作,SSE服务器被跳过. `atomic-acp` 永远不要写到您的 Atomic MCP 配置, 您定义的服务器在同一名称下获胜 .
-   如果原子在消息期间退出,消息会因原因而失败,而下一个消息在同一会话中再次启动原子.

## 工作流量

原子工作流程从编辑器中运行,就像在终端一样:

```text
/workflow list
/workflow ralph prompt="Add rate limiting to the API"
/workflow status
```

一个启动工作流程的信息会一直打开,直到每次运行结束,因此编辑器在工作仍在进行时不会像报告所做的那样报告代理. 每个运行都作为工具调用,带有阶段和结果.

-   取消信件会退出运行 。 继续一个 `/workflow resume <runId>`。 。 。 .
-   等待您输入的运行会停止保存消息 。 在线索中回复, 代理回复 提示 .
-   设定 `ATOMIC_ACP_WAIT_FOR_WORKFLOWS=0` 一旦启动运行,即可结束消息.

`/workflow-runs [status]` 列出项目最近的运行,以及 `/workflow-run <runId>` 显示已保存的运行摘要 .

## 斜线命令

除了原子提示,技能和扩展命令:

| 命令 | 它会做什么 |
| --- | --- |
| `/compact [instructions]` | 缩小背景 |
| `/autocompact on|off|toggle` | 打开或关闭自动收缩 |
| `/session` | 会话ID、令牌、信件和费用 |
| `/name <name>` | 重命名会话 |
| `/export` | 导出会话为 HTML 到工作文件夹 |
| `/steering`, (中文(简体) ), `/follow-up` | 显示或设置队列中信件的发送方式 |
| `/changelog` | 显示原子的更改日志 |

使用编辑器取出 `/model` 财务报告和审定财务报表 `/thinking`,并用新的线程代替 `/clear`。 。 。 .

## 配置

设置于 `env` 您的代理服务器条目 :

| 变量 | 默认 | 目的 |
| --- | --- | --- |
| `ATOMIC_ACP_ATOMIC_COMMAND` | `atomic` | 原子可执行文件的路径或名称 |
| `ATOMIC_ACP_ATOMIC_ARGS` | 未设定 | JSON 每个原子过程的额外参数阵列 |
| `ATOMIC_ACP_WAIT_FOR_WORKFLOWS` | `1` | `0` 结束信件而不等待它开始的运行 |
| `ATOMIC_ACP_HEADLESS` | 未设定 | `1` 当没有人能回答问题时(见下文) |
| `ATOMIC_ACP_ENABLE_EMBEDDED_CONTEXT` | 未设定 | `true` 让编辑器直接附加文件内容到提示 |

参数后 `--` 也涉及每个原子过程,例如 `"args": ["--", "--model", "openai/gpt-6.1-sol"]`。标记适配器自行管理,例如 `--mode` 和会话旗,启动时拒绝.

其他一切,包括登录,模型,技能,扩展和会话存储,都来自你的正常原子环境.

### 无头客户

与 `ATOMIC_ACP_HEADLESS=1`问题马上结束 而不是等待. `ask_user_question` 告诉模型没有人可用,扩展对话框被取消,停止输入的工作流程被退出. 仍能取还.

## 限制

-   `ask_user_question` 需要Atomic 0.9.50或更新,需要支持ACP格式(删除)的编辑器。 没有他们,问题就无法回答.
-   原子自己读取,写作和运行命令. 编辑器的文件和终端API没有被使用.
-   Atomic 忙碌时发送的信件被队列并一次发送一个.
-   Zed是测试客户端. 其他非加太客户应该发挥作用,但可能会提供不同的更新.

## 发展

```bash
npm install
npm run dev     # run from source
npm test
npm run lint
npm run build
```

`src/acp/` 支持非加太方面 `src/atomic-rpc/` 原子过程包装器。 这个 `npm run smoke:*` 脚本驱动一个真实的,签名的原子 并花费模型符号,所以它们不是的一部分 `npm test`。 。 。 .

## 释放

合并一个名为“合并”的承诺 `Release X.Y.Z` (或 `Release X.Y.Z-alpha.N`)将该版本设置在 `package.json`标记 `X.Y.Z` 就在这 这个 [发布工作流程](https://npmcn.com/package/%40bastani/atomic-acp/.github/workflows/publish.yml) 检查标签, 运行测试并发布到 npm [值得信赖的出版](https://docs.npmjs.com/trusted-publishers)。稳定版本转到 `latest` 字母改为 `next`。 。 。 .

## 贷项

-   [皮亚克](https://github.com/svkozak/pi-acp) 由Sergii Kozak撰写
-   [Pi](https://pi.dev/)

## 许可证

[麻省理工学院](https://npmcn.com/package/%40bastani/atomic-acp/LICENSE)

## 常见问题

### @bastani/atomic-acp 是什么？

ACP 原子编码剂适配器

### 如何安装 @bastani/atomic-acp？

在项目目录运行 npm install @bastani/atomic-acp，或使用 pnpm add / yarn add / bun add。它还需要宿主项目提供 peer 依赖：@bastani/atomic（\>=0\.9\.39）。npm 7 及以上与 pnpm 8 及以上默认会自动安装必需的 peer 依赖，Yarn 需要手动安装。它还提供命令行工具 atomic-acp，可以用 npx atomic-acp 直接运行。

### @bastani/atomic-acp 支持 TypeScript 吗？

该包的 package\.json 没有声明类型入口。需要类型提示时，可以在 npm 上查找社区维护的 @types/bastani\_\_atomic-acp 是否存在。

### @bastani/atomic-acp 支持 ESM 还是 CommonJS？

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

### @bastani/atomic-acp 需要什么版本的 Node\.js？

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

### @bastani/atomic-acp 可以商用吗？

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

### @bastani/atomic-acp 的下载量有多少？

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

### @bastani/atomic-acp 还在维护吗？

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