<< All versions
四、单智能体模式（
五、会话管理（
六、模型管理（
七、技能管理（
八、配置与初始化（
Skill v1.0.4
currentAutomated scan100/100wsshow/feikong-teams/fkteams
~2 modified
──Details
PublishedAugust 12, 2026 at 06:53 AM
Content Hashsha256:0fed1a57148d6d00...
Git SHA4d0b5753582e
Bump Typepatch
──Files
Files (1 file, 11.9 KB)
SKILL.md11.9 KBactive
SKILL.md · 383 lines · 11.9 KB
version: "1.0.4" name: fkteams description: > fkteams 多智能体协作 AI 助手的完整使用指南。当用户需要启动 fkteams、切换工作模式（团队/深度/讨论/自定义）、 通过命令行或管道执行查询、管理单个智能体（coder/researcher/fkteams_helper/analyst/remote/generalist）、管理会话历史（保存/加载/导出/恢复）、 管理模型配置（添加/切换/删除/登录服务商）、管理本地技能（列出/搜索/安装/移除）、初始化或修改配置文件， 以及了解 fkteams 的任意命令行用法时，请使用此 skill。 compatibility: 需要 fkteams 二进制文件，首次使用前需运行 fkteams generate config 生成配置文件。 metadata: author: fkteams version: "1.0"
fkteams 命令行完整指南
一、快速入门
bash
# 第一步：生成配置文件fkteams generate config# 第二步：编辑配置，添加模型（必填）# 编辑 ~/.fkteams/config/config.toml，填写 api_key 和 model# 第三步（可选）：安装运行时依赖fkteams init --all # 安装 uv（Python）和 bun（JavaScript）# 第四步：启动fkteams web # Web 界面（推荐）fkteams # CLI 交互模式
二、启动与运行模式
模式对照表
| 模式 | 命令 | 适用场景 | |
|---|---|---|---|
| Web 界面 | fkteams web | 日常使用，需要历史记录和可视化界面 | |
| CLI 交互 | fkteams | 服务器/终端环境 | |
| 直接查询 | fkteams -q "..." | 脚本集成、自动化 | |
| 纯 API 服务 | fkteams serve | 作为后端独立部署 |
Web 界面模式
bash
fkteams web# 启动后访问 http://localhost:23456
CLI 交互模式
bash
fkteams # 默认：团队模式（coordinator 协调多智能体）fkteams -m deep # 深度分析模式fkteams -m group # 多智能体讨论模式（圆桌）fkteams --temporary # 临时会话，不保存历史
直接查询模式（非交互，执行后退出）
bash
fkteams -q "帮我审查 main.go"fkteams -m deep -q "深度分析这个架构"fkteams -q "生成一份报告" # 默认保存历史fkteams -q "临时问答" --temporary # 不保存历史
管道输入模式
管道有内容时自动进入非交互模式。
bash
echo "解释一下 Go 的 context 包" | fkteamscat main.go | fkteams -q "审查以下代码:"git diff HEAD~1 | fkteams -q "审查这次提交"curl -s https://example.com/api | fkteams -q "解析这个 API 响应"
规则：同时提供 -q 时，查询内容为 -q 文本 + 换行 + 管道内容；管道为空且无 -q 时报错。
纯 API 服务模式
bash
fkteams servefkteams serve --host 0.0.0.0 --port 8080
与 web 提供相同的 API，但无前端页面。支持端点：GET /v1/models、POST /v1/chat/completions。
恢复历史会话
bash
fkteams -r "20260302_091249" # 交互模式恢复fkteams -r "20260302_091249" -q "继续上次的分析" # 恢复后直接查询
全局参数
| 参数 | 简写 | 说明 | |
|---|---|---|---|
--mode | -m | 工作模式：team（默认）/ deep / group | |
--query | -q | 直接查询模式，执行后退出 | |
--resume | -r | 恢复指定会话 ID | |
--temporary | --temp | 临时会话，不保存历史 | |
--approve | 自动批准工具调用：all / command / file / git / dispatch（逗号分隔） |
三、交互模式内置命令
| 命令 | 说明 | |
|---|---|---|
quit / q | 退出程序 | |
help | 显示帮助 | |
list_agents | 列出所有可用智能体 | |
@智能体名 [查询] | 切换到指定智能体并可选执行查询 | |
switch_work_mode | 切换工作模式 | |
save_chat_history | 保存当前会话 | |
list_chat_history | 列出所有历史会话 | |
load_chat_history | 选择并加载历史会话 | |
clear_chat_history | 清空当前会话（不删除文件） | |
save_chat_history_to_markdown | 导出为 Markdown | |
save_chat_history_to_html | 导出为 HTML | |
list_schedule | 列出所有定时任务 | |
cancel_schedule | 取消定时任务 | |
delete_schedule | 删除定时任务 | |
list_memory | 列出长期记忆条目 | |
delete_memory | 删除记忆条目 | |
clear_memory | 清空所有长期记忆 |
四、单智能体模式（agent 子命令）
智能体目录
| 名称 | 配置项 | 角色 | |
|---|---|---|---|
coordinator | [[agents.items]] id = "coordinator" | 协调者 | |
coder | [[agents.items]] id = "coder" | 软件工程师，代码实现、调试、重构 | |
researcher | [[agents.items]] id = "researcher" | DuckDuckGo 网络搜索 | |
fkteams_helper | [[agents.items]] id = "fkteams_helper" | fkteams 安装、配置、扩展与故障排查答疑 | |
analyst | [[agents.items]] id = "analyst" | 数据分析（Excel、Python、文档） | |
remote | [[agents.items]] id = "remote" + ssh = { ... } | SSH 远程服务器访问 | |
generalist | [[agents.items]] id = "generalist" | 通用执行助手，支持多工具任务 |
agent 命令用法
bash
# 列出所有可用智能体fkteams agent list# 交互模式（进入对话）fkteams agent -n coderfkteams agent --name analyst# 直接查询（一次性，执行后退出）fkteams agent -n researcher -q "搜索最新的 Go 语言新闻"fkteams agent -n coder -q "解释这个函数的作用"fkteams agent -n fkteams_helper -q "如何配置 MCP？"# 配合管道cat error.log | fkteams agent -n coder -q "分析这个错误日志"git diff HEAD~1 | fkteams agent -n coder -q "审查这次提交"cat data.csv | fkteams agent -n analyst -q "计算基本统计数据"# JSON 原始事件输出（用于程序化处理）fkteams agent -n researcher -q "搜索 AI 新闻" --format json# 自动批准工具调用fkteams agent -n shell -q "清理临时文件" --approve allfkteams agent -n coder -q "重构 main.go" --approve file,command# 临时运行，不保存历史fkteams agent -n researcher -q "搜索 AI 新闻" --temporary
agent 子命令参数
| 参数 | 简写 | 说明 | |
|---|---|---|---|
list | 列出所有可用智能体 | ||
--name | -n | 智能体名称（必填，与 list 互斥） | |
--query | -q | 直接查询模式 | |
--temporary | --temp | 临时会话，不保存历史 | |
--format | 输出格式：default（格式化）或 json（原始事件） | ||
--approve | 自动批准：all / command / file / git / dispatch |
交互模式下，输入 @ 符号后自动显示智能体列表供选择。
五、会话管理（session 子命令）
会话文件保存在 ~/.fkteams/sessions/，以时间戳命名（如 20260302_091249）。
bash
# 列出所有历史会话fkteams session list# 会话默认保存（退出时写入文件）fkteamsfkteams -q "你的问题"# 恢复历史会话fkteams -r "20260302_091249"fkteams -r "20260302_091249" -q "继续上次的问题"
交互模式内：save_chat_history / load_chat_history / clear_chat_history / save_chat_history_to_markdown / save_chat_history_to_html
六、模型管理（model 子命令）
bash
# 列出已配置的模型fkteams model ls # 或 fkteams model list# 查询服务商的可用模型fkteams model lr --name deepseekfkteams model lr --provider openai# 切换默认对话模型（交互式选择）fkteams model sw# 指定配置名fkteams model sw --name deepseek# 切换到指定模型fkteams model sw --name deepseek --model deepseek-reasoner# 移除模型配置（交互式选择）fkteams model rmfkteams model rm --name old-config
登录服务商（写入 config.toml，无需手动编辑）
bash
fkteams login openai --api-key sk-...fkteams login deepseek --api-key sk-...fkteams login claude --api-key sk-ant-...fkteams login gemini --api-key AIza...fkteams login qwen --api-key sk-...fkteams login ollama # 无需 API Keyfkteams login ark --api-key ...fkteams login openrouter --api-key sk-or-...fkteams login copilot # OAuth 设备码流程fkteams login copilot --import # 从 VS Code 已保存的 token 导入fkteams login custom --base-url https://my-proxy.example.com/v1 --api-key sk-...# 通用可选参数fkteams login openai --api-key sk-... --model gpt-4o --name my-openai# --name 指定模型 ID；首次登录会自动设为默认对话模型# 退出登录fkteams logout
七、技能管理（skill 子命令）
技能目录：~/.fkteams/skills/<技能名>/，每个技能必须包含 SKILL.md。
bash
# 列出本地已安装的技能fkteams skill list # 或 fkteams skill ls# 搜索技能市场（默认后端：SkillHub）fkteams skill search <关键词>fkteams skill search ffmpeg --page 2 --size 20fkteams skill search ffmpeg --provider SkillHub# 安装技能fkteams skill install <技能slug>fkteams skill install video-frames --version 1.0.0fkteams skill install video-frames --provider SkillHub# 移除技能fkteams skill remove <技能slug>
八、配置与初始化（generate / init 子命令）
bash
# 生成示例配置文件（首次使用必须执行）fkteams generate config# 生成路径：~/.fkteams/config/config.toml# 生成 OpenAI 兼容 API 密钥fkteams generate apikey# 初始化运行时依赖fkteams init # 交互式选择fkteams init --all # 安装全部（uv + bun）fkteams init --env uv # 仅安装 uv（Python 脚本工具）fkteams init --env bun # 仅安装 bun（JS 脚本工具）fkteams init --mirror # 生成镜像源配置（国内加速）
关键配置项
toml
# 模型（必填）[[models]]name = "default"provider = "openai"base_url = "https://api.openai.com/v1"api_key = "sk-..."model = "gpt-4o"# 智能体目录[[agents.items]]id = "researcher"name = "研究员"description = "网络研究员"tools = ["search", "fetch"]enabled = true[[agents.items]]id = "remote-prod"name = "生产服务器"description = "通过 SSH 管理生产服务器"tools = ["ssh"]ssh = { host = "ip:port", username = "user", password = "pass", known_hosts_file = "~/.ssh/known_hosts" }enabled = true# 长期记忆[memory]enabled = true# Web 服务器[server]port = 23456# OpenAI 兼容 API（需要先 fkteams generate apikey）[openai_api]api_keys = ["sk-fkteams-your-secret"]
环境变量
| 变量 | 默认值 | 说明 | |
|---|---|---|---|
FEIKONG_APP_DIR | ~/.fkteams | 应用数据目录 | |
FEIKONG_PROXY_URL | — | 代理地址（唯一的代理配置方式） | |
FEIKONG_MAX_ITERATIONS | 60 | 智能体最大迭代次数（0/-1 不限制） |
九、其他子命令
bash
# 检查并更新 fkteams 到最新版本fkteams update# 列出所有可用工具fkteams tool list# 显示版本fkteams --version
十、常见问题（Gotchas）
- 会话默认保存：退出时会自动写入历史；临时任务可加
--temporary，额外导出可在交互中执行save_chat_history_to_html或save_chat_history_to_markdown。 - 管道触发非交互模式：哪怕管道为空也会触发，空管道 + 无
-q会报错。 - `fkteams web` vs `fkteams serve`：
web包含前端页面；serve仅提供 API，无界面。 - 首次使用需先生成配置：运行
fkteams generate config后再启动，否则报错。 - 可选智能体需先在配置中启用：调用未启用的智能体会返回错误。
- 代理只能通过环境变量设置：
config.toml中没有代理配置项，只用FEIKONG_PROXY_URL。 - `model sw` 只切换默认，不删除配置：要删除用
model rm。 - 技能安装后需重启 fkteams 才生效：技能在启动时加载，热安装不生效。
- `[openai_api]` 不配置 `api_keys` 时所有 API 请求返回 401。