Le protocole OpenAI-compatible est le mécanisme, pas le nombre de modèles

Le guide de configuration de l'éditeur Zed d'OfoxAI parcourt l'ajout d'un fournisseur LLM personnalisé à Zed via le protocole OpenAI-compatible : une api_url, un tableau available_models, une clé stockée dans le trousseau du système. (OfoxAI, «Zed Editor: Configure Custom LLM Providers & External Agents», OfoxAI, publié 2026-03-30, récupéré 2026-08-23, https://ofox.ai/blog/zed-editor-ai-configuration-guide-2026/). Le Honest Architect lit le guide comme un exemple travaillé d'un mécanisme général : la propriété (flexibilité de fournisseur — échanger un backend de modèle contre un autre sans recompiler l'éditeur) est garantie par le mécanisme (une surface de protocole standardisée — l'API OpenAI-compatible, plus un schéma de configuration que l'éditeur parse au démarrage), non par l'affirmation «nous supportons 100+ modèles.» Un éditeur qui liste 100 modèles sans protocole standardisé est un catalogue fragile ; un éditeur qui expose un protocole et vous laisse ajouter des fournisseurs en éditant un tableau de config est une surface flexible. Le Honest Architect étiquette la forme le-protocole-est-le-mécanisme Production ✅ et les affirmations commerciales spécifiques d'OfoxAI (prix, noms de modèles, «0% de frais de plateforme») Partial ⚠️ (autopromotion du fournisseur, non vérifiée indépendamment par Everythink).

Le guide est un parcours de configuration, pas une enquête ni une preuve. Le Honest Architect extrait les formes de mécanisme que le parcours exhibe — le protocole OpenAI-compatible comme mécanisme de flexibilité de fournisseur, le trousseau du système comme mécanisme de souveraineté de clé, le routage d'agents externes comme la forme l-espace-est-le-routeur — et étiquette chaque forme Production ✅ où la forme est réelle et reproductible, Partial ⚠️ où la forme est une affirmation commerciale spécifique au fournisseur.

Conclusions clés

• Le protocole OpenAI-compatible est le mécanisme pour la flexibilité de fournisseur. Théorème 3 : la propriété (échanger un backend LLM contre un autre sans recompiler) est garantie par le mécanisme (une surface d'API standardisée + un schéma de config que l'éditeur parse au démarrage), non par l'affirmation «nous supportons 100+ modèles.» Le Honest Architect étiquette la forme le-protocole-est-le-mécanisme Production ✅.
• Le trousseau du système est le mécanisme pour la souveraineté de clé. Le guide : «L'API Key est stockée de façon sécurisée dans le trousseau du système (macOS Keychain / Linux Secret Service) et n'est jamais écrite en texte clair dans les fichiers de configuration.» La propriété (la clé n'est pas dans la config en texte clair) est garantie par le mécanisme (stocker dans le trousseau de l'OS, pas dans le JSON), non par l'affirmation «nous protégeons votre clé.» Le Honest Architect étiquette la forme trousseau-pas-texte-clair Production ✅.
• Le champ de capacités est le schéma parsé en runtime. Chaque entrée de modèle a capabilities: { tools: true, images: false }. Zed lit les capacités et route en conséquence — il ne tentera pas un appel de fonction sur un modèle dont tools est false. La propriété (pas d'appels d'outil échoués sur des modèles sans support d'outils) est garantie par le mécanisme (l'éditeur lit le flag de capacité avant le routage), non par l'affirmation «nous avons vérifié la compatibilité du modèle.» Le Honest Architect étiquette la forme les-capacités-sont-le-schéma Production ✅.
• Les agents externes sont la forme l-espace-est-le-routeur. Le Panneau d'Agent de Zed a Agent Zed (intégré, utilise le fournisseur LLM configuré) et Agents Externes (Claude Code, Codex CLI, Gemini CLI — «tournent indépendamment, ont leurs propres identifiants, accès aux modèles et facturation — séparés de votre fournisseur LLM configuré»). L'éditeur route vers n'importe quel agent ; l'agent tourne par lui-même. Le Honest Architect étiquette la forme l-éditeur-route-l-agent-tourne Production ✅.
• Parallèles cross-domain : Eye Key (HMAC avant persister = trousseau-pas-texte-clair dans un domaine différent), World Monitor (un cache par tuile de geohash = un protocole par surface de fournisseur), normalisation Oracle (normaliser à un seul endroit = le protocole OpenAI-compatible est l'unique point de normalisation), Zod à la frontière du runtime (le champ de capacités est parsé au démarrage, comme le schéma est parsé à la frontière réseau). Tous Partial ⚠️ : même forme, domaines séparés.
• Portée : civil/défensif. Un guide de configuration pour un éditeur de code n'est pas une arme. Pas de portée offensive. Aucun résultat de token, wallet ou community-credit n'est promis ; ceux-ci sont Roadmap 🔵, revue Howey en attente. Everythink est une plateforme de forecasting, pas un agrégateur de fournisseurs LLM ; les parallèles cross-domain sont des illustrations Partial ⚠️ des formes de mécanisme, pas des endossements d'OfoxAI comme produit.

Le protocole est le mécanisme

La config centrale du guide est un objet JSON : language_models.openai_compatible.OfoxAI avec une api_url et un tableau available_models. La clé openai_compatible est le mécanisme — il dit à Zed «parle le protocole OpenAI-compatible à ce endpoint, et voici les modèles qu'il sert.» La propriété (Zed peut parler à un nouveau fournisseur sans un changement de code) est garantie par le mécanisme (la surface du protocole OpenAI-compatible + le schéma de config), non par l'affirmation «Zed supporte OfoxAI.» Le Honest Architect étiquette la forme le-protocole-est-le-mécanisme Production ✅ parce que la forme est réelle et reproductible : tout éditeur qui expose un slot de config openai_compatible peut parler à tout endpoint qui parle le protocole OpenAI-compatible, et le fournisseur est ajouté en éditant du JSON, pas en recompilant.

La forme se généralise à travers le guide. Le guide offre deux méthodes : le GUI du Panneau d'Agent et le fichier settings.json. Les deux produisent le même objet de config. Le GUI est une commodité ; le JSON est la source de vérité. Le Honest Architect étiquette la forme le-JSON-est-la-source-de-vérité Production ✅ (le GUI édite le JSON, le JSON est ce que Zed lit au démarrage, le GUI est une vue sur le JSON, pas un état séparé). Le «Pro Tip» du guide — envoie l'URL des docs et le endpoint /v1/models à une IA et fais-lui auto-générer la config — est la forme le-protocole-est-le-mécanisme dans une boucle meta : le endpoint de liste de modèles fait partie du protocole OpenAI-compatible, donc une IA peut le lire et générer la config. Le Honest Architect étiquette la meta-forme Partial ⚠️ (flux de travail suggéré par le fournisseur, non vérifié indépendamment).

La section troubleshooting est une mesure des modes d'échec du mécanisme. «Vérifie que le format du settings.json est correct, puis redémarre Zed» — la config est parsée au démarrage ; un JSON malformé casse le parse. «Recherche language model: reset credentials, et re-saisis ta clé API» — la clé est dans le trousseau ; un reset la re-stocke. «Définis capabilities.tools sur false pour ce modèle. Si tu le laisses à true pour un modèle qui ne supporte pas l'appel de fonctions, les requêtes peuvent échouer» — le champ de capacités est le schéma parsé en runtime ; un mauvais flag produit une mauvaise route. «Confirme que l'URL de l'API est exactement https://api.ofox.ai/v1 — pas de barre oblique finale, pas de suffixe /v1 manquant» — la surface du protocole a une forme d'URL ; une mauvaise URL casse le protocole. Chaque étape est une mesure où le mécanisme casse : le parse JSON, le magasin de clés, la route de capacité, l'URL. Le Honest Architect étiquette la forme troubleshooting-comme-mesure Production ✅ (cartographie des modes d'échec réelle et reproductible).

Le trousseau est le mécanisme de souveraineté de clé

Le guide déclare : «L'API Key est stockée de façon sécurisée dans le trousseau du système (macOS Keychain / Linux Secret Service) et n'est jamais écrite en texte clair dans les fichiers de configuration.» La propriété (la clé n'est pas dans la config en texte clair) est garantie par le mécanisme (stocker dans le trousseau de l'OS, pas dans le JSON), non par l'affirmation «nous protégeons votre clé.» Le Honest Architect étiquette la forme trousseau-pas-texte-clair Production ✅. La forme est l'analogue dans le domaine de l'éditeur du Eye Key d'Everythink : la propriété (le plaintext du Eye Key ne touche jamais le disque) est garantie par le mécanisme (HMAC avant persister, seul l'empreinte va à Postgres), non par l'affirmation «nous protégeons votre clé.» Même forme, domaines séparés. Le Honest Architect étiquette la parallèle cross-domain Partial ⚠️.

La forme trousseau-pas-texte-clair se généralise : tout secret qui ne doit pas apparaître dans la config en texte clair (clés API, mots de passe de base de données, secrets client OAuth) est stocké dans un magasin de secrets hors-bande (trousseau de l'OS, gestionnaire de secrets, variable d'environnement injectée au runtime), et la config référence le magasin, pas le secret. L'affirmation «nous ne stockons pas de secrets en texte clair» est un non-mécanisme : elle ne produit aucune souveraineté. Le mécanisme (stocker dans le trousseau, référencer depuis la config) produit la souveraineté directement. Le Honest Architect étiquette la forme stocke-le-secret-hors-texte-clair Production ✅.

Le Honest Architect note la friction honnêtement. Le trousseau est spécifique à l'OS (macOS Keychain, Linux Secret Service ; le guide ne mentionne pas Windows Credential Manager). Le trousseau exige une session de bureau en cours (un serveur headless n'a pas de trousseau). Le trousseau est par-utilisateur (un fichier de config partagé ne peut pas partager la clé). Ce ne sont pas des défauts du mécanisme ; ce sont la portée du mécanisme. Le Honest Architect étiquette l'honnêteté-sur-la-portée Partial ⚠️ (le guide n'établit pas explicitement ces limites ; elles sont inférées de la forme du mécanisme).

Le champ de capacités est le schéma parsé en runtime

Chaque entrée de modèle dans le tableau available_models a un objet capabilities : { tools: true, images: false }. Zed lit les capacités au démarrage et route en conséquence — il ne tentera pas un appel de fonction sur un modèle dont tools est false, et il n'enverra pas d'image à un modèle dont images est false. La propriété (pas d'appels d'outil échoués sur des modèles sans support d'outils, pas d'envois d'image échoués sur des modèles sans support d'images) est garantie par le mécanisme (l'éditeur lit le flag de capacité avant le routage), non par l'affirmation «nous avons vérifié la compatibilité du modèle.» Le Honest Architect étiquette la forme les-capacités-sont-le-schéma Production ✅.

La forme est l'analogue dans le domaine de l'éditeur du Zod d'Everythink à la frontière du runtime : la propriété (un mauvais payload surgit comme un ApiError typé, jamais un crash) est garantie par le mécanisme (schémas Zod parsés à la frontière réseau), non par l'affirmation «notre API est typée.» Les types TypeScript sont effacés au runtime ; le champ capabilities est lu au démarrage. Les deux sont des schémas parsés au runtime qui routent la requête basé sur la valeur parsée. Le Honest Architect étiquette la parallèle cross-domain Partial ⚠️ (même forme — le schéma parsé au runtime est le mécanisme — domaines séparés — routage de capacité de l'éditeur vs sécurité de type à la frontière réseau).

Le troubleshooting du guide confirme le mécanisme : «Définis capabilities.tools sur false pour ce modèle. Si tu le laisses à true pour un modèle qui ne supporte pas l'appel de fonctions, les requêtes peuvent échouer.» Un mauvais flag de capacité produit une mauvaise route. Le mécanisme ne corrige pas silencieusement un mauvais flag ; il route basé sur le flag et la route échoue si le flag ment. Le Honest Architect étiquette la forme le-mécanisme-route-sur-le-flag-pas-sur-la-vérité Production ✅ (le routeur fait confiance à la config, la config doit être honnête).

Les agents externes sont la forme l-espace-est-le-routeur

Le Panneau d'Agent de Zed a deux modes : Agent Zed (intégré, utilise le fournisseur LLM configuré) et Agents Externes (Claude Code, Codex CLI, Gemini CLI — «tournent indépendamment, ont leurs propres identifiants, accès aux modèles et facturation — séparés de votre fournisseur LLM configuré»). L'éditeur route vers n'importe quel agent que l'utilisateur sélectionne ; l'agent tourne par lui-même, avec ses propres identifiants, son propre accès aux modèles, sa propre facturation. Le Honest Architect étiquette la forme l-éditeur-route-l-agent-tourne Production ✅. La forme est l'analogue dans le domaine de l'éditeur du l-espace-est-le-routeur d'Everythink : la topologie network→community→room route avant que quoi que ce soit réponde, et l'entité routée tourne par elle-même. Le Honest Architect étiquette la parallèle cross-domain Partial ⚠️.

La forme d'agent externe se généralise : l'éditeur est un routeur, pas un runtime. L'Agent Zed intégré utilise le fournisseur LLM configuré ; les agents externes utilisent les leurs. L'éditeur n'absorbe pas les identifiants, l'accès aux modèles ou la facturation de l'agent externe — il lance l'agent et laisse l'agent tourner. La propriété (l'utilisateur peut utiliser n'importe quel agent sans que l'éditeur absorbe son auth) est garantie par le mécanisme (l'éditeur route, l'agent tourne indépendamment), non par l'affirmation «nous supportons de nombreux agents.» Le Honest Architect étiquette la forme l-éditeur-route-n'absorbe-pas Production ✅.

Ce qu'un Honest Architect lit dans un guide de config de fournisseur

Le guide Zed d'OfoxAI est un parcours de configuration de fournisseur. Le Honest Architect extrait les formes de mécanisme (le protocole OpenAI-compatible comme mécanisme de flexibilité de fournisseur ; le trousseau du système comme mécanisme de souveraineté de clé ; le champ de capacités comme schéma parsé en runtime ; les agents externes comme la forme l-espace-est-le-routeur) sans endosser OfoxAI comme produit. Les formes de mécanisme sont Production ✅ : réelles, implémentables, vérifiées par la propre description du guide du schéma de config et les modes d'échec du troubleshooting. Les affirmations commerciales spécifiques d'OfoxAI — «100+ modèles LLM mainstream», «0% de frais de plateforme», «tarifs officiels de DeepSeek, sans majoration», les noms et prix spécifiques de modèles — sont Partial ⚠️ (autopromotion du fournisseur, non vérifiée indépendamment par Everythink). Le Honest Architect ne recommande pas OfoxAI, DeepSeek, ni aucun modèle spécifique. Everythink est une plateforme de forecasting, pas un agrégateur de fournisseurs LLM ni un éditeur de code. Les parallèles cross-domain sont des illustrations Partial ⚠️ des formes de mécanisme, pas des endossements du produit que le guide vend. La portée est civile/défensive : un guide de configuration pour un éditeur de code n'est pas une arme. Aucun résultat de token, wallet ou community-credit n'est promis ; ceux-ci sont Roadmap 🔵, revue Howey en attente.

Questions fréquentes

Le protocole OpenAI-compatible est-il l'affirmation ou le mécanisme ?

Le mécanisme. Théorème 3 : la propriété (échanger un backend LLM contre un autre sans recompiler) est garantie par le mécanisme (une surface d'API standardisée + un schéma de config que l'éditeur parse au démarrage), non par l'affirmation «nous supportons 100+ modèles.» Le Honest Architect étiquette la forme le-protocole-est-le-mécanisme Production.

Comment le trousseau parallélise-t-il Eye Key ?

Le guide : «L'API Key est stockée de façon sécurisée dans le trousseau du système et n'est jamais écrite en texte clair dans les fichiers de configuration.» La propriété (la clé n'est pas dans la config en texte clair) est garantie par le mécanisme (stocker dans le trousseau de l'OS, pas dans le JSON). Eye Key : la propriété (le plaintext ne touche jamais le disque) est garantie par le mécanisme (HMAC avant persister, seul l'empreinte va à Postgres). Même forme — stocke-le-secret-hors-texte-clair — domaines séparés. Le Honest Architect étiquette trousseau-pas-texte-clair Production et la parallèle cross-domain Partial.

Comment le champ de capacités parallélise-t-il Zod à la frontière ?

Chaque entrée de modèle a capabilities: { tools: true, images: false }. Zed lit les capacités au démarrage et route en conséquence. Les schémas Zod sont parsés à la frontière réseau et routent la requête basé sur la valeur parsée. Les deux sont des schémas parsés au runtime. Le Honest Architect étiquette les-capacités-sont-le-schéma Production et la parallèle cross-domain Partial.

Comment les agents externes parallélisent-ils l-espace-est-le-routeur ?

Les Agents Externes de Zed (Claude Code, Codex CLI, Gemini CLI) «tournent indépendamment, ont leurs propres identifiants, accès aux modèles et facturation — séparés de votre fournisseur LLM configuré.» L'éditeur route ; l'agent tourne par lui-même. La topologie network→community→room d'Everythink route avant que quoi que ce soit réponde ; l'entité routée tourne par elle-même. Même forme — l-éditeur-route-l-agent-tourne — domaines séparés. Le Honest Architect étiquette la forme Production et la parallèle cross-domain Partial.

Everythink endosse-t-il OfoxAI ou Zed ?

Non. Everythink est une plateforme de forecasting, pas un agrégateur de fournisseurs LLM ni un éditeur de code. Le guide Zed d'OfoxAI est un parcours de configuration de fournisseur. Le Honest Architect extrait les formes de mécanisme sans endosser le produit. Les affirmations commerciales spécifiques d'OfoxAI sont Partial (autopromotion du fournisseur, non vérifiée indépendamment). Aucun résultat de token, wallet ou community-credit n'est promis ; ceux-ci sont Roadmap, revue Howey en attente.

Sources

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

Si ton équipe est prête à shipper le mécanisme au lieu d'affirmer la propriété, construisez votre network — les Sisters rédigent, l'Oracle normalise, le protocole route.