源码系统概览
文章正文
jiuwenswarm 是一个面向复杂任务的多智能体（Multi-Agent）蜂群协作框架，强调“理解意图、自主演化”，让多个 Agent 协同拆解并完成复杂工作。
它把多个专业 Agent 组织成一个可协作的蜂群，让复杂任务被拆解、分配并汇总，同时保留规划、性能与集群等多种运行策略。
源码简介
jiuwenswarm 由 openJiuwen-ai 团队开源，主体以 Python 3.11+ 实现，前端控制台使用 TypeScript/React 构建，并包含终端 TUI。
框架围绕 Agent Client Protocol（ACP）组织多智能体通信，配套 jiuwenbox 沙箱运行时实现隔离执行。
它内置技能自演化（Skill Self-Evolution）机制，支持群聊/集群模式、规划模式与性能模式，并提供 Docker 部署方案。
项目遵循 Apache-2.0 协议，代码量与测试覆盖都较充足。
框架的 Python 内核负责编排与调度，React 前端提供可视化工作台，jiuwenbox 则承担隔离执行，整体形成从编排到落地的闭环。
适用场景
该项目适合需要把大型任务拆给多个专业 Agent 协作的团队，例如自动化研发流水线、资料调研与写作、运维编排或需要可控沙箱执行的代码生成场景。
对于希望基于开源框架搭建自己“AI 员工团队”的开发者，jiuwenswarm 提供了一套从编排、隔离到可视化的较完整底座。
功能亮点
支持 Swarm 蜂群协作模式，把复杂任务分解为多 Agent 协同的子任务并汇总结果。
提供规划模式（Plan Mode）与性能模式（Performance Mode），分别面向可控推演与高吞吐执行。
内置 jiuwenbox 沙箱，使用 landlock 与独立进程隔离工具调用，降低执行风险。
Web 控制台、TUI 与集群模式让多人在同一任务空间内协作，技能自演化机制可在运行中沉淀与复用经验。
技术架构与部署指南
| 维度 | 本套源码 | 同类通用方案 |
|---|---|---|
| 技术栈 | 前端：React/TypeScript 构建的 Web 控制台与终端 TUI 界面。 | 依具体方案选型，需自行搭建与维护 |
| 部署方式 | 通过 pip 安装 jiuwenswarm，配置模型供应商与技能目录后启动 server/launcher。 | 多托管于第三方平台或订阅云服务 |
| 功能侧重 | 支持 Swarm 蜂群协作模式，把复杂任务分解为多 Agent 协同的子任务并汇总结果。 | 功能通用，定制深度有限 |
| 数据归属 | 数据自持，部署在自有服务器，不出站 | 数据通常留存于服务商侧 |
| 成本模式 | 获取后自主部署，无持续授权费用 | 通常按订阅或调用量计费 |
技术栈与运行环境
前端：React/TypeScript 构建的 Web 控制台与终端 TUI 界面。
后端：Python 实现的 Agent 编排内核、ACP 协议适配层与任务调度。
数据库：运行时状态多为内存与本地文件，可选代理与沙箱元数据持久化。
运行环境：Python 不低于 3.11，支持 Windows、macOS、Linux，提供 Docker 部署。
其他依赖：jiuwenbox 沙箱运行时、landlock 隔离、MCP 与各类模型 SDK。
安装与部署提示
通过 pip 安装 jiuwenswarm，配置模型供应商与技能目录后启动 server/launcher。
Web 控制台与 TUI 均可访问，集群模式需额外配置节点。
生产环境建议使用官方 Docker 镜像与 jiuwenbox 沙箱，避免让 Agent 直接在本机无隔离地执行命令。
首次部署请先阅读 docs 中的配置与权限说明。
截图与演示说明
仓库 docs/assets/images 下提供了丰富的界面与架构截图。
下图展示了 jiuwenswarm 的模型配置界面，可以看到多模型与 API Key 的管理方式。
集群模式界面呈现了多节点协同的任务空间。
规划模式把任务拆解为可回溯的步骤。
性能模式侧重于高并发执行的可视化。
TUI 终端界面适合本地快速操作。
整体布局概览则帮助理解各模块的位置关系。
这些截图均来自官方文档，能直观呈现蜂群协作的工作台形态。
常见问题
问：和普通单个 Agent 有什么区别？
jiuwenswarm 通过 Swarm 把任务拆给多个专业 Agent 协作完成，并支持规划、性能与集群等多种运行模式。
问：沙箱如何做隔离？
jiuwenbox 使用 landlock 与独立沙箱进程执行工具调用，减少本机无隔离执行带来的风险。
问：是否支持可视化？
提供 React Web 控制台与终端 TUI，集群模式下还能多人协作同一任务空间。
安全风险提示
静态扫描在仓库文档中检出凭据类特征，经研判均为示例占位值，并非真实泄露密钥，但部署前仍建议替换为自有密钥并避免把真实密钥提交到仓库。
路径：jiuwenbox/README.md、jiuwenbox/README_CN.md。
类型：hardcoded-credential（文档示例密钥）。
证据：示例配置中出现 sk_sandbox_managed_openai_key、sk_sandbox_managed_custom_key、sk_fake_key 等占位值，以及 JIUWENBOX_API_TOKEN 的 openssl rand 生成示例。
建议：上线前将示例值替换为自有密钥，真实密钥通过环境变量注入，切勿提交到仓库或写入前端代码。
特别提示：以上均为文档示例占位，并非真实泄露凭据；
下载后请仍对源码做一次安全审计，确认无恶意代码后再部署使用！
下载说明
源码仅供学习研究、测试部署和二次开发参考，商用前请自行确认授权、版权和安全风险。
本项目为 Apache-2.0 协议，可自由使用但须保留版权与许可声明。
由于框架支持 Agent 在本机或沙箱中执行命令，请仅在受信任环境启用执行权限，并为对外暴露的服务设置独立鉴权，避免未授权调用。
GitHub项目开源地址：https://github.com/openJiuwen-ai/jiuwenswarm