Skip to content

IFLOW_INTEGRATION.md

Latest commit

 

History

History
166 lines (133 loc) · 3.76 KB

IFLOW_INTEGRATION.md

File metadata and controls

166 lines (133 loc) · 3.76 KB

iFlow CLI 集成文档

概述

iFlow CLI 是一款强大的AI助手，已成功集成到系统中。

特性

  • 🆓 免费AI模型访问（Kimi K2、Qwen3 Coder、DeepSeek v3等）
  • 🎨 多模态能力
  • 🏪 内置开放市场
  • 🔌 VS Code 和 JetBrains 插件支持
  • 🚀 YOLO模式，自动执行操作
  • 📝 智能代码分析和任务执行

安装

方法1: npm安装（推荐）

npm i -g @iflow-ai/iflow-cli

方法2: 官方安装脚本

# macOS/Linux
bash -c "$(curl -fsSL https://cloud.iflow.cn/iflow-cli/install.sh)"

验证安装

iflow --version

在系统中使用

1. 启动服务器

# 首次使用需要编译
go build -o xx-cli-to-api .

# 启动服务
./xx-cli-to-api serve

2. 访问Web界面

打开浏览器访问: http://localhost:25486

在工具管理页面中：

  1. 找到 iFlow CLI 工具
  2. 确认状态显示"已安装"和"可用"
  3. 点击开关启用工具

3. 使用API调用

方法1: 通过X-CLI-Tool头指定

curl -X POST http://localhost:25486/v1/chat/completions \
  -H "Authorization: Bearer YOUR_TOKEN" \
  -H "Content-Type: application/json" \
  -H "X-CLI-Tool: iflow" \
  -d '{
    "model": "iflow",
    "messages": [{"role": "user", "content": "创建一个Python计算器函数"}],
    "stream": false
  }'

方法2: 直接使用模型名

curl -X POST http://localhost:25486/v1/chat/completions \
  -H "Authorization: Bearer YOUR_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "iflow",
    "messages": [{"role": "user", "content": "解释什么是递归"}],
    "stream": false
  }'

流式输出

curl -X POST http://localhost:25486/v1/chat/completions \
  -H "Authorization: Bearer YOUR_TOKEN" \
  -H "Content-Type: application/json" \
  -H "X-CLI-Tool: iflow" \
  -d '{
    "model": "iflow",
    "messages": [{"role": "user", "content": "编写一个快速排序算法"}],
    "stream": true
  }'

技术细节

命令参数

iFlow集成使用以下参数：

  • -y: YOLO模式，自动执行所有操作
  • -p: 直接提问模式

示例: iflow -y -p "你的问题"

输出过滤

系统会自动过滤iFlow的调试信息，包括：

  • MCP错误日志
  • 内部思考过程（<think> 标签）
  • 执行信息块（<Execution Info> 标签）

只返回AI的实际回复内容。

负载均衡

当启用多个CLI工具时，系统会自动进行负载均衡：

  • 支持轮询分配请求
  • 只有可用的工具参与负载均衡
  • 可通过X-CLI-Tool头指定特定工具

测试脚本

运行自动化测试：

./test_iflow_integration.sh

测试脚本会验证：

  1. 服务器运行状态
  2. iFlow工具存在性
  3. 安装和可用状态
  4. API调用功能

相关链接

故障排除

iFlow未在工具列表中

# 重新编译并重启服务器
go build -o xx-cli-to-api .
# 停止旧服务，然后启动新服务
./xx-cli-to-api serve

iFlow显示未安装

# 安装iFlow
npm i -g @iflow-ai/iflow-cli

# 刷新工具状态（在Web界面或通过API）
curl -X POST http://localhost:25486/api/tools/refresh \
  -H "Authorization: Bearer YOUR_TOKEN"

iFlow显示已安装但不可用

这通常是正常的，因为iFlow不需要特殊认证即可使用。只要显示"已安装"即可启用。

更新日志

v1.1.0 (2024-12-02)

  • ✅ 添加输出过滤脚本，清理MCP错误日志
  • ✅ 完善文档说明
  • ✅ 添加自动化测试脚本
  • ✅ 优化错误处理

v1.0.0 (2024-11-18)

  • ✅ 添加iFlow CLI到内置工具列表
  • ✅ 实现命令参数构建（-y -p模式）
  • ✅ 集成历史记录和Token统计