Karukan macOS开发版更新指南make install killall的正确姿势【免费下载链接】karukanJapanese Input Method System for Linux, macOS, Neural Kana-Kanji Conversion Engine项目地址: https://gitcode.com/GitHub_Trending/ka/karukanKarukan 是一款面向 Linux 与 macOS 的开源日语输入法内置基于 llama.cpp 的神经网络假名汉字转换引擎支持实时转换、上下文理解与转换学习。对于每天跟踪源码迭代的 macOS 用户来说把最新版开发版装进系统只需一条make install——但装完不生效的坑多半出在killall这一步。本文将完整讲清两者的正确姿势。先看懂 make install 到底做了什么macOS 端由 Swift 前端InputMethodKit Rust 引擎karukan-imserver组成Makefile 中的install目标实际串联了 5 个动作install: bundle install-dict install-models rm -rf $(INSTALL_DIR)/Karukan.app cp -a $(APP) $(INSTALL_DIR)/ -killall KarukanIME 2/dev/null || true对应到源码 Makefile#L73-L78执行流程为buildswift build -c release编译前端cargo build --release编译 Rust 引擎见 Makefile#L13-L15bundle把两份二进制、Info.plist 和资源文件组装成Karukan.app并做 ad-hoc 签名install-dict若系统词典~/Library/Application Support/com.karukan.karukan-im/dict.bin不存在自动下载预构建词典离线失败不致命install-models把 models.toml 中定义的转换模型预取到 HuggingFace 缓存避免首次启动长时间等待下载落地 重启整包替换~/Library/Input Methods/Karukan.app并顺手killall KarukanIME让改动即刻生效。 词典与模型下载失败都不会中断安装引擎会在首次启动时后台补下期间假名输入和词典转换照常可用。开发版更新两条命令的标准姿势第二次及以后的更新完全不需要注销系统在karukan-im/macos目录下执行make install killall KarukanIME # 下次聚焦文本框时自动重启原理在于 Swift 前端对引擎进程有指数退避自动重启机制EngineProcess.swift 中karukan-imserver退出后按2^n秒上限 15 秒延迟拉起而 IME 前端本身被killall杀死后macOS 在你下次点击文本框聚焦时会自动重新拉起它。因此杀掉即更新无需任何额外操作。首次安装为什么必须注销再登录make install结尾会自动打印提示Makefile#L78First install: log out and back in, then add Karukan in System Settings Keyboard Input Sources.首次安装后 macOS 不会立刻识别新输入法必须注销 → 重新登录然后打开「系统设置 → 键盘 → 输入来源」点击「」选择「日语」→ 添加Karukan从菜单栏输入菜单切换即可使用。⚠️ 记住这个区别首装必须注销更新只需killall——这是新手最常混淆的一点。killall 之外的隐藏坑macOS 缓存的元数据代码二进制更新靠killall KarukanIME即可但菜单图标、输入模式名称、Info.plist 中的模式定义属于 macOS 侧缓存的元数据杀进程未必能刷新。按 macOS README 推荐的递进方案处理# 刷新输入菜单图标/名称缓存引擎会自动重启无需再次 killall KarukanIME killall TextInputMenuAgent仍不生效 → 系统设置中将 Karukan 输入源删除后重新添加终极手段 → 注销并重新登录。顺手收藏调试与数据文件位置用途路径运行日志Swift Rust 双侧~/Library/Logs/KarukanIME/karukan-ime.log配置文件~/Library/Application Support/com.karukan.karukan-im/config.toml系统词典 / 用户词典.../dict.bin、.../user_dicts/学习数据.../learning.tsv键盘操作见 docs/key-bindings.md全部配置项见 docs/configuration.md词典机制见 docs/dictionary.md。小结首装make install→ 注销重登 → 输入源中添加 Karukan日常更新make installkillall KarukanIME两条命令聚焦文本框即自动重启生效图标/名称不刷新加一道killall TextInputMenuAgent不行就删除重加输入源词典与模型下载失败不阻塞安装后台会自动补下。掌握这套姿势你就能在 macOS 上丝滑地跟进 Karukan 日语输入法的每一次开发版迭代。【免费下载链接】karukanJapanese Input Method System for Linux, macOS, Neural Kana-Kanji Conversion Engine项目地址: https://gitcode.com/GitHub_Trending/ka/karukan创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考