transx

打开交互界面，可翻译文本或文件。非交互环境输出帮助。

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

输出：<源文件名>_<目标语言>；PDF 输出 DOCX。

限制：文件 20MB，可翻译文本 100000 字符，最多 500 次请求。

transx languages

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

专属参数

语言范围

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

JSON 示例

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。安装完成后重新打开终端。

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"
  }
}

错误码