断网也能翻译！kiss-translator完全离线使用指南

你是否遇到过这样的尴尬：在高铁上想阅读英文文档、在国外旅行时想查看当地网页，却发现没有网络连接？作为一款简约、开源的双语对照翻译扩展与油猴脚本，kiss-translator不仅支持在线翻译，还提供了强大的离线使用能力。本文将带你解锁三种核心离线方案，让你在无网络环境下也能畅享翻译服务。

方案一：浏览器内置AI翻译（零配置即用）

最便捷的离线翻译方式是使用浏览器内置的AI翻译功能。kiss-translator已深度集成Chrome浏览器的BuiltinAI翻译接口，无需额外配置即可在断网时使用。

启用步骤：

1. 打开扩展设置页面（快捷键Alt+O）
2. 在翻译服务选项中选择「Chrome BuiltinAI」
3. 启用「优先使用缓存」选项（位于高级设置）

核心实现代码位于src/config/api.js，该模块定义了内置AI翻译的基础配置。当网络不可用时，系统会自动切换至本地处理模式，利用浏览器内置的AI模型进行翻译。

方案二：Ollama本地大模型部署（高级玩家首选）

对于需要高质量离线翻译的用户，推荐部署Ollama本地大模型。通过自定义接口配置，可将翻译请求完全本地化处理。

部署流程：

1. 安装Ollama并启动服务：

# 启动时允许跨域访问（关键步骤）
OLLAMA_ORIGINS=* ollama serve

2. 在扩展中添加自定义接口：

   • URL: http://localhost:11434/v1/chat/completions
   • 请求Hook代码参考custom-api_v2.md中Ollama配置示例
   • 响应Hook使用内置parseAIRes函数解析结果

3. 测试本地连接：在设置页面点击「测试接口」按钮

关键代码实现位于src/libs/builtinAI.js，该模块处理本地模型的请求分发与响应解析。系统会自动判断网络状态，在离线时将翻译任务路由至本地Ollama服务。

方案三：翻译缓存优化策略（无缝衔接网络切换）

即使没有本地模型，通过优化缓存策略也能显著提升离线体验。系统默认缓存翻译结果，配置得当可满足日常阅读需求。

配置方法：

1. 打开设置页面「高级选项」
2. 调整缓存参数：
   • 缓存超时时间：建议设置为86400秒（24小时）
   • 缓存容量限制：根据需求调整（默认500条）
3. 启用「预缓存常用语言对」选项

缓存机制由src/libs/cache.js实现，核心函数包括：

• putHttpCache: 存储翻译结果到本地缓存
• getHttpCache: 从缓存读取数据
• tryClearCaches: 手动清除过期缓存

缓存工作流程：

sequenceDiagram
    participant 用户
    participant 扩展
    participant 缓存系统
    participant 本地模型
    
    用户->>扩展: 发起翻译请求
    扩展->>扩展: 检查网络状态
    alt 网络可用
        扩展->>缓存系统: 检查缓存
        alt 缓存命中
            缓存系统-->>扩展: 返回缓存结果
        else 未命中
            扩展->>远程API: 请求翻译
            远程API-->>扩展: 返回结果
            扩展->>缓存系统: 存储结果
        end
    else 离线模式
        扩展->>本地模型: 请求翻译
        本地模型-->>扩展: 返回结果
    end
    扩展-->>用户: 显示翻译结果

离线功能最佳实践

日常使用建议：

1. 定期预热缓存：在有网络时浏览常用网站，系统会自动缓存翻译结果
2. 配置快捷键：设置Alt+Shift+O快速切换离线模式（src/libs/shortcut.js）
3. 监控缓存状态：通过「高级设置」中的「缓存统计」查看缓存使用率

常见问题解决：

• 缓存不生效：检查src/libs/cache.js中的DEFAULT_CACHE_TIMEOUT值
• 本地模型无响应：确认Ollama服务状态及src/config/setting.js中的本地接口配置
• 翻译质量下降：尝试更新本地模型或调整src/libs/interpreter.js中的翻译参数

结语

通过本文介绍的三种方案，你可以根据实际需求选择合适的离线翻译策略。从简单的缓存优化到高级的本地模型部署，kiss-translator提供了灵活的离线解决方案。完整项目文档可参考README.md，更多高级技巧欢迎在社区分享。

无论是商务出行还是网络不稳定环境，这些技巧都能确保你始终保持顺畅的翻译体验。现在就打开扩展设置，配置你的专属离线翻译方案吧！