Compatibilidade do terminal e acessibilidade

Confira os requisitos do terminal, os ajustes de teclado e os limites de acessibilidade.

O Clarvis é um aplicativo de terminal em tela cheia criado com OpenTUI. Emuladores de terminal diferem no tratamento do teclado, na largura de caracteres Unicode, nas cores, na integração com a área de transferência e no comportamento do mouse. Por isso, o projeto documenta o comportamento observado separadamente dos alvos de release configurados.

Linha de base

• O modo interativo exige uma PTY real e linhas e colunas suficientes para renderizar a interface.
• Os arquivos para Linux GNU/glibc, macOS e Windows em x64 e arm64 estão disponíveis publicamente na v0.1.1. Os seis jobs nativos de pacote e smoke de instalação passaram. Alpine e outras distribuições Linux exclusivas de musl não são alvos da release portátil.
• Os jobs de release no Linux e no macOS verificam a primeira renderização em uma PTY real. No Windows, o smoke verifica o manifesto e os caminhos rápidos da CLI; a primeira renderização em uma PTY nativa do Windows continua sem verificação manual.
• clarvis -p é a alternativa orientada a texto para scripts, terminais limitados e fluxos assistivos que não podem usar a interface em tela cheia.

Ao relatar um problema de renderização ou entrada, informe o sistema operacional, a arquitetura, o nome e a versão do terminal, o shell, o multiplexador ou salto remoto, o layout do teclado, o tamanho da janela e se --ascii altera o resultado.

Símbolos e cores

O Clarvis usa símbolos Unicode por padrão. Comece com clarvis --ascii quando uma fonte ou terminal mostrar quadrados no lugar de símbolos, desalinhar as colunas ou não tiver os símbolos esperados. A opção ASCII altera a seleção de símbolos, mas não converte o texto do modelo para ASCII.

O Clarvis respeita NO_COLOR em ambientes sem cores. A cor não deve ser a única forma de comunicar um estado, mas o contraste ainda não foi certificado segundo uma meta formal de acessibilidade. Os temas do terminal continuam sob controle do usuário.

Entrada pelo teclado

O rodapé e /help mostram os atalhos ativos e sensíveis ao contexto. Consulte esses lugares em vez de usar um mapa de teclas estático na documentação. Terminais modernos podem informar teclas modificadoras de formas diferentes, e o Clarvis seleciona um perfil de teclado a partir das capacidades observadas.

Ctrl+S é o atalho portátil para os presets de segurança a partir do campo de mensagem. Alt+S é um acelerador do modo aprimorado somente quando o terminal envia Alt ou Option como Meta/Esc+. O Clarvis deliberadamente não solicita relatórios de escape para todas as teclas, inclusive em sessões diretas do iTerm, para preservar acentos em português, composição com teclas mortas e o texto comum da tecla Option. Se o terminal enviar um ß literal, o Clarvis o mantém como texto e Ctrl+S continua disponível.

Se um atalho não funcionar:

1. feche os menus aninhados com Esc e tente o atalho exibido no contexto;
2. teste fora de tmux, screen, SSH ou de um terminal de IDE para isolar a tradução da entrada;
3. verifique as configurações de teclas de aplicação e Alt/Option do terminal;
4. inclua o layout do teclado e o terminal exato em um relatório de bug sem dados sensíveis.

Terminais remotos e multiplexadores

SSH e multiplexadores de terminal são rotas válidas quando preservam uma PTY compatível, eventos de redimensionamento da janela e sequências de teclado. Recursos de imagem ou área de transferência podem perder capacidade de forma independente. Use --ascii e NO_COLOR=1 para uma apresentação conservadora e -p quando o ambiente remoto não for adequado para uma interface em tela cheia.

Leitores de tela e necessidades de movimento reduzido

O Clarvis ainda não passou por uma auditoria de compatibilidade com leitores de tela. A atualização da tela inteira, as camadas de foco e as mudanças dinâmicas do histórico da conversa podem ser difíceis para algumas tecnologias assistivas. O modo headless com clarvis -p --format text ou --format md é a alternativa atual sem interface em tela cheia, mas não é apresentado como cobertura de acessibilidade equivalente.

O projeto não declara conformidade formal da TUI com as WCAG. Defeitos de acessibilidade e combinações concretas de terminal e tecnologia assistiva podem ser enviados pelo formulário de bug.

Limitações das plataformas

As lacunas atuais no Windows incluem o comportamento local ainda não verificado de !bash e diferenças específicas da plataforma na saída de processos e monitores. Consulte a Solução de problemas antes de diagnosticar uma falha entre plataformas. O checklist de release exige evidência nativa em vez de inferir compatibilidade a partir de uma compilação bem-sucedida no Linux.