Passo 1 · Evidência operacional · Evidência operacional · Arquitetura e fonte da verdade PT-BREN
CLIProxyAPI 7.2.70 · kimi-k3 · Visual Course

Arquitetura e fonte da verdade

Antes de mudar qualquer rota, descubra qual arquivo realmente governa o serviço e confirme-o no endpoint vivo.

Leia primeiro (fonte primária)
CONFIG-MODEL-POLICY-EVIDENCE.md

Registro local redigido do gateway em execução e do exemplo kimi-k3.

Leia a versão simples, ou abra a camada técnica em qualquer seção.
1

A grande ideia

Antes de mudar qualquer rota, descubra qual arquivo realmente governa o serviço e confirme-o no endpoint vivo.

Pense como… O gateway é como a torre de controle: o espelho de configuração é o plano de voo, mas o painel de decolagens é o processo em 127.0.0.1:8317. A analogia falha porque software pode iniciar com outro arquivo..

Por baixo do capô

Compare a configuração ativa em /opt/homebrew/etc/cliproxyapi.conf com config.yaml e com GET /v1/models autenticado; os três têm papéis diferentes.

2

Em uma imagem

01 · arquivo ativoarquivo ativogovernaespelho byte a byteA configuração ativa fica em /opt/homebrew/etc/cliproxyapi.conf.
arquivo ativo — governa — A configuração ativa fica em /opt/homebrew/etc/cliproxyapi.conf.
3

No código

Este é o caminho local real e um comando seguro de leitura.

/opt/homebrew/etc/cliproxyapi.conf 
# trecho real, não editado
cmp /opt/homebrew/etc/cliproxyapi.conf /Users/acf/.cli-proxy-api/config.yaml
node -e "JSON.parse(require('fs').readFileSync('max-token-policy.json'))"

Acesse você mesmo

cmp /opt/homebrew/etc/cliproxyapi.conf /Users/acf/.cli-proxy-api/config.yaml node -e "JSON.parse(require('fs').readFileSync('max-token-policy.json'))"

4

Experimente

Use os controles para recuperar a evidência antes de ler a explicação.

02 · espelho byte a byteespelho byte a byteconfere comlistener 8317O endpoint autenticado retornou 13 IDs.
espelho byte a byte — confere com — O endpoint autenticado retornou 13 IDs.
03 · listener 8317listener 8317roteia paraprocesso HomebrewO hash live/mirror prova igualdade de arquivos.
listener 8317 — roteia para — O hash live/mirror prova igualdade de arquivos.
04 · processo Homebrewprocesso HomebrewexcluiGET /v1/modelsA configuração ativa fica em /opt/homebrew/etc/cliproxyapi.conf.
processo Homebrew — exclui — A configuração ativa fica em /opt/homebrew/etc/cliproxyapi.conf.
05 · GET /v1/modelsGET /v1/modelsprovaconjunto de 13 IDsO endpoint autenticado retornou 13 IDs.
GET /v1/models — prova — O endpoint autenticado retornou 13 IDs.
06 · conjunto de 13 IDsconjunto de 13 IDsdelimitapolítica JSONO hash live/mirror prova igualdade de arquivos.
conjunto de 13 IDs — delimita — O hash live/mirror prova igualdade de arquivos.
07 · política JSONpolítica JSONmapeia parahash de configuraçãoA configuração ativa fica em /opt/homebrew/etc/cliproxyapi.conf.
política JSON — mapeia para — A configuração ativa fica em /opt/homebrew/etc/cliproxyapi.conf.
08 · hash de configuraçãohash de configuraçãoreinicia comoreinício e PIDO endpoint autenticado retornou 13 IDs.
hash de configuração — reinicia como — O endpoint autenticado retornou 13 IDs.
09 · reinício e PIDreinício e PIDpreservaalias públicoO hash live/mirror prova igualdade de arquivos.
reinício e PID — preserva — O hash live/mirror prova igualdade de arquivos.
10 · alias públicoalias públicocompara comupstream observadoA configuração ativa fica em /opt/homebrew/etc/cliproxyapi.conf.
alias público — compara com — A configuração ativa fica em /opt/homebrew/etc/cliproxyapi.conf.
11 · upstream observadoupstream observadoretornasentinela semânticaO endpoint autenticado retornou 13 IDs.
upstream observado — retorna — O endpoint autenticado retornou 13 IDs.
12 · sentinela semânticasentinela semânticaconfirmalimite local versus externoO hash live/mirror prova igualdade de arquivos.
sentinela semântica — confirma — O hash live/mirror prova igualdade de arquivos.
13 · limite local versus externolimite local versus externoqualificaarquivo ativo registro de verificaçãoA configuração ativa fica em /opt/homebrew/etc/cliproxyapi.conf.
limite local versus externo — qualifica — A configuração ativa fica em /opt/homebrew/etc/cliproxyapi.conf.
14 · arquivo ativo registro de verificaçãoarquivo ativo registro de verificaçãoregistraarquivo ativoO endpoint autenticado retornou 13 IDs.
arquivo ativo registro de verificação — registra — O endpoint autenticado retornou 13 IDs.

Resumo em três quadros

1 Configuração declara intenção
2 Endpoint vivo declara comportamento
3 Evidência registra momento
Compare a configuração ativa em /opt/homebrew/etc/cliproxyapi.conf com config.yaml e com GET /v1/models autenticado; os três têm papéis diferentes.
Registre a observação, preserve a exceção e escolha a próxima prova estreita.
recupereOnde a configuração viveclique para virar
A configuração ativa fica em /opt/homebrew/etc/cliproxyapi.conf.
recupereQual rota o processo anunciaclique para virar
O endpoint autenticado retornou 13 IDs.
recupereQual artefato registra o instanteclique para virar
O hash live/mirror prova igualdade de arquivos.
Preveja antes de revelar

Qual observação é fonte de verdade para uma rota?

O endpoint vivo mostra o comportamento; o espelho e comentários apenas ajudam a explicar intenção.

Exemplo resolvido
1Abra /opt/homebrew/etc/cliproxyapi.conf.
2Confronte arquivo ativo com conjunto de 13 IDs.
3Registre sentinela semântica como próxima prova.
Revisão de recuperação
Qual observação é fonte de verdade para uma rota?

O endpoint vivo mostra o comportamento; o espelho e comentários apenas ajudam a explicar intenção.

Pergunte qual fronteira você provaria a seguir; a próxima lição reduz outro risco operacional.