heavenchenggong/fn-ime-voice-switch

O que fn-ime-voice-switch faz?

Habilidade do Claude Code: automação da tecla Fn no macOS para alternar entre o IME padrão e a entrada de voz Doubao via Hammerspoon. Pressione Fn para ativar a entrada de voz Doubao, solte para voltar ao IME padrão.

Visão Geral

Este skill para Claude Code no macOS automatiza a tecla Fn (função) usando Hammerspoon para alternar rapidamente entre o método de entrada (IME) padrão e a entrada de voz do Doubao (aplicativo de voz do ByteDance). Enquanto você mantém a tecla Fn pressionada, o sistema muda para o IME do Doubao, permitindo entrada por voz. Ao soltar, retorna ao IME padrão.

Pré-requisitos

• macOS (testado no macOS Ventura/Sonoma e posteriores)
• Hammerspoon instalado
• Doubao (或豆包) instalado e configurado com entrada por voz
• IME padrão configurado (ex.: ABC, Pinyin, Sogou)

Instalação

1. Instale o Hammerspoon via Homebrew ou site oficial:

   brew install --cask hammerspoon
   

2. Copie o conteúdo do script init.lua para ~/.hammerspoon/init.lua (ou adicione ao seu existente).

3. Recarregue a configuração do Hammerspoon:

   • Clique no ícone do Hammerspoon na barra de menu > "Reload Config" ou use o atalho Cmd+Shift+R.

4. Teste mantendo a tecla Fn pressionada — o IME deve mudar para Doubao. Solte para voltar ao IME padrão.

Como Funciona

O script Hammerspoon monitora eventos de teclado para a tecla Fn. Ao pressionar, ele define o layout de entrada atual para o IME do Doubao (identificado pelo nome do aplicativo). Ao soltar, ele restaura o IME padrão. Você pode personalizar os nomes dos IMEs no arquivo init.lua.

Personalização

Edite ~/.hammerspoon/init.lua e altere os seguintes valores conforme necessário:

-- Defina o nome do IME padrão (ex.: "ABC" ou "Pinyin - Simplified")
local defaultIME = "ABC"

-- Defina o nome do IME do Doubao (ex.: "Doubao Voice Input" ou "豆包语音输入")
local doubaoIME = "Doubao Voice Input"

Solução de Problemas

• Fn não funciona: Verifique se o Hammerspoon tem permissão de acessibilidade (Preferências do Sistema > Privacidade e Segurança > Acessibilidade).
• IME não alterna: Verifique os nomes exatos dos IMEs em Preferências do Sistema > Teclado > Fontes de Entrada.
• Conflitos: Desabilite outros atalhos de teclado que usem a tecla Fn.

Licença

MIT