Instale o skill da CLI belt:
npx skills add belt-sh/cli
Changelog do Produto
Escreva changelogs e notas de versão que os usuários leiam e se importem, via CLI do inference.sh.
Início Rápido
Requer a CLI do inference.sh (
belt). Instruções de instalação
belt login
# Gere um visual de anúncio de funcionalidade
belt app run falai/flux-dev-lora --input '{
"prompt": "mockup limpo de screenshot de UI de produto, interface de dashboard moderna mostrando um novo recurso de gráfico de análise, modo claro, design minimalista, produto SaaS profissional",
"width": 1248,
"height": 832
}'
Formato da Entrada
A Anatomia de uma Boa Entrada
### Novo: Exportação em Massa para Relatórios 📊
Agora você pode exportar até 10.000 linhas de uma vez de qualquer visualização de relatório.
Selecione suas linhas, clique em Exportar e escolha o formato CSV ou Excel.
Anteriormente limitado a 500 linhas por exportação.
Estrutura: Rótulo da categoria -> Título voltado ao usuário -> O que você pode fazer agora -> Como -> O que mudou -> Visual
Linguagem Voltada ao Usuário
❌ Linguagem interna:
"Implementei a fila de processamento em lote para o serviço de exportação"
"Refatorei a classe ReportExporter para suportar paginação"
"Corrigi bug na serialização CSV (PR #4521)"
✅ Linguagem voltada ao usuário:
"Agora você pode exportar até 10.000 linhas de uma vez de qualquer relatório"
"Os relatórios agora carregam 3x mais rápido ao filtrar grandes conjuntos de dados"
"Corrigido um problema onde arquivos CSV exportados tinham colunas ausentes"
Regras:
- Escreva o que o usuário pode FAZER, não o que você CONSTRUIU
- Comece com "Agora você pode..." / "Os relatórios agora..." / "Corrigido um problema onde..."
- Inclua o benefício, não apenas o mecanismo
- Use o presente
Categorias
Categorias Padrão
| Categoria | Cor | Ícone | Uso |
|---|---|---|---|
| Novo | Verde | ✨ ou 🆕 | Funcionalidades ou capacidades totalmente novas |
| Melhorado | Azul | ⚡ ou 🔧 | Melhorias em funcionalidades existentes |
| Corrigido | Amarelo/Laranja | 🐛 ou 🔨 | Correções de bugs |
| Removido | Vermelho | 🗑️ ou ⚠️ | Funcionalidades descontinuadas ou removidas |
| Segurança | Roxo | 🔒 | Patches de segurança |
Regras de Categorização
- Novo = algo que os usuários não podiam fazer antes
- Melhorado = algo que os usuários podiam fazer, agora está melhor/mais rápido/mais fácil
- Corrigido = algo que estava quebrado, agora funciona corretamente
- Não use "Atualizado" — é sem sentido. Foi melhorado ou corrigido?
Numeração de Versão
Versionamento Semântico (SemVer)
MAJOR.MINOR.PATCH
3 . 2 . 1
| Componente | Incrementar Quando | Exemplo |
|---|---|---|
| MAJOR | Mudanças que quebram compatibilidade, reformulação importante | 2.0.0 -> 3.0.0 |
| MINOR | Novas funcionalidades, compatível com versões anteriores | 3.1.0 -> 3.2.0 |
| PATCH | Correções de bugs, pequenas melhorias | 3.2.0 -> 3.2.1 |
Versionamento Baseado em Data
2026-02-08 ou 2026.02.08 ou 8 de Fevereiro de 2026
Melhor para produtos SaaS com implantação contínua.
Estrutura da Página de Changelog
# Changelog
## 8 de Fevereiro de 2026
### Novo
- **Exportação em Massa para Relatórios** — Exporte até 10.000 linhas de uma vez. [Saiba mais →](link)
- **Modo Escuro** — Alterne o modo escuro em Configurações > Aparência.
### Melhorado
- **Carregamento do Dashboard** — Os dashboards agora carregam 3x mais rápido em grandes conjuntos de dados.
- **Pesquisa** — Os resultados da pesquisa agora incluem itens arquivados.
### Corrigido
- Corrigido um problema onde arquivos CSV exportados tinham cabeçalhos de coluna ausentes.
- Corrigido um bug onde o seletor de data mostrava fuso horário incorreto.
---
## 1 de Fevereiro de 2026
### Novo
- **Webhooks da API** — Seja notificado quando eventos ocorrerem na sua conta.
### Corrigido
- Corrigido um problema onde as notificações por email estavam atrasadas em até 2 horas.
Changelogs Visuais
Quando Adicionar Visuais
| Tipo de Mudança | Visual |
|---|---|
| Novo recurso de interface | Screenshot do novo recurso |
| Redesign de interface | Comparação antes/depois |
| Novo fluxo de trabalho | Screenshots passo a passo ou vídeo curto |
| Melhoria de desempenho | Gráfico mostrando a melhoria |
| Recurso complexo | GIF animado ou demonstração em vídeo |
Gerando Visuais
# Screenshot de recurso (se o app estiver rodando, use o navegador agente)
belt app run infsh/agent-browser --input '{
"url": "https://seu-app.com/novo-recurso",
"action": "screenshot"
}'
# Comparação antes/depois
belt app run infsh/stitch-images --input '{
"images": ["antes-screenshot.png", "depois-screenshot.png"],
"direction": "horizontal"
}'
# Screenshot anotado com destaque
belt app run bytedance/seededit-3-0-i2i --input '{
"prompt": "adicione um círculo vermelho de destaque ao redor do botão de exportação na área superior direita",
"image": "screenshot.png"
}'
# Banner de anúncio de recurso
belt app run falai/flux-dev-lora --input '{
"prompt": "banner de anúncio de produto limpo e moderno, fundo gradiente azul para roxo, formas geométricas abstratas, estética SaaS profissional, formato largo",
"width": 1248,
"height": 832
}'
Mudanças que Quebram Compatibilidade
Mudanças que quebram compatibilidade exigem tratamento especial:
### ⚠️ Quebra: Endpoints da API v2 Descontinuados
**O que mudou:** Os endpoints da API v1 deixarão de funcionar em 15 de Março de 2026.
**O que você precisa fazer:**
1. Atualize suas chamadas de API para usar os endpoints v2 ([guia de migração →](link))
2. Atualize a autenticação para usar tokens Bearer em vez de chaves de API
3. Teste sua integração antes de 15 de Março
**Cronograma:**
- Agora: endpoints v2 disponíveis, v1 ainda funciona
- 1 de Março: v1 retorna avisos de descontinuação
- 15 de Março: v1 para de funcionar
Se precisar de ajuda para migrar, entre em contato com [email protected].
Canais de Distribuição
| Canal | Formato | Quando |
|---|---|---|
| Página de changelog | Detalhe completo, todas as entradas | A cada versão |
| Notificação no app | Resumo de 1-2 linhas | Novos recursos, mudanças que quebram compatibilidade |
| Destaques selecionados, visuais | Versões principais (mensal/trimestral) | |
| Post no blog | Aprofundamento com contexto | Grandes lançamentos |
| Redes sociais | Destaque de um único recurso | Recursos notáveis |
| Slack/Discord | Anúncio breve | Se você tiver uma comunidade |
Formato de Snippet para Redes Sociais
🆕 Novo no [Produto]: [Nome do Recurso]
[Descrição de 1 a 2 frases sobre o que você pode fazer agora]
[Screenshot ou vídeo de demonstração]
Experimente agora → [link]
Dicas de Escrita
Faça
- Agrupe alterações relacionadas
- Lidere com a mudança maior/mais solicitada
- Link para a documentação para recursos complexos
- Inclua quem solicitou ("Por solicitação popular:")
- Mostre caminhos de migração para mudanças que quebram compatibilidade
- Date cada entrada
Não Faça
- Não diga "várias correções de bugs" — liste correções específicas ou pule-as
- Não inclua referências internas (números de PR, IDs de tickets, nomes de branch)
- Não use "[Recurso] atualizado" sem dizer como
- Não liste mudanças que ninguém se importa (bumps de dependência, refatorações internas)
- Não despeje commits — uma entrada de changelog pode representar muitos commits
Frequência do Changelog
| Tipo de Produto | Frequência | Notas |
|---|---|---|
| SaaS (implantação contínua) | Lote semanal | Agrupe uma semana de mudanças |
| SaaS (recursos principais) | Por lançamento de recurso | Com post no blog |
| Software com versão | Por versão | Vinculado ao semver |
| API | Por versão + avisos de descontinuação | Inclua guias de migração |
| Aplicativo móvel | Por versão na loja | Corresponda à seção "O que há de novo" da listagem na loja |
Erros Comuns
| Erro | Problema | Correção |
|---|---|---|
| Linguagem de desenvolvedor | Usuários não entendem | Escreva o que os usuários podem fazer |
| "Correções de bugs e melhorias" | Informação zero | Liste correções específicas |
| Sem datas | Não é possível saber o que é novo | Date cada entrada |
| Sem visuais | Usuários pulam o texto | Screenshot dos principais recursos |
| Mudanças que quebram compatibilidade enterradas | Usuários descobrem tarde demais | Aviso proeminente + cronograma |
| Log de commits como changelog | Ruidoso, inútil | Crie e reescreva |
Skills Relacionados
npx skills add inference-sh/skills@ai-image-generation
npx skills add inference-sh/skills@prompt-engineering
Navegue por todos os apps: belt app list