命令行翻译工具的配置与使用指南，支持多提供商、TOML配置、模板自定义及批量文件处理。
说明：
## 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 配置、环境变量、命令行参数的优先级规则需仔细管理，避免预期外行为
会员专属
