Pular para o conteúdo
Documentação

Atalhos de teclado customizados

Rebinde 27 das ações mais usadas (Cosmos Optimizer, WHAT-IF Lab, Realtime Dashboard, Theme Studio, etc.) sem editar arquivos de config.

O que você pode customizar

NoSqlStudio vem com 27 actions que você pode rebinder: Tools › Cosmos DB (4 entries), Tools › Dashboards & Monitoring (7), Tools › Data Ops (6), Tools › Compliance (3), Tools › AI Assistant (2), Editor (3), File (2). Atalhos padrão de editor (Ctrl+C, Ctrl+V, Ctrl+Z, etc.) não são customizáveis — eles seguem as convenções do OS.

Como rebinder um atalho

  1. Abra Settings → Shortcuts (ou pressione Ctrl+, e clique em "Shortcuts" na sidebar esquerda).
  2. Encontre a action que você quer rebinder. Use a caixa de busca no topo para filtrar.
  3. Clique em "Edit" na linha. Um modal de captura aparece.
  4. Pressione a combinação de teclas que você quer (ex.: Ctrl+Alt+Shift+X). Clique em "Save". O novo binding entra em efeito IMEDIATAMENTE — sem restart.

Detecção de conflitos

Quando duas actions compartilham a mesma key combination, um banner amarelo de aviso aparece no topo do painel. As linhas conflitantes ficam destacadas. O conflito NÃO bloqueia você — você ainda pode salvar a duplicata, mas o OS vai rotear o keystroke para qualquer action que estiver registrada primeiro. Resolva escolhendo um combo diferente para uma delas.

Resetar um atalho

Cada linha sobrescrita mostra um botão "Reset" que restaura o default. O botão "Reset all to defaults" no topo limpa todos os overrides de uma vez. Defaults são documentados ao lado de cada linha para você poder comparar.

Compartilhando atalhos entre máquinas

Atalhos customizados são armazenados no arquivo de preferences. Copie o arquivo entre máquinas para espelhar seus bindings:

// On Windows
%APPDATA%\NoSqlStudio\preferences.json

// On macOS
~/Library/Application Support/NoSqlStudio/preferences.json

// On Linux
~/.config/NoSqlStudio/preferences.json

O objeto customKeybindings lista cada override como { actionId: accelerator }. Exemplo:

{
  "customKeybindings": {
    "tools.cosmosOptimizer": "CmdOrCtrl+Shift+1",
    "tools.cosmosWhatIf": "CmdOrCtrl+Shift+2",
    "editor.themeStudio": "F12"
  }
}

Limitações (v1)

  • 27 actions wireadas hoje. As 71 entries de menu restantes ainda usam seus aceleradores hardcoded — o wire-up é incremental e vai chegar no próximo release.
  • Multi-keystroke chords (estilo VS Code "Ctrl+K Ctrl+S") não são suportados — cada binding é um único combo.
  • Atalhos de nível de OS (Cmd+Tab no macOS, Ctrl+Alt+Del no Windows) não podem ser rebinder — o OS captura-os antes que o app os veja.