ZoaK

ZoaK

Zepp OS Agent Knowledge Base

Uma camada ciente de compatibilidade entre as fontes oficiais do Zepp OS e os agentes de IA que escrevem código para Zepp OS.

Calculado a partir de data/ a cada render, nunca digitado à mão.

A pergunta que ela existe para responder

Isto não é um espelho da documentação. A documentação oficial existe, mas não está no formato que um agente consegue consumir de forma confiável quando a pergunta é “posso chamar esta API, neste runtime, neste API_LEVEL?” Este projeto extrai essas fontes para uma camada estruturada em que essa pergunta tem resposta verificável.

A falha específica que ela evita é um agente produzir código Zepp OS plausível que não consegue justificar. Todas as avaliações feitas até aqui terminaram a tarefa e nenhuma ficou bloqueada — elas falharam em comprovar, entregando código que a base não conseguia sustentar com uma citação. É esse o problema, não o desconhecimento.

O que as fontes não carregam

Como funciona

  1. fetchclonar ou atualizar os repositórios oficiais em um cache local
  2. parsedez frentes, cada uma lendo um formato de fonte
  3. enrichfundir as frentes em um registro por símbolo
  4. storegravar o JSON fonte de verdade, um arquivo por módulo
  5. rendergerar o Markdown que o agente lê

E três coisas que consomem isso:

O JSON em data/ é a fonte de verdade; a árvore Markdown é derivada e reproduzível. O CI re-renderiza e falha em qualquer diferença, então uma página editada à mão não sobrevive.

Como usar

Tudo roda localmente. Clone o repositório e instale — não há nada para sincronizar antes, porque data/ e as páginas renderizadas estão commitadas:

git clone https://github.com/FelipeRicardo5/zeppos-agent-knowledge-base.git
cd zeppos-agent-knowledge-base
npm install

npm run sync só é necessário para mover a base contra o upstream; um clone novo já é legível. Ele clona os repositórios oficiais em .cache/ e reescreve data/.

Três formas de entrar, na ordem de quanto quem consome precisa ler.

  1. Consultar por nome

    npm run mcp

    Dezesseis tools somente-leitura sobre stdio. Chame get_freshness primeiro: um relatório que não consegue nomear a versão que leu não pode ser comparado com outro. Nada para autenticar, e nenhuma requisição sai da máquina.

  2. Pontuar um app contra a base

    npm run check -- caminho/para/um/app

    Confere um diretório sob quatro regras — runtime, permissão, API_LEVEL e manifest — e devolve um veredito por linha, em vez de um passou ou não passou.

  3. Ler o Markdown renderizado

    api/  compatibility/  runtimes/  patterns/  …

    Está commitado, então clonar basta. É isto que a Agent Skill em skills/zepp-os/SKILL.md lê: ela não carrega documentação própria, só como usar esta base.

O que o check responde

StatusSignificado
VOUCHEDEsta base consegue apontar o registro que sustenta aquilo
UNVERIFIABLENão coberto aqui. Nunca evidência de que o símbolo não existe
VIOLATIONEsta base contradiz aquilo

Ausência de violação não é aprovação. Todo relatório traz uma lista notChecked, porque um checador que listasse só o que encontrou ensinaria o leitor a ler silêncio como aprovação — exatamente a leitura que este projeto existe para evitar.

O que tem dentro

Gerado a partir de data/ a cada render. O que cada número significa é a parte que vale ler; o tamanho de hoje está na tabela.

O quêQuantidade
Símbolos513
Módulos50
OFFICIAL / OBSERVED496 / 17
Símbolos que declaram API_LEVEL mínimo353
Símbolos com descrição435
Símbolos com assinatura de chamada234
Símbolos com tabela de propriedades, e propriedades nelas184, 1300
Tipos declarados sob um heading sem coluna de nome142, 232
Conjuntos de valores, e membros neles55, 388
Membros de instância257
Por runtimedevice-app 375, watchface 105, settings 21, side-service 20, workout-extension 12
Dispositivos, dos quais rodam Zepp OS com nível declarado41, 29
Padrões de boas práticas11
Apps de exemplo lidos como código33

O que mantém a base honesta

Ver o código no GitHub