JSON 檔案翻譯助手

翻譯 JSON 檔案中的指定欄位（預設為 description），支援多種語言互譯，並保持原始 JSON 結構完整。

核心功能

• 智慧欄位識別：自動查詢 JSON 中的目標欄位（預設 description），支援自定義指定多個欄位
• 多語言支援：支援中文、英文、日文、韓文四種語言的互譯
• 真實翻譯 API：整合 MyMemory 和 LibreTranslate 兩個線上翻譯服務
• 進度反饋：顯示翻譯進度和當前處理的欄位內容
• 結構保持：只翻譯目標欄位，保持 JSON 結構和其他欄位不變
• 錯誤處理：翻譯失敗時保留原文並新增標記，不會中斷整個翻譯過程
• 檔案匯出：提供翻譯後的 JSON 檔案下載和結果展示

工作流程

1. 讀取使用者需求

先理解使用者需要翻譯的內容：

• JSON 檔案的路徑
• 需要翻譯的欄位名（預設 description，可指定多個逗號分隔）
• 源語言和目標語言
• 是否需要檢視翻譯結果或直接下載檔案

2. 呼叫翻譯指令碼

使用技能目錄中的 scripts/translate_json.py 指令碼進行翻譯：

python scripts/translate_json.py <輸入檔案> --target-language <語言程式碼> [選項]

指令碼引數

支援的語言程式碼

3. 檢視翻譯結果

指令碼執行後會顯示：

• 翻譯進度（當前/總數）
• 原文和譯文預覽
• 翻譯統計資訊
• 輸出檔案路徑

4. 下載翻譯後的檔案

翻譯完成後：

• 控制台會顯示輸出檔案路徑
• 使用者可以下載該檔案檢視完整內容
• 可以選擇性地將結果返回給使用者

使用示例

示例 1：翻譯 description 欄位到中文

使用者說： "幫我翻譯這個 JSON 檔案的 description 欄位到中文"

python scripts/translate_json.py data.json --target-language zh

示例 2：翻譯多個欄位到英文

使用者說： "把這個 JSON 檔案的 name 和 description 欄位翻譯成英文"

python scripts/translate_json.py data.json --target-language en --fields name,description

示例 3：指定源語言翻譯

使用者說： "將這個檔案從中文翻譯成日文"

python scripts/translate_json.py data.json --target-language ja --source-language zh

示例 4：指定輸出檔案

使用者說： "翻譯這個檔案，輸出到 translation.json"

python scripts/translate_json.py data.json --target-language en --output translation.json

輸出說明

控制台輸出

指令碼執行時會在控制台顯示：

• [當前/總數] - 翻譯進度
• 欄位路徑 - 當前正在翻譯的欄位位置
• 原文預覽 - 50個字元
• 譯文預覽 - 50個字元
• 完成資訊 - 翻譯成功/失敗統計

檔案輸出

• 預設檔名格式：{原檔名}_translated.json
• 使用者也可以通過 --output 引數指定輸出路徑
• JSON 檔案保持原始縮排格式，使用 UTF-8 編碼

錯誤處理

指令碼會處理以下錯誤情況：

• JSON 檔案格式錯誤 - 顯示錯誤資訊並退出
• 檔案不存在 - 提示檔案路徑錯誤

  更多技能請訪問小蔥技能站7w4.net。

• 欄位不存在 - 顯示警告資訊但繼續處理
• 翻譯失敗 - 保留原文並新增錯誤標記

注意事項

1. API 限流：指令碼會自動在每次翻譯之間新增 0.1 秒延遲，避免 API 限流
2. 大檔案處理：建議 JSON 檔案大小不超過 10MB
3. 網路要求：需要能夠訪問 MyMemory API (https://api.mymemory.translated.net)
4. 欄位存在性：如果指定的欄位在 JSON 中不存在，會提示缺失欄位但繼續處理其他欄位
5. 結構保持：只翻譯目標欄位，其他欄位和 JSON 結構完全保持不變
6. 依賴：需要安裝 requests 庫（指令碼會自動處理，如果未安裝會提示）

技術實現

翻譯服務

指令碼使用 MyMemory 作為主要翻譯服務，LibreTranslate 作為備用服務：

• MyMemory：免費線上翻譯 API，主要翻譯服務
• LibreTranslate：開源機器翻譯 API，作為備用服務
• 自動降級：主服務失敗時自動切換到備用服務
• 錯誤處理：API 失敗時保留原文並新增標記

欄位查詢

指令碼使用深度遞迴演算法查詢 JSON 中的目標欄位：

• 遞迴遍歷所有物件和陣列
• 識別指定欄位名
• 記錄欄位路徑和值
• 保持原始 JSON 結構

進度反饋

指令碼提供即時翻譯進度：

• 顯示當前翻譯的欄位編號
• 顯示欄位路徑和內容預覽
• 顯示翻譯狀態（成功/失敗）
• 顯示完成統計資訊

這個 Skill 專門用於翻譯 JSON 檔案中的文本內容，支援中文、英文、日文、韓文四種語言互譯，功能簡單實用。文件說明詳細，容易上手，翻譯失敗時不會丟失原文。不足之處是支援的語言種類偏少，僅 4 種；完全依賴網路翻譯服務，翻譯速度和穩定性受網路影響，大檔案翻譯會比較慢。整體質量中規中矩，適合有明確多語言翻譯需求的場景使用。