transx

打开可交互 CLI，支持翻译文本、文件或图片。非交互环境输出帮助。

transx help

显示命令、参数和示例。

transx init

设置 DLX API Key。前往 Linux.do Connect 获取。

专属参数

示例

自动化示例：printf '%s' "$DLX_API_KEY" | transx init --key-stdin

transx translate

翻译文本、stdin 或文件。Agent 调用使用 --json。

专属参数

示例

stdin：echo "Hello world" | transx translate --to ZH --json

文件：transx translate --file ./paper.pdf --to ZH --json

图片：transx translate --image ./screenshot.png --to ZH --json

输出：<源文件名>_<目标语言>；PDF 输出 DOCX。文件最多 5 个请求并发执行。

OCR 支持图片、PDF、DOCX、PPTX 和 Markdown；输入 20MB，最多 100 张图片或 100 页 PDF。

transx languages

显示 --source 和 --to 支持的语言代码。

专属参数

语言范围

DLX 接口支持 31 个目标语言代码。

JSON 示例

transx ocr

本地识别图片文字，生成可查看的中间文件，确认后再翻译。

transx ocr enable [--yes]

需要 Python 3.10+，下载约 180 MB。模型为 PP-OCRv6 Quality（RapidOCR + OpenVINO），支持中英日等 50 种语言。

transx ocr status [--json]

查看 OCR 扩展安装状态、模型、引擎、平台和验证结果。

transx ocr recognize <path> [--json]

识别图片、PDF 页面、DOCX/PPTX 内嵌图片或 Markdown 本地图片，不翻译。生成 <源文件名>_OCR.md；JSON 返回 recognition_file 和预览。

transx translate --image 先保存并预览识别结果。仅输入 y/Y 后按文件流程并发翻译；n/N 或 Esc 不发送。

transx ocr remove [--yes]

删除 OCR 扩展，释放磁盘空间。扩展安装在 ~/.transx/features/ocr/，与 CLI 主依赖隔离。

transx history

查看、搜索或清理本地翻译历史。文件记录只保存源文件和译文文件信息。

transx history [list]

按时间倒序查看记录。省略 list 时行为相同，默认显示 20 条。

transx history search <keyword>

不区分英文大小写。文本记录搜索原文和译文，文件记录搜索源文件名和译文文件名。支持与查看命令相同的 --limit、--offset、时间范围和 --json 参数。

transx history status [--json]

显示历史目录、记录数量、文件总量、最早和最新记录，以及是否需要清理。

transx history clear <mode>

存储与时间

记录不限制条数，也不会自动删除。时间统一按中国时间处理，格式为 YYYY-MM-DD HH:mm:ss.SSS，不附带时区标记。运行 transx history help 可在终端查看此命令组帮助。

transx config

查看 URL 模板和完整 API Key，或维护本地配置。

transx config

transx config set-key [--stdin]

transx config reset <target>

示例

环境变量 DLX_API_KEY 会覆盖本地配置，但不会写入配置文件。

transx install

把当前包安装到用户目录并配置 PATH，支持 Windows、macOS 与 Linux。

专属参数

首次安装

要求 Node.js 22+。安装完成后重新打开终端。

查看当前生效路径：Windows 使用 where transx，macOS/Linux 使用 which transx。

transx version

显示当前版本；--check 检查最新版。

专属参数

transx update

更新 TransX CLI。

JSON 与错误码

translate --json：成功写入 stdout，失败写入 stderr。

{
  "ok": true,
  "data": "你好，世界",
  "source_lang": "auto",
  "target_lang": "ZH",
  "provider": "dlx"
}

{
  "ok": false,
  "error": {
    "code": "CONFIG_NOT_INITIALIZED",
    "message": "缺少 DLX API Key，请先运行 transx init"
  }
}

错误码