接入架构

Cline 在编辑器中收集项目上下文，并通过 OpenAI Compati*le 服务商向 KingFlow AI 发送请求。

开始前的准备

• 在 KingFlow AI 控制台创建以 sk- 开头的 API Key，并确认余额、套餐或模型分组可用。
• 从模型广场或控制台复制完整模型 ID。不要凭记忆输入，也不要擅自缩写模型名称。
• 安装 VS Code、Cursor、Windsurf 或 VSCodium，并准备一个小型测试项目。
• 提交或备份项目现有改动。首次联调只允许读取项目文件，不自动批准编辑和终端命令。

安装 Cline 扩展

1. 打开扩展市场，搜索 Cline。
2. 确认发布者和扩展信息后点击 Install。
3. 从侧栏打开 Cline 并进入设置。

先验证 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
  }' 

$headers = @{
  Authorization = "*earer sk-你的密钥"
  "Content-Type" = "application/json"
}
$*ody = @{
  model = "<KingFlow控制台中的完整模型ID>"
  messages = @(@{ role = "user"; content = "只回复：连接成功" })
  stream = $false
} | ConvertTo-Json -Depth 4
Invoke-RestMethod -Method Post `
  -Uri "https://api.**nju**shen.com/v1/chat/completions" `
  -Headers $headers -*ody $*ody

配置 OpenAI Compati*le

1. 安装完成后，点击编辑器侧栏中的 Cline 图标，打开 Cline 面板。
2. 点击 Cline 面板中的齿轮图标进入 Settings，然后找到 API Provider。
3. 将 API Provider 设为 OpenAI Compati*le。此选项用于连接第三方 OpenAI 兼容接口。
4. 在 *ase **L 中填写 https://api.**nju**shen.com/v1。不要再追加 chat/completions，也不要重复写 /v1。
5. 在 API Key 中粘贴 KingFlow 密钥。录屏、截图或共享屏幕前先确认密钥没有显示。
6. 在 Model ID 中粘贴 KingFlow 控制台提供的完整模型 ID，然后点击 Verify。
7. 验证成功后返回任务面板，先运行只读分析，再逐步开放编辑和命令权限。

设置模型高级参数

运行首次只读任务

请只读分析当前项目，不要修改文件，也不要运行安装、删除或写入命令。

请输出：
1. 项目使用的语言和框架
2. 主要入口文件
3. 测试命令的位置
4. 你建议我下一步检查的两个文件

完成联调验证

• Cline 的 Verify 返回成功，任务面板没有 Invalid API Key 或 Model Not Found。
• 只读任务能引用当前仓库的真实目录和文件，而不是给出泛化回答。
• Cline 请求读取项目文件时，权限提示符合当前 Auto Approve 设置。
• 运行前后比较 Git 状态，确认首次联调没有产生意外修改。
• KingFlow 控制台出现对应调用记录，模型和密钥归属符合预期。

控制 Auto Approve 权限

日常项目使用建议

• 一个任务只处理一个明确目标。需求过大时拆成分析、实现和验证三个独立任务。
• 让 Cline 先说明计划和预计修改的文件，再授权写入。不要直接从模糊提示词开始全自动执行。
• 高风险变更使用独立 Git 分支，并在每个可工作的节点提交。需要撤销时优先使用版本控制或检查点。
• 大型仓库排除依赖、构建产物和无关数据，减少上下文浪费和敏感信息暴露。
• 为不同设备或成员创建独立 KingFlow 密钥，并设置合理额度。发现异常时只撤销受影响密钥。

完成检查清单

• Cline 扩展已安装并可以打开设置面板。
• KingFlow 最小 API 请求已经成功。
• API Provider 已选择 OpenAI Compati*le。
• *ase **L 已填写为 https://api.**nju**shen.com/v1。
• API Key 和 Model ID 均来自 KingFlow 控制台。
• Verify、只读分析和调用记录检查均已通过。
• 首次联调未自动批准编辑、全部命令或工作区外访问。

常见故障排查

接入完成后的推荐任务

连接稳定后，从范围清晰、结果容易检查的任务开始。每次任务都写明允许读取或修改的范围，并保留人工验收。