Como adiciono um atalho de teclado para limpar o buffer de rolagem no Windows Terminal?

Atualização 2021-10-20 : Isso agora é suportado nativamente a partir da versão 1.12 (em visualização no momento da redação).

Veja PR #10906 para detalhes completos.

Isso adiciona uma nova ação, clearBuffer. Aceita 3 valores para o tipo clear:

• "clear": "screen": Limpe o conteúdo da janela de visualização do terminal. Deixa a rolagem intocada. Move a linha do cursor para o topo da janela de visualização (não modificada).

• "clear": "scrollback": Limpe a rolagem. Deixa a viewport intocada.

• "clear": "all": (padrão) Limpe a rolagem e a viewport visível. Move a linha do cursor para o topo da janela de visualização (não modificada).

• "Limpar buffer" também foi adicionado ao defaults.json.

Essas ações podem ser invocadas a partir da paleta de comandos ou podem ser vinculadas a atalhos de teclado por meio da interface do usuário de configurações e diretamente settings.jsonconforme abordado na documentação oficial .

Para referência, aqui está uma discussão sobre a diferença entre Cmd ⌘+ Ke Ctrl+ L: Qual é a diferença entre Ctrl+L e Cmd+K para limpar a tela do terminal?

Resposta mais longa

De acordo com Mike Griese ( zadjii-msft no GitHub), um engenheiro que trabalha no Windows Terminal:

Para esclarecer para mim no futuro - cmd + k não é algo que está sendo tratado pelo bash ou pelo shell. Este é o próprio Terminal manipulando a combinação de teclas e limpando o buffer e a rolagem.

Você descreveu uma história de usuário que faz sentido para mim, então vou colocar isso na lista de pendências.

Dustin Howett ( DHowett-MSFT no GitHub) continua dizendo:

[Esta] questão em particular é mais espinhosa do que a maioria. Para compatibilidade com aplicativos de console do Windows que não esperam que um terminal seja conectado, precisamos manter um buffer de texto para que eles leiam. Isso é tudo. Como não temos como limpar esse buffer de texto (do lado do terminal), e ainda não escrevemos um, é apenas mais complexo do que limpar a tela local. Não é um problema de classe de complexidade com todo o Terminal.

Referência: https://github.com/microsoft/terminal/issues/1882

Bem, isso se transformou em um rastro de coelho e meio ;-) ...

Eu teria pensado que isso teria sido bastante direto com a sendInputação introduzida no Windows Terminal 1.3, mas continuo falhando usando esse método. Não afirmo ser nenhum especialista em atalhos de teclado ou sequências de escape de terminal, mas estou tentando atrapalhar.

Primeiro, de man clear, a sequência "clear scrollback" é Esc[3J. Isso funciona no Windows Terminal via:

• Powershell:Write-Output "`e[3J"
• bash, zsh ou fish: printf '\033[3J'(ou equivalente echo)

É claro que precisa ser acoplado com a sequência "limpar tela inteira" ( \033[2J) e o "cursor para a posição inicial" ( \033[H) (obtido nesta resposta ).

Junte-os e printf '\033[2J\033[3J\033[H'obtenha-nos o clearcomportamento (sem argumentos).

Então, eu pensaria, dado o sendInputexemplo nas notas de lançamento do Windows Terminal 1.3, que poderíamos enviar esse código de escape via:

{ "command": { "action": "sendInput", "input": "\u001B[3J" }, "keys": "ctrl+shift+l"}

na "actions"seção (anteriormente "keybindings"). O \u001b[Aexemplo (seta para cima) funciona bem para mim, mas o "clear scrollback" resulta em um sino de erro no bash e na impressão [3Jem fish. O mesmo ocorre para \u001B[2Jtentar limpar a tela também. Se alguém puder descobrir onde estou errando nisso, eu adoraria saber.

Mas... podemos religar as chaves nas conchas. No entanto, eles provavelmente não serão capazes de dizer a diferença entre + Ctrle L++ Ctrlpor esse motivoShift . Exceto para o recente PSReadLine 2.0, que diferencia maiúsculas de minúsculas em combinações de teclas.L

Portanto, se você realmente deseja usar Ctrl++ nos shells do PowerShell Shifte ldo Linux no WSL, precisará fazer isso em duas etapas:

Primeiro, configure uma ação do Terminal do Windows para sendInputcom um código de chave não utilizado:

"actions":
// formerly "keybindings"
    [
      ...
        { "command": { "action": "sendInput", "input": "\uAC12" }, "keys": "ctrl+shift+l"},
      ...
    ]
}

Honestamente, não tenho certeza de qual é a melhor maneira de escolher um código de chave. Acabei de usar algo do conjunto de caracteres Hangul\uAC12 ( ), já que tenho certeza de que nunca vou encontrar isso na vida real. Observe que este comentário recomenda o uso do intervalo " uso privado " E000-EFFF, mas parecia bastante preenchido no Windows Terminal e eu já havia resolvido o Hangul, então deixei os exemplos abaixo usando \uAC12.

Então, precisamos vincular \uAC12em cada shell para enviar as sequências de escape corretas:

• Bash:

  Primeiro, obtenha a sequência de chaves para vincular com printf '\uAC12' | xxd, o que resulta em 00000000: eab0 92.

  Em seguida, usando essa saída, codifique o comando bind como bind -x '"\xEA\xB0\x92":"printf \\033[2J\\033[3J\\033[H"'( xxdideia de um comentário nesta resposta .)

• Zsh: Parece estar um pouco mais envolvido:

  function clear-scrollback {
    clear && printf '\e[3J'
    zle && zle .reset-prompt && zle -R
  }
  zle -N clear-scrollback
  bindkey '\uAC12' clear-scrollback
  
  

  (com a ajuda desta resposta ).

• Peixe: bind \uAC12 "printf '\033[2J\033[3J\033[H'; commandline -f repaint"

• PowerShell: Set-PSReadLineKeyHandler "$([char]0xAC12)" -ScriptBlock { Write-Output "`e[2J`e[3J"; [Microsoft.PowerShell.PSConsoleReadLine]::ClearScreen() }. Ajude na [char]conversão desta resposta e, caramba, se não demorei para encontrar um exemplo de chamada de uma função PSReadline em um ScriptBlock.

• Núcleo do PowerShell: Set-PSReadLineKeyHandler "$([char]0xAC12)" -ScriptBlock { Write-Host "`e[2J`e[3J"; [Microsoft.PowerShell.PSConsoleReadLine]::ClearScreen() }. Não tenho certeza por que o PowerShell e o PowerShell Core se comportam de maneira diferente aqui.

Correções ou sugestões de melhoria são bem-vindas.

Edite seu~/.bashrc

alias cls='clear && echo -en "\e[3J"'

Agora você pode digitar clspara limpar a tela e rolar para dentro de sua sessão do WSL do bash.

Edite seu arquivo JSON do Terminal do Windows

"actions": 
[
    // Command to reset terminal and scrollback
    { 
        "command": 
        { 
            "action": "sendInput", "input": "cls\r" 
        }, 
        "keys": "ctrl+k"
    },
]

Agora pressionando CTRL+ kirá inserir o comando CLS para você. Para o PowerShell ou um prompt CMD, o comando CLS já tem suporte por padrão, portanto, nenhuma configuração extra é necessária.