Changelog: Histórico de Versões e Novidades do Plannotator
O Que Você Vai Aprender
- ✅ Conhecer o histórico de versões e novidades do Plannotator
- ✅ Entender as principais atualizações e melhorias de cada versão
- ✅ Acompanhar correções de bugs e otimizações de desempenho
Versão Mais Recente
v0.6.7 (2026-01-24)
Novos Recursos:
- Comment mode: Adicionado modo de comentário, permitindo inserir comentários diretamente no plano
- Type-to-comment shortcut: Adicionado atalho para digitar comentários diretamente
Melhorias:
- Corrigido problema de sub-agent blocking no plugin OpenCode
- Corrigida vulnerabilidade de segurança de prompt injection (CVE)
- Melhorada a detecção inteligente de agent switching no OpenCode
Referência do Código-fonte:
- Comment mode:
packages/ui/components/AnnotationToolbar.tsx - Type-to-comment:
packages/ui/components/AnnotationToolbar.tsx
v0.6.6 (2026-01-20)
Correções:
- Corrigida vulnerabilidade de segurança CVE no plugin OpenCode
- Corrigido problema de sub-agent blocking para prevenir prompt injection
- Melhorada a lógica de detecção inteligente de agent switching
Referência do Código-fonte:
- OpenCode plugin:
apps/opencode-plugin/index.ts - Agent switching:
packages/ui/utils/agentSwitch.ts
v0.6.5 (2026-01-15)
Melhorias:
- Aumento do hook timeout: Hook timeout aumentado do valor padrão para 4 dias, adequado para planos de IA de longa duração
- Correção da função copy: Preservadas as quebras de linha na operação de cópia
- Novo atalho Cmd+C: Adicionado suporte ao atalho Cmd+C
Referência do Código-fonte:
- Hook timeout:
apps/hook/server/index.ts - Copy newlines:
packages/ui/components/Viewer.tsx
v0.6.4 (2026-01-10)
Novos Recursos:
- Atalho Cmd+Enter: Suporte para usar Cmd+Enter (Windows: Ctrl+Enter) para enviar aprovação ou feedback
Melhorias:
- Otimizada a experiência de operação por teclado
Referência do Código-fonte:
- Keyboard shortcuts:
packages/ui/components/AnnotationPanel.tsx(Funcionalidade do atalho Cmd+Enter implementada diretamente nos componentes)
v0.6.3 (2026-01-05)
Correções:
- Corrigido problema de skip-title-generation-prompt
Referência do Código-fonte:
- Skip title:
apps/opencode-plugin/index.ts
v0.6.2 (2026-01-01)
Correções:
- Corrigido problema de arquivos HTML não incluídos no pacote npm do plugin OpenCode
Referência do Código-fonte:
- OpenCode plugin build:
apps/opencode-plugin/index.ts
v0.6.1 (2025-12-20)
Novos Recursos:
- Integração com Bear: Suporte para salvar automaticamente planos aprovados no aplicativo de notas Bear
Melhorias:
- Melhorada a lógica de geração de tags na integração com Obsidian
- Otimizado o mecanismo de detecção de vault do Obsidian
Referência do Código-fonte:
- Integração com Bear:
packages/server/integrations.ts - Integração com Obsidian:
packages/server/integrations.ts
Lançamentos de Recursos Importantes
Funcionalidade de Code Review (2026-01)
Novos Recursos:
- Ferramenta de revisão de código: Execute o comando
/plannotator-reviewpara revisar visualmente o Git diff - Comentários por linha: Clique no número da linha para selecionar o intervalo de código e adicionar anotações do tipo comment/suggestion/concern
- Múltiplas visualizações de diff: Suporte para alternar entre diferentes tipos de diff como uncommitted/staged/last-commit/branch
- Integração com Agent: Envie feedback estruturado para o agente de IA com suporte a resposta automática
Como Usar:
bash
# Execute no diretório do projeto
/plannotator-reviewTutoriais Relacionados:
Referência do Código-fonte:
- Code review server:
packages/server/review.ts - Code review UI:
packages/review-editor/App.tsx - Ferramenta Git diff:
packages/server/git.ts
Funcionalidade de Anotação de Imagens (2026-01)
Novos Recursos:
- Upload de imagens: Faça upload de anexos de imagem em planos e revisões de código
- Ferramentas de anotação: Três ferramentas de anotação disponíveis: pincel, seta e círculo
- Anotação visual: Anote diretamente nas imagens para melhorar o feedback de revisão
Tutoriais Relacionados:
Referência do Código-fonte:
- Image annotator:
packages/ui/components/ImageAnnotator/index.tsx - Upload API:
packages/server/index.ts
Integração com Obsidian (2025-12)
Novos Recursos:
- Detecção automática de vaults: Detecta automaticamente o caminho do arquivo de configuração do vault do Obsidian
- Salvamento automático de planos: Planos aprovados são salvos automaticamente no Obsidian
- Geração de frontmatter: Inclui automaticamente frontmatter como created, source e tags
- Extração inteligente de tags: Extrai palavras-chave do conteúdo do plano como tags
Configuração: Nenhuma configuração adicional necessária. O Plannotator detecta automaticamente o caminho de instalação do Obsidian.
Tutoriais Relacionados:
Referência do Código-fonte:
- Detecção do Obsidian:
packages/server/integrations.ts - Salvamento no Obsidian:
packages/server/integrations.ts - Geração de frontmatter:
packages/ui/utils/obsidian.ts
Funcionalidade de Compartilhamento por URL (2025-11)
Novos Recursos:
- Compartilhamento sem backend: Comprime planos e anotações no hash da URL, sem necessidade de servidor backend
- Compartilhamento com um clique: Clique em Export → Share as URL para gerar link de compartilhamento
- Modo somente leitura: Colaboradores podem visualizar ao abrir a URL, mas não podem enviar decisões
Implementação Técnica:
- Usa algoritmo de compressão Deflate
- Codificação Base64 + substituição de caracteres seguros para URL
- Suporta payload máximo de aproximadamente 7 tags
Tutoriais Relacionados:
Referência do Código-fonte:
- Sharing utils:
packages/ui/utils/sharing.ts - Share hook:
packages/ui/hooks/useSharing.ts
Modo Remoto/Devcontainer (2025-10)
Novos Recursos:
- Suporte a modo remoto: Use o Plannotator em ambientes remotos como SSH, devcontainer e WSL
- Porta fixa: Defina uma porta fixa através de variável de ambiente
- Encaminhamento de porta: Exibe automaticamente a URL para o usuário abrir manualmente o navegador
- Controle do navegador: Controle se o navegador abre automaticamente através da variável de ambiente
PLANNOTATOR_BROWSER
Variáveis de Ambiente:
PLANNOTATOR_REMOTE=1: Ativa o modo remotoPLANNOTATOR_PORT=3000: Define porta fixaPLANNOTATOR_BROWSER=disabled: Desativa abertura automática do navegador
Tutoriais Relacionados:
Referência do Código-fonte:
- Remote mode:
packages/server/remote.ts - Browser control:
packages/server/browser.ts
Compatibilidade de Versões
| Versão Plannotator | Claude Code | OpenCode | Versão Mínima Bun |
|---|---|---|---|
| v0.6.x | 2.1.7+ | 1.0+ | 1.0+ |
| v0.5.x | 2.1.0+ | 0.9+ | 0.7+ |
Recomendações de Atualização:
- Mantenha o Plannotator na versão mais recente para obter os recursos e correções de segurança mais recentes
- Claude Code e OpenCode também devem ser mantidos atualizados
Alterações de Licença
Versão Atual (v0.6.7+): Business Source License 1.1 (BSL-1.1)
Detalhes da Licença:
- Permitido: uso pessoal, uso comercial interno
- Restrito: fornecer serviços hospedados, produtos SaaS
- Detalhes em LICENSE
Feedback e Suporte
Reportar Problemas:
- GitHub Issues: https://github.com/backnotprop/plannotator/issues
Sugestões de Recursos:
- Envie um feature request no GitHub Issues
Vulnerabilidades de Segurança:
- Por favor, reporte vulnerabilidades de segurança através de canais privados
Prévia da Próxima Lição
Você agora conhece o histórico de versões e novidades do Plannotator.
Próximos passos:
- Volte ao Início Rápido para aprender como instalar e usar
- Consulte as Perguntas Frequentes para resolver problemas de uso
- Leia a Referência da API para conhecer todos os endpoints da API