media-translation

name	media-translation
description	長文翻譯（Gemini，背景執行）
allowed-tools	mcp__ching-tech-os__run_skill_script
metadata	{"ctos":{"requires_app":"file-manager","mcp_servers":"ching-tech-os","requires":{"env":["GEMINI_API_KEY"]}}}

【長文翻譯（Gemini 背景執行）】

將長文（逐字稿、文章等）翻譯成指定語言。使用 Google Gemini 翻譯，背景執行不阻塞。 翻譯流程為非同步：啟動翻譯 → 查詢進度 → 取得翻譯結果。

可用 scripts：

1. translate — 啟動翻譯（非同步，立即回傳 job ID）

   • run_skill_script(skill="media-translation", script="translate", input='{"source_path":"ctos://...","caller_context":{...}}')
   • source_path：要翻譯的檔案路徑（支援 ctos://、shared:// 格式，限 .md/.txt 純文字）
   • 或 text：直接傳入要翻譯的文字（二擇一）
   • 可選參數： · target_language：目標語言代碼（如 zh-TW、en），預設自動偵測 · model：Gemini 模型（預設 gemini-2.5-flash）
   • 必須附帶 caller_context
   • 限制：檔案 ≤ 2MB，文字 ≤ 500,000 字元

2. check-translation — 查詢翻譯進度（同步）

   • run_skill_script(skill="media-translation", script="check-translation", input='{"job_id":"之前取得的job_id"}')
   • 回傳翻譯狀態（starting/reading/translating/completed/failed）
   • 翻譯中顯示進度（如「3/12」表示第 3 段，共 12 段）
   • 完成時回傳：file_path（絕對路徑，可用 Read 工具讀取）、ctos_path

典型使用流程：

1. 使用者要求翻譯某篇文章或逐字稿