Community생산성 & 협업github.com

heavenchenggong/fn-ime-voice-switch

Claude Code 스킬: macOS에서 Fn 키를 눌러 기본 IME와 Doubao 음성 입력 간 전환을 자동화하는 Hammerspoon 기반 스크립트입니다.

fn-ime-voice-switch란 무엇인가요?

이 스킬은 macOS 사용자가 Fn 키 하나만으로 기본 입력기(IME)와 Doubao 음성 입력 모드를 빠르게 전환할 수 있도록 도와주는 자동화 도구입니다. Hammerspoon을 활용하여 Fn 키를 길게 누르면 Doubao 음성 입력으로 전환되고, 놓으면 원래의 기본 IME로 돌아갑니다. 이는 특히 중국어와 같은 이중 입력 환경에서 음성 입력을 자주 사용하는 개발자나 사용자에게 유용합니다. Claude Code, Cursor, Codex 등 다양한 AI 에이전트 플랫폼에서 사용할 수 있는 스킬로, macOS의 접근성 권한만 설정하면 간단히 사용할 수 있습니다.

지원 대상✓Claude Code~Codex CLI~Cursor
npx skills add heavenchenggong/fn-ime-voice-switch

Installed? Explore more 생산성 & 협업 skills: steipete/gemini, steipete/gh-issues, steipete/skill-creator · View all 6 →

즐겨 사용하는 AI에게 물어보기

이 에이전트 스킬이 미리 로드된 새 채팅을 엽니다.

문서

fn-ime-voice-switch은(는) 무엇을 하나요?

Claude Code 스킬: macOS Fn 키를 사용하여 기본 IME와 Doubao 음성 입력 간 전환을 자동화하는 Hammerspoon 기반 도구입니다. Fn 키를 길게 누르면 Doubao 음성 입력으로 전환되고, 놓으면 기본 IME로 되돌아갑니다.

기능

  • Fn 키를 누르고 있는 동안 Doubao 음성 입력 모드 활성화
  • Fn 키를 놓으면 시스템 기본 IME로 자동 복귀
  • Hammerspoon 기반으로 간단한 Lua 스크립트로 구현
  • macOS 접근성 권한만 설정하면 바로 사용 가능

설치 방법

  1. Hammerspoon 설치
  2. Hammerspoon 설정 파일(~/.hammerspoon/init.lua)에 다음 내용 추가:
hs.hotkey.bind({}, 'fn', nil, function()
  -- Doubao 음성 입력으로 전환 (예: 중국어 IME)
  hs.keycodes.currentSourceID('com.apple.inputmethod.SCIM')  -- 필요에 따라 변경
end, function()
  -- 기본 IME로 복귀 (예: 영어)
  hs.keycodes.currentSourceID('com.apple.keylayout.ABC')
end)
  1. Hammerspoon 재시작 및 macOS 접근성 권한 부여

사용 방법

  • Fn 키를 길게 누르면 Doubao 음성 입력 모드가 활성화됩니다.
  • Fn 키를 놓으면 자동으로 기본 IME로 전환됩니다.

참고 사항

  • 이 스킬은 Doubao 앱이 설치되어 있고, macOS 시스템 설정에서 음성 입력이 활성화되어 있어야 합니다.
  • IME 소스 ID는 시스템 환경에 따라 다를 수 있으므로 hs.keycodes.currentSourceID()로 확인 후 설정하세요.

라이선스

MIT

관련 스킬