KaibanJS
用看板式界面编排、运行并观察 JavaScript 多智能体工作流。
- Star 数
- ★ 1.5k
- 最近更新
- 5 个月前
- License
- MIT
- 主语言
- TypeScript
- FA 评分
- 33/100 · 缺口较多
30 秒速览
- 运行形态
- 可在哪里用
- 通用 · 跨平台Codex · Claude Code · OpenAI API · Claude API
- 费用
- 软件免费，模型调用费用自付
- 上手难度
- 低 · 几分钟可跑通
- 开始前需要
- 典型场景
- JavaScript 团队要把研究、撰写、编辑拆成连续任务，并将研究任务结果传给后续内容任务。
- 不适合
- 需要稳定生产接口、不能承受 beta 版本变更的团队
- 在浏览器或纯前端环境使用外部编码代理的开发者
这个 Agent 能做什么，适合哪些场景？
KaibanJS 是面向 JavaScript 的多智能体系统框架，核心对象为 Agent、Task 与 Team。Team 负责启动任务流、在任务之间传递结果，并可通过 Kaiban Board 实时展示任务状态和最终结果。开发者既可将其作为 npm 库接入 React、Node.js 等项目，也可创建自定义 UI 或在无 UI 的环境中运行。框架提供团队级 memory、Redux-inspired 状态管理、工作流日志以及多模型配置。它还包含 WorkflowDrivenAgent，用于执行确定性工作流，以及在 Node 或服务器运行时调用 Claude Code、OpenCode 或 Codex 本地 CLI 的 ExternalCodingAgent。
开发者用 new Agent() 定义角色、目标、背景、工具或 llmConfig，用 new Task() 指定 description、expectedOutput 和负责的 agent，再用 new Team() 汇集 agents、tasks、inputs、env 与 memory。调用 team.start() 会执行工作流，并返回含 result 的输出；后续任务可用 {taskResult:taskN} 引用前序任务结果。Kaiban Board 可显示任务从“To Do”到“Done”的过程，useStore() 可读取 agents、tasks、workflowResult 和 workflowLogs，并订阅状态变化、耗时、LLM 用量及成本信息。Tool 可接入 LangchainJS-compatible tools；WorkflowDrivenAgent 通过 @kaibanjs/workflow 的 createStep 与 createWorkflow 执行定义好的步骤；ExternalCodingAgent 则使用 child_process 启动本地编码 CLI。
- JavaScript 团队要把研究、撰写、编辑拆成连续任务，并将研究任务结果传给后续内容任务。
- React 应用需要以 useStore() 把智能体、任务状态和 workflowResult 显示在自建界面中。
- Node.js 服务需要运行无界面的 Team 工作流，并从 team.start() 获取最终结果。
- 需要为不同职责选择 Google、Anthropic 和 OpenAI 模型的团队，希望在同一 Team 中配置各 Agent 的 llmConfig。
- 本地开发者希望把某个任务委派给 Claude Code、OpenCode 或 Codex CLI，而非通过 LangChain 发起 LLM 调用。
- 需要人工介入、暂停和恢复的确定性多步骤流程，可将 @kaibanjs/workflow 包装为 WorkflowDrivenAgent。
如何安装或部署这个 Agent？
在项目目录运行：
npx kaibanjs@latest init将 AI 服务密钥写入 .env，例如：
VITE_OPENAI_API_KEY=your-api-key-here然后运行：
npm run kaiban也可手动安装：
npm install kaibanjsExternalCodingAgent 仅适用于 Node 或服务器运行时；使用 Codex 时，先执行 codex login，或提供 OPENAI_API_KEY。
如何使用这个 Agent？
导入 import { Agent, Task, Team } from 'kaibanjs';，创建 Agent、关联该 Agent 的 Task，并用 agents、tasks 和 env 创建 Team。调用 team.start()，从成功结果读取 output.result；失败时处理 Promise rejection。首次使用看板时运行 npm run kaiban，点击“Start Workflow”执行默认示例，并在 Task Board 与 Results Overview 查看进度和结果。若任务要使用前序输出，在描述中写入 {taskResult:taskN}；是否自动提供历史任务结果由 Team 的 memory: true 或 false 决定。
这个 Agent 有哪些优点和局限？
- 以 Agent、Task、Team 三个明确对象组织工作流，并支持 {taskResult:taskN} 的任务结果传递。
- Kaiban Board 将任务状态可视化；useStore() 和 workflowLogs 还可用于自建监控界面与订阅日志。
- 同一团队可为不同 Agent 配置 Google、Anthropic 或 OpenAI 模型，并可使用 LangchainJS-compatible tools。
- WorkflowDrivenAgent 为无需 LLM 推理的确定性流程提供步骤执行、暂停和恢复能力。
- ExternalCodingAgent 可将任务交给 Claude Code、OpenCode、Codex 或 mock 后端。
- README 标注稳定性为 beta，采用前应为接口和行为变化预留验证与升级成本。
- 运行 LLM 工作流需要相应服务的 API 凭据；示例要求配置 VITE_OPENAI_API_KEY。
- 外部编码代理依赖本机 CLI、认证和 Node 或服务器运行时；浏览器 bundle 会将 node:child_process 标为 external。
- 框架声称面向 React、Vue、Angular、NextJS 和 Node.js 的兼容性，但所给材料未说明各环境的版本要求或完整部署矩阵。
这个 Agent 与同类方案有什么区别？
README 将 Kaiban Board 类比为面向智能体和人的 Trello 或 Asana：共同点是用看板跟踪工作项；KaibanJS 的具体对象是 Agent、Task 与 Team，并可执行工作流。
与相关度最高的同类 agent 并排比较关键指标。
| Agent | 源码审查 | 形态 / 费用 | Star | 最近更新 | 主语言 | 完整支持的平台 |
|---|---|---|---|---|---|---|
| KaibanJS 当前 | 33 · 缺口较多 | 命令行工具免费 + 模型费 | ★ 1.5k | 5 个月前 | TypeScript | Codex · Claude Code · OpenAI API · Claude API |
| Dynamiq 智能体编排框架 | 61 · 存在缺口 | 代码库 / SDK免费 + 模型费 | ★ 1.1k | 1 天前 | Python | OpenAI API |
| amux 智能体控制平面 | 77 · 表现良好 | 自托管服务免费 + 模型费 | ★ 554 | 1 天前 | Rust | Codex · Claude Code |
| acpx | 57 · 缺口较多 | 命令行工具免费 + 模型费 | ★ 3.4k | 1 天前 | TypeScript | Codex · Claude Code |
FollowAgents 如何评估这个 Agent？
查看各维度的扣分理由
证据显示框架需要API密钥（如OPENAI_API_KEY）并可能执行外部CLI命令（如claude-code），但未提供权限最小化、用户确认或数据流透明度的机制。敏感数据处理（如API密钥）未明确说明存储和传输方式。依赖众多（如langchain、zustand），但未提供安全审计或漏洞扫描证据。外部效果（如调用外部API、执行CLI）未明确限制或提示。回滚机制未提及。来源归属（如作者、版权）在LICENSE中明确，但发布者身份未验证。因此所有信任标准得分为0。
自一致性：README和package.json基本一致，但存在一些不一致（如README提到'Kaiban Board'，package.json中无对应脚本）。依赖可用性：依赖列表完整，但未提供锁定文件或完整性校验。失败消息：代码中可能有错误处理，但未提供具体示例。因此各得1分。
受众和场景：README明确面向JavaScript开发者，提供多种集成场景（React、Node.js等），得2分。能力边界：文档描述了多种功能（如WorkflowDrivenAgent、ExternalCodingAgent），但未明确限制或边界，得1分。触发精度：任务和代理定义明确，但未提供精确的触发条件，得1分。环境适配：支持多种框架和Node.js，但未提供浏览器端支持细节，得2分。
信息架构：README结构清晰，有目录和详细章节，得2分。安装说明：提供npm安装和初始化命令，得2分。命名稳定性：版本号存在，但未提供命名规范或稳定性说明，得1分。示例和FAQ：提供多个代码示例，但无FAQ，得2分。已知限制：未明确列出，得1分。许可证：MIT许可证明确，得2分。版本和变更日志：有版本号，但无CHANGELOG文件，得1分。维护责任：有贡献指南和社区支持，但发布者未验证，得1分。
输出可用性：提供清晰的输出示例（如workflowResult），得2分。边际价值：针对JavaScript生态提供多代理框架，有独特价值，得2分。成本效益：未提供性能或成本数据，得1分。
声明可追溯性：README中的功能声明未链接到具体代码或测试，得1分。跨来源佐证：有测试文件（如opentelemetry测试），但未覆盖所有声明，得1分。事实与推断分离：文档中区分了功能描述和示例，但未明确标注推断，得1分。
- 源码中未见：最小权限约束只授予完成任务所需的权限：用专用账号或只读令牌，并限定可访问的目录和仓库。
- 源码中未见：执行前用户确认开启或自行加上执行前确认；先在沙箱或测试环境跑通，确认行为后再接入真实数据。
- 源码中未见：数据流向说明运行时观察它连接了哪些外部服务（代理或防火墙日志）；弄清数据去向之前不要输入敏感数据。
- 源码中未见：敏感信息处理使用专用、低权限、可随时吊销的 API 密钥，不要复用生产凭据，也不要让密钥出现在日志里。
- 源码中未见：依赖安全审查安装前固定版本并做一次依赖扫描（如 npm audit、pip-audit）；优先放在容器里运行。
- 源码中未见：外部影响披露先弄清它会写入、发送或修改哪些外部系统，用测试账号或测试仓库验证后再接入正式环境。
- 源码中未见：回滚或恢复路径运行前先备份，或在 git 分支、快照上操作，确保改动可以撤销。
- 源码中未见：来源归属可核验从官方仓库或包源安装，核对发布者和仓库地址，避免同名仿冒包。
- 框架需要API密钥，但未提供安全存储或传输的指导，存在泄露风险。
- 外部CLI执行（如claude-code）可能带来安全风险，需谨慎使用。
- 依赖众多，但未提供安全审计或漏洞扫描证据，供应链风险未知。
- 发布者身份未验证，需谨慎评估信任度。
最近版本
来自该项目 GitHub Releases 的最新发布记录，说明为上游原文摘录，未经本站改写或测试。
-
发布说明摘录
KaibanJS v0.24.1 🚀 🤖 External Coding Agents: delegate tasks to Claude Code & OpenCode KaibanJS introduces ExternalCodingAgent — a new agent type that runs your task prompt through a local coding CLI instead of routing inference through LangChain. Use it for headless coding workflows, repo-aware answers, and two-step “planner + reviewer” style teams where each step is a separate CLI invocation. The agent is built for Node / server runtimes (it uses child_process; browser bundles treat node:child_process as external). What you can plug in | Backend | Behavior | …在 GitHub 查看 ↗ -
发布说明摘录
KaibanJS v0.23.0 🚀 🤖 WorkflowDrivenAgent: Deterministic Workflow Execution KaibanJS introduces WorkflowDrivenAgent — a revolutionary new agent type that executes predefined workflows instead of using traditional LLM-based reasoning. This enables deterministic, structured execution with full control over workflow patterns and state management. The WorkflowDrivenAgent is the centerpiece of this release, bringing workflow-driven automation to multi-agent systems with support for: - Sequential Processing: Linear workflow execution with step-by-step control …在 GitHub 查看 ↗ -
发布说明摘录
KaibanJS v0.22.0 🚀 🤖 xAI Grok Model Support (Including Grok-4) KaibanJS now supports the latest Grok-4 model from [xAI](https://x.ai) — bringing advanced LLM reasoning into your multi-agent workflows. Alongside Grok-4, this release also adds compatibility with additional xAI variants: - grok-3 - grok-3-mini - grok-3-mini-fast Whether you're building lightweight prototypes or full-scale agentic systems, KaibanJS now offers native support for all current xAI model versions. 🌐 How to Use …在 GitHub 查看 ↗