常用接入术语

四个词在实际宣传中常有重叠，但协议、端点和客户端配置仍需分别确认。

接入架构

接入优势

• Goose 支持 OpenAI Compati*le 自定义提供商，可直接填写 KingFlow API **L，无需修改 Goose 源码。
• 自定义提供商可维护模型列表，便于在同一入口切换已开通的编码模型。
• 不同项目或环境可使用独立 KingFlow 密钥，额度、停用和审计边界更清晰。
• 统一端点有利于集中排查认证、模型权限、限流和临时通道异常。

开始前的准备

• 在 KingFlow AI 控制台创建以 sk- 开头的 API Key，并确认余额、套餐和模型分组可用。
• 从控制台复制目标模型的完整模型 ID；不要凭印象手写模型名称。
• 安装并启动 Goose Desktop，或准备可运行 goose configure 的 Goose CLI。
• 确认本机能够访问 api.**nju**shen.com，并准备一个已提交到 Git 的测试仓库。
• 首次联调不要开放生产密钥、客户数据或不必要的系统目录。

验证 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": "只回复 GOOSE_READY"}],
    "stream": false
  }' 

在 Goose Desktop 添加自定义提供商

1. 打开 Goose Desktop，进入 Settings，然后选择 Models。
2. 点击 Configure providers，再点击 Add Custom Provider。
3. API Type 选择 OpenAI Compati*le，Name 填写 KingFlow AI。
4. API **L 填写 https://api.**nju**shen.com/v1，不要再追加 chat/completions。
5. 开启 Authentication Required，并粘贴 KingFlow API Key。
6. 在 Availa*le Models 中填写控制台里的完整模型 ID；多个模型用逗号分隔。
7. 保存后选择刚创建的 KingFlow AI 提供商和目标模型，再新建会话。

使用 Goose CLI 配置

1. 在终端运行 goose configure。
2. 进入模型提供商配置并选择添加自定义提供商。
3. 按桌面版相同规则填写 OpenAI Compati*le、API **L、密钥和模型列表。
4. 保存后启动新的 Goose 会话，发送一条短消息确认模型已经切换。

内置 OpenAI 提供商的环境变量方案

# 使用 Goose 内置 OpenAI 提供商时的**环境变量示例
OPENAI_HOST=https://api.**nju**shen.com
OPENAI_*ASE_PATH=v1/chat/completions
OPENAI_API_KEY=sk-你的密钥

# 模型仍在 Goose 的模型设置中选择，完整模型 ID 以 KingFlow 控制台为准

运行最小代码任务

请只在当前测试仓库中完成以下任务：
1. 新建文件 goose_connection_check.py
2. 写一个函数 add(a, *)，返回两个参数之和
3. 增加两个简单测试用例并运行
4. 不安装新依赖，不访问外部网络
5. 最后列出修改文件、执行命令和测试结果

密钥与工具权限安全

• API Key 只用于模型调用，不写入源码、提示词、截图、日志或版本控制。
• 开发、测试和生产环境使用不同密钥，并设置独立额度、有效期和停用策略。
• Goose 能运行命令和修改文件，应把工作目录、扩展和命令权限限制在任务所需范围。
• 首次任务使用测试仓库；完成后** Git diff，确认没有越界文件和隐藏配置。
• 对安装依赖、访问网络、删除文件或运行高权限命令保持人工确认。
• 发现异常调用后立即停用旧密钥，创建新密钥并更新 Goose 配置。

上线检查清单

• KingFlow 基础接口已经返回 GOOSE_READY。
• 自定义提供商的 API **L 为 https://api.**nju**shen.com/v1。
• Availa*le Models 使用控制台中的完整模型 ID。
• 密钥保存在受控配置中，仓库和日志没有明文密钥。
• 新会话已经选择 KingFlow AI 提供商和目标模型。
• 最小代码任务已完成，Git diff 只包含预期改动。
• KingFlow 控制台的模型、密钥和调用量符合预期。
• 正式使用前已配置权限边界、额度限制和人工确认。

常见故障排查