# BubbleComplete

**Repository Path**: BigPig0/bubble-complete

## Basic Information

- **Project Name**: BubbleComplete
- **Description**: AI Agent 团队协作平台 — “让 AI Agent 像人类团队一样协作完成任务。”
- **Primary Language**: Unknown
- **License**: Not specified
- **Default Branch**: main
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 0
- **Created**: 2026-04-12
- **Last Updated**: 2026-06-07

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# BubbleComplete

> **AI Agent 团队协作平台** — “让 AI Agent 像人类团队一样协作完成任务。”  
> 许可证: MIT OR Apache-2.0  
> 完成度: ~70% | P0 端到端主链路已打通

---

## 核心特性

- **纯开源**: MIT OR Apache-2.0 许可证
- **团队系统**: 创建团队，添加 AI 成员，设置角色/性格/能力
- **工作流引擎**: 自动化任务流转（线性 → 并行 → 完整）
- **智能分配**: 基于角色/能力/负载/绩效加权分配
- **多模型支持**: OpenAI + Anthropic + Qwen + DeepSeek + Kimi + 阿里百炼
- **多平台沙箱**: Linux → Landlock，macOS → SandboxExec，Windows → Native
- **国内优先通道**: 微信 + 钉钉 + 飞书 + Telegram + Discord + Slack

## 技术栈

| 层次 | 技术 |
|------|------|
| 语言 | Rust 2024 + Tokio + Axum |
| 前端 | React 19 + Vite + Ant Design 5 |
| 数据库 | SQLite / PostgreSQL / MySQL |
| 性能目标 | < 10MB 内存，< 10ms 启动 |

---

## 文档

| 文档 | 说明 |
|------|------|
| [产品说明书](doc/product-specification.md) | 产品愿景、定位、功能需求、路线图 |
| [使用场景](doc/use-cases.md) | 15 个场景（4 核心 + 6 扩展 + 5 边界） |
| [架构设计](doc/architecture.md) | 技术栈、数据模型、接口设计、项目结构 |
| [**待办任务清单**](doc/task-backlog.md) | 开发任务跟踪，完成后及时更新 |

---

## 快速开始

### 环境要求

- Rust 1.85+ (edition 2024)
- Node.js 20+
- npm

### 构建后端

```bash
cargo build --release
```

### 构建前端

```bash
cd web
npm install
npm run build
cd ..
```

构建产物输出到 `dist/web` 目录，Gateway 启动时会自动托管前端静态文件。

### 配置

复制 `deploy/config.example.toml` 为 `config.toml` 并填写 API Key：

```toml
[server]
host = "127.0.0.1"
port = 42617
api_key = "your-api-key"

[[providers]]
name = "openai"
type = "openai"
api_key = "sk-..."
default_model = "gpt-4"
```

### 启动

#### 方式一：生产模式（前端已构建）

先构建前端，再启动 Gateway，浏览器访问 `http://127.0.0.1:42617`：

```bash
# 一键构建前端 + 启动（Windows）
start-with-web.bat

# 或手动执行
cd web && npm install && npm run build && cd ..
target\release\bubblecomplete.exe gateway --port 42617
```

#### 方式二：开发模式（前后端分离热重载）

适合前端开发调试，Vite 开发服务器提供热更新，API 请求自动代理到后端：

```bash
# 终端 1：启动后端 Gateway
cargo run --bin bbc -- gateway --port 42617

# 终端 2：启动前端开发服务器
cd web
npm install
npm run dev
```

前端开发服务器默认运行在 `http://localhost:3000`，Vite 会自动将 `/api`、`/health`、`/ws` 请求代理到后端 `127.0.0.1:42617`。

#### CLI 管理

```bash
bbc team list
bbc task list --team <team_id>
```

### 打包

```bash
# Windows 打包脚本
package.bat
```

---

## 项目结构

```
BubbleComplete/
├── crates/
│   ├── core/           # 配置系统 + 事件总线
│   ├── database/       # 数据库抽象层 (SQLite/PG/MySQL)
│   ├── providers/      # AI 模型 Provider (6 种)
│   ├── sandbox/        # 多平台沙箱
│   ├── channels/       # 消息通道 (微信/钉钉/飞书)
│   ├── team/           # 团队管理
│   ├── member/         # 成员管理
│   ├── task/           # 任务系统
│   ├── workflow/       # 工作流引擎
│   ├── agent-runtime/  # Agent 运行时 + 工具执行 + 记忆系统
│   ├── gateway/        # HTTP/WebSocket 网关
│   └── cli/            # CLI 工具 (bbc)
├── web/                # React 前端
└── doc/                # 项目文档
```

---

## 许可证

本项目采用 **MIT OR Apache-2.0** 双许可证。