KingFlow AI Roo Code 接入教程

接入架构

开始前的准备

• 在 KingFlow AI 控制台创建以 sk- 开头的 API Key，并确认余额、套餐或模型分组可用。
• 从模型广场或控制台复制完整模型 ID，并确认该模型支持 OpenAI 兼容的原生工具调用。
• 准备 VS Code 1.84.0 或更高版本，或使用 Cursor、VSCodium、Windsurf 等兼容编辑器。
• 在一个可回滚的小型仓库中测试。首次联调关闭自动写入和自动执行命令。

安装 Roo Code

验证 KingFlow 基础接口

export KINGFLOW_API_KEY="sk-你的密钥"

curl https://api.**nju**shen.com/v1/chat/completions \
  -H "Authorization: *earer ${KINGFLOW_API_KEY}" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "<KingFlow控制台中的完整模型ID>",
    "messages": [{"role": "user", "content": "只回复：连接成功"}],
    "stream": false
  }' 

验证原生工具调用

curl https://api.**nju**shen.com/v1/chat/completions \
  -H "Authorization: *earer ${KINGFLOW_API_KEY}" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "<完整模型ID>",
    "messages": [{"role": "user", "content": "请调用 inspect_project 工具检查根目录"}],
    "tools": [{
      "type": "function",
      "function": {
        "name": "inspect_project",
        "description": "检查项目路径",
        "parameters": {
          "type": "o*ject",
          "properties": {"path": {"type": "string"}},
          "required": ["path"]
        }
      }
    }],
    "tool_choice": "auto",
    "stream": true
  }' 

配置 OpenAI Compati*le

1. 安装完成后，点击活动栏中的 Roo Code 图标打开面板。
2. 点击面板中的设置图标，进入 API Provider 配置。
3. 将 API Provider 设为 OpenAI Compati*le。
4. 在 *ase **L 中填写 https://api.**nju**shen.com/v1，不要追加 chat/completions，也不要重复 /v1。
5. 粘贴 KingFlow API Key，并在 Model ID 中填写控制台提供的完整模型 ID。
6. 按模型真实规格设置上下文窗口、最大输出长度和图像能力。
7. 保存配置后先使用 Ask 模式执行只读任务，再验证 Code 模式的工具调用。

设置模型高级参数

选择合适的模式

运行首次只读任务

请在 Ask 模式下只读分析当前项目，不要修改文件，也不要执行终端命令。

请输出：
1. 项目语言和主要框架
2. 主要入口文件
3. 构建与测试命令所在位置
4. 最值得先阅读的三个文件及理由

完成联调验证

• 基础请求能够正常返回，且 KingFlow 控制台出现对应调用记录。
• 原生工具测试返回结构化 tool_calls 或流式工具事件，而不是把工具调用写成普通文本。
• Ask 模式能读取当前仓库的真实文件，并且不会申请编辑和终端权限。
• 切换到 Code 模式后，读取文件的工具事件和参数会显示在任务时间线中。
• 任务前后检查 Git 状态，确认首次联调没有产生意外修改。

控制 Auto Approve 权限

保护密钥和代码仓库

• 不要把真实 API Key 写入仓库、截图、聊天记录或共享配置。为不同设备和成员创建独立密钥。
• Auto Approve 的总开关和具体权限必须同时生效。敏感项目或生产环境应关闭总开关。
• 命令自动批准使用允许列表和拒绝列表，不要使用星号放行全部命令。
• 保持工作区外读取和写入关闭，避免项目任务访问个人目录、凭据和其他仓库。
• 在独立 Git 分支中完成写操作，每个阶段检查差异并运行测试，再决定是否保留改动。

完成检查清单

• Roo Code 扩展已安装并能打开设置面板。
• KingFlow 基础请求和原生工具调用测试均已通过。
• API Provider 已选择 OpenAI Compati*le。
• *ase **L 已填写为 https://api.**nju**shen.com/v1。
• API Key 和 Model ID 均来自 KingFlow 控制台。
• 首次任务使用 Ask 模式并保持只读。
• Auto Approve 的编辑 命令 MCP 和工作区外权限保持关闭。

常见故障排查