原子-原子

使用 原子 zed和其他会说代理客户协议的编辑器内部的编码代理.

开始吧  • 妇女  何谓有效  • 妇女  工作流量  • 妇女  配置  • 妇女  原子文件

如何运作

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

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

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

开始吧

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

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

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

添加到泽德

在泽德 settings.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 配置, 您定义的服务器在同一名称下获胜 .
• 如果原子在消息期间退出,消息会因原因而失败,而下一个消息在同一会话中再次启动原子.

工作流量

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

/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> 显示已保存的运行摘要 .

斜线命令

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

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

配置

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

参数后 -- 也涉及每个原子过程,例如 "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是测试客户端. 其他非加太客户应该发挥作用,但可能会提供不同的更新.

发展

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 就在这 这个 发布工作流程 检查标签, 运行测试并发布到 npm 值得信赖的出版。稳定版本转到 latest 字母改为 next。 。 。 .

贷项

• 皮亚克 由Sergii Kozak撰写
• Pi

许可证

麻省理工学院