Vibe Kanban：BloopAI 开源的 AI 编码代理看板工具

一、Vibe Kanban是什么

Vibe Kanban是由BloopAI开源的一款专为开发者设计的AI编码代理协作与项目管理工具，基于看板模式提供可视化任务管理界面。它支持Claude Code、Gemini CLI等主流AI编码代理的集成，通过Git工作树隔离技术实现多智能体并行执行，同时提供任务跟踪、代码变更预览、开发流程集成等核心功能，有效解决多AI工具协调难、上下文丢失、代码审核繁琐等开发痛点。项目采用Rust+React技术栈构建，支持本地快速部署与远程SSH访问，适用于个人开发、团队协作及开源项目管理等多种场景，遵循Apache-2.0许可证，可自由定制与二次开发。

从本质上讲，Vibe Kanban是一个Kanban风格的图形化管理工具，核心定位是“AI编码代理的协作中枢”，它将分散的AI编码工具、Git仓库管理、任务跟踪流程整合到统一界面，让开发者从繁琐的命令行交互和工具切换中解放出来，专注于需求设计、任务规划和代码质量审核等核心工作。简单来说，如果你在开发中需要同时使用多个AI编码助手，或者希望对AI生成的代码进行规范化管理，Vibe Kanban就能成为连接开发者、AI工具与代码仓库的桥梁。

作为开源项目，Vibe Kanban采用Apache-2.0许可证，这意味着个人开发者、团队乃至企业都可以自由使用、修改和分发代码，无需担心商业使用限制，非常适合根据自身需求进行定制化开发。项目目前维护活跃，版本迭代频繁，最新版本已支持主流AI编码代理的集成，并持续优化开发流程与用户体验，在GitHub等开源平台获得了开发者社区的广泛关注。

与传统项目管理工具（如Jira、Trello）相比，Vibe Kanban的核心差异在于“AI编码代理原生支持”——它不是简单的任务展示工具，而是深度集成了AI执行、代码管理、开发环境隔离等技术特性，专门针对AI驱动的开发流程设计，这也是它区别于其他看板工具的核心竞争力。

二、功能特色

Vibe Kanban的功能设计围绕“AI编码代理协作”核心展开，覆盖项目管理、任务编排、AI集成、开发流程衔接等全链路场景，以下是其核心功能特色的详细介绍：

1. 可视化看板任务管理

Vibe Kanban延续了Kanban看板的经典设计，以卡片式布局组织任务，支持拖拽操作调整任务状态，直观呈现项目进度。每个任务卡片不仅包含描述、优先级等基础信息，还与AI编码代理、Git分支、工作空间深度绑定，成为“可执行的任务单元”而非单纯的状态标记。

核心能力包括：

• 任务状态自定义：支持“待执行（To Do）”“进行中（In Progress）”“已完成（Done）”等默认状态，可根据项目需求调整状态流转规则；

• 任务详情管理：支持添加富文本描述、备注信息，记录AI执行指令、开发要求等关键内容，避免需求传递偏差；

• 进度实时追踪：通过看板直观查看每个任务的执行状态、负责的AI代理、当前进度，无需手动查询或沟通确认；

• 优先级管理：支持任务优先级标记与排序，确保核心需求优先执行，合理分配AI与人力资源。

这种可视化设计解决了传统命令行交互中“任务状态不透明”的问题，让开发者对AI执行的任务一目了然，尤其适合多任务并行的开发场景。

2. 多AI编码代理集成与编排

这是Vibe Kanban最核心的特色功能，它打破了AI编码代理之间的壁垒，支持多个工具同时协作，实现“1+1>2”的开发效率提升。

目前已支持的主流AI编码代理包括：

• Claude Code：Anthropic推出的高级AI编码助手，擅长复杂逻辑实现与代码优化；

• Gemini CLI：Google开发的AI编码工具，支持多语言开发与测试用例生成；

• Amp：专注于开发流程自动化的AI代理，可快速完成重复编码工作；

• Codex：OpenAI推出的代码生成工具，支持多种编程语言的代码编写；

• 其他工具：还支持Echo（测试/调试专用）、Cursor CLI、Qwen Code等多款主流编码代理。

核心编排能力包括：

• 灵活切换代理：同一任务可选择不同AI代理执行，便于对比不同工具的输出效果；

• 并行/顺序执行：支持多个AI代理同时执行不同任务（并行），或按指定顺序执行关联任务（顺序），大幅提升任务吞吐量；

• 迭代式执行：支持对同一任务进行多次AI执行尝试，基于前一次结果优化指令，实现代码迭代优化；

• 集中配置管理：统一管理所有AI代理的MCP（模型配置参数），避免重复配置，确保执行标准一致。

例如，开发者可以让Claude Code负责核心逻辑编码，同时让Gemini CLI生成对应的测试用例，两个任务并行执行，无需等待一个完成后再启动另一个，显著节省开发时间。

3. 基于Git的安全隔离执行环境

为解决多AI代理并行执行时的代码冲突问题，Vibe Kanban引入了Git工作树（Git Worktree）技术，为每个任务创建独立的隔离环境，这是其保障代码安全的核心设计。

具体实现逻辑：

• 每个任务自动创建独立的Git分支与工作树，AI代理的所有修改都在该隔离环境中进行，不影响主分支代码；

• 任务之间的文件修改互不干扰，即使多个AI代理修改同一文件，也不会出现实时冲突；

• 支持分支Rebase操作，可随时同步主分支的最新代码，确保任务代码与项目主干保持一致；

• 任务执行失败或结果不符合预期时，可直接删除隔离环境，不会对项目主代码造成任何影响。

这种设计相当于为每个AI任务提供了“沙箱环境”，既保证了多任务并行的灵活性，又解决了AI生成代码的安全性问题，让开发者可以放心让多个AI代理同时工作。

4. 代码变更可视化与审核

AI生成的代码需要经过人工审核才能合并到项目中，Vibe Kanban内置了完整的代码审查流程，让审核工作更高效、更精准。

核心能力包括：

• 实时Diff对比：自动展示AI代理修改的代码内容，通过Git Diff格式清晰呈现新增、删除、修改的具体行数，无需手动对比文件；

• 执行日志追踪：记录AI代理的完整执行过程，包括输入指令、中间输出、错误信息等，便于排查问题；

• 手动编辑支持：审核过程中可直接在隔离环境中修改AI生成的代码，补充或优化逻辑后再进行合并；

• 一键合并/放弃：审核通过后可直接将隔离环境的代码合并到主分支，不符合要求则可一键放弃，操作简洁高效。

这一功能解决了传统流程中“AI代码审核繁琐”的痛点，将代码生成、审核、合并流程整合到同一界面，大幅减少工具切换与操作成本。

5. 无缝集成现有开发工作流

Vibe Kanban不强制改变开发者的现有习惯，而是通过灵活的集成能力融入现有开发流程，降低使用门槛。

主要集成能力包括：

• Git仓库深度集成：支持导入现有Git仓库或创建新仓库，自动检测仓库有效性，提供项目级文件搜索功能，可快速定位代码文件；

• 编辑器集成：支持在VS Code、Cursor、IntelliJ、Zed等主流代码编辑器中直接打开任务工作树，无缝衔接本地开发环境；

• GitHub协作集成：通过GitHub CLI可直接从看板创建Pull Request，或将审核通过的代码推送到远程仓库，无需手动操作Git命令；

• 开发服务器支持：内置开发服务器管理功能，可一键启动项目开发服务，实时预览AI生成的代码效果（如前端页面、接口功能等）；

• 远程SSH访问：支持在远程服务器上运行Vibe Kanban，通过SSH协议管理任务，适合云开发或远程协作场景。

6. 实用的开发者辅助工具

除核心功能外，Vibe Kanban还提供了一系列细节工具，提升开发体验：

• 实时执行监控：可查看AI代理的执行状态，支持单独停止某个任务或批量停止所有任务；

• 声音通知：任务执行完成后自动触发声音提醒，无需持续关注界面；

• 项目脚本自定义：可为每个项目配置专属的开发脚本（如启动命令、构建命令），一键执行；

• 文件系统浏览：支持直接浏览本地文件系统，快速导入或创建项目；

• 多项目管理：支持同时管理多个Git仓库项目，在同一界面切换不同项目的看板，适合多项目并行开发场景。

三、技术细节

Vibe Kanban的技术架构围绕“高性能、高可靠性、易扩展性”设计，采用前后端分离架构，结合Rust、React等主流技术栈，确保在多任务并行、Git操作频繁的场景下依然保持流畅体验。

1. 核心技术栈

这种技术选型既保证了后端处理的高性能与稳定性，又兼顾了前端界面的交互流畅性，同时降低了部署与维护成本（如SQLite无需额外数据库服务）。

2. 核心技术架构

Vibe Kanban采用分层架构设计，从下至上分为基础设施层、核心服务层、应用层与前端界面层，各层职责清晰，便于维护与扩展：

（1）基础设施层

• Git操作模块：封装Git仓库克隆、分支创建、工作树管理、Diff对比、合并等核心操作，为上层提供统一的Git操作接口；

• 进程管理模块：基于Tokio Process管理AI编码代理的进程生命周期，包括启动、监控、日志收集、强制终止等功能；

• 数据存储模块：使用SQLite存储项目信息、任务数据、AI代理配置等，通过Diesel ORM框架简化数据库操作；

• 文件系统模块：处理本地文件浏览、仓库导入、工作树创建与删除等文件操作，确保跨平台兼容性。

（2）核心服务层

• 项目管理服务：负责项目的CRUD操作，包括仓库导入、验证、配置保存、文件搜索等；

• 任务管理服务：处理任务的创建、状态更新、执行调度、历史记录存储等核心逻辑；

• AI代理服务：集成各类AI编码代理的API或CLI接口，提供统一的执行入口，支持参数配置与结果解析；

• 隔离环境服务：管理Git工作树与分支的创建、同步、删除，确保任务执行环境的隔离性；

• 通知服务：处理任务完成通知、错误提醒等，支持声音通知与界面弹窗提醒。

（3）应用层

• API接口层：提供RESTful API与WebSocket接口，供前端调用核心服务；

• 权限控制模块：支持多用户与组织管理，提供基础的权限控制功能，适合团队协作；

• 日志模块：记录系统操作日志、任务执行日志、错误日志，便于问题排查。

（4）前端界面层

• 看板组件：实现任务卡片拖拽、状态切换、详情展示等核心交互；

• 项目管理组件：提供项目导入、配置、切换等功能界面；

• 任务执行组件：展示AI代理执行状态、日志输出、代码Diff等信息；

• 工具组件：集成开发服务器启动、编辑器打开、Pull Request创建等辅助功能。

3. 关键技术实现原理

（1）Git工作树隔离机制

Vibe Kanban的隔离环境基于Git Worktree实现，其核心原理是：

• 每个任务创建时，系统自动执行git worktree add命令，在项目目录外创建独立的工作目录，并关联到专属分支；

• AI代理的所有代码修改都在该工作目录中进行，提交记录存储在专属分支；

• 任务审核通过后，执行git merge命令将专属分支的代码合并到主分支；

• 任务放弃或删除时，执行git worktree remove命令清理工作目录，同时删除专属分支，不残留垃圾文件。

这种实现方式既利用了Git的原生功能保证兼容性，又通过封装简化了操作复杂度，让开发者无需手动执行Git命令即可享受隔离环境带来的便利。

（2）多AI代理并行执行调度

Vibe Kanban通过Tokio异步运行时实现多AI代理的并行调度，核心逻辑：

• 任务执行时，系统为每个任务创建独立的异步任务（Task），由Tokio调度执行；

• 每个异步任务负责启动对应的AI代理进程，收集输出日志，并实时推送至前端；

• 通过Tokio的任务管理机制，支持同时运行多个AI代理进程，且进程之间互不干扰；

• 提供统一的进程监控接口，支持单独终止某个任务或批量终止所有任务，避免资源泄漏。

这种调度方式确保了多任务并行执行时的系统稳定性，即使同时运行多个AI代理，也不会出现卡顿或崩溃问题。

（3）实时状态同步机制

为实现任务执行状态的实时展示，Vibe Kanban采用WebSocket实现前后端实时通信：

• 前端页面加载时与后端建立WebSocket连接；

• 后端在任务状态变化（如启动、执行中、完成、失败）或AI代理输出日志时，通过WebSocket实时推送数据至前端；

• 前端接收数据后即时更新界面，无需手动刷新即可查看最新状态与日志。

这种机制保证了开发者能实时掌握AI代理的执行情况，及时发现并处理问题。

4. 跨平台兼容性

Vibe Kanban支持Windows、macOS、Linux三大主流操作系统，通过以下设计保证跨平台兼容性：

• 后端使用Rust的跨平台特性，Git操作、进程管理等底层功能通过条件编译适配不同操作系统；

• 前端基于React构建，使用跨平台UI组件库，确保界面在不同系统下的一致性；

• 依赖管理采用npm与Cargo结合的方式，自动处理不同系统的依赖差异，用户无需手动配置。

四、应用场景

Vibe Kanban的设计围绕AI编码代理协作展开，适用于多种开发场景，尤其适合需要高效利用AI工具提升开发效率的个人与团队：

1. 个人开发者的AI辅助开发

对于独立开发者而言，Vibe Kanban可成为AI编码助手的“管理中心”，解决单开发者同时使用多个AI工具的效率问题：

• 场景示例1：全栈开发中，让Claude Code负责后端接口开发，Gemini CLI负责前端页面实现，两个任务并行执行，开发者只需专注于需求拆解与代码审核，大幅缩短开发周期；

• 场景示例2：开源项目维护时，使用AI代理批量修复简单Bug（如语法错误、格式优化），通过Vibe Kanban的任务管理功能跟踪修复进度，审核通过后一键合并，减少重复劳动；

• 场景示例3：学习新技术时，让AI代理生成示例代码，通过隔离环境运行测试，无需担心污染本地项目，同时可通过任务历史记录回顾学习过程。

这类场景的核心价值是“解放开发者双手”，让AI承担重复性编码工作，开发者可将精力集中在更有创造性的需求设计与逻辑优化上。

2. 小型团队的协作开发

对于3-10人的小型开发团队，Vibe Kanban可作为团队协作中枢，规范AI工具的使用与代码管理流程：

• 场景示例1：前端团队开发时，团队成员分工拆解需求，为每个模块创建任务并分配给合适的AI代理，通过看板实时同步进度，避免重复开发或需求偏差；

• 场景示例2：远程协作项目中，团队成员通过SSH访问同一台服务器上的Vibe Kanban，共享项目看板与AI执行结果，无需频繁传输文件或同步代码，提升协作效率；

• 场景示例3：测试驱动开发（TDD）中，让AI代理根据需求生成测试用例，开发人员基于测试用例编写代码，通过Vibe Kanban的代码Diff功能对比实现与测试用例的匹配度，确保代码质量。

这类场景的核心价值是“统一协作流程”，让团队成员与AI工具形成高效配合，减少沟通成本与流程损耗。

3. 开源项目的贡献管理

开源项目通常有多个贡献者，且代码质量要求高，Vibe Kanban可帮助维护者高效管理AI辅助的贡献流程：

• 场景示例1：处理开源项目的Issue时，维护者可创建任务让AI代理初步修复问题，生成隔离环境的代码，然后邀请贡献者审核优化，最后合并到主分支，提升Issue处理效率；

• 场景示例2：为开源项目添加新功能时，维护者可通过Vibe Kanban编排多个AI代理并行开发不同模块，然后统一审核合并，缩短功能迭代周期；

• 场景示例3：管理贡献者提交的PR时，可通过Vibe Kanban的隔离环境运行PR代码，自动生成Diff对比，便于维护者快速审核，同时支持AI代理辅助排查潜在问题。

这类场景的核心价值是“提升开源项目的迭代效率”，让维护者能更高效地利用AI工具与社区贡献，降低开源项目的维护成本。

4. 企业级项目的AI规范开发

对于企业级项目，Vibe Kanban可作为AI编码的规范化管理工具，平衡效率与安全：

• 场景示例1：大型项目的模块开发中，企业可通过Vibe Kanban统一配置AI代理的参数与编码规范，确保不同团队使用AI生成的代码风格一致，减少后期整合成本；

• 场景示例2：敏感项目开发时，通过隔离环境控制AI代理的代码修改范围，避免误操作影响核心模块，同时保留完整的执行日志，便于审计与追溯；

• 场景示例3：新人培训场景中，让新人通过Vibe Kanban观察AI代理的编码思路与流程，同时可在隔离环境中尝试修改优化，快速提升开发能力，且不会影响项目主代码。

这类场景的核心价值是“规范AI编码流程”，在提升开发效率的同时，保障项目的安全性与可维护性。

五、使用方法

1. 前置条件

在使用Vibe Kanban前，需确保本地环境满足以下要求：

• Node.js：版本≥18（推荐18.x或20.x稳定版）；

• Rust：最新稳定版（用于后端编译，若仅通过npx运行可无需手动安装，自动下载依赖）；

• pnpm：版本≥8（前端依赖管理，可选，若需本地开发则需安装）；

• Git：最新稳定版（确保支持Git Worktree功能）；

• AI编码代理：已安装并完成身份验证（如Claude Code需配置API密钥，Gemini CLI需登录账号等）；

• 浏览器：推荐Chrome、Firefox、Edge等现代浏览器，确保支持WebSocket功能。

2. 安装部署

Vibe Kanban提供两种安装使用方式，可根据需求选择：

（1）快速启动（无需安装，推荐个人使用）

这是最简单的使用方式，通过npx直接运行，无需手动下载与安装，适合快速体验或临时使用：

1. 打开终端（Windows命令提示符、macOS终端、Linux终端均可）；

2. 输入以下命令，系统会自动下载最新版本的Vibe Kanban并启动：

   npx vibe-kanban

3. 命令执行成功后，会自动在默认浏览器中打开Vibe Kanban的界面（默认地址：http://localhost:3000），若未自动打开，可手动在浏览器输入该地址访问。

（2）本地开发部署（适合二次开发或团队定制）

若需对Vibe Kanban进行二次开发或本地部署，可通过源码编译的方式安装：

1. 克隆GitHub仓库：

   git clone https://github.com/BloopAI/vibe-kanban.git
   cd vibe-kanban

2. 安装前端依赖：

   cd frontend
   pnpm install # 若未安装pnpm，可先执行npm install -g pnpm

3. 编译后端代码：

   cd ..
   cargo build --release # 编译生成可执行文件

4. 启动服务：

   # 方式1：通过cargo直接启动
   cargo run --release
   
   # 方式2：运行编译后的可执行文件（Linux/macOS）
   ./target/release/vibe-kanban
   
   # Windows系统
   .\target\release\vibe-kanban.exe

5. 启动成功后，浏览器访问http://localhost:3000即可使用。

（3）远程服务器部署（适合团队协作）

若需团队共享使用，可部署在远程服务器上，通过SSH或公网地址访问：

1. 服务器环境需满足前置条件（Node.js、Rust、Git等）；

2. 克隆仓库并编译（步骤同本地开发部署）；

3. 启动服务时指定端口（可选，默认3000）：

   ./target/release/vibe-kanban --port 8080 # 指定端口8080

4. 配置服务器防火墙，开放指定端口（如8080）；

5. 团队成员可通过服务器IP+端口访问（如http://xxx.xxx.xxx.xxx:8080）；

6. 若需远程操作工作树，可通过SSH登录服务器后，在Vibe Kanban中选择“SSH打开工作树”功能。

3. 核心使用流程

以“快速启动”方式为例，详细介绍Vibe Kanban的核心使用流程：

（1）项目创建与导入

首次使用时，需先创建或导入项目（关联Git仓库）：

1. 打开Vibe Kanban界面，点击首页的“Add Project”按钮；

2. 选择项目类型：

• 导入现有仓库：输入本地Git仓库路径（如/Users/xxx/projects/my-app），系统会自动验证仓库有效性；

• 创建新仓库：输入项目名称、保存路径，系统会自动初始化Git仓库；

3. 配置项目信息：可设置项目名称、描述、开发脚本（如启动命令npm run dev）等，点击“Save”完成创建；

4. 项目创建成功后，会自动进入该项目的看板界面，同时系统会扫描仓库文件，支持后续的文件搜索功能。

（2）创建任务

1. 在项目看板界面，点击“Create Task”按钮；

2. 填写任务信息：

• 任务标题：简洁描述任务目标（如“实现用户登录接口”“修复前端表单验证bug”）；

• 任务描述：详细说明需求、技术要求、AI执行指令等（如“使用Express框架实现POST接口，接收用户名和密码参数，返回token”）；

• 选择AI代理：从下拉列表中选择执行该任务的AI编码代理（如Claude Code）；

• 设置优先级：选择高、中、低优先级；

3. 点击“Create & Run”直接启动任务，或点击“Create”仅创建任务不执行。

（3）任务执行与监控

1. 任务启动后，系统会自动创建隔离的Git工作树与分支，AI代理开始执行任务；

2. 在看板中，任务卡片会显示“In Progress”状态，点击卡片可查看详情：

• 执行日志：实时显示AI代理的输出信息、错误提示等；

• 进程状态：显示AI代理的运行状态（如“运行中”“已完成”“失败”）；

• 操作按钮：支持“停止执行”“重新执行”“放弃任务”等操作；

3. 任务执行过程中，可随时点击“Stop”停止执行，或在日志中查看中间结果。

（4）代码审核与合并

1. 任务执行完成后，任务状态会更新为“Done”，点击任务卡片进入详情页；

2. 查看代码变更：在“Changes”标签页中，通过Diff格式查看AI代理修改的代码，可切换文件查看不同文件的变更；

3. 手动优化（可选）：若代码需要调整，点击“Open in Editor”按钮，在本地编辑器中打开任务工作树，修改完成后保存；

4. 合并代码：审核通过后，点击“Merge”按钮，系统会将任务分支的代码合并到主分支；

5. 同步主分支（可选）：若合并前主分支有更新，可先点击“Rebase”同步最新代码，避免合并冲突；

6. 清理环境：代码合并后，系统会自动清理隔离工作树（也可手动点击“Delete Worktree”删除）。

（5）任务管理与历史记录

1. 在看板界面，可通过拖拽任务卡片调整状态（如从“In Progress”拖到“Done”）；

2. 点击任务卡片的“History”标签，可查看该任务的所有执行尝试记录，包括每次的日志与代码变更；

3. 在项目首页，可通过“Search”功能搜索任务标题、描述或文件内容，快速定位目标任务。

（6）辅助功能使用

• 开发服务器：在任务详情页点击“Dev Server”按钮，系统会执行项目配置的启动命令，实时预览代码效果；

• 创建Pull Request：若项目已关联远程GitHub仓库，点击“Create PR”按钮，可直接跳转到GitHub创建Pull Request；

• 多项目切换：点击界面顶部的项目名称，在下拉列表中选择其他项目，即可切换看板。

4. 常用命令与快捷键

六、常见问题解答（FAQ）

Q1：执行npx vibe-kanban时提示“Node.js版本过低”怎么办？

A1：Vibe Kanban要求Node.js版本≥18，需升级Node.js：

• Windows/macOS：通过Node.js官网下载最新稳定版安装（https://nodejs.org/）；

• Linux：通过nvm（Node Version Manager）安装并切换版本：

  nvm install 18
  nvm use 18

升级完成后，重新执行npx vibe-kanban命令。

Q2：启动后浏览器无法访问http://localhost:3000，提示“无法连接到服务器”？

A2：可能的原因及解决方案：

• 端口被占用：使用--port参数指定其他端口，如npx vibe-kanban --port 8080，然后访问http://localhost:8080；

• 防火墙拦截：检查本地防火墙是否阻止了Node.js进程的网络访问，放行即可；

• 服务未完全启动：等待终端显示“Server started on port xxx”后再访问，避免启动过程中访问。

Q3：本地开发部署时，执行cargo build提示“Rust编译错误”？

A3：确保Rust版本为最新稳定版，执行以下命令更新Rust：

rustup update stable

若仍报错，可能是依赖包下载失败，可删除Cargo.lock文件和target目录，重新执行cargo build。

Q4：导入Git仓库时提示“仓库验证失败”怎么办？

A4：排查以下几点：

• 仓库路径正确：确保输入的本地路径是Git仓库根目录（包含.git文件夹）；

• Git已初始化：若为新文件夹，需先执行git init初始化仓库；

• 权限足够：确保当前用户对该仓库路径有读写权限；

• Git版本兼容：升级Git到最新版本，确保支持Git Worktree功能。

Q5：任务执行时提示“AI代理未找到”或“身份验证失败”？

A5：解决方案：

• 检查AI代理是否已安装：确保所选AI代理（如Claude Code）已正确安装在本地；

• 完成身份验证：按照AI代理的官方文档完成身份验证（如配置API密钥、登录账号等）；

• 检查环境变量：部分AI代理需要配置环境变量（如CLAUDE_API_KEY），确保配置正确；

• 切换AI代理：若某一代理无法使用，可尝试选择其他支持的AI代理执行任务。

Q6：多任务并行执行时出现代码冲突怎么办？

A6：Vibe Kanban的隔离环境设计已避免实时冲突，若合并时出现冲突：

• 点击任务详情页的“Rebase”按钮，同步主分支最新代码，重新执行AI代理任务；

• 手动解决冲突：在本地编辑器中打开任务工作树，修改冲突文件，然后重新提交合并；

• 放弃当前任务：若冲突无法解决，可删除该任务的隔离环境，重新创建任务执行。

Q7：无法在编辑器中打开任务工作树怎么办？

A7：排查以下几点：

• 编辑器已安装：确保已安装所选编辑器（如VS Code）；

• 编辑器路径配置：部分编辑器需要手动配置路径，在Vibe Kanban的“设置”中找到“Editor Path”，选择编辑器可执行文件路径；

• 工作树已创建：确保任务已启动，隔离工作树已成功创建；

• 权限足够：确保当前用户对任务工作树路径有读写权限。

Q8：任务执行完成后，看不到代码变更（Diff为空）怎么办？

A8：可能的原因及解决方案：

• AI代理未修改文件：检查任务描述是否清晰，AI代理是否理解需求，可优化指令重新执行；

• 工作树创建失败：查看任务日志，若提示Git工作树创建失败，重新创建任务；

• 仓库路径错误：确认项目关联的Git仓库路径正确，重新导入项目；

• Git配置问题：检查Git用户配置（git config --global user.name和user.email）是否完整，部分AI代理需要Git配置才能提交代码。

Q9：远程服务器部署后，团队成员无法访问怎么办？

A9：解决方案：

• 服务器端口开放：在服务器防火墙中开放Vibe Kanban使用的端口（如8080）；

• 服务器IP可访问：确保团队成员能ping通服务器IP，若为云服务器，需配置安全组规则；

• 服务绑定地址：启动服务时指定绑定地址为0.0.0.0，确保外部可访问：

  ./target/release/vibe-kanban --host 0.0.0.0 --port 8080

• 网络环境限制：若团队成员在局域网外，需确保服务器有公网IP或通过VPN访问。

Q10：Vibe Kanban支持中文界面吗？

A10：目前Vibe Kanban的默认界面为英文，但任务描述、日志等支持中文输入。部分用户已实现日志的中文化显示，可通过修改配置文件或二次开发实现界面中文化，具体可参考GitHub社区的相关讨论与教程。

Q11：如何备份Vibe Kanban的项目数据与任务记录？

A11：Vibe Kanban的数据存储在本地SQLite数据库中，默认路径为用户目录下的.vibe-kanban文件夹：

• 备份：直接复制.vibe-kanban文件夹到备份位置；

• 恢复：将备份的文件夹覆盖到用户目录下的.vibe-kanban即可。

Q12：是否支持自定义AI代理？

A12：目前Vibe Kanban主要支持官方集成的AI代理，若需添加自定义AI代理，可通过二次开发修改AI代理服务层代码，添加新代理的执行接口与参数配置，具体可参考项目源码中的ai-agent模块实现。

七、相关链接

• GitHub仓库：https://github.com/BloopAI/vibe-kanban

• 官方网站：https://www.vibekanban.com

八、总结

Vibe Kanban作为一款专为AI编码代理设计的开源协作工具，通过可视化看板、多智能体集成、Git隔离环境、代码审核流程等核心功能，有效解决了AI驱动开发中的工具协调难、状态不透明、代码冲突等痛点，为开发者打造了“AI编码协作中枢”。它采用Rust+React技术栈构建，兼顾了后端处理的高性能与前端界面的流畅性，支持本地快速启动、远程服务器部署等多种使用方式，适用于个人开发、团队协作、开源项目维护等多种场景。作为开源项目，Vibe Kanban遵循Apache-2.0许可证，允许自由使用与二次开发，同时拥有活跃的社区维护与版本迭代，持续优化功能与用户体验。无论是希望通过AI工具提升个人开发效率，还是需要规范团队的AI编码流程，Vibe Kanban都能提供简洁高效的解决方案，成为连接开发者、AI工具与代码仓库的重要桥梁，推动AI驱动的软件开发模式走向规范化与高效化。