ARTICLE DETAIL

资讯详情

深耕郑州网站建设与运营推广的一线实战洞察。

Karukan日文输入法仓库结构导览:4个Rust crate + 1个Swift包快速上手

Karukan日文输入法仓库结构导览:4个Rust crate + 1个Swift包快速上手 Karukan日文输入法仓库结构导览4个Rust crate 1个Swift包快速上手【免费下载链接】karukanJapanese Input Method System for Linux, macOS, Neural Kana-Kanji Conversion Engine项目地址: https://gitcode.com/GitHub_Trending/ka/karukanKarukan 是一款面向Linux 和 macOS 的日文输入法系统内置基于 llama.cpp 的神经 kana-kanji假名转汉字转换引擎。整个仓库由4 个 Rust crate 1 个 Swift 包组成结构清晰、职责分明。本文带你快速看懂 Karukan 日文输入法的仓库结构无论新手还是进阶用户都能快速上手。上图是 Karukan 日文输入法在编辑器中实时将罗马字转换为汉字的实际效果演示。仓库结构一览一张表看懂 Karukan 项目打开仓库根目录你会发现顶层只有三大块目录 若干文档非常清爽目录/文件作用类型karukan-engine/核心转换引擎罗马字→平假名、神经网络汉字转换、字典、学习缓存Rust cratekarukan-im/core/IME 本体状态机、输入处理、macOS 用的 JSON-RPC 服务器Rust cratekarukan-im/fcitx5/Linux 前端fcitx5 插件 C FFI 桥接Rust crate C 插件karukan-im/macos/macOS 前端Swift/InputMethodKit 输入法Swift 包karukan-cli/CLI 工具集字典构建、词典查看器、HTTP 服务器、基准测试Rust cratedocs/用户文档键位、配置、字典、分块等文档所有 Rust 代码通过根目录的 Cargo.toml 组织成一个Cargo workspace一条命令即可构建全部 cratecargo build --release仓库还有一份 CLAUDE.md相当于官方给开发者准备的架构说明书包含每个模块的职责和构建命令强烈推荐先读它。第一步获取 Karukan 仓库git clone https://gitcode.com/GitHub_Trending/ka/karukan要求Rust 1.92workspace 使用 2024 edition。macOS 前端还需要 Xcode/Swift 工具链Linux 前端还需要 cmake、gcc、clang 等 C/C 构建工具详见 karukan-im/fcitx5/README.md。核心大脑karukan-engineRust crate 1/4karukan-engine/ 是整个 Karukan 日文输入法的智力中枢关键源码都在 karukan-engine/src/ 下romaji/— 罗马字→平假名转换内部用 Trie 200 多条规则驱动kanji/— 通过 llama.cpp 加载 GGUF 小模型GPT-2 / Qwen3 底座实现上下文感知的神经假名转汉字dict.rs— 双数组 Trie 系统字典支持高速精确/前缀匹配learning.rs— 学习缓存记住你选过的转换结果下次优先展示✨rewriter/— 候选改写器从 Mozc 移植自动生成半角片假名、全角/半角、数字多种写法等变体模型清单定义在 karukan-engine/models.toml首次运行时会自动从 Hugging Face 后台下载下载期间假名输入和字典转换照常可用加载完成后神经转换自动生效。IME 本体karukan-im coreRust crate 2/4karukan-im/core/ 是输入法运行时核心是一个Empty → Composing → Conversion的状态机core/engine/ — 引擎主逻辑输入处理、实时转换、分块chunk策略、LRU 转换缓存server/ —karukan-imserver基于 stdio 的 JSON-RPC 2.0 服务器专门给 macOS 前端当引擎子进程config/settings.rs — 读取用户配置config.tomlLinux 前端karukan-fcitx5Rust crate 3/4karukan-im/fcitx5/ 让 Karukan 日文输入法以插件形式运行在 fcitx5 框架上src/ffi/ — Rust 侧 C FFI 层把karukan-im引擎包装成 C APIinclude/karukan.h — 暴露给 C 插件的 C 头文件fcitx5-addon/ — C 编写的 fcitx5 插件本体用 CMake 构建安装安装只需三步系统级安装cd karukan-im/fcitx5/fcitx5-addon cmake -B build -DCMAKE_INSTALL_PREFIX/usr cmake --build build -j sudo cmake --install buildmacOS 前端Swift 包唯一非 Rust 组件karukan-im/macos/ 是一个标准的 Swift Package定义见 Package.swift采用服务器-客户端架构Swift 端只负责与 InputMethodKit 对接翻译键盘事件、渲染预编辑和候选窗口所有 IME 状态都跑在 Rust 的karukan-imserver子进程里通过 JSON-RPC 通信关键文件KarukanInputController.swift — IMK 输入控制器EngineProcess.swift — 引擎子进程生命周期管理崩溃自动重启EngineProtocol.swift — 与 Rust 侧 protocol.rs 一一对应的协议镜像开发安装只需cd karukan-im/macos make install # 构建 打包 Karukan.app 安装到 ~/Library/Input Methods工具层karukan-cliRust crate 4/4karukan-cli/ 是面向开发者的工具箱提供 4 个二进制二进制用途karukan-dict从 JSON/Mozc TSV 构建二进制字典 Web/CLI 词典查看器sudachi-dict从 Sudachi 字典 CSV 生成带评分的 JSON 字典karukan-server假名汉字转换 HTTP 服务器带 Web UIajimee-benchAJIMEE-Bench 精度评测工具构建并运行服务器体验在线转换cargo run --release --bin karukan-server新手上手路线与延伸阅读推荐的上手顺序读 README.md 了解项目全貌读 CLAUDE.md 掌握架构与构建命令跑通测试cargo test --workspace按需深入Linux 用户看 karukan-im/fcitx5/README.mdmacOS 用户看 karukan-im/macos/README.md用户向文档日常使用最常用键位绑定docs/key-bindings.md配置项docs/configuration.md字典说明docs/dictionary.md用户字典docs/user-dictionary.md分块机制docs/chunking.md符号与全角半角docs/symbols.md一句话总结引擎在karukan-engine/运行在karukan-im/平台差异被封在各前端里工具都在karukan-cli/——掌握这个分层你就能快速定位 Karukan 日文输入法的任何功能代码。【免费下载链接】karukanJapanese Input Method System for Linux, macOS, Neural Kana-Kanji Conversion Engine项目地址: https://gitcode.com/GitHub_Trending/ka/karukan创作声明:本文部分内容由AI辅助生成(AIGC),仅供参考
返回列表