AiCode Flow

专为 Vibe Coding 设计的本地看板任务管理工具。

功能特点

• 🎯 纯本地部署 - 数据完全存储在本地，无需联网
• 🔄 看板管理 - TODO → InProgress → Review → Done 流程
• 🚀 AI CLI 集成 - 自动检测并调用本地已安装的 AI 工具
• 📝 任务管理 - 标题、描述、预估时间、标签、关联文件
• 🎨 拖拽排序 - 优先级由拖拽位置决定
• 💾 SQLite 存储 - 单文件数据库，易于备份

支持的 AI CLI 工具

启动时会自动检测以下工具：

• Claude Code (claude)
• Google Gemini CLI (gemini)
• Kimi CLI (kimi)
• OpenCode (opencode)
• Aider (aider)
• OpenAI Codex (codex)

快速开始

1. 安装依赖

需要安装 Rust 和 Node.js。

2. 构建前端

cd frontend
npm install
npm run build
cd ..

3. 运行后端

cargo run

服务将自动在浏览器中打开 http://127.0.0.1:3456

4. 开发模式（可选）

前后端分离开发：

终端 1（后端）：

cargo run

终端 2（前端）：

cd frontend
npm run dev

前端开发服务器将运行在 http://localhost:5173，并代理 API 请求到后端。

项目结构

ai-code-flow/
├── Cargo.toml              # Rust 后端配置
├── src/
│   ├── main.rs             # 入口
│   ├── api/                # HTTP API 路由
│   ├── cli/                # AI CLI 检测与执行
│   ├── db/                 # SQLite 数据库操作
│   └── ws/                 # WebSocket（预留）
├── frontend/               # React 前端
│   ├── package.json
│   ├── src/
│   │   ├── components/     # React 组件
│   │   ├── types/          # TypeScript 类型
│   │   ├── App.tsx
│   │   └── main.tsx
│   └── dist/               # 构建输出
└── README.md

API 接口

| 方法 | 路径 | 描述 | |------|------|------| | GET | /api/tasks | 获取所有任务 | | POST | /api/tasks | 创建任务 | | PUT | /api/tasks/:id | 更新任务 | | DELETE | /api/tasks/:id | 删除任务 | | POST | /api/tasks/:id/move | 移动/排序任务 | | GET | /api/clis | 获取可用的 AI CLI | | POST | /api/ai/run | 运行 AI CLI 分析任务 |

数据存储

数据存储在 ~/.aicode-flow/data.db (SQLite)。

可手动备份此文件，或使用应用内的导出功能。

技术栈

• 后端: Rust + Axum + SQLite (rusqlite)
• 前端: React + TypeScript + Tailwind CSS + Vite
• 拖拽: @dnd-kit
• 图标: Lucide React

Pre-commit Hooks

项目配置了 pre-commit hooks，在提交代码前自动运行质量检查。

安装

# 安装 pre-commit (如果尚未安装)
pip install pre-commit

# 安装项目 hooks
pre-commit install

Hook 列表

• Rust 格式检查: cargo fmt --check
• Rust Clippy: cargo clippy --all-targets --all-features -- -D warnings
• 编译检查: cargo test --no-run
• 单元测试: cargo test --all --no-fail-fast
• 代码覆盖率: 新增代码必须达到 95% 覆盖率

使用

# 手动运行所有 hooks (不提交)
pre-commit run --all-files

# 跳过 hooks (不推荐)
git commit --no-verify

覆盖率检查

覆盖率检查使用 cargo-tarpaulin，会在首次运行时自动安装。该检查只分析被修改的 Rust 文件，确保新增代码至少有 95% 的测试覆盖率。

生成覆盖率报告：

./scripts/coverage.sh

或者直接使用 cargo-tarpaulin：

cargo tarpaulin --bin ai-code-flow --out Html --output-dir coverage
open coverage/tarpaulin-report.html

开发计划

• [x] 基础看板功能
• [x] AI CLI 自动检测
• [x] 任务 CRUD
• [x] 拖拽排序
• [ ] 数据导出/导入
• [ ] 任务搜索和过滤
• [ ] 键盘快捷键
• [ ] 暗色模式

License

MIT