首页> 都市> KingFlow AI Zed 编辑器接入教程

KingFlow AI Zed 编辑器接入教程

著

本文标签：

KingFlow AI Zed 编辑器接入教程配置 OpenAI Compatible Provider 并验证 Agent Panel Zed 可以通过 OpenAI Compatible Provider 使用自定义接口，为 Zed Agent、Inline Assistant、提交信息生成和线程摘要提供模型。本文使用 KingFlow AI 的 Op

来源：KingFlow AI 主角: 更新: 2026-10-29 10:03:44

在线阅读

【扫一扫】手机随心读

读书简介

KingFlow AI Zed 编辑器接入教程

配置 OpenAI Compati*le Provider 并验证 Agent Panel

Zed 可以通过 OpenAI Compati*le Provider 使用自定义接口，为 Zed Agent、Inline Assistant、提交信息生成和线程摘要提供模型。本文使用 KingFlow AI 的 OpenAI 兼容端点，说明图形界面配置、settings.json、系统钥匙串、模型能力、上下文添加、变更审阅和检查点恢复。完成后，可以在不把密钥写入配置文件的前提下，将模型接入 Zed 的原生 AI 工作流。

内容核验日期 2026-10-29

接入架构

环节	职责	注意事项
Zed 项目	提供文件诊断和 Git 上下文	先在可回滚分支中测试
Zed Agent	读取上下文并调用编辑或终端工具	工具行为受权限设置控制
KingFlow Provider	保存端点模型和能力**	Provider ID 使用 kingflow
KingFlow AI	验证密钥并按模型 ID 路由	使用 OpenAI 兼容协议

开始前的准备

在 KingFlow AI 控制台创建以 sk- 开头的 API Key，并确认余额、套餐或模型分组可用。
从模型广场或控制台复制完整模型 ID，并确认模型是否支持工具调用、图像输入和推理参数。
安装当前版本 Zed，打开一个可回滚的 Git 项目，并先保存现有修改。
确认模型的实际上下文窗口和最大输出长度。settings.json 中不能虚报这些数值。

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

使用设置界面添加 Provider

打开命令面板并运行 agent: open settings。
进入 AI 下的 LLM Providers，选择 Add Provider。
选择 OpenAI Compati*le，并把 Provider ID 设为 kingflow。
API **L 填写 https://api.**nju**shen.com/v1，不要追加 chat/completions。
填写 KingFlow API Key。Zed 会把它保存到系统钥匙串，而不是 settings.json。
填写控制台中的完整模型 ID和真实上下文窗口，保存后在模型选择器中选中该模型。

Zed Provider 工作流 — 图二 Zed 设置 Provider、密钥、模型、上下文、审阅和检查点流程。AI 生成示意图。

使用 settings json 配置

{
  "language_models": {
    "openai_compati*le": {
      "kingflow": {
        "api_url": "https://api.**nju**shen.com/v1",
        "**aila*le_models": [
          {
            "name": "<完整模型ID>",
            "display_name": "KingFlow Coding",
            "**x_tokens": 128000,
            "**x_output_tokens": 8192
          }
        ]
      }
    }
  }
}

字段	示例	说明
Provider ID	kingflow	决定环境变量名 KINGFLOW_API_KEY
api_url	https://api.njushen.com/v1	只填写到 /v1
name	完整模型 ID	必须与 KingFlow 控制台一致
display_name	KingFlow Coding	仅用于 Zed 界面显示
**x_tokens	模型真实上下文窗口	示例中的 128000 需要按模型修改
**x_output_tokens	模型真实输出上限	示例中的 8192 需要按模型修改

使用环境变量提供密钥

$env:KINGFLOW_API_KEY="sk-你的密钥"
# 从同一 PowerShell 窗口启动 Zed

export KINGFLOW_API_KEY="sk-你的密钥"
# 从同一终端启动 Zed

确认模型能力

能力	默认或示例	用途	注意事项
tools	默认 true	Zed Agent 读写文件和运行工具	端点必须支持工具调用
i**ges	默认 false	向模型发送图像上下文	仅在模型支持视觉时启用
chat_completions	默认 true	使用聊天补全端点	KingFlow 常规 OpenAI 兼容模型适用
parallel_tool_calls	默认 false	并行调用多个工具	先确认端点实现再开启
reasoning_effort	按模型设置	发送推理强度	不支持时设为 none 或省略

{
  "name": "<推理模型完整ID>",
  "display_name": "KingFlow Reasoning",
  "**x_tokens": 128000,
  "**x_output_tokens": 16384,
  "reasoning_effort": "high",
  "capa**lities": {
    "tools": true,
    "i**ges": false,
    "chat_completions": true
  }
}

运行首次只读线程

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

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

控制上下文范围

上下文	作用	建议
@文件	加入单个文件	目标实现文件和测试文件
@目录	加入目录上下文	只在范围明确时使用
@符号	加入函数类型或类	减少无关 Token
@诊断	加入编译器或语言服务器错误	适合修复具体错误
@分支差异	加入 Git 变更	适合代码**

执行小范围修改

只修改 @src/example.ts 中选中的函数：
- 保持公开接口不变
- 为异常输入补充校验
- 不修改其他文件
- 不运行终端命令
- 完成后说明每处修改的理由

审阅和恢复修改

修改完成后打开 Review Changes，逐块保留或拒绝。若线程方向错误，使用 Restore Checkpoint 恢复到该消息之前。并行线程可能修改相同文件时，先创建独立 Git worktree。

完成联调验证

模型选择器显示 KingFlow Coding，基础问答能正常返回。
KingFlow 控制台出现对应模型的调用记录，密钥和分组状态正常。
首次只读任务能引用真实项目文件，并且没有产生工作区修改。
需要工具时，Zed 显示具体工具调用；不支持工具的模型会出现 No tools 提示。
编辑后 Review Changes 能显示文件和差异块，可以逐块保留或拒绝。
Restore Checkpoint 能恢复到本轮修改前的状态。

保护密钥和代码

不要把 API Key 写入 settings.json。优先使用设置界面的系统钥匙串，或在本机环境变量中提供。
环境变量优先于钥匙串。更换密钥后要清除旧环境变量并重启 Zed，避免继续使用旧值。
首次接入关闭或逐次确认终端、删除文件、工作区外访问和外部工具权限。
只添加任务需要的文件和选择区作为上下文，不要向模型发送密钥、客户数据和生产日志。
在独立 Git 分支或工作树中执行修改，逐块审阅差异，再运行测试和提交。

完成检查清单

Zed 已更新并能打开 Agent Settings。
KingFlow 基础接口已使用 https://api.**nju**shen.com/v1 验证。
Provider ID 为 kingflow，模型 ID 来自控制台。
API Key 保存在系统钥匙串或 KINGFLOW_API_KEY 环境变量。
settings.json 中没有真实密钥。
上下文窗口和输出上限按模型真实规格填写。
首次只读任务、工具提示、Review Changes 和 Restore Checkpoint 已验证。

常见故障排查

现象	常见原因	处理方法
401 或 Invalid API Key	密钥错误停用或变量未被 Zed 读取	重新保存钥匙串或从同一环境启动 Zed
404 Model Not Found	模型 ID 错误或分组未授权	从控制台复制完整 ID并确认套餐分组
404 接口不存在	api_url 包含完整端点或重复 /v1	改为 https://api.njushen.com/v1
Provider 不显示	**ON 语法错误或配置层级错误	检查 settings.json 并重新打开设置
No tools	模型或端点不支持工具调用	换用支持 tools 的已授权模型
工具调用失败	兼容端点未完整转发工具协议	关闭工具任务或联系服务商确认兼容性
推理参数报错	模型不支持 reasoning_effort	删除该字段或设为 none
上下文超限	**x_tokens 虚报或加入内容过多	填**实窗口并缩小上下文
请求超时或 503	**** 通道繁忙或临时无可用账号	检查网络等待后有限重试

《KingFlow AI Zed 编辑器接入教程》资讯列表：

KingFlow AI Zed 编辑器接入教程

相关小说

为您推荐

小说标签