接入架构

开始前的准备

• 在 KingFlow AI 控制台创建以 sk- 开头的 API Key，并确认余额、套餐或模型分组可用。
• 从模型广场或控制台复制完整模型 ID，并确认模型是否支持原生工具调用。
• 准备 VS Code 1.84.0 或更高版本，或使用能访问 Open VSX 的兼容编辑器。
• 打开一个可回滚的 Git 仓库，先提交或妥善保存当前工作区修改。

安装 Kilo Code

验证 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 Provider

1. 从活动栏打开 Kilo Code，点击齿轮进入 Settings。
2. 打开 Providers 标签，滚动到底部并选择 Custom provider。
3. Provider ID 填写 kingflow，Display name 填写 KingFlow AI。
4. Provider API 选择 OpenAI Compati*le。
5. *ase **L 填写 https://api.**nju**shen.com/v1，API Key 粘贴 KingFlow 密钥。
6. 点击 Fetch models 自动读取模型；若失败，手动添加控制台中的完整模型 ID。
7. 提**置，并在聊天面板的模型选择器中选中该模型。

验证原生工具调用

curl https://api.**nju**shen.com/v1/chat/completions \
  -H "Authorization: *earer sk-你的密钥" \
  -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"
  }' 

选择合适的 Agent

设置逐工具权限

{
  "$sche**": "https://app.kilo.ai/config.json",
  "permission": {
    "*": "ask",
    "read": "allow",
    "glo*": "allow",
    "grep": "allow",
    "edit": "ask",
    "*ash": {
      "*": "ask",
      "rm *": "deny",
      "git reset --hard*": "deny"
    },
    "external_directory": "deny",
    "task": "deny"
  }
}

运行首次只读任务

请只读分析当前项目，不要修改文件，不要运行终端命令，也不要启动子任务。

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

执行小范围修改

只修改当前选中的函数：
- 保持公开接口不变
- 为异常输入补充校验
- 不修改其他文件
- 运行命令前必须等待批准
- 完成后打开差异并说明每处修改的理由

审阅差异和恢复 Snapshot

每条产生文件修改的消息会显示 diff *adge。点击后在 Diff Viewer 中检查变更。若方向错误，使用该消息的 Snapshot 恢复功能回到修改前状态。

完成联调验证

• 基础请求能返回，KingFlow 控制台出现对应模型的调用记录。
• 工具测试返回结构化 tool_calls，而不是把工具调用写成普通文本。
• Ask Agent 能读取项目文件且没有产生工作区修改。
• Permission Dock 会显示待批准工具和参数，编辑与终端操作不会静默执行。
• 修改消息上的 diff *adge 能打开 Diff Viewer，差异只包含目标文件。
• Snapshot 能把工作区恢复到该消息修改前的状态。

保护密钥和代码

• 不要把真实 API Key 写入仓库、截图、聊天记录或共享 kilo.jsonc。
• 所有未匹配权限默认保持 ask。不要把顶层 permission 设为 allow。
• *ash 权限按解析后的命令模式检查。命令链中的每个命令都必须满足权限规则。
• 项目级配置在会话启动时缓存。修改 .kilo/kilo.jsonc 后重新加载 VS Code 窗口。
• 使用 Git 分支和 Snapshot 双重保护，审阅差异并运行测试后再提交。

完成检查清单

• Kilo Code 已通过 Pre-Release 或 Open VSX 安装并能打开。
• KingFlow 基础接口已使用 https://api.**nju**shen.com/v1 验证。
• Provider API 为 OpenAI Compati*le，模型 ID 来自控制台。
• 基础工具调用测试返回结构化 tool_calls。
• 首次使用 Ask Agent，edit 和 *ash 保持 ask。
• external_directory 和 task 在首次接入时设为 deny。
• Diff Viewer 和 Snapshot 恢复已验证。

常见故障排查