开源引擎部署方案（L2 层）

L2 层两个候选都是开源免费、可本机离线运行。本页只做方案对比与步骤说明，全部安装动作待老板批准（PENDING）。

Argos Translate vs LibreTranslate 对比

对比项	Argos Translate	LibreTranslate
是什么	Python 翻译库，离线跑，pip 安装	自托管翻译 API 服务（底层也用 Argos 模型），REST 接口
安装方式	pip install argostranslate + 导入 .argosmodel 模型包	pip install libretranslate 或 Docker，启动后监听本机端口（如 :5000）
体积 / 模型大小	本体约几十 MB；每个语言对模型约 100–300 MB（估算），按需下载	同左（复用 Argos 模型）；Docker 镜像另需约 1–2 GB（估算）
离线	✅ 模型下载后完全离线	✅ 完全离线（本机服务）
质量预期	通用短句良好；印尼语中等；行业词必须靠 L1 词库保护	同 Argos（同模型）；多了 HTTP API 方便各模块调用
适合场景	后端脚本、批处理、队列 worker 直接 import 调用	多模块共用一个翻译 HTTP 服务（商城/客服/工单都调它）
我们需要的语言对	zh↔en、en↔id 有现成模型；zh↔id 没有直翻模型，走英语中转（zh→en→id），质量损失靠 L1 词库后处理补回来。

第 1 步 · 下载模型（在有网的电脑） PENDING · 待老板批准

下载 zh↔en、en↔id 的 .argosmodel 模型包（每个约 100–300 MB，估算），存到仓库 runtime/translate-models/ 目录留档。

PENDING · 待老板批准

第 2 步 · 离线安装 Argos PENDING · 待老板批准

pip install argostranslate；然后 argospm install 指向本地 .argosmodel 文件，不依赖网络。

PENDING · 待老板批准

第 3 步 · 起 LibreTranslate 本机服务 PENDING · 待老板批准

pip install libretranslate，仅监听 127.0.0.1，不对外；用同一份模型目录，给商城/客服/工单模块提供统一翻译 API。

PENDING · 待老板批准

第 4 步 · 与 L1 词库联调验收 PENDING · 待老板批准

跑 100 句真实业务句（报价/物流/税务），术语准确率必须 100%（L1 保护），整句可读性人工抽检后给老板过目。

PENDING · 待老板批准

服务器若断网：在有网电脑下好模型 → U 盘/内网拷贝到服务器 → 本地安装，全程不需要服务器联网。模型包与安装脚本一起入备份体系。

① 译前保护：先把 L1 命中的行业词替换成占位符（如 __TERM_17__），防止引擎翻错行话。

② 引擎翻译：L2 只翻占位符之外的普通句子。

③ 译后还原：把占位符换回目标语言的标准行业词（来自 L1 词库），保证术语 100% 正确。

⚠ 每一步动工前再次请示老板