Opencode-models-descoberta 2.0 Lançamento: Configurar Forma cheia, OpenCode v2 Formalmente correto

Em primeiro lugar, a conclusão é que:Opencode-models-descoberta 2.0.0, publicado em 19 de outubro de 2026, formalmente restaurar OpenCode v2 para a força principal e v1 para o adaptador compatível.Esta não é uma atualização de rotina -- a forma do arquivo de configuração é completamente alterada, e você segue o currículo antigo, e você provavelmente não pode ficar fora da linha.

Eu próprio pisei em três caudas. Está tudo lá em baixo. Primeiro de tudo, o que ele faz: é um plugin OpenCode que resolve um problema muito irritante -- você tem um monte de gateways compatíveis com OpenCode, serviços de modelos locais, API em trânsito, e cada novo modelo vai manualmente para a configuração para atingir o nome do modelo, comprimento do contexto, preço. Este plugin faz você caber apenas uma vez, e o resto dele puxa-se.

O que mudou desta vez?

O armazém foi construído em abril de 2026 por yuhp/opencode-modelos-descoberta, MIT, e agora 188 estrelas, 57 garfos. Não parece o topo da lista, mas são alguns projetos na ecologia OpenCode que são sérios sobre "descoberta de modelos".

2.0.0 Há apenas uma ação central:Aumentar o OpenCode v2 para integração estável primáriaNão sei. Tecnicamente, V2 usa estruturas de configuração originais para pulgins / provedores, API de ciclo de vida do provedor, armazenamento host hosting, voucher de integração, TUI nativo, manipulador RPC e ferramentas de agente.

Tradutor: O plugin antigo foi "Eu mudei sua configuração" e agora é "O Host me abre." O documento não precisa ser escrito no arquivo de configuração, o cache é dado ao gerenciador do host, e as capas do modelo podem ser acesas no painel TuI e não reiniciadas.

Nível de suporte para v1 e v2

Versão da Máquina	Nível de suporte	Configurar os Campos	Armazenagem e voucher
OpenCode v2	Firme / Principal	`plugins` e `providers`	Máquina `ctx.storage` / `ctx.integration`
OpenCode v1	Compatibilidade Legado	`plugin` e `provider`	v1 XDG Cache + Auth Bottom

v1 não é cortado, reparo seguro e retorno sério permanecerá no lugar. Mas as novas funções -- ciclo de vida, cache, TUI, RPC, sobreposição de modelos -- tudo vai apenas para v2, não automaticamente voltar para v1.

Dois ou nove formatos de metadados. Esse é o quadro geral.

v2.0.0 O documento oficial possui nove formatos de informação de modelo, que removem completamente a "ingestão de metadados" e "programação de descoberta". Este é um design inteligente: a lógica de movimento não precisa ser alterada para cada fabricante, com um adaptador de formato.

Formato	Perceber o quê?	Pedidos adicionais
`openrouter`	Comprimento de contexto, tampas de saída superior, modo (texto/imagem/udio), preços prompt/complemento e cache, marcas de chamada de ferramentas, slots de raciocínio (baixa/média/alta)	Nenhum pedido adicional
`aiproxy`	Exibição de AIProxi Inline Limiteds, Preço, esforço + Models.dev First Name	montagem
`bifrost`	Limites em linha, molde, token, variante de raciocínio	Nenhum pedido adicional
`litellm`	Metadados de modelo ricos, limitações de contexto, preços, capacidades	Pedido `/v1/model/info`
`lmstudio`	Configuração de instância carregada (LM Studio 0.4.0+ nativo) `/api/v1/models`Não tenho a certeza.	Uma vez.
`llama-swap`	Comprimento de contexto, estrutura, marcas de chamada de função	Nenhum pedido adicional
`models.dev`	Baixo diretório público, contexto comum e capacidades	Puxa! `models.json`
`omniroute`	(rápido/flexo)	Nenhum pedido adicional
`vllm`	A direito. `max_model_len`	Nenhum pedido adicional

Comparações de capacidade de nove formatos de metadados

Veja a última frase:Se você não corresponder modelInfoFormatEntão só há identificação do modelo, não há metadados.Não é bug, é design -- não adivinhe que tipo de serviço você está fazendo, evitando um monte de preços errados e comprimentos de contexto.

Eu não me encaixo neste campo em primeiro lugar, e eu olhei para uma lista de modelos com apenas nomes e pensei, "Porque nada mudou?" E olhei para eles meio dia.

E o perfil? Escrever

Este é o lugar mais fácil de rolar. v1 isso. plugin / provider / options Inválido tudo em v2, substituí-lo por um plural settingsNão sei.

OpenCode v1	OpenCode v2
`plugin`	`plugins`
`provider`	`providers`
`provider.<id>.npm`	`providers.<id>.package`
`provider.<id>.options`	`providers.<id>.settings`
`options.baseURL`	`settings.baseURL`
`options.apiKey`	`settings.apiKey`
`options.modelsDiscovery`	`settings.modelsDiscovery`

Uma configuração v2 que é executada diretamente é a seguinte:

{
  "$schema": "https://opencode.ai/config.json",
  "plugins": [
    "opencode-models-discovery@2.0.0"
  ],
  "providers": {
    "gateway": {
      "package": "@opencode/ai/providers/openai-compatible",
      "name": "My Gateway",
      "settings": {
        "baseURL": "https://gateway.example.com/v1",
        "apiKey": "{env:GATEWAY_API_KEY}",
        "modelsDiscovery": {
          "enabled": true,
          "modelInfoFormat": "models.dev",
          "smartModelName": true,
          "cache": {
            "enabled": true,
            "ttlSeconds": 86400
          }
        }
      }
    }
  }
}

Há vários pontos a observar:

modelsDiscovery.enabled Sim.VisívelEscrever trueNão sei. v2 não é mais padrão aberto, é mudança comportamental, não opcional.
package Serviço compatível com OpenAI Unificado @opencode/ai/providers/openai-compatibleNão sei.
Certificado {env:KEY} Deixe a máquina analisar, ou não escreva. apiKeyUsando diretamente OpenCode. /connect Entrada interactiva.
A tração padrão é /v1/models(relativo à origem da baseURL). Em contacto com o DeepSeek. /models Sim. modelsDiscovery Riga. "endpoint": "/models"Não sei.
v2 De modo algum. V1 auth.json e OPENCODE_AUTH_CONTENT Vai para o fundo. Vai ficar preso no 401.

IV. Capa do modelo e cache, mais funcional do que o esperado

O modelo v2 cobre a máquina armazenada overrides:<providerID>:<modelID> Espaço de nomes. Alterações podem ser feitas em campos como nomes de exibição, limites, habilidades, raciocínio, anexos, variantes, preços, metadados compatíveis.

Há muito a dizer.Campos como vouchers e autorizações seriam rejeitados e nunca seriam sustentáveis.A borda é claramente desenhada — a cobertura cobre os parâmetros de exibição e movimento, não a chave que você conecta.

Outro Organizador /models-discovery-console Visualize a edição, rotulando modelos super-cobertos na lista *Não sei. Altere a lista de modelos para recarregar e atualizar o TUI diretamente, sem reiniciar o serviço.Cache não será excluído.É o que muitas pessoas fazem de errado.

Fluxos de trabalho do plug-in: leitura de configurações, puxando modelos, patches, injeções

Os padrões de cache estão desligados, em seguida, os padrões de TTL 24 horas, com resposta de detecção original e eutrofização, go-host ctx.storageNão sei. Nota Arquivo de cache XDG para v1Não.Importa um v2, dois grupos de espaços nomeados são completamente isolados.

V. Comandos TUI e Ferramentas de Agente

O v2 oferece quatro pontos de acesso:

/models-discovery-refresh
/models-discovery-console
models_discovery_refresh
models_discovery_status

Os dois primeiros são comandos TUI, os dois últimos são para automação.models_discovery_status Passar rawCache: true É particularmente útil quando você pode cuspir os modelos originais no cache, juntamente com os resultados da eutrofização.

Console também suporta filtragem pelo provedor:/models-discovery-console status --provider <provider-id>Não sei. Quando você pega três ou cinco portais, economiza tempo.

Seis: Passe esta folha de cheque antes da promoção.

Atualização das primeiras quatro listas de verificação

Versão do OpenCode:v2 requer ≥ 2.0.26; pelo menos 1,18.29 permanece em v1.
Substituir todos os campos: complexo + settingsNão sei.npm Sim. packageNão sei.options Sim. settingsNão sei.
Abrir Visível: Escreva cada provedor para encontrar enabled: trueNão sei.
Verificação final: Não /v1/models É manual. endpointNão sei.

Os outros dois são fáceis de ignorar: construção local.package Preencher file:///绝对路径/distNão sei.Apontar para a pasta em vez de index.jsTemos de mudar o código. opencode service restart Deixe o serviço de back-office carregar a nova livraria. O terceiro é onde estou preso -- meio dia sem o código, porque o serviço nem sequer começou.

Vale a pena fingir?

Olha para a tua cena.

Apenas uma API oficialNão finjas. A lista de modelos é aqueles, escritos à mão por um ano, e os plugs são mais uma camada.
Temos a paragem. O portal do polímero.: Forte recomendação. Tais modelos de serviços são caracterizados por atendimento, nomes errados e mudanças de preços frequentes, e manutenção manual é puramente auto-abuso.
Local de execução do LM Studio / vLLM / lhama-swap: Carregar. Estes modelos de serviço são carregados sob demanda. O plug-in vai carregar-te. max_model_len É muito mais direto, muito mais rápido do que sua própria configuração.
A empresa construiu o portal.: Vale a pena uma avaliação. Nove formulários. bifrostNão sei.omniroute É para o portal. includeBy / excludeBy Suporta filtragem regular e equivalente de campos originais, que podem bloquear diretamente modelos que não devem ser vistos por usuários comuns.

2.0.0 No que diz respeito a si mesmo, as notas de lançamento referem-se a 41 arquivos de teste, 314 testes, além de testes de integração HTTP compatíveis com OpenAI local e validação de produto de tradução. Esta densidade de teste é grave para um projeto de 188 estrelas.

V1 funciona, mas coisas novas estão em v2. Se você quiser acompanhar a longo prazo, mova suas configurações mais cedo e não espere até o dia em que o adaptador V1 só tenha um patch de segurança.

Endereço do projeto:Gythub.com/yuhp/opencode-models-descovery, instalar diretamente npm i opencode-models-discovery@2.0.0 Ou escreva o nome do pacote na configuração acima. pluginsOpenCode resolverá a carga em si.