Fx 自定义模型接入：命名连接与 Chat Completions

这里的 Fx 指官方 vercel-labs/fx 编程 Agent，不是同名 JSON 查看工具。它采用接近 Shell 的交互，也提供单次 fx ask；官方仓库标注实验状态，因此接入评估应先在隔离工作区进行。

自定义连接只有明确的一种协议

官方自定义连接文档要求 protocol 为 openai-chat-completions，并由客户端在 base_url 后追加 /chat/completions。不能把 Responses 或 Messages 服务填进去，期待客户端自动识别转换。

在用户级 settings.json 声明

连接定义放在 ~/.fx/settings.json 的顶层。下面是需要合并到原设置的短例；地址仅为占位，本站没有提供真实接口。FX_GUIDE_KEY 是本例自行选择的环境变量名，并非 Fx 固定要求。

{
  "provider": "guide",
  "providers": {
    "guide": {
      "protocol": "openai-chat-completions",
      "base_url": "https://80321.cn/v1",
      "auth": { "type": "bearer", "env": "FX_GUIDE_KEY" }
    }
  },
  "models": { "guide": "YOUR_MODEL_ID" }
}

示意密钥值为 YOUR_API_KEY，实际应通过受控环境提供，不放进共享项目。自定义连接不能由项目 .fx.json 定义或选中，避免把用户级能力误写成仓库配置。

单次选择比修改默认更便于比较

fx provider guide 会保存选择；想避免改变默认值，可以为一次启动设置官方支持的变量。

FX_PROVIDER=guide FX_MODEL=YOUR_MODEL_ID fx ask "只回答连接验证，不运行工具"

这仅是测试步骤，本文未执行。准备好真实地址与授权凭证后，先在临时目录比较普通响应，再允许一次只读任务。使用 fx status --json 核对选中端点及模型，但不能把状态信息当作真实请求成功。

缺失元数据会影响压缩与视觉

官方说明 model_metadata 可以登记上下文、输出及工具能力；未知上下文窗口时，Fx 无法计算自动压缩阈值。图片输入需要明确声明视觉支持，声明本身不改变模型能力。 未获得服务契约前，先做短文本测试，不虚填大窗口或开启图像。

自定义连接不是完整网关替代

自定义适配器支持聊天补全中的流式文本、推理和函数工具，但网关搜索、额度检查及视觉回退不可用，也不支持自定义认证请求头或供应商专属推理控制。 如果服务必须依赖这些能力，应停止本方案评估。鉴权缺失先检查 auth.env 指向的变量；路径错误先核对拼接结果，不执行陌生登录脚本或放开自动审批。

把同一句短问题在不同连接中对照，并将自定义端点结果与默认网关分开记录。账号登录成功并不能证明另一条连接的认证有效；只有服务确认接受相同的模型 ID，才复用原来的模型选择。