translate-cli 综合评估
核心用法
translate-cli 是一款面向开发者的命令行翻译工具，支持文本、标准输入、单文件、多文件（glob）以及 .xcstrings 目录等多种输入形式。核心命令结构遵循"选项在前、输入在后"的原则，例如 translate --to de README.md。工具内置多提供商支持（OpenAI、Anthropic、Ollama、OpenAI-compatible、Apple、DeepL），用户可通过 --provider 切换或通过 translate config set defaults.provider 持久化配置。
配置系统采用 TOML 格式，通过 translate config 子命令管理，支持设置默认提供商、网络参数、流式输出偏好等。高级功能包括：prompt presets（预置提示模板）、自定义模板（支持 @file 加载和占位符系统）、并行任务控制、dry-run 验证模式。输出行为灵活，支持 stdout、--output 指定路径、--in-place 原地修改或自动后缀命名。
显著优点
- 多输入源兼容：从单行文本到批量文件翻译，覆盖开发者常见场景
- 提供商生态丰富：既支持商业 API（OpenAI、Anthropic、DeepL），也支持本地 Ollama 部署
- 配置持久化：TOML 配置文件 + 子命令管理，避免重复输入长参数
- 模板可扩展：presets 系统允许自定义翻译风格，支持占位符实现动态提示
- 开发者友好：dry-run 模式验证命令、流式输出可选、明确的退出码设计
潜在缺点与局限性
- 依赖外部 API：需要自行管理多平台的 API key 和计费，配置复杂度随提供商数量增加
- 本地部署门槛：Ollama 等本地方案需额外环境准备，对非技术用户不友好
- 模板学习成本：自定义 prompt 模板需理解占位符语法，高级功能文档分散于多个引用文件
- 无图形界面：纯 CLI 工具，不适合需要可视化交互的场景
- 网络稳定性敏感：批量文件翻译时，任一请求失败可能影响整体工作流
适合人群
- 需要批量处理本地化文件的开发者/技术写作者
- 偏好命令行工作流、寻求翻译自动化集成的 DevOps 工程师
- 已使用特定 AI 提供商（OpenAI/Anthropic）并希望统一翻译工具链的团队
- 需要自定义翻译风格（如技术文档专用术语表）的高级用户
常规风险
- 凭证泄露风险：API key 可能出现在 shell history、环境变量或配置文件中，需配合
translate config安全存储 - 成本失控：批量翻译大文件或未设置
--dry-run验证时，可能产生意外 API 费用 - 数据隐私：敏感代码或文档上传至第三方 API 存在合规风险，建议敏感场景优先使用 Ollama 本地部署
- 翻译质量波动：依赖 LLM 的翻译结果可能存在术语不一致，需配合 presets 预设模板约束输出风格
- 配置覆盖混乱：TOML 配置、环境变量、命令行参数的优先级规则需仔细管理，避免预期外行为