Fkteams

# 第一步：生成配置文件
fkteams generate config

# 第二步：编辑配置，添加模型（必填）
# 编辑 ~/.fkteams/config/config.toml，填写 api_key 和 model

# 第三步（可选）：安装运行时依赖
fkteams init --all   # 安装 uv（Python）和 bun（JavaScript）

# 第四步：启动
fkteams web          # Web 界面（推荐）
fkteams              # CLI 交互模式

fkteams web
# 启动后访问 http://localhost:23456

fkteams              # 默认：团队模式（coordinator 协调多智能体）
fkteams -m deep      # 深度分析模式
fkteams -m group     # 多智能体讨论模式（圆桌）
fkteams --temporary  # 临时会话，不保存历史

fkteams -q "帮我审查 main.go"
fkteams -m deep -q "深度分析这个架构"
fkteams -q "生成一份报告"             # 默认保存历史
fkteams -q "临时问答" --temporary     # 不保存历史

echo "解释一下 Go 的 context 包" | fkteams
cat main.go | fkteams -q "审查以下代码:"
git diff HEAD~1 | fkteams -q "审查这次提交"
curl -s https://example.com/api | fkteams -q "解析这个 API 响应"

fkteams serve
fkteams serve --host 0.0.0.0 --port 8080

fkteams -r "20260302_091249"              # 交互模式恢复
fkteams -r "20260302_091249" -q "继续上次的分析"  # 恢复后直接查询

# 列出所有可用智能体
fkteams agent list

# 交互模式（进入对话）
fkteams agent -n coder
fkteams 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 all
fkteams agent -n coder -q "重构 main.go" --approve file,command

# 临时运行，不保存历史
fkteams agent -n researcher -q "搜索 AI 新闻" --temporary

# 列出所有历史会话
fkteams session list

# 会话默认保存（退出时写入文件）
fkteams
fkteams -q "你的问题"

# 恢复历史会话
fkteams -r "20260302_091249"
fkteams -r "20260302_091249" -q "继续上次的问题"

# 列出已配置的模型
fkteams model ls       # 或 fkteams model list

# 查询服务商的可用模型
fkteams model lr --name deepseek
fkteams model lr --provider openai

# 切换默认对话模型（交互式选择）
fkteams model sw
# 指定配置名
fkteams model sw --name deepseek
# 切换到指定模型
fkteams model sw --name deepseek --model deepseek-reasoner

# 移除模型配置（交互式选择）
fkteams model rm
fkteams model rm --name old-config

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 Key
fkteams 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

# 列出本地已安装的技能
fkteams skill list    # 或 fkteams skill ls

# 搜索技能市场（默认后端：SkillHub）
fkteams skill search <关键词>
fkteams skill search ffmpeg --page 2 --size 20
fkteams skill search ffmpeg --provider SkillHub

# 安装技能
fkteams skill install <技能slug>
fkteams skill install video-frames --version 1.0.0
fkteams skill install video-frames --provider SkillHub

# 移除技能
fkteams skill remove <技能slug>

# 生成示例配置文件（首次使用必须执行）
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  # 生成镜像源配置（国内加速）

# 模型（必填）
[[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"]

# 检查并更新 fkteams 到最新版本
fkteams update

# 列出所有可用工具
fkteams tool list

# 显示版本
fkteams --version