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 版本问题，以及如何验证模型文件是否实际存在（应为数十兆字节，而非 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 开发者提供了完整的构建说明。