接入架构

开始前的准备

• 在 KingFlow AI 控制台创建以 sk- 开头的 API Key，并确认余额、套餐或模型分组可用。
• 从模型广场或控制台复制完整模型 ID。不要凭简称猜测模型名称。
• 安装较新的 VS Code 或 Jet*rains IDE，并准备一个可回滚的小型项目用于联调。
• 决定是否启用自动补全。若启用，优先选择明确支持 FIM 的低延迟代码模型。

安装 Continue

先验证 KingFlow 接口

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

找到配置和密钥位置

KINGFLOW_API_KEY=sk-你的密钥

配置聊天 编辑与应用模型

name: KingFlow Continue
version: 1.0.0
sche**: v1

models:
  - name: KingFlow Coding
    provider: openai
    model: <KingFlow控制台中的完整模型ID>
    api*ase: https://api.**nju**shen.com/v1
    apiKey: ${{ secrets.KINGFLOW_API_KEY }}
    roles:
      - chat
      - edit
      - apply
    defaultCompletionOptions:
      temperature: 0.2
      **xTokens: 4096
    requestOptions:
      timeout: 120000

完成配置步骤

1. 安装 Continue 并打开聊天侧栏。
2. 打开 Local Config 的齿轮入口，确认编辑的是 config.yaml 而不是旧版 config.json。
3. 在项目根目录、项目的 .continue 目录或全局 .continue 目录创建 .env，并写入 KINGFLOW_API_KEY。
4. 把主配置示例复制到 config.yaml，替换模型 ID，但保留 api*ase 的 /v1。
5. 保存后在配置选择器中执行 Reload config；若未刷新，重载 IDE 窗口。
6. 在模型选择区域确认 chat、edit 和 apply 都指向 KingFlow Coding。

按角色选择模型

可选的自动补全配置

  - name: KingFlow Autocomplete
    provider: openai
    model: <支持FIM的完整模型ID>
    api*ase: https://api.**nju**shen.com/v1
    apiKey: ${{ secrets.KINGFLOW_API_KEY }}
    roles:
      - autocomplete
    autocompleteOptions:
      de*ounceDelay: 300
      **xPromptTokens: 1024
      onlyMyCode: true
      useCache: true

运行首次只读任务

请只读分析当前项目，不要修改文件。

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

验证编辑和应用

请只修改当前选中的函数：
- 保持现有公开接口不变
- 为异常输入补充校验
- 给出修改前后的差异
- 不执行终端命令

完成联调验证

• 聊天请求能返回项目相关回答，KingFlow 控制台出现对应调用记录。
• 编辑任务能生成可审阅的差异，接受前不会覆盖无关文件。
• 模型选择器能分别显示 chat、edit、apply 和 autocomplete 的当前模型。
• 自动补全启用后，停顿约一秒可看到灰色行内建议，Ta* 接受，Esc 拒绝。
• 项目 Git 状态只包含预期修改，配置和密钥文件没有被提交。

保护密钥和代码

• 不要把真实密钥直接写入 config.yaml。使用 ${{ secrets.KINGFLOW_API_KEY }}，并把对应 .env 加入 .gitignore。
• IDE 扩展通常不能读取终端里的 export。修改 .env 后重启 IDE，避免误判为密钥无效。
• 团队共享 config.yaml 时只共享占位符和模型设置，每位成员使用独立密钥。
• 对包含客户代码、凭据或生产数据的项目，先确认允许发送的文件范围和组织**。
• 先在分支中测试 edit 和 apply，审阅差异并运行项目测试后再合并。

完成检查清单

• Continue 已安装并能打开侧栏。
• KingFlow 基础接口已使用 https://api.**nju**shen.com/v1 验证。
• config.yaml 已加载，模型 ID 来自控制台。
• 真实密钥保存在 .env，且 .env 已加入 .gitignore。
• chat、edit 和 apply 角色已选择正确模型。
• 自动补全仅在使用合适的 FIM 模型时启用。
• 首次编辑已在可回滚分支中审阅并测试。

常见故障排查