eggplants/deepl-cli

deepl‑cli – DeepL 翻译器的命令行封装工具

是什么 – 一个微小的 Python 包，让你无需付费的 DeepL API 密钥即可从终端（或从 Python 代码）调用 DeepL Web 翻译器。它通过 Playwright 驱动 DeepL 网站，提取翻译结果并将其打印回给你。

为什么重要 – 翻译是许多 AI 驱动工作流中的常见下游任务（例如：本地化文档、预处理多语言语料库或构建快速查询工具）。拥有一个零配置的 CLI 意味着你可以在 Shell 或 CI 流水线中编写翻译脚本，而无需注册 API。

如何获取 – 从 PyPI 安装：

pip install deepl-cli

该包会引入 playwright，并在首次运行时自动下载所需的浏览器二进制文件。

典型的命令行用法

# 将短字符串从英语翻译为日语
$ deepl -F en -T ja -s <<< 'This tool is useful for me.'
このツールは私にとって役に立ちます。

# 从文件读取并翻译
$ deepl -f mytext.txt -F en -T fr

关键标志：

• -F / --fr – 源语言（或使用 auto 让 DeepL 自动检测）。
• -T / --to – 目标语言（支持许多 ISO 风格的代码）。
• -s – 从 stdin 读取源文本。
• -f – 翻译文件的内容。
• --no-headless – 显示浏览器窗口（调试时很有用）。
• -t – 超时时间（毫秒）。

Python API – 如果你更喜欢在脚本中嵌入翻译：

from deepl import DeepLCLI

translator = DeepLCLI('en', 'ja')
print(translator.translate('hello'))   # → こんにちは

同时也为 asyncio 代码提供了异步变体 (translate_async)（参见 examples/async.py）。

局限性 – 由于它是通过爬取 DeepL 公共网站实现的，因此它受到与人类用户相同的速率限制和使用政策。对于重度或商业工作负载，你应该切换到官方的 DeepL API（README 指向了 deepl-python）。

许可证 – MIT，因此你可以自由地修改或将其嵌入到其他工具中。