fkteams 非空小队

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

演示图

登录界面	主界面

审批	子任务进行中

子任务完成	文件管理

文件分享	密码访问

分享预览	批量分享预览

并行子任务

非交互模式

功能特性

• 多智能体协作：内置多个专业智能体（代码、搜索、命令行、数据分析、SSH 等），由统御智能体智能调度
• 四种工作模式：团队模式、深度模式、圆桌会议模式、自定义模式
• 双界面支持：现代化 Web 界面 + 命令行界面
• MCP 工具生态：完整支持 MCP 协议，轻松接入外部工具
• 自定义智能体：通过配置文件灵活创建专业智能体
• OpenAI 兼容 API：对外提供 OpenAI 格式接口，任意客户端配置地址和密钥即可使用已配置的模型
• 聊天通道集成：支持接入 QQ、Discord 等即时通讯平台
• 长期记忆：跨会话自动记忆，助手越用越顺手
• 多模态输入：支持文本、图片、音频、视频和文件
• 推理模型支持：流式展示思考过程（DeepSeek-R1、o1/o3 等）
• GitHub Copilot：一键登录 GitHub Copilot，OAuth 设备码认证
• 流式任务控制：后台独立执行任务，SSE 订阅事件流，断线重连无损续接
• Skills 技能系统：动态加载技能提升特定任务表现
• 交互式提问：模型可主动向用户提问，支持选项选择（单选/多选）+ 自由输入
• 定时任务：自然语言设置定时任务，后台静默执行
• 子任务并行：小助智能体支持多子任务并行处理
• 输出截断自动续接：检测模型 max_tokens 截断，自动触发续接（自动修复不完整的 JSON ），输出不丢失

安装

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

Linux / macOS

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

Windows (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 页面手动下载对应平台的压缩包。

快速开始

快速体验：安装完成后，只需要生成配置文件并运行 fkteams web 即可立即体验 Web 界面！

1. 生成配置文件

fkteams generate config

编辑 ~/.fkteams/config/config.toml，填写模型配置：

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

或使用 GitHub Copilot（需要 Copilot 订阅）：

# 登录 GitHub Copilot
fkteams login copilot
或从 VS Code 已保存的 token 导入（免登录）
fkteams login copilot --import

也可通过 login 命令快速配置供应商：

# 交互式选择供应商并配置（推荐）
fkteams login
或直接指定供应商
fkteams login openai
fkteams login deepseek
fkteams login copilot         # GitHub Copilot（OAuth 设备码）
fkteams login copilot --import # 从 VS Code 导入 Copilot token
模型管理
fkteams model ls                     # 列出已配置的模型
fkteams model rm                     # 交互式选择并移除模型配置
fkteams logout openai                # 退出指定供应商

[[models]]
name = "default"
provider = "copilot"
model = "gpt-4o"

完整配置项请参考 配置指南

2. 运行

# Web 界面模式（推荐）
fkteams web
命令行模式
fkteams

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

更多运行模式和命令行参数请参考 使用指南

构建与部署

# 从源码构建
git clone https://github.com/wsshow/feikong-teams.git
cd feikong-teams
make build
Docker 部署
docker compose up -d

详细部署配置请参考 部署指南

内置智能体

智能体	说明	默认启用
@小码	资深软件工程师，擅长代码实现、调试和重构	✓
@小令	命令行专家，根据操作系统环境执行合适的命令	✓
@小说	故事创作专家，擅长构思和撰写引人入胜的故事	✓
@小简	总结专家，擅长提炼和总结复杂信息	✓
@小搜	搜索专家，通过 DuckDuckGo 检索信息并深度分析	配置启用
@小析	数据分析专家，Excel 和 Python 脚本数据处理	配置启用
@小访	远程访问专家，SSH 连接远程服务器和系统管理	配置启用
@小助	个人全能助手，支持子任务并行分发执行	配置启用

通过 [[custom.agents]] 定义的自定义智能体也会自动注册，在任意模式下可通过 @ 或 agent 子命令使用。

文档导航

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

许可证

本项目采用 MIT 许可证。详见 LICENSE 文件。

致谢

• Bubble Tea - 基于 Elm 架构的终端 UI 框架
• Pterm - 美观的终端 UI 库
• Cloudwego Eino - 强大的 AI 编程框架
• MCP Go - Go 语言的 MCP 协议实现
• Model Context Protocol - AI 工具集成标准协议

相关链接

• MCP 官方文档
• MCP 服务器列表
• Cloudwego Eino 文档
• 项目 GitHub