Vibe Kanban 从零跑起来：AI 编程代理看板本地部署与配置避坑指南

Vibe Kanban 从零跑起来AI 编程代理看板本地部署与配置避坑指南【免费下载链接】vibe-kanbanGet 10X more out of Claude Code, Codex or any coding agent项目地址: https://gitcode.com/GitHub_Trending/vi/vibe-kanbanVibe Kanban 是一个 AI 编程代理任务管理看板把 Claude Code、Codex、Gemini CLI 等编码代理排进看板并行执行。读完本文你可以快速完成本地部署并掌握代理切换与数据库迁移这两处高频改动。 它解决什么问题你可能熟悉这种流程把一段需求贴进单个编码代理盯着它跑完再开新窗口处理下一个任务。Vibe Kanban 把这个流程变成了一块看板任务可视化每张任务卡对应一次 AI 编程代理的执行排队、运行、完成状态一目了然多代理并行任务可以分派给 Claude Code、Codex、Gemini、Qwen Code 等不同代理各自在独立工作环境里执行互不干扰过程可回看执行结束后可回看日志、代码变更和 PR 创建情况还能追加指令继续迭代本地自托管服务跑在你自己的机器上数据落在本地 SQLite不依赖云服务。 开工前自检环境清单动手之前把下面三样按 package.json 和 rust-toolchain.toml 的声明核对一遍Node.js 20 与 pnpm 8仓库把 pnpm 固定在 10.13.1执行corepack enable后版本会自动对齐Rust 工具链项目用 rust-toolchain.toml 锁定nightly-2025-12-04装了 rustup 的话首次构建会自动切换无需手工配置Docker可选只有想验证容器化部署时才需要本地开发用不到。三项齐活就可以开工缺哪项从官方渠道装好再重开一次终端。 最快跑通路线整个流程合并成一条操作流按顺序执行即可git clone https://gitcode.com/GitHub_Trending/vi/vibe-kanban cd vibe-kanban pnpm install pnpm devpnpm dev是根脚本的入口它先为前后端分配端口再同时拉起 Rust 后端带cargo watch热重载和 Vite 前端开发服务器。浏览器里看到看板页面加载出来就算跑通了。首次执行 Rust 要编译大量依赖耐心等十来分钟之后的启动就快了。 关键文件速览想深入看代码先打开这三个文件各自职责很清晰前端入口packages/local-web/src/app/entry/Bootstrap.tsxReact 根节点在这里挂载TanStack Query 数据层、Sentry 错误追踪、PostHog 行为分析这些「全局插件」都集中接在这里工作区定义Cargo.tomlRust workspace 的根列出crates/server、crates/db、crates/executors等三十多个 crate并统一声明 tokio、axum 等公共依赖执行器配置crates/executors/default_profiles.json各 AI 代理的默认执行参数比如 CLAUDE_CODE 默认跳过权限确认、CODEX 用全量访问沙箱、CURSOR_AGENT 指定模型为 auto。 两处高频改动切换AI代理 数据库迁移第一处切换 AI 代理。在设置页面可以直接换用哪个代理想改默认参数就打开 default_profiles.json结构是「执行器 → 场景 → 参数组」三层改完保存后端会自动热重载生效。第二处新增数据库迁移。表结构改动都走 crates/db/migrations/ 里的 SQL 迁移文件。照着现有YYYYMMDDHHMMSS_描述.sql的命名放一个新文件即可服务启动时按文件名顺序执行所以时间戳前缀一旦定下就不要改。 上线部署Docker 要点根目录的 Dockerfile 是两阶段构建前端先用node:24-alpine构建pnpm 构建缓存已配置后端再用rust:1.93-slim-bookworm编译。构建时可用--build-arg注入监控配置docker build --build-arg SENTRY_DSN你的DSN -t vibe-kanban .注意团队远程协作云服务是独立工作区crates/remote有自己单独的 docker-compose.yml 和数据库准备脚本只做本地看板的话用根目录的 Dockerfile 就够了。 卡住了先查这三处端口冲突开发端口由 scripts/setup-dev-environment.js 动态分配页面打不开时先确认后端端口没被占用、VK_ALLOWED_ORIGINS指向的是前端地址依赖缺失cargo build报编译错误多半是系统库没装齐照 Dockerfile 构建阶段的清单装一套——gcc、libclang-dev、libssl-dev、pkg-config本地就能通过数据库迁移状态后端起来了但报表结构错误检查数据目录里是否残留旧库文件用 scripts/prepare-db.js 可以初始化和校验数据库状态。本地跑通就是上面那几条命令的事代理切换和数据库迁移也有据可依了。打开看板把第一个任务派给 AI 编程代理让它们并行干活吧。【免费下载链接】vibe-kanbanGet 10X more out of Claude Code, Codex or any coding agent项目地址: https://gitcode.com/GitHub_Trending/vi/vibe-kanban创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考