📌 项目地址BloopAI/vibe-kanban | ⭐ 26,579 颗星 | 🔧 Rust | 📜 Apache-2.0

Vibe Kanban 在 GitHub 拿了 26579 颗星,然后 2025 年宣布停止维护。README 第一行写着“Vibe Kanban is sunsetting”。我读了这个项目的源码和文档,它解决的问题很具体,但最终被自己支撑的复杂性压垮。这篇分析不说空话,只讲事实和工程判断。

一条命令启动 AI 代理工作流

执行 npx vibe-kanban 后,本地启动一个服务,浏览器里出现看板页面。流程是固定的:

  1. 在看板上创建 Issue,拖拽到执行状态
  2. 选一个编码代理(支持 10+ 种,列表见官网)
  3. 代理被放进一个 Workspace,每个 Workspace 有自己的 Git 分支、终端进程、开发服务器
  4. 代理改代码后,UI 实时显示 diff,你可以在 diff 行写注释,代理根据注释再改
  5. 改完自动生成 PR 描述,跳转到 GitHub 合并

整个链条是 Issue → Workspace → Diff → PR。每个步骤都有对应 UI,不需要切换窗口。README 原话:“Plan with kanban issues — create, prioritise, and assign issues on a kanban board”和“Review diffs and leave inline comments — send feedback directly to the agent”。

Workspace 隔离:最实在的技术设计

每个 Workspace 对应三样东西:

  • 一个独立 Git 分支:隔离代码修改
  • 一个终端进程:隔离代理输出和错误日志
  • 一个开发服务器:使用随机端口,避免端口冲突

多个代理跑同一个 Issue 的不同方案时,互不干扰。Rust 后端用 std::process::Command 启动子进程,通过 WebSocket 推送终端输出(这个细节我推测的,README 没详细描述)。分支创建和服务器端口分配都是自动的。

这种设计可以拿来复用:任何需要并行跑 AI 代理的场景,不限于看板。把每个代理的执行环境隔离成一个独立沙箱,相当于把“写代码”的动作标准化成一个可控进程。

为什么停更:IDE 内置代理和适配层维护成本

项目没有给出停更的具体原因。从产品逻辑和工程角度,我判断有两点。

第一,IDE 生态挤压独立看板。 VS Code 的 Copilot、Cursor 等工具把代理直接嵌在编辑器里。工程师在写代码的界面就能调用代理,不需要单独开一个看板页面。独立看板的价值被压缩到“多代理管理”和“流程可视化”上,大众市场已经被 IDE 吃掉。

第二,适配层维护成本太高。 Vibe Kanban 支持 10+ 种代理:Claude Code、Codex、Gemini CLI、Copilot、Amp、Cursor、OpenCode、Droid、CCR、Qwen Code。每个代理的调用方式、参数、配置文件都在快速迭代。项目停更后,这些适配全部冻结。如果某个代理改了命令行参数,你需要自己去改 Rust 源码里的调用逻辑。理想设计是把适配层做成可插拔的:抽象出一个 Agent Trait,每个代理一个独立模块,通过 JSON 配置文件注册。但项目没有这么做,所有适配写死在 Rust 代码里。

这是一个典型的“平台化过度”陷阱——为了支持所有主流代理,团队投入大量精力做适配,但每个代理都在变,维护工作像吹气球一样膨胀。一旦项目停止更新,这些适配立刻变成技术负债。

现在还能用吗:能用,但需要自己维护

启动命令就一行:

npx vibe-kanban

前提是你已经认证了想用的编码代理。支持的代理列表在官网 https://vibekanban.com/docs/supported-coding-agents

本地开发依赖:

  • Rust(latest stable)
  • Node.js(>=20)
  • pnpm(>=8)

安装开发工具:

cargo install cargo-watch
cargo install sqlx-cli

安装依赖和启动:

pnpm i
pnpm run dev

这会启动后端和 web 应用,数据库用 SQLite,初始数据从 dev_assets_seed 文件夹复制。

构建 web 应用:

cd packages/local-web
pnpm run build

团队协作需要自托管。README 提供的指南:https://vibekanban.com/docs/self-hosting/deploy-docker。自托管需要自己配置数据库和认证。

如果长期用,建议 fork 项目自己维护代理适配层,或者手动模仿工作流:为每个 Issue 建 Git 分支,用 claude codecodex 命令行执行,手动检查 diff。缺看板,但稳定性高。

对做类似项目的人:四个可借鉴的点

26579 星证明“看板 + AI 代理”这个需求真实存在。但如果你要做类似的工具,有四个坑值得避开。

第一,代理适配层必须可插拔。 每个代理一个独立模块,通过配置文件注册。添加新代理不修改核心代码。Vibe Kanban 的 Rust 后端把适配逻辑写死在代码里,导致停更后适配全部失效。

第二,服务端与本地脚本分离。 Vibe Kanban 把整个后端逻辑放在 Rust 二进制里,本地启动。要支持团队协作,需要用云服务。虽然项目提供了 Docker 自托管,但团队规模越大,维护越重。

第三,流程要可配置。 不是每个团队都想要“Issue → Workspace → Diff → PR”这四步。有的团队只需要 Workspace + Diff,有的想加审批流。Vibe Kanban 的流程是固定的,不能调整。

第四,考虑与 IDE 的融合。 独立 UI 在 IDE 生态挤压下生存空间很小。最好把看板功能做成 IDE 插件或 WebView,而不是独立浏览器应用。

Vibe Kanban 是一个过渡产品。它留下的 Workspace 隔离思路和流程标准化方法,比项目本身更有价值。停更不代表它的设计没有参考意义。

这篇文章对你有帮助吗?

发表回复