| |

Nem vento nem chuva, entre neblina e céu claro: de abandonar a escola e ir trabalhar na fábrica a chegar ao topo dos assuntos em alta no GitHub; criou o Archify, que transforma uma frase em um diagrama de arquitetura interativo (comece em 5 passos)

Ele usa o nome «也无风雨也雾晴» e seu nome verdadeiro é Tu Shaokun. Fez um curso técnico, serviu no exército por dois anos e depois ingressou na Universidade de Correios e Telecomunicações de Chongqing por meio de um programa de complementação da graduação. Durante uma busca por emprego, foi barrado na etapa de verificação de antecedentes por causa da escolaridade. Mais tarde, escolheu provar seu valor com projetos de código aberto. Ele criou o Archify, que transforma uma frase em um diagrama de arquitetura interativo.

O Archify é gratuito; o que custa é o modelo por trás da ferramenta. Para gerar diagramas com mais consistência, use o claude-opus-5-5 da APIYI.

Informações básicas deste tutorial:

  • Objetivo: instalar o Archify no Claude Code, criar um diagrama interativo do fluxo de requisições de um site a partir de uma frase em chinês e depois editar o diagrama com outro comando.
  • Tempo estimado: de 20 a 30 minutos, sem contar o cadastro e a recarga de créditos.
  • Pré-requisitos: saber usar o Claude Code ou ferramentas como o Cursor; ter o Node.js instalado no computador (necessário para usar o npx), um navegador e uma conta na APIYI.
  • Dificuldade: iniciante. Não é preciso escrever código nem editar arquivos de configuração manualmente.

archify-tu-shaokun-interactive-architecture-diagram-claude-opus-5-5-pt-pt-image-0


Também há dias sem vento nem chuva, e dias de neblina e céu limpo: pontos principais sobre ele e o Archify

| Ponto | Descrição |
| Autor | Tu Shaokun, conhecido online como 也无风雨也雾晴; cursou uma faculdade técnica, serviu no Exército e depois concluiu a graduação |
| O que é o Archify | Um Agent Skill de código aberto e gratuito, sob licença MIT |
| Onde se gasta dinheiro | No modelo usado pelo Agent que executa o Skill |
| Modelo recomendado | claude-opus-5-5 na APIYI |
| Resultado | Um HTML independente, que é só abrir no navegador para usar |

Quem é Tu Shaokun: da faculdade técnica e do serviço militar a provar seu valor com código aberto

O relato abaixo vem principalmente de uma publicação longa que ele próprio fez no X em 2026-07-15. Depois do vestibular de 2018, ele entrou em uma faculdade técnica para estudar Tecnologia de Aplicações Computacionais. Ele conta que passou o primeiro ano sem muito rumo e, depois, foi servir no Exército, onde ficou por dois anos. Quando chegou, pesava cerca de 53 kg e tinha dificuldade para fazer muitos dos exercícios. Mais tarde, foi designado para a área de comunicações e representou sua unidade em uma competição de comunicações do grupo do Exército, na qual ficou em primeiro lugar.

Depois de dar baixa, voltou à faculdade para concluir a graduação. Dos mais de 70 candidatos daquela turma, só seis seriam selecionados. Ele ficou em primeiro lugar entre os candidatos dispensados do serviço militar e entrou na Universidade de Correios e Telecomunicações de Chongqing para estudar Engenharia de Software. Ao se formar, era três anos mais velho que seus colegas da mesma idade. Depois de estudar front-end por pouco mais de um mês com cursos online, saiu em busca de um estágio. Mais tarde, fez entrevistas na Feishu, do ByteDance, e passou pelas duas etapas, mas foi barrado na verificação de antecedentes por ter concluído a graduação após um curso técnico. Na seleção de outono para a empresa chinesa Dongchedi, em Chongqing, ele mencionou espontaneamente que havia concluído a graduação depois do curso técnico durante a entrevista com o RH; depois disso, não teve mais notícias. Mais tarde, o entrevistador da primeira etapa mandou uma mensagem: “Desculpe”. Naquela noite, ele saiu para correr cinco quilômetros.

Ele não atribuiu todos os fracassos à formação acadêmica. Já escreveu que não conseguiu resolver a questão na quarta etapa da entrevista na Yuanfudao e que era normal ter sido reprovado. Depois, durante um estágio na Universidade Westlake, em Hangzhou, o RH voltou a perguntar sobre sua formação. Ele respondeu: “Não é uma vergonha ter vindo de uma origem humilde”. Dessa vez, passou. Na entrevista para a Manus, alguém comentou que quem não tem vantagem acadêmica pode provar seu valor com trabalhos ou projetos de código aberto. Na época, ele já estava pensando nisso. Nas palavras dele: no começo, o objetivo de criar projetos de código aberto não era tão nobre; ele só queria ter algo a mais no currículo que pudesse provar sua capacidade. O repositório do Archify foi criado em 2026-04-15.

Uma entrevista da QbitAI, publicada em setembro de 2026, também conta que ele abandonou os estudos aos 16 anos, aprendeu mecânica automotiva e trabalhou em uma fábrica. Essa parte é um relato da entrevista e não aparece na publicação longa que ele próprio fez. Ele também publicou no Bilibili um vídeo chamado “De abandonar os estudos e trabalhar em fábrica ao topo dos assuntos em alta no GitHub: a IA mudou minha vida!”, em 2026-09-14. O endereço é: https://www.bilibili.com/video/BV1cGe56cEHo/. Conferimos apenas o título, a data, o autor do vídeo e as tags; não assistimos ao vídeo inteiro. A expressão “ao topo do GitHub”, no título, se refere a uma captura de tela que ele publicou no X em 2026-09-01: o Archify estava em primeiro lugar no ranking semanal do GitHub Trending entre todas as linguagens. Aquela era a posição na data da captura, não significa que o projeto continue em primeiro lugar hoje.

Abaixo está a página do vídeo. Ela mostra 123 mil visualizações e mais de 1.700 curtidas. Com mais de 100 mil visualizações, o vídeo que ele mesmo publicou já fez bastante sucesso.

Página do vídeo de 也无风雨也雾晴 no Bilibili, com 123 mil visualizações

Da trajetória dele, queremos destacar apenas três coisas:

  • Não dá para mudar a formação acadêmica. O que ele fez depois foi transformar sua capacidade em trabalhos que qualquer pessoa pode abrir e usar.
  • Ele não atribuiu todos os fracassos à formação. Quando não conseguiu resolver uma questão, reconheceu que não conseguiu.
  • Popularidade não significa que as pessoas realmente estejam usando algo. O que importa para ele é saber se alguém usa o que criou.

O que é o Archify?

Segundo o README oficial em chinês, o Archify é um Agent Skill de código aberto e gratuito. Você conta uma ideia, uma dúvida ou um plano a um AI Agent, e ele gera um HTML interativo que dá para clicar e compartilhar. Não é preciso ter um repositório de código. Se você pedir ao Agent para ler um repositório, ele também consegue criar um diagrama de arquitetura com referências ao código-fonte. Os nós podem receber a marca SRC e ficar associados a um commit específico. Além dos diagramas, há outro tipo de resultado chamado explainer: uma página que apresenta primeiro a conclusão e depois divide o conteúdo em painéis organizados por perguntas, que podem incluir tabelas, etapas e diagramas.

O projeto também deixa claro o que não faz. Ele não é um editor de diagramas genérico nem um tema para Mermaid. Análise automática de Mermaid, layout automático genérico, serviço de hospedagem para compartilhamento e editor WYSIWYG não fazem parte do escopo atual. O Archify não vende modelos nem emite chaves API; o projeto informa que os planos pagos de terceiros não representam o Archify. A versão estável atual é a v3.2.0. O selo de instalações do skills.sh indica mais de 130 mil, mas esse número é informado pelo próprio projeto e não foi verificado por nós.

A equipe do projeto também criou uma imagem promocional. No centro, aparece o repositório tt-a1i/archify, com um selo que diz que ele ficou em primeiro lugar no GitHub Trending naquela semana. Logo abaixo, lê-se: “Uma frase para gerar um diagrama de arquitetura interativo”. A posição e o número de estrelas impressos na imagem foram informados pelo próprio material promocional. Portanto, são apenas uma referência da época e não indicam que o projeto continue em primeiro lugar.

Imagem promocional do Archify, com o cartão do repositório indicando o primeiro lugar no GitHub Trending naquela semana

Em termos simples, o processo funciona assim: primeiro, o Agent escreve um JSON em um formato fixo e depois o valida. Só quando a validação é aprovada ele entrega o HTML. Ao editar um diagrama, o Agent modifica apenas as partes necessárias, sem refazer tudo do zero. As conexões e os caminhos mostrados no diagrama vêm das relações descritas nele; as interações não inventam uma topologia. Portanto, conseguir clicar nos elementos do diagrama não significa que o sistema funcione assim na prática.

archify-tu-shaokun-interactive-architecture-diagram-claude-opus-5-5-pt-pt-image-1

Como escolher entre os dez tipos de diagrama do Archify

Tipo de diagrama Para que serve Exemplo
Architecture Componentes, serviços, armazenamento e limites do sistema Quais serviços compõem nosso site
Workflow Fluxos, aprovações e chamadas de ferramentas Como funciona o reembolso, do envio ao pagamento
Sequence Ordem das etapas de uma chamada Quem vem antes no login: front-end, back-end ou banco de dados
Data Flow Como os dados circulam Como os dados de um pedido vão da compra até o relatório
Lifecycle Estados, novas tentativas e estados finais O ciclo de uma tarefa, da fila até o sucesso ou a falha
ERD Tabelas e campos Relação entre as tabelas de usuários e pedidos
Class Classes e interfaces Quais classes existem no módulo de pagamento
Tree Hierarquias com um único elemento pai Estrutura dos departamentos da empresa
Timeline Linha do tempo Marcos de um projeto ao longo de três meses
Waterfall Duração de cada etapa de uma solicitação Em que etapa uma API está demorando

Os cinco últimos tipos foram adicionados a partir da versão 3.1. Vale observar que alguns exemplos oficiais de Timeline e Waterfall usam dados ilustrativos. Os tempos mostrados no diagrama só devem ser tratados como reais quando vêm de logs ou de rastreamento distribuído.

archify-tu-shaokun-interactive-architecture-diagram-claude-opus-5-5-pt-pt-image-2

Como usar o Archify em cinco etapas

  1. Configure um modelo para o Agent. Neste artigo, conectamos o claude-opus-5-5 da APIYI ao Claude Code.
  2. Instale o Archify com um único comando.
  3. Explique em linguagem simples o que você quer desenhar.
  4. Abra no navegador o HTML gerado.
  5. Continue conversando para ajustar o diagrama. Quando estiver satisfeito, exporte como imagem ou PDF.

Guia rápido do Archify: conecte o claude-opus-5-5 e desenhe seu primeiro diagrama de arquitetura interativo

Passo 1: prepare um token da APIYI para o Archify

Antes de começar, vale entender onde os tokens são usados. O repositório do Archify não cobra pelo uso de modelos. Quem consome tokens é o agente que executa o Skill: ler o repositório, escrever JSON e corrigir erros de validação — tudo isso usa o modelo configurado para o agente. Portanto, você precisa de créditos para o modelo, não de uma assinatura do Archify.

Acesse o painel da APIYI, crie um token, selecione claude-opus-5-5 entre os modelos disponíveis e copie o token. Se ainda não comprou créditos e quer testar o Opus primeiro, confira as instruções de teste na seção de leituras complementares, no fim do artigo.

Ao concluir, você deverá ver: um novo token na lista, claude-opus-5-5 entre os modelos disponíveis e o token copiado.

Passo 2: conecte o token ao Claude Code (siga o tutorial do magpie)

Não vamos repetir aqui as etapas para conectar a chave. Siga este tutorial ilustrado já publicado: Tutorial passo a passo: use uma única chave com todos os agentes e conecte-se ao gateway de API com o magpie, um projeto de código aberto (exemplos com Claude Code, Codex, Pi e Hermes).

Durante a configuração, lembre-se de dois valores. Primeiro: o endereço compatível com Anthropic usado pelo Claude Code é https://api.apiyi.com, sem /v1 no final. Segundo: o nome do modelo deve ser claude-opus-5-5, exatamente assim. Se estiver diferente, você receberá o erro “model not found”. Ferramentas como o Codex usam o endereço compatível com OpenAI https://api.apiyi.com/v1, mas não vamos abordar esse fluxo neste artigo. Se você usa o Cursor com a assinatura própria da ferramenta, talvez nem precise de um token da APIYI. O Archify não exige o uso da APIYI.

Depois de concluir o tutorial, volte aqui para instalar o Archify.

Ao concluir, você deverá ver: ao perguntar “Olá” no Claude Code, ele responde normalmente, sem erros 401 nem “model not found”.

Passo 3: instale o Skill do Archify

Abra o terminal e execute este comando oficial:

npx skills add tt-a1i/archify -g

A opção -g indica uma instalação global, que permite usar o Archify em qualquer diretório de projeto. Os agentes compatíveis com o fluxo principal são Cursor, Claude Code, Codex CLI e OpenCode. Neste artigo, vamos usar apenas o Claude Code. Depois da instalação, feche a sessão atual do Claude Code e abra uma nova.

Ao concluir, você deverá ver: o comando termina sem erros em vermelho. Na nova sessão, pergunte “Você consegue usar o Archify?” e o Claude Code deverá reconhecer o Skill.

Passo 4: desenhe o fluxo de requisições de um site com uma frase

Envie este exemplo oficial ao Claude Code, sem alterações:

Use o Archify para desenhar o fluxo de requisições de um site: o navegador faz uma requisição à API, que primeiro consulta o Redis. Se não encontrar o dado no cache, consulta o PostgreSQL e atualiza o cache.

Em seguida, o Claude Code vai escrever o JSON, validá-lo e, por fim, gerar um arquivo HTML. Se ele apenas colar o código na conversa, sem salvar um arquivo, peça: “Salve o HTML no diretório atual”. Encontre o arquivo .html e abra-o com um clique duplo ou arrastando-o para o navegador.

Ao concluir, você deverá ver: um diagrama no navegador com nós para o navegador, a API, o Redis e o PostgreSQL, conectados por linhas. Ao clicar em um nó, você poderá ver suas relações com os nós anteriores e seguintes.

Passo 5: altere o diagrama de arquitetura do Archify com uma frase e exporte

Não precisa descrever o diagrama inteiro de novo. Basta pedir:

Adicione autenticação, destaque o caminho em que o cache não encontra o dado e mude para um tema claro.

O Archify altera apenas as partes necessárias, sem refazer o diagrama do zero. Depois, você pode escolher entre quatro estilos, com temas claros e escuros. Também pode exportar como imagem PNG, WebP ou JPG em formato longo, ou imprimir em PDF. Você pode enviar o próprio HTML a um colega; ele também poderá interagir com o diagrama ao abri-lo. Se o diagrama tiver links para sites externos ou mapas, será preciso estar conectado à internet para acessá-los.

Ao concluir, você deverá ver: o mesmo diagrama, agora com nós de autenticação, o caminho em que o cache não encontra o dado destacado e um tema claro.

🎯 Dica técnica: na primeira vez, comece com o exemplo oficial para confirmar que tudo está funcionando. Depois, experimente descrever o seu próprio caso de uso. Assim, se algo der errado, fica mais fácil saber se o problema está na configuração do ambiente ou se a descrição ficou complexa demais.

Quanto custa o modelo usado pelo Archify?

Os valores abaixo foram consultados na API pública de preços da APIYI no dia em que este artigo foi escrito. A conversão considera que o multiplicador 1 equivale a US$ 2 por milhão de tokens. Os preços exibidos no painel da APIYI no dia do uso são os que valem; o preço efetivo pode variar de acordo com o grupo.

Modelo Entrada Saída Leitura do cache Gravação no cache Quando usar
claude-opus-5-5 US$ 4 US$ 20 US$ 0,20 US$ 5 Diagramas complexos, leitura de repositórios e HTML extenso
claude-sonnet-5-5 US$ 2 US$ 10 US$ 0,10 US$ 2,50 Diagramas simples e alterações pequenas

Todos os valores são por milhão de tokens. Também existe o claude-opus-5-5-thinking, com o mesmo multiplicador. Não fizemos testes para medir o custo de geração de um diagrama, então não apresentamos um valor. O consumo de tokens em cada geração depende do tamanho do diagrama, da necessidade de ler o repositório e de quantas rodadas de correção são necessárias após falhas na validação.

Quando não é preciso usar o Opus 5.5

A documentação oficial não diz que o Claude Opus 5.5 é obrigatório. Recomendamos o Opus por conta própria: o Archify precisa escrever JSON estruturado e HTML extenso e, às vezes, ler o repositório inteiro. Um modelo de programação de ponta tende a errar menos a formatação. Nas situações abaixo, um modelo mais barato, como o claude-sonnet-5-5, geralmente dá conta:

  • Você só precisa de um diagrama pequeno, com três ou quatro caixas, relações simples e sem necessidade de ler um repositório.
  • O JSON já está pronto e você só quer mudar o estilo e exportar de novo.

Se o diagrama ficar maior, for necessário ler o repositório ou as validações falharem repetidamente, volte para o Opus. As leituras complementares incluem um artigo específico sobre como combinar os dois modelos.

Tabela de solução de problemas do Archify

Problema Causa comum O que fazer
Depois da instalação, o agente diz que não reconhece o Archify Você ainda está na sessão antiga; não usou -g; o Node.js não foi instalado corretamente Reinicie o Claude Code; confirme que instalou novamente com -g; execute node -v no terminal para verificar se uma versão é exibida
O HTML não abre ou aparece em branco O código foi colado, mas não salvo em um arquivo; o arquivo está incompleto; os links externos precisam de conexão Peça ao agente para salvar o HTML em um arquivo; abra-o diretamente no navegador; verifique a conexão
Aparece um erro de validação A descrição é complexa demais ou há contradições entre as relações A ferramenta fornece instruções para localizar o problema. Faça até duas rodadas de correções focadas; se ainda não funcionar, divida o diagrama em dois ou torne a descrição mais específica
model not found O nome do modelo está incorreto; /v1 foi acrescentado indevidamente ao endereço Corrija o nome para claude-opus-5-5; remova /v1 do final do endereço Anthropic
Erro 401 ou aviso de créditos insuficientes O token foi copiado incorretamente, está desativado ou os créditos acabaram Confira o status do token e o saldo no painel da APIYI; copie o token novamente e atualize a configuração seguindo o tutorial do magpie

Perguntas frequentes sobre o Archify

P1: O Archify é pago?

O Archify é gratuito e tem código aberto sob a licença MIT. O custo vem dos tokens do modelo usado pelo agente. Você paga de acordo com o modelo configurado no Claude Code.

P2: É obrigatório usar o Opus ou a APIYI?

Não. A documentação oficial não exige um modelo específico. Recomendamos o claude-opus-5-5, mas o Sonnet também pode funcionar para diagramas pequenos. A versão oficial do Archify também não tem integração com a APIYI. Se você usa a assinatura própria do Cursor, talvez nem precise de um token da APIYI.

P3: Posso usar o Archify sem um repositório de código?

Sim. Basta descrever o que você quer em chinês. Se tiver um repositório, você pode pedir ao agente que o leia antes de criar um diagrama com referências ao código-fonte. Nesse caso, os nós terão a indicação SRC. Esse fluxo consome mais tokens.

P4: Posso enviar o HTML para outra pessoa e ela ainda poderá clicar no diagrama?

Sim. O HTML é um arquivo independente, e os recursos interativos ficam dentro dele. Apenas os links para sites externos e mapas precisam de conexão com a internet para abrir.

P5: Se consigo clicar nos elementos do diagrama, isso significa que o sistema em produção realmente funciona assim?

Não. Os caminhos exibidos são baseados nas relações que você descreveu. O Archify não verifica se eles correspondem ao sistema em produção. Em diagramas como os de waterfall, os tempos só são confiáveis quando vêm de logs ou de rastreamento distribuído.


Resumo: o que Archify nos deixa, entre tempestades e neblina

Tu Shaokun não podia mudar sua formação acadêmica, então transformou suas habilidades em uma ferramenta que qualquer pessoa pode instalar e usar. Veja os principais pontos práticos:

  • O que é o Archify: um Agent Skill gratuito e de código aberto que gera gráficos HTML interativos a partir de uma frase.
  • Onde o dinheiro é gasto: no modelo por trás do Agent — não é preciso comprar uma assinatura do Archify.
  • Como configurar a chave: crie um token na APIYI, selecione o modelo claude-opus-5-5 e siga o tutorial do Magpie para configurá-lo no Claude Code. Não inclua /v1 no endereço.
  • Como instalar: basta executar este comando: npx skills add tt-a1i/archify -g.
  • Como usar: descreva o gráfico em uma frase, depois peça os ajustes que quiser e exporte o resultado como PNG ou PDF.
  • Dica para economizar: use o Sonnet para gráficos simples e para exportá-los novamente; deixe o Opus para os gráficos mais complexos.

Se quiser começar agora, crie um token no console da APIYI, em apiyi.com, e use o exemplo oficial para gerar seu primeiro gráfico.

As informações deste artigo vêm de diferentes fontes, com níveis de confiabilidade variados:

Informação Fonte Observação
Funcionalidades, versão, dez tipos de gráfico e mais de 130 mil instalações README oficial Informações declaradas pelo próprio projeto
Primeiro lugar no ranking semanal Captura de tela publicada pelo autor no X em 2026-09-01 Registro daquele momento, não uma classificação em tempo real
Formação técnica, serviço militar, transferência para uma graduação de quatro anos e experiência em busca de emprego Publicação longa do autor no X em 2026-07-15 Relato do próprio autor
Abandono dos estudos aos 16 anos, conserto de carros e trabalho em fábrica Entrevista da QbitAI em setembro de 2026 Informações compiladas pela imprensa
Preços dos modelos Consulta à interface pública de preços da APIYI no dia de redação deste artigo Confira os valores exibidos no console naquele dia
Opcional: verificação de atualizações e comandos do repositório (dispensável para a maioria dos leitores)

O Archify não instala novas versões automaticamente. Para receber avisos de atualização, acesse a página do repositório no GitHub e clique, nesta ordem, em Watch → Custom → Releases. O Skill instalado faz verificações de atualização pouco frequentes. Se a verificação falhar, nada de errado acontece: você recebe apenas um aviso, e o programa não baixa nada por conta própria. Ele acessa somente `archify.si/skill-updates/archify/stable.json` e não envia a versão instalada, o conteúdo do projeto, as entradas do usuário nem as chaves. Para desativar esse recurso, defina a variável de ambiente `ARCHIFY_UPDATE_CHECK_DISABLED=1`.

O repositório também contém comandos como `node bin/archify.mjs`, voltados principalmente à depuração por colaboradores. A maioria dos leitores não precisa executá-los; consulte o README do repositório para ver os detalhes de uso.


Referências

  1. Repositório oficial do Archify (README em chinês): funcionalidades, instalação e escopo
  2. Link: github.com/tt-a1i/archify
  3. Observação: as informações sobre funcionalidades e versões deste artigo têm essa fonte como referência
  4. Site oficial do Archify: página do projeto
  5. Link: archify.si
  6. Publicação longa do autor no X (2026-07-15): relato do próprio autor sobre sua trajetória
  7. Link: x.com/t20000622yy/status/2077425261856096720
  8. Vídeo do autor no Bilibili: “De abandonar os estudos e ir trabalhar numa fábrica a chegar ao topo do ranking do GitHub: a IA transformou minha vida!”, publicado pelo próprio autor
  9. Link: www.bilibili.com/video/BV1cGe56cEHo/
  10. Demonstração do projeto pelo autor no Bilibili: “Acordei e descobri que meu projeto de código aberto tinha chegado ao primeiro lugar global no GitHub Trending”
  11. Link: www.bilibili.com/video/BV16MhA6pEMb/
  12. Reportagem da QbitAI, de setembro de 2026: matéria sobre o projeto e a história do desenvolvedor; o texto cita apenas uma frase, com a fonte indicada
  13. Interface pública de preços da APIYI: consulta feita no dia de redação deste artigo
  14. Link: api.apiyi.com/api/pricing

Artigos relacionados

Similar Posts