An open API service indexing awesome lists of open source software.

https://github.com/wsshow/feikong-teams

一个基于多智能体协作的 AI 助手,支持命令行和Web界面,提供团队模式、自定义会议模式和多智能体讨论模式(圆桌会议模式)三种工作方式,通过多个专业智能体协同工作来完成复杂的编程和系统任务。
https://github.com/wsshow/feikong-teams

agents ai auto chatbot chatgpt cli cowork eino fkteams mcp multiagent skills

Last synced: 4 days ago
JSON representation

一个基于多智能体协作的 AI 助手,支持命令行和Web界面,提供团队模式、自定义会议模式和多智能体讨论模式(圆桌会议模式)三种工作方式,通过多个专业智能体协同工作来完成复杂的编程和系统任务。

Awesome Lists containing this project

README

          

# fkteams 非空小队

fkteams(FeiKong Teams,非空小队)是一个开源的多智能体协作 AI 助手,旨在通过多个专业智能体的协同工作来完成复杂的任务。它支持两种交互界面:现代化的 Web 界面和传统的命令行界面,满足不同用户的使用习惯和场景需求。

![非空小队架构简介](./docs/images/fkteams.png)

## 演示图

| 登录界面 | 主界面 |
| :----------------------------------------------: | :-----------------------------------------: |
| ![登录界面](./docs/images/fkteams_web_login.png) | ![主界面](./docs/images/fkteams_web_mp.png) |

| 审批 | 子任务进行中 |
| :---------------------------------------: | :------------------------------------------------: |
| ![审批](./docs/images/fkteams_web_sp.png) | ![子任务进行中](./docs/images/fkteams_web_ing.png) |

| 子任务完成 | 文件管理 |
| :-----------------------------------------------: | :-------------------------------------------: |
| ![子任务完成](./docs/images/fkteams_web_done.png) | ![文件管理](./docs/images/fkteams_web_fm.png) |

| 文件分享 | 密码访问 |
| :--------------------------------------------------: | :-----------------------------------------------------: |
| ![文件分享](./docs/images/fkteams_web_fileshare.png) | ![密码访问](./docs/images/fkteams_web_fileshare_mm.png) |

| 分享预览 | 批量分享预览 |
| :-----------------------------------------------------: | :---------------------------------------------------------: |
| ![分享预览](./docs/images/fkteams_web_fileshare_yl.png) | ![批量分享预览](./docs/images/fkteams_web_fileshare_pl.png) |

| 并行子任务 |
| :-----------------------------------------------: |
| ![并行子任务](./docs/images/fkteams_cli_task.png) |

| 非交互模式 |
| :----------------------------------------------: |
| ![非交互模式](./docs/images/fkteams_cli_fjh.png) |

## 功能特性

- **多智能体协作**:内置多个专业智能体(代码、搜索、命令行、数据分析、SSH 等),由统御智能体智能调度
- **四种工作模式**:团队模式、深度模式、圆桌会议模式、自定义模式
- **双界面支持**:现代化 Web 界面 + 命令行界面
- **MCP 工具生态**:完整支持 MCP 协议,轻松接入外部工具
- **自定义智能体**:通过配置文件灵活创建专业智能体
- **聊天通道集成**:支持接入 QQ、Discord 等即时通讯平台
- **长期记忆**:跨会话自动记忆,助手越用越顺手
- **多模态输入**:支持文本、图片、音频、视频和文件
- **推理模型支持**:流式展示思考过程(DeepSeek-R1、o1/o3 等)
- **Skills 技能系统**:动态加载技能提升特定任务表现
- **定时任务**:自然语言设置定时任务,后台静默执行
- **子任务并行**:小助智能体支持多子任务并行处理

## 安装

一键安装脚本会自动下载最新版本并解压到 `~/.fkteams/bin`(Windows 为 `%USERPROFILE%\.fkteams\bin`),同时将该目录添加到 PATH。

**Linux / macOS**

```bash
curl -fsSL https://raw.githubusercontent.com/wsshow/feikong-teams/main/install.sh | bash
```

**Windows (PowerShell)**

```powershell
powershell -c "irm https://raw.githubusercontent.com/wsshow/feikong-teams/main/install.ps1 | iex"
```

> 如需自定义安装目录,可在执行前设置环境变量 `FKTEAMS_INSTALL_DIR`:
>
> - Linux/macOS:`export FKTEAMS_INSTALL_DIR=/your/path`
> - Windows:`$env:FKTEAMS_INSTALL_DIR = "D:\fkteams"`

也可以直接在 [GitHub Releases](https://github.com/wsshow/feikong-teams/releases) 页面手动下载对应平台的压缩包。

## 快速开始

> **快速体验**:安装完成后,只需要生成配置文件并运行 `fkteams web` 即可立即体验 Web 界面!

### 1. 生成配置文件

```bash
fkteams generate config
```

编辑 `~/.fkteams/config/config.toml`,填写模型配置:

```toml
[[models]]
name = "default"
provider = "openai"
base_url = "https://api.openai.com/v1"
api_key = "your_api_key_here"
model = "gpt-5"
```

> 完整配置项请参考 [配置指南](./docs/configuration.md)

### 2. 运行

```bash
# Web 界面模式(推荐)
fkteams web

# 命令行模式
fkteams
```

启动后访问 `http://localhost:23456` 即可使用。

> 更多运行模式和命令行参数请参考 [使用指南](./docs/usage.md)

## 从源码构建

```bash
# 克隆项目
git clone https://github.com/wsshow/feikong-teams.git
cd feikong-teams

# 编译
make build

# Web界面模式
./release/fkteams_darwin_arm64 web
```

## 内置智能体

| 智能体 | 说明 |
| ------- | -------------------------------------- |
| `@小码` | 代码专家,擅长读写和处理代码文件 |
| `@小搜` | 情报搜索专家,擅长中英文双语检索 |
| `@小令` | 命令行专家,根据操作系统执行命令 |
| `@小析` | 数据分析专家,Excel 和 Python 数据处理 |
| `@小访` | 远程访问专家,SSH 连接和远程管理 |
| `@小说` | 讲故事专家,编写引人入胜的故事 |
| `@小简` | 总结专家,提炼简洁摘要 |
| `@小助` | 个人全能助手,支持子任务并行执行 |

## 文档导航

| 文档 | 说明 |
| --------------------------------------- | ---------------------------------------- |
| [配置指南](./docs/configuration.md) | 环境变量、config.toml 配置 |
| [使用指南](./docs/usage.md) | 运行模式、CLI 命令、智能体切换、定时任务 |
| [圆桌会议模式](./docs/roundtable.md) | 多模型讨论模式的原理和配置 |
| [Skills 指南](./docs/skills.md) | 技能系统的使用和配置 |
| [MCP 工具集成](./docs/mcp.md) | MCP 协议集成和常用服务配置 |
| [自定义智能体](./docs/custom-agents.md) | 创建和配置自定义智能体 |
| [聊天通道](./docs/channels.md) | QQ、Discord、微信等平台接入 |
| [长期记忆](./docs/memory.md) | 记忆提取、存储、检索机制 |
| [多模态支持](./docs/multimodal.md) | 图片、音频、视频等多模态输入 |
| [推理模型支持](./docs/reasoning.md) | 推理/思考模型的流式输出 |
| [部署指南](./docs/deployment.md) | 构建、Docker 部署 |
| [安全说明](./docs/security.md) | 安全机制和注意事项 |
| [API 文档](./docs/api/) | HTTP/WebSocket API 接口 |

## 构建

```bash
make clean && make build
```

## Docker 部署

```bash
# docker-compose(推荐)
docker compose up -d

# 或 docker run
docker build -t fkteams .
docker run -d --name fkteams -p 23456:23456 \
-e FEIKONG_BASE_URL=https://api.openai.com/v1 \
-e FEIKONG_API_KEY=your_api_key_here \
-e FEIKONG_MODEL=GPT-5 \
fkteams
```

> 详细部署配置请参考 [部署指南](./docs/deployment.md)

## 许可证

本项目采用 MIT 许可证。详见 [LICENSE](LICENSE) 文件。

## 致谢

- [Bubble Tea](https://github.com/charmbracelet/bubbletea) - 基于 Elm 架构的终端 UI 框架
- [Pterm](https://github.com/pterm/pterm) - 美观的终端 UI 库
- [Cloudwego Eino](https://github.com/cloudwego/eino) - 强大的 AI 编程框架
- [MCP Go](https://github.com/mark3labs/mcp-go) - Go 语言的 MCP 协议实现
- [Model Context Protocol](https://modelcontextprotocol.io/) - AI 工具集成标准协议

## 相关链接

- [MCP 官方文档](https://modelcontextprotocol.io/)
- [MCP 服务器列表](https://github.com/modelcontextprotocol/servers)
- [Cloudwego Eino 文档](https://github.com/cloudwego/eino)
- [项目 GitHub](https://github.com/wsshow/feikong-teams)