O protocolo OpenAI-compatível é o mecanismo, não a contagem de modelos

O guia de configuração do editor Zed da OfoxAI percorre adicionar um provedor LLM personalizado ao Zed via o protocolo OpenAI-compatível: um api_url, um array available_models, uma chave armazenada no chaveiro do sistema. (OfoxAI, «Zed Editor: Configure Custom LLM Providers & External Agents», OfoxAI, publicado 2026-03-30, recuperado 2026-08-23, https://ofox.ai/blog/zed-editor-ai-configuration-guide-2026/). O Honest Architect lê o guia como um exemplo trabalhado de um mecanismo geral: a propriedade (flexibilidade de provedor — trocar um backend de modelo por outro sem recompilar o editor) é garantida pelo mecanismo (uma superfície de protocolo padronizada — a API OpenAI-compatível, mais um esquema de configuração que o editor parseia no início), não pela afirmação «suportamos mais de 100 modelos.» Um editor que lista 100 modelos sem um protocolo padronizado é um catálogo frágil; um editor que expõe um protocolo e te permite adicionar provedores editando um array de configuração é uma superfície flexível. O Honest Architect etiqueta a forma o-protocolo-é-o-mecanismo Production ✅ e as afirmações comerciais específicas da OfoxAI (preços, nomes de modelos, «0% de taxa de plataforma») Partial ⚠️ (autopromoção de fornecedor, não verificada independentemente por Everythink).

O guia é um percurso de configuração, não uma investigação nem uma prova. O Honest Architect extrai as formas de mecanismo que o percurso exibe — o protocolo OpenAI-compatível como mecanismo de flexibilidade de provedor, o chaveiro do sistema como mecanismo de soberania de chave, o roteamento de agentes externos como a forma o-espaço-é-o-roteador — e etiqueta cada forma Production ✅ onde a forma é real e reproduzível, Partial ⚠️ onde a forma é uma afirmação comercial específica do fornecedor.

Conclusões chave

• O protocolo OpenAI-compatível é o mecanismo para a flexibilidade de provedor. Teorema 3: a propriedade (trocar um backend LLM por outro sem recompilar) é garantida pelo mecanismo (uma superfície de API padronizada + um esquema de configuração que o editor parseia no início), não pela afirmação «suportamos mais de 100 modelos.» O Honest Architect etiqueta a forma o-protocolo-é-o-mecanismo Production ✅.
• O chaveiro do sistema é o mecanismo para a soberania de chave. O guia: «A API Key é armazenada de forma segura no chaveiro do sistema (macOS Keychain / Linux Secret Service) e nunca é escrita em texto plano nos arquivos de configuração.» A propriedade (a chave não está em configuração de texto plano) é garantida pelo mecanismo (armazenar no chaveiro do SO, não no JSON), não pela afirmação «protegemos sua chave.» O Honest Architect etiqueta a forma chaveiro-não-texto-plano Production ✅.
• O campo de capacidades é o esquema parseado em runtime. Cada entrada de modelo tem capabilities: { tools: true, images: false }. O Zed lê as capacidades e roteia conforme — não tentará uma chamada de função em um modelo cujo tools é false. A propriedade (sem chamadas de ferramenta falhadas em modelos sem suporte a ferramentas) é garantida pelo mecanismo (o editor lê o flag de capacidade antes de rotear), não pela afirmação «verificamos a compatibilidade do modelo.» O Honest Architect etiqueta a forma as-capacidades-são-o-esquema Production ✅.
• Os agentes externos são a forma o-espaço-é-o-roteador. O Painel de Agente do Zed tem Agente Zed (integrado, usa o provedor LLM configurado) e Agentes Externos (Claude Code, Codex CLI, Gemini CLI — «rodam independentemente, têm suas próprias credenciais, acesso a modelos e faturamento — separados do seu provedor LLM configurado»). O editor roteia para qualquer agente; o agente roda por conta própria. O Honest Architect etiqueta a forma o-editor-roteia-o-agente-roda Production ✅.
• Paralelos cross-domain: Eye Key (HMAC antes de persistir = chaveiro-não-texto-plano em um domínio diferente), World Monitor (um cache por tile de geohash = um protocolo por superfície de provedor), normalização Oracle (normalizar em um só lugar = o protocolo OpenAI-compatível é o único ponto de normalização), Zod no boundary de runtime (o campo de capacidades é parseado no início, como o esquema é parseado no boundary de rede). Todos Partial ⚠️: mesma forma, domínios separados.
• Escopo: civil/defensivo. Um guia de configuração para um editor de código não é uma arma. Sem escopo ofensivo. Nenhum resultado de token, wallet ou community-credit é prometido; esses são Roadmap 🔵, revisão Howey pendente. Everythink é uma plataforma de forecasting, não um agregador de provedores LLM; os paralelos cross-domain são ilustrações Partial ⚠️ das formas de mecanismo, não endossos da OfoxAI como produto.

O protocolo é o mecanismo

A configuração central do guia é um objeto JSON: language_models.openai_compatible.OfoxAI com um api_url e um array available_models. A chave openai_compatible é o mecanismo — diz ao Zed «fale o protocolo OpenAI-compatível para este endpoint, e aqui estão os modelos que ele serve.» A propriedade (Zed pode falar com um novo provedor sem uma mudança de código) é garantida pelo mecanismo (a superfície do protocolo OpenAI-compatível + o esquema de configuração), não pela afirmação «Zed suporta OfoxAI.» O Honest Architect etiqueta a forma o-protocolo-é-o-mecanismo Production ✅ porque a forma é real e reproduzível: qualquer editor que exponha um slot de configuração openai_compatible pode falar com qualquer endpoint que fale o protocolo OpenAI-compatível, e o provedor é adicionado editando JSON, não recompilando.

A forma se generaliza através do guia. O guia oferece dois métodos: o GUI do Painel de Agente e o arquivo settings.json. Ambos produzem o mesmo objeto de configuração. O GUI é uma conveniência; o JSON é a fonte de verdade. O Honest Architect etiqueta a forma o-JSON-é-a-fonte-de-verdade Production ✅ (o GUI edita o JSON, o JSON é o que o Zed lê no início, o GUI é uma vista sobre o JSON, não um estado separado). O «Pro Tip» do guia — envia a URL dos docs e o endpoint /v1/models para uma IA e faz ela auto-gerar a configuração — é a forma o-protocolo-é-o-mecanismo em um loop meta: o endpoint de lista de modelos é parte do protocolo OpenAI-compatível, então uma IA pode lê-lo e gerar a configuração. O Honest Architect etiqueta a meta-forma Partial ⚠️ (fluxo de trabalho sugerido pelo fornecedor, não verificado independentemente).

A seção de troubleshooting é uma medição dos modos de falha do mecanismo. «Verifica que o formato do settings.json esteja correto, depois reinicia o Zed» — a configuração é parseada no início; um JSON malformado quebra o parse. «Busca por language model: reset credentials, e re-insere tua API Key» — a chave está no chaveiro; um reset a re-armazena. «Define capabilities.tools como false para esse modelo. Se o deixares como true para um modelo que não suporta chamada de funções, as requisições podem falhar» — o campo de capacidades é o esquema parseado em runtime; um flag errado produz uma rota errada. «Confirma que a API URL seja exatamente https://api.ofox.ai/v1 — sem barra final, sem o sufixo /v1 faltante» — a superfície do protocolo tem forma de URL; uma URL errada quebra o protocolo. Cada passo é uma medição de onde o mecanismo quebra: o parse JSON, o armazém de chaves, a rota de capacidade, a URL. O Honest Architect etiqueta a forma troubleshooting-como-medição Production ✅ (mapeamento de modos de falha real e reproduzível).

O chaveiro é o mecanismo de soberania de chave

O guia afirma: «A API Key é armazenada de forma segura no chaveiro do sistema (macOS Keychain / Linux Secret Service) e nunca é escrita em texto plano nos arquivos de configuração.» A propriedade (a chave não está em configuração de texto plano) é garantida pelo mecanismo (armazenar no chaveiro do SO, não no JSON), não pela afirmação «protegemos tua chave.» O Honest Architect etiqueta a forma chaveiro-não-texto-plano Production ✅. A forma é o análogo no domínio do editor do Eye Key de Everythink: a propriedade (o plaintext do Eye Key nunca toca disco) é garantida pelo mecanismo (HMAC antes de persistir, só a impressão digital vai para Postgres), não pela afirmação «protegemos tua chave.» Mesma forma, domínios separados. O Honest Architect etiqueta o paralelo cross-domain Partial ⚠️.

A forma chaveiro-não-texto-plano se generaliza: qualquer segredo que não deve aparecer em configuração de texto plano (chaves API, senhas de banco de dados, segredos de cliente OAuth) é armazenado em um armazém de segredos fora de banda (chaveiro do SO, gestor de segredos, variável de ambiente injetada em runtime), e a configuração referencia o armazém, não o segredo. A afirmação «não armazenamos segredos em texto plano» é um não-mecanismo: não produz soberania. O mecanismo (armazenar no chaveiro, referenciar da configuração) produz a soberania diretamente. O Honest Architect etiqueta a forma armazena-o-segredo-fora-de-texto-plano Production ✅.

O Honest Architect nota a fricção honestamente. O chaveiro é específico do SO (macOS Keychain, Linux Secret Service; o guia não menciona Windows Credential Manager). O chaveiro requer uma sessão de desktop em execução (um servidor sem interface não tem chaveiro). O chaveiro é por usuário (um arquivo de configuração compartilhado não pode compartilhar a chave). Estes não são falhas do mecanismo; são o escopo do mecanismo. O Honest Architect etiqueta a honestidade-sobre-o-escopo Partial ⚠️ (o guia não estabelece explicitamente estes limites; são inferidos da forma do mecanismo).

O campo de capacidades é o esquema parseado em runtime

Cada entrada de modelo no array available_models tem um objeto capabilities: { tools: true, images: false }. O Zed lê as capacidades no início e roteia conforme — não tentará uma chamada de função em um modelo cujo tools é false, e não enviará uma imagem para um modelo cujo images é false. A propriedade (sem chamadas de ferramenta falhadas em modelos sem suporte a ferramentas, sem envios de imagem falhados em modelos sem suporte a imagens) é garantida pelo mecanismo (o editor lê o flag de capacidade antes de rotear), não pela afirmação «verificamos a compatibilidade do modelo.» O Honest Architect etiqueta a forma as-capacidades-são-o-esquema Production ✅.

A forma é o análogo no domínio do editor do Zod de Everythink no boundary de runtime: a propriedade (um payload ruim surge como um ApiError tipado, nunca um crash) é garantida pelo mecanismo (esquemas Zod parseados no boundary de rede), não pela afirmação «nossa API é tipada.» Os tipos TypeScript são apagados em runtime; o campo capabilities é lido no início. Ambos são esquemas parseados em runtime que roteiam a requisição baseada no valor parseado. O Honest Architect etiqueta o paralelo cross-domain Partial ⚠️ (mesma forma — o esquema parseado em runtime é o mecanismo — domínios separados — roteamento de capacidade do editor vs segurança de tipo no boundary de rede).

O troubleshooting do guia confirma o mecanismo: «Define capabilities.tools como false para esse modelo. Se o deixares como true para um modelo que não suporta chamada de funções, as requisições podem falhar.» Um flag de capacidade errado produz uma rota errada. O mecanismo não corrige silenciosamente um flag errado; roteia baseado no flag e a rota falha se o flag mente. O Honest Architect etiqueta a forma o-mecanismo-roteia-segundo-o-flag-não-segundo-a-verdade Production ✅ (o roteador confia na configuração, a configuração deve ser honesta).

Os agentes externos são a forma o-espaço-é-o-roteador

O Painel de Agente do Zed tem dois modos: Agente Zed (integrado, usa o provedor LLM configurado) e Agentes Externos (Claude Code, Codex CLI, Gemini CLI — «rodam independentemente, têm suas próprias credenciais, acesso a modelos e faturamento — separados do seu provedor LLM configurado»). O editor roteia para qualquer agente que o usuário selecione; o agente roda por conta própria, com suas próprias credenciais, seu próprio acesso a modelos, seu próprio faturamento. O Honest Architect etiqueta a forma o-editor-roteia-o-agente-roda Production ✅. A forma é o análogo no domínio do editor do o-espaço-é-o-roteador de Everythink: a topologia network→community→room roteia antes de qualquer coisa responder, e a entidade roteada roda por conta própria. O Honest Architect etiqueta o paralelo cross-domain Partial ⚠️.

A forma de agente externo se generaliza: o editor é um roteador, não um runtime. O Agente Zed integrado usa o provedor LLM configurado; os agentes externos usam os seus. O editor não absorve as credenciais, o acesso a modelos ou o faturamento do agente externo — lança o agente e deixa o agente rodar. A propriedade (o usuário pode usar qualquer agente sem que o editor absorva seu auth) é garantida pelo mecanismo (o editor roteia, o agente roda independentemente), não pela afirmação «suportamos muitos agentes.» O Honest Architect etiqueta a forma o-editor-roteia-não-absorve Production ✅.

O que um Honest Architect lê em um guia de configuração de fornecedor

O guia Zed da OfoxAI é um percurso de configuração de fornecedor. O Honest Architect extrai as formas de mecanismo (o protocolo OpenAI-compatível como mecanismo de flexibilidade de provedor; o chaveiro do sistema como mecanismo de soberania de chave; o campo de capacidades como esquema parseado em runtime; os agentes externos como a forma o-espaço-é-o-roteador) sem endossar OfoxAI como produto. As formas de mecanismo são Production ✅: reais, implementáveis, verificadas pela própria descrição do guia do esquema de configuração e os modos de falha do troubleshooting. As afirmações comerciais específicas da OfoxAI — «mais de 100 modelos LLM mainstream», «0% de taxa de plataforma», «tarifas oficiais do DeepSeek, sem margem», os nomes e preços específicos de modelos — são Partial ⚠️ (autopromoção de fornecedor, não verificada independentemente por Everythink). O Honest Architect não recomenda OfoxAI, DeepSeek, nem nenhum modelo específico. Everythink é uma plataforma de forecasting, não um agregador de provedores LLM nem um editor de código. Os paralelos cross-domain são ilustrações Partial ⚠️ das formas de mecanismo, não endossos do produto que o guia vende. O escopo é civil/defensivo: um guia de configuração para um editor de código não é uma arma. Nenhum resultado de token, wallet ou community-credit é prometido; esses são Roadmap 🔵, revisão Howey pendente.

Perguntas frequentes

O protocolo OpenAI-compatível é a afirmação ou o mecanismo?

O mecanismo. Teorema 3: a propriedade (trocar um backend LLM por outro sem recompilar) é garantida pelo mecanismo (uma superfície de API padronizada + um esquema de configuração que o editor parseia no início), não pela afirmação «suportamos mais de 100 modelos.» O Honest Architect etiqueta a forma o-protocolo-é-o-mecanismo Production.

Como o chaveiro paraleliza Eye Key?

O guia: «A API Key é armazenada de forma segura no chaveiro do sistema e nunca é escrita em texto plano nos arquivos de configuração.» A propriedade (a chave não está em configuração de texto plano) é garantida pelo mecanismo (armazenar no chaveiro do SO, não no JSON). Eye Key: a propriedade (o plaintext nunca toca disco) é garantida pelo mecanismo (HMAC antes de persistir, só a impressão digital vai para Postgres). Mesma forma — armazena-o-segredo-fora-de-texto-plano — domínios separados. O Honest Architect etiqueta chaveiro-não-texto-plano Production e o paralelo cross-domain Partial.

Como o campo de capacidades paraleliza Zod no boundary?

Cada entrada de modelo tem capabilities: { tools: true, images: false }. O Zed lê as capacidades no início e roteia conforme. Os esquemas Zod são parseados no boundary de rede e roteiam a requisição baseada no valor parseado. Ambos são esquemas parseados em runtime. O Honest Architect etiqueta as-capacidades-são-o-esquema Production e o paralelo cross-domain Partial.

Como os agentes externos paralelizam o-espaço-é-o-roteador?

Os Agentes Externos do Zed (Claude Code, Codex CLI, Gemini CLI) «rodam independentemente, têm suas próprias credenciais, acesso a modelos e faturamento — separados do seu provedor LLM configurado.» O editor roteia; o agente roda por conta própria. A topologia network→community→room de Everythink roteia antes de qualquer coisa responder; a entidade roteada roda por conta própria. Mesma forma — o-editor-roteia-o-agente-roda — domínios separados. O Honest Architect etiqueta a forma Production e o paralelo cross-domain Partial.

Everythink endossa OfoxAI ou Zed?

Não. Everythink é uma plataforma de forecasting, não um agregador de provedores LLM nem um editor de código. O guia Zed da OfoxAI é um percurso de configuração de fornecedor. O Honest Architect extrai as formas de mecanismo sem endossar o produto. As afirmações comerciais específicas da OfoxAI são Partial (autopromoção de fornecedor, não verificada independentemente). Nenhum resultado de token, wallet ou community-credit é prometido; esses são Roadmap, revisão Howey pendente.

Fontes

• OfoxAI, «Zed Editor: Configure Custom LLM Providers & External Agents», OfoxAI, publicado 2026-03-30, recuperado 2026-08-23, https://ofox.ai/blog/zed-editor-ai-configuration-guide-2026/

Se tua equipa está pronta para enviar o mecanismo em vez de afirmar a propriedade, construa teu network — as Sisters redigem, o Oracle normaliza, o protocolo roteia.