Files
AutoZhuyin/README.md
T
ays953andClaude Opus 5.5 e0eecc1eb5 Add Windows version on PIME
Port the core (Zhuyin parser, classifier, converter, composition engine) to
Python as a PIME input method, with the same test cases as the Swift version
plus wrapper tests against stand-in PIME modules. scripts/package-windows.sh
builds a zip with install/uninstall scripts and a README for testers.

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
2026-11-10 14:31:42 +08:00

3.8 KiB
Raw Blame History

自動注音 AutoZhuyin

macOS 繁體中文輸入法:不用按切換鍵,直接用大千注音鍵盤打字,輸入法會自動判斷你打的是注音還是英文。

按鍵: ji3 hello world su3cl3␣
輸出: 我hello world 你好

運作方式

每按一個鍵,Classifier 會同時用兩種解讀幫目前的按鍵序列打分:

注音分數 英文分數
是否能拆成合法注音音節(SyllableTable) 是否為常用英文字(english-common.txt)
每個音節有沒有聲調鍵(3 4 6 7 空白) 是否在系統字典 /usr/share/dict/words
讀音是否存在於詞庫 字母 bigram 模型判斷「像不像英文」
前一段是中文 → 加分(語境) 前一段是英文 → 加分(語境)
使用者過去的修正(學習) 有大寫字母 → 一定是英文

分數高的一方勝出。組字區即時顯示結果(英文以藍字顯示)。

按鍵

按鍵 作用
空白 注音:一聲;音節已完成時送出中文。英文:送出單字加空白
Enter 送出目前組字
Tab 判斷錯了?按 Tab 在中/英之間翻轉,輸入法會記住這次修正
↓ 開啟候選字(選最後一個字或詞),數字鍵 1–9 選字
Esc 取消組字
Shift + 字母 強制英文
< > ? ! : 中文語境下自動轉成全形 ,。?!:

建置與安裝

需要 Xcode(使用 /Applications/Xcode.app 的工具鏈)。

swift test                # 執行單元測試(需 DEVELOPER_DIR 指向 Xcode)
scripts/build.sh          # 產生 build/AutoZhuyin.app
scripts/install.sh        # 安裝到 ~/Library/Input Methods 並重啟輸入法

第一次安裝後:系統設定 → 鍵盤 → 文字輸入 → 編輯… → + → 繁體中文 → 自動注音。 如果清單裡沒出現,登出再登入一次。

詞庫

Resources/lexicon.txt 由開源的小麥注音原始資料轉換而來(MIT 授權,約 17 萬筆), 後面再接上手寫的入門詞庫 Resources/lexicon-seed.txt。轉換只讀取資料檔,不執行小麥注音的程式碼。 要更新到小麥注音最新資料:

scripts/import-mcbopomofo.sh
scripts/install.sh

自訂詞:~/Library/Application Support/AutoZhuyin/user-phrases.txt,格式同 lexicon.txt: ㄗˋ-ㄉㄨㄥˋ-ㄓㄨˋ-ㄧㄣ 自動注音 -4

專案結構

Sources/AutoZhuyinCore/     純邏輯,可單元測試
  Bopomofo.swift            大千鍵盤對應、音節結構
  SyllableTable.swift       合法注音音節表
  ZhuyinParser.swift        按鍵 → 音節
  Lexicon.swift             詞庫
  Converter.swift           音節 → 中文(Viterbi)
  EnglishModel.swift        英文判斷
  Classifier.swift          中英判斷 + 學習
  CompositionEngine.swift   輸入法狀態機
Sources/AutoZhuyin/         InputMethodKit 外殼
Tests/                      單元測試

下一步(Roadmap)

  • 匯入完整詞庫,並用真實打字資料調整判斷權重
  • 已送出的英文單字若判斷錯誤,可以「事後翻轉」
  • 用 Core ML 小模型取代手調分數,參考整句語境
  • 使用者詞頻學習(選過的候選字優先)
  • 偏好設定視窗

Windows 版

windows/ 是給 Windows 用的版本,建立在開源輸入法框架 PIME 上。 核心邏輯用 Python 重寫(windows/autozhuyin/core/),行為和測試案例都跟 Mac 版一樣;詞庫共用 Resources/。

scripts/package-windows.sh   # 產生 build/AutoZhuyin-Windows-<版本>.zip(會先跑測試)

zip 裡附有 install.bat、uninstall.bat 和給測試者看的 README.txt。使用者需要先安裝 PIME。 修改核心邏輯時,Swift(Sources/AutoZhuyinCore/)和 Python(windows/autozhuyin/core/)兩邊都要改。