OpenAI 兼容协议是机制，不是模型数量

OfoxAI 的 Zed 编辑器配置指南通过 OpenAI 兼容协议逐步讲解如何向 Zed 添加自定义 LLM 提供商：一个 api_url，一个 available_models 数组，一个存储在系统钥匙串中的密钥。（OfoxAI，「Zed Editor: Configure Custom LLM Providers & External Agents」，OfoxAI，发布于 2026-03-30，检索 2026-08-23，https://ofox.ai/blog/zed-editor-ai-configuration-guide-2026/）。Honest Architect 把这篇指南读作一个通用机制的工作示例：属性（提供商灵活性——不重编译编辑器就交换一个模型后端）由机制保证（一个标准化协议表面——OpenAI 兼容 API，加上一个编辑器在启动时解析的配置 schema），而不是由声明「我们支持 100+ 模型」保证。一个列出 100 个模型却没有标准化协议的编辑器是一个脆弱的目录；一个暴露一个协议并让你通过编辑配置数组添加提供商的编辑器是一个灵活的表面。Honest Architect 把「协议是机制」形式标为 Production ✅，把 OfoxAI 特定的商业声明（定价、模型名称、「0% 平台费」）标为 Partial ⚠️（供应商自我推销，未经 Everythink 独立核实）。

这篇指南是一个配置演练，不是调查也不是证明。Honest Architect 提取演练展示的机制形式——OpenAI 兼容协议作为提供商灵活性机制，系统钥匙串作为密钥主权机制，外部代理路由作为「空间即路由器」形式——并在形式真实可复现时标为 Production ✅，在形式是供应商特定商业声明时标为 Partial ⚠️。

关键结论

• OpenAI 兼容协议是提供商灵活性的机制。Theorem 3：属性（不重编译就交换一个 LLM 后端）由机制保证（一个标准化 API 表面 + 一个编辑器在启动时解析的配置 schema），不是由声明「我们支持 100+ 模型」保证。Honest Architect 把「协议是机制」形式标为 Production ✅。
• 系统钥匙串是密钥主权的机制。指南：「API Key 安全地存储在系统钥匙串中（macOS Keychain / Linux Secret Service），从不以明文写入配置文件。」属性（密钥不在明文配置中）由机制保证（存在 OS 钥匙串中，不是 JSON 中），不是由声明「我们保护你的密钥」保证。Honest Architect 把「钥匙串非明文」形式标为 Production ✅。
• 能力字段是运行时解析的 schema。每个模型条目有 capabilities: { tools: true, images: false }。Zed 读取能力并相应路由——它不会对一个 tools 为 false 的模型尝试函数调用。属性（在无工具支持的模型上无失败工具调用）由机制保证（编辑器在路由前读取能力标志），不是由声明「我们检查了模型兼容性」保证。Honest Architect 把「能力即 schema」形式标为 Production ✅。
• 外部代理是「空间即路由器」形式。Zed 的代理面板有 Zed Agent（内置，使用配置的 LLM 提供商）和外部代理（Claude Code、Codex CLI、Gemini CLI——「独立运行，有自己的凭据、模型访问和计费——与你的配置 LLM 提供商分离」）。编辑器路由到任何一个代理；代理自行运行。Honest Architect 把「编辑器路由代理运行」形式标为 Production ✅。
• 跨域平行：Eye Key（持久化前 HMAC = 不同域中的钥匙串非明文），World Monitor（每个 geohash 瓦片一个缓存 = 每个提供商表面一个协议），Oracle 归一化（在一个地方归一化 = OpenAI 兼容协议是唯一的归一化点），Zod 运行时边界（能力字段在启动时解析，如 schema 在网络边界解析）。全部 Partial ⚠️：相同形式，分离的领域。
• 范围：民事/防御性。一个代码编辑器的配置指南不是武器。没有攻击性范围。不承诺任何代币、钱包或社区积分结果；这些是 Roadmap 🔵，Howey 审查待定。Everythink 是一个预测平台，不是 LLM 提供商聚合器；跨域平行是机制形式的 Partial ⚠️ 插图，不是对 OfoxAI 作为产品的背书。

协议是机制

指南的核心配置是一个 JSON 对象：language_models.openai_compatible.OfoxAI，带一个 api_url 和一个 available_models 数组。openai_compatible 键是机制——它告诉 Zed「向这个端点说 OpenAI 兼容协议，这里是它服务的模型。」属性（Zed 可以在不改代码的情况下与一个新提供商通信）由机制保证（OpenAI 兼容协议表面 + 配置 schema），不是由声明「Zed 支持 OfoxAI」保证。Honest Architect 把「协议是机制」形式标为 Production ✅，因为形式真实可复现：任何暴露 openai_compatible 配置槽的编辑器可以与任何说 OpenAI 兼容协议的端点通信，提供商通过编辑 JSON 添加，不是通过重编译。

形式在整个指南中泛化。指南提供两种方法：代理面板 GUI 和 settings.json 文件。两者产生相同的配置对象。GUI 是便利；JSON 是真理来源。Honest Architect 把「JSON 是真理来源」形式标为 Production ✅（GUI 编辑 JSON，JSON 是 Zed 在启动时读取的，GUI 是 JSON 上的视图，不是分离的状态）。指南的「Pro Tip」——把文档 URL 和 /v1/models 端点发给一个 AI 让它自动生成配置——是「协议是机制」形式在一个元循环中：模型列表端点是 OpenAI 兼容协议的一部分，所以一个 AI 可以读取它并生成配置。Honest Architect 把元形式标为 Partial ⚠️（供应商建议的工作流，未经独立核实）。

故障排除部分是机制失败模式的测量。「验证 settings.json 格式正确，然后重启 Zed」——配置在启动时解析；一个格式错误的 JSON 会破坏解析。「搜索 language model: reset credentials，然后重新输入你的 API Key」——密钥在钥匙串中；重置会重新存储它。「将该模型的 capabilities.tools 设为 false。如果你对一个不支持函数调用的模型将其留为 true，请求可能失败」——能力字段是运行时解析的 schema；一个错误的标志产生一个错误的路由。「确认 API URL 正好是 https://api.ofox.ai/v1——没有尾随斜杠，没有缺失的 /v1 后缀」——协议表面是 URL 形状的；一个错误的 URL 会破坏协议。每一步都是对机制在哪里断裂的测量：JSON 解析、密钥存储、能力路由、URL。Honest Architect 把「故障排除即测量」形式标为 Production ✅（真实的、可复现的失败模式映射）。

钥匙串是密钥主权机制

指南声明：「API Key 安全地存储在系统钥匙串中（macOS Keychain / Linux Secret Service），从不以明文写入配置文件。」属性（密钥不在明文配置中）由机制保证（存在 OS 钥匙串中，不是 JSON 中），不是由声明「我们保护你的密钥」保证。Honest Architect 把「钥匙串非明文」形式标为 Production ✅。形式是 Everythink 的 Eye Key 在编辑器领域的类比：属性（Eye Key 明文从不触及磁盘）由机制保证（持久化前 HMAC，只有指纹进入 Postgres），不是由声明「我们保护你的密钥」保证。相同形式，分离的领域。Honest Architect 把跨域平行标为 Partial ⚠️。

「钥匙串非明文」形式泛化：任何不应出现在明文配置中的秘密（API 密钥、数据库密码、OAuth 客户端密钥）存储在带外秘密存储中（OS 钥匙串、秘密管理器、运行时注入的环境变量），配置引用存储，不是秘密。声明「我们不以明文存储秘密」是非机制：它不产生主权。机制（存在钥匙串中，从配置引用）直接产生主权。Honest Architect 把「把秘密存出明文」形式标为 Production ✅。

Honest Architect 诚实地注意到摩擦。钥匙串是 OS 特定的（macOS Keychain、Linux Secret Service；指南未提及 Windows Credential Manager）。钥匙串需要一个运行中的桌面会话（无头服务器没有钥匙串）。钥匙串是按用户的（共享配置文件无法共享密钥）。这些不是机制的缺陷；它们是机制的范围。Honest Architect 把范围诚实标为 Partial ⚠️（指南未明确陈述这些限制；它们从机制的形式中推断）。

能力字段是运行时解析的 schema

available_models 数组中的每个模型条目有一个 capabilities 对象：{ tools: true, images: false }。Zed 在启动时读取能力并相应路由——它不会对一个 tools 为 false 的模型尝试函数调用，也不会对一个 images 为 false 的模型发送图像。属性（在无工具支持的模型上无失败工具调用，在无图像支持的模型上无失败图像发送）由机制保证（编辑器在路由前读取能力标志），不是由声明「我们检查了模型兼容性」保证。Honest Architect 把「能力即 schema」形式标为 Production ✅。

形式是 Everythink 的 Zod 运行时边界在编辑器领域的类比：属性（一个坏的 payload 作为类型化 ApiError 出现，从不崩溃）由机制保证（Zod schema 在网络边界解析），不是由声明「我们的 API 是类型化的」保证。TypeScript 类型在运行时被擦除；capabilities 字段在启动时读取。两者都是运行时解析的 schema，根据解析值路由请求。Honest Architect 把跨域平行标为 Partial ⚠️（相同形式——运行时解析的 schema 是机制——分离的领域——编辑器能力路由 vs 网络边界类型安全）。

指南的故障排除确认了机制：「将该模型的 capabilities.tools 设为 false。如果你对一个不支持函数调用的模型将其留为 true，请求可能失败。」一个错误的能力标志产生一个错误的路由。机制不会静默纠正一个错误的标志；它根据标志路由，如果标志撒谎，路由就会失败。Honest Architect 把「机制根据标志路由而非根据真相」形式标为 Production ✅（路由器信任配置，配置必须诚实）。

外部代理是「空间即路由器」形式

Zed 的代理面板有两种模式：Zed Agent（内置，使用配置的 LLM 提供商）和外部代理（Claude Code、Codex CLI、Gemini CLI——「独立运行，有自己的凭据、模型访问和计费——与你的配置 LLM 提供商分离」）。编辑器路由到用户选择的任何一个代理；代理自行运行，有自己的凭据、自己的模型访问、自己的计费。Honest Architect 把「编辑器路由代理运行」形式标为 Production ✅。形式是 Everythink 的「空间即路由器」在编辑器领域的类比：network→community→room 拓扑在任何东西响应之前路由，被路由到的实体自行运行。Honest Architect 把跨域平行标为 Partial ⚠️。

外部代理形式泛化：编辑器是路由器，不是运行时。内置 Zed Agent 使用配置的 LLM 提供商；外部代理使用它们自己的。编辑器不吸收外部代理的凭据、模型访问或计费——它启动代理并让代理运行。属性（用户可以使用任何代理而编辑器不吸收其认证）由机制保证（编辑器路由，代理独立运行），不是由声明「我们支持很多代理」保证。Honest Architect 把「编辑器路由不吸收」形式标为 Production ✅。

Honest Architect 在供应商配置指南中读什么

OfoxAI 的 Zed 指南是一个供应商配置演练。Honest Architect 提取机制形式（OpenAI 兼容协议作为提供商灵活性机制；系统钥匙串作为密钥主权机制；能力字段作为运行时解析的 schema；外部代理作为「空间即路由器」形式）而不背书 OfoxAI 作为产品。机制形式是 Production ✅：真实的、可实现的、由指南自身对配置 schema的描述和故障排除失败模式核实。OfoxAI 特定的商业声明——「100+ 主流 LLM 模型」、「0% 平台费」、「官方 DeepSeek 费率，无加价」、特定的模型名称和价格——是 Partial ⚠️（供应商自我推销，未经 Everythink 独立核实）。Honest Architect 不推荐 OfoxAI、DeepSeek 或任何特定模型。Everythink 是一个预测平台，不是 LLM 提供商聚合器也不是代码编辑器。跨域平行是机制形式的 Partial ⚠️ 插图，不是对指南所售产品的背书。范围是民事/防御性的：一个代码编辑器的配置指南不是武器。不承诺任何代币、钱包或社区积分结果；这些是 Roadmap 🔵，Howey 审查待定。

常见问题

OpenAI 兼容协议是声明还是机制？

机制。Theorem 3：属性（不重编译就交换一个 LLM 后端）由机制保证（一个标准化 API 表面 + 一个编辑器在启动时解析的配置 schema），不是由声明「我们支持 100+ 模型」保证。Honest Architect 把「协议是机制」形式标为 Production。

钥匙串如何平行 Eye Key？

指南：「API Key 安全地存储在系统钥匙串中，从不以明文写入配置文件。」属性（密钥不在明文配置中）由机制保证（存在 OS 钥匙串中，不是 JSON 中）。Eye Key：属性（明文从不触及磁盘）由机制保证（持久化前 HMAC，只有指纹进入 Postgres）。相同形式——把秘密存出明文——分离的领域。Honest Architect 把「钥匙串非明文」标为 Production，跨域平行标为 Partial。

能力字段如何平行 Zod 边界？

每个模型条目有 capabilities: { tools: true, images: false }。Zed 在启动时读取能力并相应路由。Zod schema 在网络边界解析并根据解析值路由请求。两者都是运行时解析的 schema。Honest Architect 把「能力即 schema」标为 Production，跨域平行标为 Partial。

外部代理如何平行「空间即路由器」？

Zed 的外部代理（Claude Code、Codex CLI、Gemini CLI）「独立运行，有自己的凭据、模型访问和计费——与你的配置 LLM 提供商分离」。编辑器路由；代理自行运行。Everythink 的 network→community→room 拓扑在任何东西响应之前路由；被路由到的实体自行运行。相同形式——编辑器路由代理运行——分离的领域。Honest Architect 把形式标为 Production，跨域平行标为 Partial。

Everythink 背书 OfoxAI 或 Zed 吗？

不。Everythink 是一个预测平台，不是 LLM 提供商聚合器也不是代码编辑器。OfoxAI 的 Zed 指南是一个供应商配置演练。Honest Architect 提取机制形式而不背书产品。OfoxAI 特定的商业声明是 Partial（供应商自我推销，未经独立核实）。不承诺任何代币、钱包或社区积分结果；这些是 Roadmap，Howey 审查待定。

来源

• OfoxAI，「Zed Editor: Configure Custom LLM Providers & External Agents」，OfoxAI，发布于 2026-03-30，检索 2026-08-23，https://ofox.ai/blog/zed-editor-ai-configuration-guide-2026/

如果你的团队准备好发布机制而不是声明属性，构建你的 network——Sisters 起草，Oracle 归一化，协议路由。