﻿Ultimate Shift Controller
Guia do usuário
Version 3.0.9

━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
■ 1. Tipo de distribuição e requisitos
━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━

Tipo: freeware, sem custo de uso.
Requisitos: Windows 10/11 de 64 bits, .NET 8 Desktop Runtime (x64), teclado e mouse. O comportamento pode variar conforme o dispositivo, aplicativo ou jogo. O controle virtual pode exigir drivers e configuração adicionais.

━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
■ 2. Instalação
━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━

Não há instalador. Extraia o ZIP para uma pasta com permissão de gravação, execute UltimateShiftController.exe, configure os mapeamentos e clique em [Salvar]. Não execute diretamente de dentro do ZIP.

━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
■ 3. Desinstalação
━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━

Desative [Executar na inicialização], feche o USC inclusive na bandeja e apague a pasta. Para remover configurações, apague [Settings]. Drivers de controle virtual instalados separadamente devem ser removidos à parte.

━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
■ 4. Sobre o USC
━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━

Ultimate Shift Controller combina teclado e mouse para remapear teclas, executar atalhos por botões do mouse e alternar mapeamentos enquanto um acionador de camada é mantido. Pode ser usado em jogos, edição, escrita, streaming, navegador e outros aplicativos. As funções básicas não exigem controle virtual.

━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
■ 5. Principais recursos
━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━

- Remapeamento de teclado e mouse
- Atalhos com SHIFT, CTRL, ALT e Windows
- Várias saídas por uma entrada
- F1-F24 e teclas de navegação
- Camadas NORMAL, HYPER, ULTRA e ULTIMATE
- Turbo, abas, perfis, importação/exportação, HUD e bandeja
- Cliques esquerdo/direito como entrada em HYPER, ULTRA e ULTIMATE
- Tradução local do texto selecionado pelo Google Chrome

━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
■ 6. Configuração básica
━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━

Execute o aplicativo, escolha a camada, registre a entrada no campo superior e a saída no inferior, clique em [Salvar] e teste. Exemplo: Q -> CTRL+1.

━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
■ 7. Quatro camadas
━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━

NORMAL é a camada padrão. HYPER e ULTRA funcionam enquanto seus acionadores são mantidos. ULTIMATE funciona quando ambos são mantidos. Os botões superiores escolhem o que editar; os acionadores definem a camada ativa.

━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
■ 8. HYPER / ULTRA / ULTIMATE e mouse externo
━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━

Os gatilhos lógicos de HYPER e ULTRA são limitados a F13-F24 e devem ser diferentes.

Exemplo: HYPER=F13 e ULTRA=F14. O botão físico deve enviar a mesma tecla configurada no USC.

Uma saída F13-F24 do USC sem Turbo também pode atuar internamente como gatilho. Os cliques esquerdo e direito podem ser registrados como entrada em HYPER/ULTRA/ULTIMATE; continuam bloqueados na entrada NORMAL e em todos os campos de saída. Uma entrada sem Turbo mantém a saída pressionada até ser solta.

[Razer Synapse 2]
O Synapse 2 salva F13-F24 mesmo sem mostrar o nome. Para F13: em NORMAL, mapeie temporariamente F1 para enviar F13; abra o registro de tecla do botão no Synapse 2; pressione F1; salve mesmo sem nome visível; depois restaure F1 no USC e use F13 como acionador HYPER.

[Razer Synapse 3]
Quando F13-F24 puderem ser escolhidas diretamente, atribua F13/F14 ao botão e use a mesma tecla no USC.

[Logicool/Logitech G-Shift e G HUB]
O G HUB permite escolher F1-F24. Atribua F13/F14 a um botão normal ou G-Shift e use a mesma tecla no USC.

[Outros dispositivos]
Qualquer software que registre F13-F24 pode usar o mesmo método. Mesmo sem exibir o nome, se salvar e enviar a tecla, funciona. Prefira F13-F24.

━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
■ 9. Abas, perfis e salvamento
━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━

Abas organizam mapeamentos. Perfis salvam toda a configuração. Clique sempre em [Salvar]. Os dados ficam em [Settings]; copie essa pasta ao mover o USC.

━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
■ 10. Turbo, HUD e estado
━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━

Turbo repete saídas. US HUD mostra a camada. CLEAN tenta liberar estados presos. Keyboard Lock bloqueia temporariamente o teclado e é desativado com o mouse.

━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
■ 11. Configurações importantes
━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━

[Kill de entradas mapeadas] evita entrada original e saída ao mesmo tempo. A opção de bloquear entradas não mapeadas impede passagem durante HYPER/ULTRA/ULTIMATE. Também há opções de bandeja e inicialização do Windows.

━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
■ 12. Controle virtual
━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━

Recurso avançado que pode exigir drivers, separação entre controle físico/virtual e ajustes do jogo. Configuração incorreta pode causar entrada dupla. Guia com imagens:
https://github.com/Lu-ci-el/UltimateShiftController/blob/main/Instructions_en.md

Não é necessário para teclado, mouse, camadas e atalhos.

━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
■ 13. Solução de problemas
━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━

Salve as alterações, confira os acionadores, verifique Kill em caso de entrada dupla, desbloqueie Keyboard Lock com o mouse, use CLEAN para estados presos e evite Program Files se não conseguir salvar.

━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
■ 14. Contato e bugs
━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━

https://github.com/Lu-ci-el/UltimateShiftController/issues

Informe problema, passos, frequência, ambiente e logs. Não há garantia de resposta individual, correção imediata ou suporte a todos os ambientes. Não são aceitos pedidos de abuso, incômodo ou desenvolvimento personalizado.

━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
■ 15. Avisos
━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━

Faça backup de [Settings], feche o USC antes de atualizar, verifique conflitos e regras de jogos/serviços. Não use para trapaça, abuso ou interferência. O autor não se responsabiliza por danos decorrentes do uso.


━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
■ USC_TRANSLATION_3_0_4 / Tradução
━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━

- A tradução exige Google Chrome de 64 bits e modelos locais compatíveis. O Microsoft Edge não é usado como fallback.
- Ative “Usar tradução” e abra as configurações. A tecla de tradução é uma tecla lógica F13-F24 e não pode repetir o gatilho HYPER ou ULTRA.
- Clique com o botão esquerdo no campo da tecla de gatilho para capturar e com o direito para limpar. Pode ser um acorde físico de teclado/mouse/controle ou uma saída de mapeamento USC sem Turbo da camada atual. Partes físicas e internas nunca são combinadas.
- O texto estrangeiro selecionado é traduzido para o idioma atualmente escolhido no USC. Texto no seu idioma vai para o último idioma de conversa bem-sucedido ou para o destino padrão.
- O resultado aparece na janela simples. Para obter o texto selecionado, o USC envia Ctrl+C exatamente uma vez ao aplicativo em primeiro plano como eventos de scan code separados, na ordem Left Ctrl DOWN → C DOWN → C UP → Left Ctrl UP, mantendo Ctrl pressionado por um breve período antes de C. O USC nunca envia C primeiro nem repete C após uma falha de cópia. Somente uma atualização comprovada da área de transferência é traduzida; caso contrário, a tradução não é executada e a janela simples informa que não foi possível obter a seleção. Captura de tela e OCR não são usados.
- Os 14 idiomas integrados podem ser preparados em lote. Outros idiomas são preparados individualmente por tag BCP-47 quando o Chrome oferece suporte.
- Abrir as configurações, atualizar ou selecionar uma linha não inicia download. Somente DL explícito ou DL em lote tem essa autoridade.
- O DL explícito abre no Chrome normal uma página local temporária protegida por token. Funciona com o Chrome já aberto e só começa após um clique no Chrome. Nenhum site externo é aberto; os modelos pertencem ao Chrome.
- A tradução normal usa um helper invisível de uma solicitação por entrada/saída padrão e não abre página, aba, janela do Chrome nem listener localhost. Modelos ausentes não são baixados automaticamente.
- O USC salva apenas configurações e evidências leves em [Settings\Translation]. Perfis, TranslateKit, pacotes, modelos, componentes, runtime e cache do Chrome não são copiados para o USC.
- Markdown, URLs, código, citações, parágrafos e quebras de linha são protegidos fora do modelo, divididos com limites finitos e reconstruídos. Salve permanentemente com [Salvar] na janela principal.
