CLI 选项参考

用法

yaku [flags] [text]

文字可以通过位置参数、-f（文件）或管道从 stdin 提供。详见输入与输出。

选项	类型	默认值	说明
`--to`	`string`	配置中的 `default-target`	必填。目标语言代码（例如 `zh-CN`、`ja`、`en`）。
`--from`	`string`	自动检测	源语言代码。省略可让 LLM 自动检测。
`--mode`	`string`	`translate`	`translate` — 翻译成目标语言。`polish` — 润色已经是目标语言的文字。详见润色模式。
`--context`	`string`		给 LLM 的领域提示（例如 `"Kubernetes 文档"`、`"正式信件"`）。帮助解决模糊的用词。

选项	简写	类型	默认值	说明
`--file`	`-f`	`string[]`		输入文件路径。重复指定可处理多个文件：`-f a.md -f b.md`。
`--output`	`-o`	`string`	stdout	将翻译结果写入文件而非 stdout。
`--format`		`string`	自动检测	强制指定输入格式：`text`、`md`、`json`、`yaml`。省略时根据 `-f` 的扩展名自动检测。

选项	类型	默认值	说明
`--backend`	`string`	`hosted`	LLM 后端：`hosted`、`gemini`、`openai`、`anthropic`。详见后端。
`--model`	`string`	`backend` 默认值	覆盖模型名称（例如 `gemini-2.5-flash`、`gpt-4o`、`claude-sonnet-4-5-20250514`）。
`--api-base`	`string`		任何本地后端的 API base URL 覆盖。常用于 OpenAI 兼容提供商（例如 `https://api.groq.com/openai/v1`）。

选项	类型	默认值	说明
`--glossary`	`string`	自动检测	术语表 YAML 文件路径。覆盖自动检测。详见术语表。
`--no-glossary`	`bool`	`false`	完全跳过术语表加载，即使默认位置存在术语表文件。

选项	类型	默认值	说明
`--prompt`	`string`	内置	自定义系统提示词文件路径。完全替换内置提示词。详见自定义提示词。

选项	类型	默认值	说明
`--verbose`	`bool`	`false`	翻译完成后在 stderr 打印模型名称、token 数和耗时。

--verbose 输出示例（显示在 stderr）：

Model: gemini-2.5-flash | Tokens: 42 in / 38 out | Time: 1.2s

管理位于 ~/.config/yaku/config.yaml 的配置文件。

详见配置了解所有可用的键。

通过浏览器设备授权流程与托管服务认证。会打开浏览器并预填授权码——只需登录并点击批准。凭据存储在 ~/.config/yaku/.credentials。

yaku login
# 打开浏览器完成认证

撤销服务器上的会话并删除本地凭据。如果服务器无法连接，凭据会保留以便重试。

yaku logout

# 即使服务器撤销失败也强制删除本地凭据
yaku logout --force

选项	说明
`--force`	无论服务器是否确认撤销，都删除本地凭据。会话可能在服务器上保持有效，直到过期。

向托管服务查询当前的认证状态。

yaku whoami
# 以 Jane Doe（[email protected], github）的身份登录

如果未登录：

Not logged in (using anonymous quota)

如果会话已过期或无效：

Session expired or invalid. Run yaku login to re-authenticate.

如果服务器无法连接：

hosted service unreachable. Check your network connection

显示你当前的托管服务使用配额。显示方案等级、每日与每月请求次数，以及每次请求的字符上限。使用自备 API 后端时，会报告无配额限制。

详见托管服务与方案了解方案等级和限制。

打印 CLI 版本。

yaku version
# yaku v0.1.0