常見問題

什麼是 yaku？

yaku（訳，日文「翻譯」的意思）是一個 CLI 工具，讓你在終端機中翻譯文字、檔案和開發產物。它從 stdin、檔案或參數讀取輸入，並將翻譯結果寫到 stdout——就像 jq 或 sed，但用於自然語言。

yaku 和其他翻譯工具有什麼不同？

詳見為什麼選擇 yaku？，有與 Google 翻譯、通用 AI CLI（llm、sgpt、aichat）和 Translate Shell 的詳細比較。

yaku 免費嗎？

CLI 是開源的（BSD 3-Clause 授權），可以用你自己的 API key 免費使用。api.yakulang.com 上的託管服務不需任何設定即可使用，並包含免費方案。詳見託管服務與方案了解方案等級和配額限制。

yaku 支援哪些 LLM？

四種後端：

後端	預設模型	使用方式
託管（api.yakulang.com）	伺服器端	預設——不需任何設定
Google Gemini	gemini-2.5-flash	yaku config set backend gemini
OpenAI	gpt-4o-mini	yaku config set backend openai
Anthropic	claude-haiku-4-5-20251001	yaku config set backend anthropic

OpenAI 後端也適用於任何 OpenAI 相容 API（Groq、Together.ai、DeepSeek、Ollama）。詳見後端。

yaku 支援哪些語言？

你所選的 LLM 後端能翻譯的任何語言。yaku 不維護固定的語言清單——它直接將語言代碼傳給模型。詳見語言。

yaku 會儲存我的文字嗎？

自備 API 後端（Gemini、OpenAI、Anthropic）： yaku 將你的文字直接傳送至 LLM API 並回傳結果。yaku 本身不會儲存任何內容。請查閱你的 LLM 提供者的隱私政策了解其資料處理方式。

託管後端： 你的文字會傳送至 api.yakulang.com 進行翻譯。託管服務在回傳回應後不會保留你的文字。

yaku 可以離線使用嗎？

可以，透過 OpenAI 相容後端搭配本機模型。例如使用 Ollama：

yaku --backend openai \
  --api-base http://localhost:11434/v1 \
  --model llama3 \
  --to zh-TW "Bonjour"

詳見後端——OpenAI 相容提供者。

如何確保術語翻譯一致？

使用術語表檔案。在專案根目錄建立 .yaku-glossary.yaml：

zh-TW:
  Kubernetes: ~     # 保留英文
  container: 容器   # 固定翻譯為此

yaku 會自動載入並將這些詞彙注入每次翻譯的提示詞中。

可以使用自己的 LLM 提示詞嗎？

可以，使用自備 API 後端時。--prompt 選項會完全取代 yaku 的內建系統提示詞：

yaku --to zh-TW --prompt my-prompt.txt -f docs.en.md

自訂提示詞僅適用於自備 API 後端（Gemini、OpenAI、Anthropic）。託管後端使用伺服器端提示詞，會忽略 --prompt。詳見自訂提示詞。

如何回報 bug？

開一個 issue，附上你的 yaku 版本（yaku version）、你執行的指令和錯誤訊息。