news 2026/9/4 11:47:55

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

作者头像

张小明

前端开发工程师

1.2k 24
文章封面图
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-kanban

Vibe Kanban 是一个 AI 编程代理任务管理看板：把 Claude Code、Codex、Gemini CLI 等编码代理排进看板并行执行。读完本文，你可以快速完成本地部署，并掌握代理切换与数据库迁移这两处高频改动。

📌 它解决什么问题

你可能熟悉这种流程：把一段需求贴进单个编码代理，盯着它跑完，再开新窗口处理下一个任务。Vibe Kanban 把这个流程变成了一块看板：

  • 任务可视化：每张任务卡对应一次 AI 编程代理的执行，排队、运行、完成状态一目了然；
  • 多代理并行：任务可以分派给 Claude Code、Codex、Gemini、Qwen Code 等不同代理，各自在独立工作环境里执行，互不干扰；
  • 过程可回看：执行结束后可回看日志、代码变更和 PR 创建情况，还能追加指令继续迭代；
  • 本地自托管：服务跑在你自己的机器上，数据落在本地 SQLite，不依赖云服务。

🔧 开工前自检：环境清单

动手之前，把下面三样按 package.json 和 rust-toolchain.toml 的声明核对一遍：

  1. Node.js 20+ 与 pnpm 8+：仓库把 pnpm 固定在 10.13.1，执行corepack enable后版本会自动对齐；
  2. Rust 工具链：项目用 rust-toolchain.toml 锁定nightly-2025-12-04，装了 rustup 的话首次构建会自动切换，无需手工配置；
  3. Docker（可选）：只有想验证容器化部署时才需要，本地开发用不到。

三项齐活就可以开工，缺哪项从官方渠道装好再重开一次终端。

🚀 最快跑通路线

整个流程合并成一条操作流，按顺序执行即可：

git clone https://gitcode.com/GitHub_Trending/vi/vibe-kanban cd vibe-kanban pnpm install pnpm dev

pnpm dev是根脚本的入口：它先为前后端分配端口，再同时拉起 Rust 后端（带cargo watch热重载）和 Vite 前端开发服务器。浏览器里看到看板页面加载出来，就算跑通了。首次执行 Rust 要编译大量依赖，耐心等十来分钟，之后的启动就快了。

📂 关键文件速览

想深入看代码，先打开这三个文件，各自职责很清晰：

  • 前端入口packages/local-web/src/app/entry/Bootstrap.tsx：React 根节点在这里挂载，TanStack Query 数据层、Sentry 错误追踪、PostHog 行为分析这些「全局插件」都集中接在这里；
  • 工作区定义Cargo.toml：Rust 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 就够了。

🩺 卡住了？先查这三处

  1. 端口冲突：开发端口由 scripts/setup-dev-environment.js 动态分配，页面打不开时先确认后端端口没被占用、VK_ALLOWED_ORIGINS指向的是前端地址；
  2. 依赖缺失：cargo build报编译错误多半是系统库没装齐，照 Dockerfile 构建阶段的清单装一套——gcc、libclang-dev、libssl-dev、pkg-config，本地就能通过；
  3. 数据库迁移状态：后端起来了但报表结构错误，检查数据目录里是否残留旧库文件，用 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），仅供参考

版权声明: 本文来自互联网用户投稿，该文观点仅代表作者本人，不代表本站立场。本站仅提供信息存储空间服务，不拥有所有权，不承担相关法律责任。如若内容造成侵权/违法违规/事实不符，请联系邮箱：809451989@qq.com进行投诉反馈，一经查实，立即删除！
网站建设 2026/9/4 11:47:15

Unsloth Desktop实战：本地大模型接入ClaudeCode完全指南

从本地跑大模型到把模型接进日常开发工作流&#xff0c;这两年可选的工具越来越多。我自己的使用轨迹大概是这样的&#xff1a;最早习惯在命令行里用 Ollama 拉模型&#xff0c;图它轻巧&#xff0c;一条命令就能起服务&#xff1b;后来又装了 LM Studio&#xff0c;在 macOS 和…

作者头像 李华
网站建设 2026/9/4 11:47:09

微信聊天记录备份导出完整指南：一条命令免费永久保存

微信聊天记录备份导出完整指南&#xff1a;一条命令免费永久保存 【免费下载链接】WeChatMsg 提取微信聊天记录&#xff0c;将其导出成HTML、Word、CSV文档永久保存&#xff0c;对聊天记录进行分析生成年度聊天报告 项目地址: https://gitcode.com/GitHub_Trending/we/WeChat…

作者头像 李华
网站建设 2026/9/4 11:46:34

DSOGI-PLL在有源电力滤波器中的闭环建模与参数整定

和有源电力滤波器打过交道的工程师&#xff0c;大概率都有过这种经历&#xff1a;仿真里 DSOGI-PLL 能完美锁相&#xff0c;波形干净得可以直接放进论文&#xff1b;可一旦换到畸变电网、不平衡电网&#xff0c;或者把算法移进 DSP&#xff0c;之前“照着文献搭”的模型就开始出…

作者头像 李华
网站建设 2026/9/4 11:44:13

从VPE.rar实战解析虚拟化环境部署：配置驱动与自动化运维

简介&#xff1a;本资源是Linux内核级虚拟网络引擎VPE&#xff08;Virtual Packet Engine&#xff09;的源码实现包&#xff0c;面向具备Linux内核网络子系统基础的中高级开发者与虚拟化网络研究者&#xff0c;用于深入理解SDN理念下的软件定义包转发与路由机制。压缩包为RAR格…

作者头像 李华
网站建设 2026/9/4 11:41:33

Grok Build：声明式任务自动化工具，简化开发运维工作流

/* MD / 富文本中的 .toc（含博客园搬家等嵌套结构）；.toc-box 在侧栏，不受影响 */#content_views .toc,/* 编辑器常在目录前后插入空 p（:empty 仍占 20px），一并去掉避免顶空隙 */#content_views.markdown_views > p:empty:has(+ .toc),#content_views.markdown_views …

作者头像 李华
网站建设 2026/9/4 11:37:22

niri 配置快速上手：10 分钟配好可平铺可滚动的 Wayland 桌面

niri 配置快速上手&#xff1a;10 分钟配好可平铺可滚动的 Wayland 桌面 【免费下载链接】niri A scrollable-tiling Wayland compositor. 项目地址: https://gitcode.com/GitHub_Trending/ni/niri niri 是一个可滚动平铺的 Wayland 合成器&#xff1a;窗口自动排成竖直…

作者头像 李华