用途:为楚克语(Chuukese,密克罗尼西亚楚克州语言)翻译辅助、词典扩充和文本生成提供基于 Ollama 的本地大模型集成,并支持规则/词典方法与语言模型结合的混合翻译流程。
主要能力:项目包含 translation 目录下的 ollama_client.py(Ollama API 客户端)、hybrid_translator.py(混合翻译器)与 helsinki_translator_v2.py;ollama-modelfile 目录提供 chuukese-translator.modelfile 自定义模型;另有 Dockerfile.ollama 与 ollama-entrypoint.sh。OllamaClient 支持检查服务可用性、列出模型、文本生成、聊天补全和文本嵌入。Modelfile 以 llama3.2 为基础,设置 temperature、top_p、num_ctx 和停止标记,并通过 SYSTEM 提示词定义楚克语翻译专家角色与输出格式。HybridTranslator 支持 dictionary、helsinki、llm、hybrid、auto 五种策略,按词数自动选择,并可让 LLM 对 Helsinki 结果进行润色。
使用方式:需先本地运行 Ollama 服务(默认 http://localhost:11434)。创建自定义模型可执行:ollama create chuukese-translator -f ollama-modelfile/chuukese-translator.modelfile;测试可执行:ollama run chuukese-translator "Translate to English: Ewe Kot a kamour Adamu.";可用 ollama list 查看模型。生成失败、模型不可用或嵌入失败时客户端返回空值。
适用场景与限制:适用于楚克语与英语互译、词典条目释义补全和翻译结果复核。依赖 Ollama 服务、本地模型和词典数据库;资料未提供安装步骤、依赖版本、许可证、性能数据与平台支持范围,使用前需自行确认环境。