# @desplega\.ai/agent-swarm 中文文档
规范地址：https://npmcn.com/package/%40desplega.ai/agent-swarm/
版本：2\.11\.0
npm 元数据更新时间：2026-11-11T04:19:01.454Z
中文译文更新时间：2026-11-12T01:35:06.182Z
软件包许可：MIT
本文由上游 README 翻译，可能存在偏差，请结合原文核对 API、命令与配置。版权与许可归原作者所有。
原始 npm 页面：https://www.npmjs.com/package/%40desplega.ai/agent-swarm
原文对照：https://npmcn.com/package/%40desplega.ai/agent-swarm/?lang=original
项目主页：https://agent-swarm.dev/
源码仓库：https://github.com/desplega-ai/agent-swarm
## 关键信息（来自 npm 元数据）
- 包体积（解压后）：119 MB，3540 个文件
- 模块格式：ES Module
- TypeScript 类型：未声明
- 运行依赖：59 个
- peer 依赖：typescript ^5
- 首次发布：2025-12-17T17:10:20.222Z
- 最新版本发布：2026-11-11T04:19:01.077Z
- 近 30 天下载量：19346（2026-10-12 至 2026-11-10，npm 官方下载统计）
- 已发布版本数：252（近 12 个月 252 个）
## 中文简介
agent-swarm.dev——AI工作的开源操作系统:一个牵头代理将目标突破成任务,引导目标到克洛德代码或Codex等专业工人手中,将每个工人运行在一个孤立的容器中,并保留共享的记忆,工具,时间表,
## 安装
```sh
npm install @desplega.ai/agent-swarm
```
也可以使用：`pnpm add @desplega.ai/agent-swarm`、`yarn add @desplega.ai/agent-swarm`、`bun add @desplega.ai/agent-swarm`
## README
[](https://github.com/desplega-ai/agent-swarm/stargazers) [](https://github.com/desplega-ai/agent-swarm/blob/main/LICENSE) [](https://github.com/desplega-ai/agent-swarm/pulls)
**[斯汉姆探员](https://swar.am/) 是开源的自托管的AI公司操作系统,由 [德普勒加实验室](https://desplega.sh/)。 。 。 .**
> \[TIP\] **这种回波每天都在演化.** [现在看](https://github.com/desplega-ai/agent-swarm/subscription)
▸ [每支队伍,一队](https://npmcn.com/package/%40desplega.ai/agent-swarm/assets/agent-swarm-every-team.mp4) • 妇女 [每日演变](https://npmcn.com/package/%40desplega.ai/agent-swarm/assets/agent-swarm.mp4) • 妇女 [制作](https://npmcn.com/package/%40desplega.ai/agent-swarm/assets/video-source)
[](https://agent-swarm.dev/) [](https://docs.agent-swarm.dev/) [](https://app.agent-swarm.dev/) [](https://discord.gg/KZgfyyDVZa) [](https://x.com/agent__swarm) [](https://www.linkedin.com/company/desplega-labs/) [](https://www.youtube.com/@desplega-labs/videos)
swarm.dev是一个用于AI工作的开源操作系统. 首席特工代表的目标为克劳德·克德克或克德克思等工人. 隔开的容器、共享的内存、工具、时间表和审查闸门保存各会的工作.
## 你得到的东西
- 接收来自Slack、寄存器、发行跟踪器、电子邮件或API的作品的牵头代理
- [任务结果](https://npmcn.com/package/%40desplega.ai/agent-swarm/MCP.md#send-task) 用于需要结构化 JSON 输出的呼叫者
- [被推迟的任务](https://npmcn.com/package/%40desplega.ai/agent-swarm/MCP.md#defer-task) 当所有或任何被监视的任务都达到结果或最后期限时
- [内置工具结果图像](https://docs.agent-swarm.dev/docs/ui#tool-result-images) 在任务日志中,带有以全尺寸打开的预览
- [Dashboard 文件附件](https://docs.agent-swarm.dev/docs/ui#file-attachments) 通过粘贴、拖放或文件拾取器
- 与开发环境隔绝的多克容器中的工人
- 内存和身份在会话中长期存在,默认情况下启用了引用评级和自评提示
- 经常性工作的工作流程、时间表、脚本和应用程序
- [扩展](https://docs.agent-swarm.dev/docs/guides/extensions) 用于信任的 TypeScript 钩子,作为代理拥有的惰性草稿安装,并由信任的铅、操作员或仪表板用户激活
- [实时会议室](https://npmcn.com/package/%40desplega.ai/agent-swarm/runbooks/realtime-rooms.md) 用于共享页面状态、存在和直播频道
- 你对绳索和模型的选择:克洛德代码, Codex, pi,开口代码, [光标](https://docs.agent-swarm.dev/docs/guides/provider-auth/cursor), Amp, (英语), [格鲁克](https://docs.agent-swarm.dev/docs/guides/provider-auth/grok), (中文(简体) ), [fx 时速](https://docs.agent-swarm.dev/docs/guides/provider-auth/fx)或非加太公司代理人
```mermaid
flowchart LR
subgraph IN["Tasks come in"]
direction TB
S["Slack"]
G["GitHub / GitLab"]
E["Email"]
A["API / CLI"]
end
LEAD(["Lead Agent
plans & delegates"])
subgraph WORKERS["Workers in Docker"]
direction TB
W1["Worker"]
W2["Worker"]
W3["Worker"]
end
subgraph BRAIN["Persistent brain"]
direction TB
MEM["Memory
(vector search)"]
ID["Identity
(SOUL, CLAUDE.md)"]
end
subgraph OUT["Work ships"]
direction TB
PR["Pull Requests"]
REPLY["Slack replies"]
EMAIL["Email replies"]
end
IN --> LEAD --> WORKERS
WORKERS -->|reads context| BRAIN
WORKERS -->|writes learnings| BRAIN
WORKERS --> OUT
```
## 快速启动
给您的编码代理, 操作员对 Docker Compose 或 Kubernetes 的技能 :
```bash
npx skills add desplega-ai/agent-swarm
```
或者把它安装为插件 :
| 节奏 | 命令 |
| --- | --- |
| 克劳德代码 | `/plugin marketplace add desplega-ai/agent-swarm` 接下来 `/plugin install agent-swarm@agent-swarm` |
| 代码 | `codex plugin marketplace add desplega-ai/agent-swarm && codex plugin add agent-swarm@agent-swarm` (或使用) `npx skills` 上文) |
| 光标 | `/add-plugin desplega-ai/agent-swarm` |
| 双子座CLI | `gemini extensions install https://github.com/desplega-ai/agent-swarm` |
| 抗重力/工厂机器人 | `droid plugin marketplace add https://github.com/desplega-ai/agent-swarm` 接下来 `droid plugin install agent-swarm@agent-swarm` |
| OpenCode, pi, Devin, Kimi, 其他人的游戏 | `npx skills add desplega-ai/agent-swarm` |
该插件的 [隐私](https://www.agent-swarm.dev/privacy) 财务报告和审定财务报表 [术语](https://www.agent-swarm.dev/terms) 链接描述 Swarm探员网站和 云服务. 自动托管的软件仍由该软件覆盖 [MIT 许可证](https://npmcn.com/package/%40desplega.ai/agent-swarm/LICENSE)。 。 。 .
或自为主. [`docker-compose.example.yml`](https://github.com/desplega-ai/agent-swarm/blob/main/docker-compose.example.yml) 是参考部署:默认部署其中的每个代理(1个领导和11个工作人员在正式模板上),仅在有正当理由时才删除代理.
计划至少4 vCPU,8 GB RAM和40 GB的自由磁盘,以及升级后prune老多克图像. 见 [主机要求和磁盘清理](https://docs.agent-swarm.dev/docs/guides/host-requirements)。 。 。 .
单发安装器检查 Docker 和 Compose v2, 丢失时安装 Bun, 运行 `agent-swarm onboard --yes --preset full` (每个正式模板;它运行一个编码器,其中实例运行两个),并打印仪表板 `/setup` 链接 :
```bash
curl -fsSL https://agent-swarm.dev/install.sh | bash
```
原始的 GitHub URL (`https://raw.githubusercontent.com/desplega-ai/agent-swarm/main/install.sh`)服务于同一剧本. API默认通过隧道公开,由API密钥保护. 添加 `bash -s -- --no-tunnel` 以保持当地.
没有服务器吗? 在一击中部署铁路模板:
[](https://railway.com/deploy/agent-swarm)
或者说 [部署一个](https://docs.agent-swarm.dev/docs/guides/one-click-deploy) 在任何 VPS 上: 粘贴 [`deploy/cloud-init.yaml`](https://npmcn.com/package/%40desplega.ai/agent-swarm/deploy/cloud-init.yaml) 作为新4 vCPU / 8 GB Ubuntu 服务器的用户数据(Hetzner, DigitalOcean, Lightsail, Vultr). 它安装了多克和凯迪,在HTTPS上服务API `.sslip.io` ,并显示 `/setup` 链接到登录时的 root。 先来看, [在E2B上试一小时](https://docs.agent-swarm.dev/docs/guides/one-click-deploy#try-it-for-an-hour-on-e2b);当沙盒停止时,该试验会删除其数据.
或者直接使用这些例子:
```bash
git clone https://github.com/desplega-ai/agent-swarm.git && cd agent-swarm
cp .env.docker.example .env # Set API_KEY and the credential for your HARNESS_PROVIDER.
openssl rand -base64 32 > encryption_key
chmod 600 .env encryption_key
docker compose -f docker-compose.example.yml --env-file .env up -d
```
代理ID变量是可选的 。 每个容器在第一个靴子上生成一个UUID并保持其个人体积,所以身份可以活下来重启. 键 `*_AGENT_ID` 内 `.env` 只为了保持现有身份或活下来去除体积.
读取 [编写核对表](https://npmcn.com/package/%40desplega.ai/agent-swarm/skills/agent-swarm/references/compose.md) 开始之前。 API: http://localhost: 30:13, 与 `/docs` 财务报告和审定财务报表 `/openapi.json`。 。 。 . 接下来,打开 [仪表板](https://app.agent-swarm.dev/) 连接到您的 API `API_KEY`。在 `/setup`,引导第一运行,涵盖提供者,代理,内存,集成,以及第一任务. 库伯涅斯: [安装 OCI Helm 图表](https://npmcn.com/package/%40desplega.ai/agent-swarm/charts/agent-swarm/README.md)。 。 。 .
## 一体化
克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克[聊天SDK](https://docs.agent-swarm.dev/docs/integrations/chat-sdk)· 混凝土-哨兵-德文- [紧急搜索](https://docs.agent-swarm.dev/docs/integrations/serply)。 。 。 . [融合指南](https://docs.agent-swarm.dev/docs/integrations)。 。 。 .
AgentMail的档案在确认运入货物之前先进行核查,并将档案保存了30天,包括排除任务路线的邮件. 见 [联系信箱分解程序簿](https://npmcn.com/package/%40desplega.ai/agent-swarm/runbooks/contact-inbox-triage.md) 保留、范围限制和推出指示.
## 学多点
- [开始](https://docs.agent-swarm.dev/docs/getting-started) • 妇女 [建筑](https://docs.agent-swarm.dev/docs/architecture/overview) • 妇女 [游戏本](https://docs.agent-swarm.dev/docs/playbooks) • 妇女 [国 际](https://docs.agent-swarm.dev/docs/reference/cli) • 妇女 [API 参考](https://docs.agent-swarm.dev/docs/api-reference)
- [管弦图案](https://npmcn.com/package/%40desplega.ai/agent-swarm/docs/orchestration-patterns.md) ——下放,扇出,取笑人类,再试等五种模式,并坚持多步代理工作
- [代理模板](https://templates.agent-swarm.dev/)
- [公开排名](https://docs.agent-swarm.dev/docs/reference/telemetry#public-ranking): 选择使用 **获得排名** (设置 ~ 配置 ~ 品牌) 排序您安装的符号 [dev/ 级别](https://agent-swarm.dev/ranking)它显示在下一个小时刷新。 托肯总计是公开和准确的;遥测,组织名称和网站必须设置.
- 帮助 : [联系人@desplega.sh](mailto:contact@desplega.sh) • 妇女 [解析器](https://discord.gg/KZgfyyDVZa)
## 捐款
读取 [捐款额](https://npmcn.com/package/%40desplega.ai/agent-swarm/CONTRIBUTING.md),叉出存储器,创建分支,并打开公关. 讨论关于 [解析器](https://discord.gg/KZgfyyDVZa)。 。 。 .
> 你是经纪人吗? 运行 `npx skills add desplega-ai/agent-swarm` 或读取 [操作技能](https://npmcn.com/package/%40desplega.ai/agent-swarm/skills/agent-swarm/SKILL.md)。 。 。 .
## 恒星历史
## 许可证
[麻省理工学院](https://npmcn.com/package/%40desplega.ai/agent-swarm/LICENSE) · 2025-2026年 [破伤风](https://desplega.sh/)
### 特性默认
新的部署启用了 Slack 线程渲染器 v2, 排队的 Slack 向导到线索, 任务指导、多运行时间工人、非洲区域局和任务工具预装。 混合内存 搜索和图表扩展也启用。 明确的环境/配置覆盖 继续支持;见 [环境参考](https://docs.agent-swarm.dev/docs/reference/environment-variables)。 。 。 . 当年长的工人升级时 `MULTI_RUNTIME_ENABLED=false` 直到他们支持 运行时间身份。 仍然选择使用和保留数据库 继续默认为干线运行.
## 常见问题
### @desplega\.ai/agent-swarm 是什么？
agent-swarm\.dev——AI工作的开源操作系统:一个牵头代理将目标突破成任务,引导目标到克洛德代码或Codex等专业工人手中,将每个工人运行在一个孤立的容器中,并保留共享的记忆,工具,时间表,
### 如何安装 @desplega\.ai/agent-swarm？
在项目目录运行 npm install @desplega\.ai/agent-swarm，或使用 pnpm add / yarn add / bun add。它还需要宿主项目提供 peer 依赖：typescript（^5）。npm 7 及以上与 pnpm 8 及以上默认会自动安装必需的 peer 依赖，Yarn 需要手动安装。它还提供命令行工具 agent-swarm，可以用 npx agent-swarm 直接运行。
### @desplega\.ai/agent-swarm 支持 TypeScript 吗？
该包的 package\.json 没有声明类型入口。需要类型提示时，可以在 npm 上查找社区维护的 @types/desplega\.ai\_\_agent-swarm 是否存在。
### @desplega\.ai/agent-swarm 支持 ESM 还是 CommonJS？
以 ES Module 形式发布，推荐使用 import 引入。在 CommonJS 项目中，Node\.js 20\.19\+ / 22\.12\+ 可以直接 require\(\) 不含顶层 await 的 ES Module，更早的版本需要改用动态 import\(\)。
### @desplega\.ai/agent-swarm 可以商用吗？
@desplega\.ai/agent-swarm 使用 MIT 许可。宽松许可：允许商业使用、修改和再分发，通常只需在分发时保留原版权与许可声明。以上为概括，不构成法律意见，请以许可原文为准。
### @desplega\.ai/agent-swarm 的下载量有多少？
根据 npm 官方下载统计，@desplega\.ai/agent-swarm 在 2026/10/12 – 2026/11/10 这 30 天内被下载 19,346 次，日均约 645 次。下载量会把 CI 构建、镜像同步和作为其他包依赖的安装一并计入，适合横向比较热度，不能直接等同于使用人数。
### @desplega\.ai/agent-swarm 还在维护吗？
最新版本 2\.11\.0 发布于 2026/11/11（今天）；至今共发布 252 个版本，其中过去 12 个月发布了 252 个；首次发布于 2025/12/18。发布频率只是参考信号：功能稳定的工具可能很少需要更新，建议结合源码仓库的 issue 和提交记录判断。