Cartão de Token

Produz um cartão SVG que resume o uso do agente de codificação de IA desta máquina — tokens totais, custo equivalente da API, sequência atual e a divisão entre agentes — e o escreve na árvore de trabalho como um arquivo que o README pode referenciar.

O cartão é um artefato confirmado em vez de uma imagem hospedada, portanto, ele é renderizado a partir do próprio repositório e não depende de um endpoint de terceiros permanecer ativo.

Quando Ativar

• Alguém quer uma figura de uso visível em um README ou página de documentação.
• Alguém pede um resumo compartilhável de sua atividade de agente em várias ferramentas.

Use /cost-report em vez disso quando a pergunta for "quanto gastei esta semana". Os dois leem fontes diferentes e produzem coisas diferentes:

A ferramenta que executa isso

@tokenchit/cli, licenciada sob MIT: https://github.com/iyashjayesh/tokenchit

Fixado em uma versão exata, deliberadamente. @latest resolve para o que o registro atualmente serve, e esta ferramenta lê logs de sessão locais — portanto, uma versão futura comprometida seria executada com acesso a eles antes que alguém a revisasse. Fixe, e aumente o pino conscientemente:

TOKENCHIT_VERSION=0.10.0

Para verificar o artefato fixado antes de executá-lo pela primeira vez:

npm view @tokenchit/cli@0.10.0 dist.integrity dist.tarball

Fluxo de Trabalho

1. Pergunte antes do primeiro download. npx busca o pacote do registro npm e o executa. Isso é um download remoto de código que lerá logs locais, então obtenha confirmação explícita do usuário antes da primeira execução em uma máquina. Se eles recusarem, pare aqui e diga o que teria sido executado.

2. Configure, a menos que seja uma execução de teste. Se .tokenchit.json estiver ausente, execute:

   npx -y @tokenchit/cli@0.10.0 init
   

   Ele detecta quais agentes têm logs nesta máquina e os registra. O arquivo destina-se a ser confirmado e nunca contém uma credencial.

   Pule isso inteiramente quando o usuário passou --dry-run, e relate que .tokenchit.json seria criado. Uma prévia que escreve um arquivo de configuração não é uma prévia.

3. Renderize o cartão. O comando puro escreve na saída configurada — tokenchit.svg a menos que .tokenchit.json nomeie outro caminho:

   npx -y @tokenchit/cli@0.10.0 sync
   

   Anexe apenas as flags que o usuário realmente solicitou, cada uma escrita exatamente como abaixo. Não copie um placeholder no comando — sync ignora um argumento posicional não reconhecido em vez de recusá-lo, então um [--dry-run] entre colchetes chega à CLI como lixo e o cartão é escrito de qualquer maneira, o que é o oposto do que foi solicitado.

   Flag	Efeito
   --out <path>	Escrever em outro lugar que não a saída configurada
   --theme auto | light | dark	Tema do cartão; auto se adapta ao sistema do leitor
   --dry-run	Imprimir o que seria escrito e não tocar em nada

   sync lê arquivos locais e não envia nada: nenhum prompt, nenhum código, nenhum conteúdo de arquivo sai da máquina, e ele não transmite nada para nenhum servidor. A invocação npx ao redor dele é um download do registro — esse é o acesso à rede neste fluxo de trabalho, e a etapa 1 é onde ele é acordado.

4. Relate e ofereça. Imprima os números que ele produziu — tokens, custo equivalente, sequência, divisão por agente — e o caminho escrito. Se o repositório tiver um README que ainda não referencia o cartão, ofereça-se para adicionar:

   ![tokenchit](./tokenchit.svg)
   

   sync imprime o caminho relativo à raiz do repositório. Uma imagem Markdown resolve relativamente ao arquivo em que está, então reescreva-o para o README que está sendo editado: um cartão em docs/usage.svg está ./docs/usage.svg da raiz do README, mas ../usage.svg de docs/zh-CN/README.md. Colar o caminho impresso em um README aninhado aponta para docs/zh-CN/docs/usage.svg e renderiza quebrado.

   Não edite o README sem ser solicitado.

Pare após a etapa 4. Publicar no placar público é um comando publish separado que requer opt-in explícito, e não faz parte deste fluxo de trabalho — execute-o apenas se o usuário pedir por nome. unpublish remove a linha e a conta novamente.

Saída

…