azooKey/azooKey-Desktop

azooKey‑Desktop – macOS 用日語輸入法

是什麼

• 一個開源的 macOS 日語輸入法（輸入法編輯器），以名為 Zenzai 的神經網路模型取代系統原有的假名-漢字轉換。專案還內建可選的基於大語言模型（LLM）的「智慧轉換」，並整合至 Tuner 個人優化服務。

為何重要

• 傳統日語輸入法依賴規則驅動的詞典。azooKey‑Desktop 改用現代神經網路（gguf 格式），能從您的輸入歷史、自訂詞典與設定提示中學習，提供更高精度的轉換。
• 專案透過 Git LFS 提供模型權重，因此 AI 核心元件直接包含在原始碼中，而非獨立下載。

主要功能（如 README 所列）

• Zenzai 神經轉換 – 高精度假名-漢字轉換。
  • 支援設定提示。
  • 歷史學習（適應您的使用習慣）。
  • 使用者詞典。
  • 與個人優化系統 Tuner 整合。
• LLM 輔助「順暢感」轉換 – 可選的大語言模型步驟，可建議更自然的表達方式。
• 即時轉換 – 輸入時結果即時顯示。
• 原生 AZIK 支援 – 兼容 AZIK 鍵盤佈局。

如何取得（終端使用者）

1. 發布套件 – 從 Releases 頁面下載 .pkg 並安裝。
2. 登出 macOS 並重新登入。
3. 開啟 系統設定 → 鍵盤 → 輸入來源，點選 +，選擇 日本語 → azooKey，並確認。
4. 從選單列圖示中選擇 azooKey。

替代方案： brew install azooKey（Homebrew）。安裝後仍需登出/登入並新增輸入來源。

從原始碼建置（開發者）

• 前置條件
  • macOS 15+（已在 15 上測試，14/26 也可運作但未驗證）
  • Xcode 26.1+（未加入 Apple Developer Program 也可使用個人團隊簽署）
  • Git LFS（用於拉取模型檔案，必需）
  • SwiftLint（程式碼風格檢查）
• 克隆帶子模組和 LFS

  git lfs install
  git clone https://github.com/azooKey/azooKey-Desktop --recursive
  cd azooKey-Desktop
  # 若已克隆但未包含 LFS/子模組：
  git submodule update --init
  git -C azooKeyMac/Resources/zenz-v3.1-small-gguf lfs pull
  git -C azooKeyMac/Resources/base_n5_lm lfs pull
  

• 設定簽署 – 開啟 azooKeyMac.xcodeproj，將 Team 改為您的個人團隊，並將套件識別碼（dev.ensan…）替換為您擁有的識別碼。
• 建置與安裝

  ./install.sh   # 與 .pkg 安裝器產生相同結果
  

  腳本完成後，重複上述登出/輸入來源步驟。
• 故障排除 – README 列出常見簽署錯誤、Xcode 版本問題，以及如何驗證模型檔案是否實際存在（應為數十 MB，而非 134 位元組的 LFS 指標）。

社群與擴充

• 支援與貢獻用 Discord 伺服器：https://discord.gg/dY9gHuyZN5
• 其他平台的分支：
  • fcitx5‑hazkey – Linux 客戶端。
  • azooKey‑Windows – Windows 客戶端。
  • azoo‑key‑skkserv – SKK 伺服器實作。

資助

• 專案接受 GitHub Sponsors 贊助。
• 受日本 IPA Mito‑IT 人才培育計畫（2024）支援。

總結 azooKey‑Desktop 是一個真正的 AI 增強型軟體專案：它內建用於日語輸入的神經語言模型，提供可選的 LLM 基礎優化，並為希望貢獻或自訂輸入法的 macOS 開發者提供完整的建置說明。