fkteams 非空小队

fkteams（FeiKong Teams，非空小队）是一个开源的多智能体协作 AI 助手，适合代码开发、资料研究、数据分析、远程运维和自动化任务。它支持 Web UI、CLI、OpenAI 兼容 API 和消息通道（Discord / QQ / 微信）多种入口。

演示图

登录界面	主界面

审批	子任务进行中

子任务完成	文件管理

文件分享	密码访问

分享预览	批量分享预览

并行子任务

非交互模式

交互模式

功能特性

• 多智能体协作：按任务自动协同代码、搜索、数据分析、远程运维等专业能力
• 多入口使用：支持 Web UI、CLI、OpenAI 兼容 API，以及 QQ、Discord、微信等消息通道
• 灵活工作模式：支持团队模式、深度模式、圆桌会议模式和自定义模式
• 工具与扩展：内置文件、命令、搜索、文档、表格、SSH 等工具，并支持 MCP、Skills 和自定义智能体
• 长任务体验：任务可在后台运行，刷新页面或断开连接后仍可回到同一会话继续查看，Web 会恢复上次存在的会话，侧边栏会显示会话状态，运行中后续队列按轮次展示
• 多模态与推理展示：支持文本、图片、音频、视频和文件输入，可流式展示推理模型思考过程
• 长期记忆与定时任务：支持跨会话记忆、自然语言定时任务和模型主动提问
• 模型接入：支持 OpenAI 兼容供应商，并可通过 OAuth 登录 GitHub Copilot

安装

一键安装脚本会自动下载最新版本并解压到 ~/.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 login

也可以直接指定供应商：

fkteams login openai
fkteams login deepseek
fkteams login copilot

或生成配置文件后手动编辑：

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 用户也可以从 VS Code 已保存的 token 导入（需要 Copilot 订阅）：

fkteams login copilot --import

常用模型管理命令：

fkteams model ls                     # 列出已配置的模型
fkteams model rm                     # 交互式选择并移除模型配置
fkteams logout openai                # 退出指定供应商

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

运行期数据默认保存在 ~/.fkteams/ 下，可通过 FEIKONG_APP_DIR 覆盖；常用子目录包括 workspace、sessions、scheduler、history、config、log、share。

2. 运行

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

# 命令行模式
fkteams

# 纯 API 服务
fkteams serve

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

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

构建与部署

# 从源码构建
git clone https://github.com/wsshow/feikong-teams.git
cd feikong-teams
make native

# 或指定平台 / 构建预设平台
make build t=linux:amd64
make all

# Docker 部署
docker compose up -d

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

内置智能体

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

架构与安全边界

• Web、CLI、API 和消息通道共用同一套执行引擎，会话、历史、流式输出和运行中输入保持一致。
• 智能体、模型、工具和运行时适配层彼此解耦；默认运行时基于 CloudWeGo Eino ADK，后续可以替换或扩展。
• 文件、命令、Git、SSH 等高风险能力会经过工具安全策略和人工确认流程；被拒绝的操作不会被自动重试。
• 任务事件会统一记录到历史中，Web 和 CLI 基于同一事件流展示思考、工具调用、成员执行和最终回复。
• Hooks、MCP、Skills 和自定义智能体用于扩展运行期能力；详细机制请参考下方文档。

文档导航

许可证

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

致谢

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

相关链接

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