妙言小智(PicTech.cc)-跨境電商圖片翻譯
📖 技能介紹
name: myxz-image-translation description: 妙言小智 (PicTech.cc) 專業級跨境電商圖片翻譯 Skill，支援批次翻譯、主圖保護、多語言對映、線上編輯與自動化工作流整合。
妙言小智圖片翻譯
使用本 skill 通過 妙言小智 圖片翻譯服務翻譯圖片中的文字。
妙言小智官方網站：https://www.pictech.cc
妙言小智API 服務域名：https://stableai.com.cn
VK(APP KEY) 獲取地址：https://www.pictech.cc/newpictech/skills/openclaw-image-translation-skill
VK 憑證規則
VK 是必需的 API 憑證。
- 必須優先從 skill/plugin 的持久配置中讀取 VK，即
config.vk。 - 不要要求使用者在每次圖片翻譯任務中都輸入 VK。
- 不要把 VK 寫入普通使用者提示、聊天訊息、日誌、報告、檔名或返回摘要。
- 如果缺少 VK，告訴使用者需要先在 skill/plugin 配置中填寫一次 VK，然後重新執行任務。
- 只有在受控內部測試時才允許使用直接傳入的
vk欄位；正式使用時優先使用config.vk。
缺少 VK 時可以這樣回覆使用者：
需要先在圖片翻譯 skill 的配置中填寫一次 VK。配置完成後，我會自動讀取，不需要你每次翻譯都輸入。
處理使用者請求的流程
- 識別圖片輸入來源：
- 單個本地圖片路徑
- 包含圖片的本地資料夾
- 一個或多個圖片 URL
- 逗號分隔的多個路徑或 URL
- 判斷翻譯語言方向：
- 預設源語言：
中文 - 預設目標語言：
英文 - 如果使用者明確說明語言方向，使用使用者指定的語言。
- 如果使用者沒有說明語言方向，使用預設值。
- 判斷是否啟用主圖/主體保護：
- 預設值：
false - 當用戶要求保護主商品、主體、主圖、產品本體、Logo 區域或關鍵視覺元素不被翻譯/修改時，設定
mainImageProtection: true。 - 判斷儲存目錄：
- 如果使用者指定了儲存目錄，使用使用者指定的目錄。
- 如果使用者沒有指定儲存目錄，讓
index.js使用預設結果目錄。 - 使用結構化引數呼叫 skill 執行器。
- 根據返回的結構化結果向用戶總結任務結果。
支援語言
支援的源語言：
中文繁體中文英文泰語俄語印尼語馬來語葡萄牙語西班牙語法語德語
目標語言除了支援以上語言外，還支援 index.js 中對映到 API 的其他語言，例如：
韓語義大利語波蘭語荷蘭語土耳其語越南語菲律賓語
如果使用者指定了不支援的源語言，需要說明當前支援的源語言列表，並請使用者選擇其中一種。
呼叫方式
從 index.js 匯入預設匯出的執行函式，並傳入結構化引數。
單張圖片示例：
await run({
input: "C:/path/to/image.png",
sourceLanguage: "中文",
targetLanguage: "英文",
mainImageProtection: false,
saveDir: "C:/path/to/output",
config: {
vk: "<從 skill/plugin 持久配置中讀取>"
}
});
多張圖片示例：
發現更多技能外掛，請訪問7w4.net。
await run({
input: [
"C:/path/to/one.jpg",
"C:/path/to/two.png",
"https://example.com/three.webp"
],
sourceLanguage: "中文",
targetLanguage: "英文",
mainImageProtection: true,
config: {
vk: "<從 skill/plugin 持久配置中讀取>"
}
});
資料夾示例：
await run({
input: "C:/path/to/image-folder",
sourceLanguage: "中文",
targetLanguage: "英語",
config: {
vk: "<從 skill/plugin 持久配置中讀取>"
}
});
引數說明
input：必填。可以是本地圖片路徑、資料夾路徑、圖片 URL、路徑/URL 陣列，或逗號分隔的字串。
config.vk：必填。必須來自 skill/plugin 的持久配置。
sourceLanguage：可選。預設值為 中文。
targetLanguage：可選。預設值為 英文。
mainImageProtection：可選。預設值為 false。
saveDir：可選。未提供時，執行器會儲存到預設輸出目錄。
返回結果結構
執行器會返回適合大模型解析的結構化物件：
{
success: true,
status: "completed",
message: "圖片翻譯完成，成功 1 個，無文字 0 個，失敗 0 個，總計 1 個。",
batchId: "batch_...",
sourceLanguage: "中文",
targetLanguage: "英文",
sourceLanguageCode: "Chinese",
targetLanguageCode: "English",
mainImageProtection: false,
saveDir: "C:/path/to/result/batch",
counts: {
total: 1,
success: 1,
noText: 0,
failed: 0
},
results: [
{
taskId: "...",
input: "C:/path/to/image.png",
fileName: "image.png",
resultUrl: "https://...",
editorUrl: "https://...",
localPath: "C:/path/to/result.png",
fromCache: false
}
],
errors: [],
skipped: []
}
無文字圖片處理
後端 querytask 返回 data.status === 300 時，表示該圖片上沒有可翻譯文字：
{
"code": 200,
"data": {
"status": 300,
"errorMessage": "圖片上無文字 翻譯失敗，無需重試"
}
}
Agent 必須把 300 當作終態處理：
- 不要繼續輪詢該任務
- 不要把該圖片重新提交給
submittask - 不要把它當作需要重試的普通失敗
- 應記錄為
no_text/skipped，並在本地快取中標記，後續同圖同語言方向直接跳過提交 - 最終統計中寫入
counts.noText，並在skipped中說明原因 - 如果一批圖片裡只有無文字圖片且沒有真實失敗，整體
status可以是completed
可能的 status 值：
completed：全部圖片翻譯成功partial_success：部分圖片成功或無文字跳過，部分圖片失敗failed：所有已嘗試圖片均失敗no_tasks：沒有找到可處理的有效圖片任務invalid_params：缺少必填引數invalid_source_language：源語言不受支援invalid_target_language：目標語言不受支援missing_api_key：沒有配置 VK
給使用者的回覆規範
任務成功時，向用戶說明：
- 成功、無文字跳過和失敗的圖片數量
- 本地檔案儲存位置
- 可用的翻譯結果預覽連結
- 可用的線上編輯連結
不要暴露內部快取 key、請求頭、原始 VK、堆疊資訊或完整 API 請求資料。
當 status 是 partial_success 時，先展示成功結果，再簡要列出失敗檔案和失敗原因。
當返回結果包含 skipped 或 counts.noText > 0 時，說明這些圖片是“圖片上無文字，無需重試”，不要建議使用者再次提交這些圖片。
當 status 是 missing_api_key 時，不要反覆要求使用者在對話裡輸入 VK。應提示使用者到 skill/plugin 配置中填寫一次 VK。
典型使用者請求
把這張圖片從中文翻譯成英文翻譯這個資料夾裡的所有商品圖，中文到西班牙語把這些圖片 URL 翻譯成英文，主圖產品不要動中文圖片翻譯成英語，結果儲存到指定目錄
可靠性要求
- 不要修改原始輸入圖片。
- 保留返回結果中的本地路徑，方便使用者找到檔案。
- 將 URL 作為遠端圖片輸入處理，將本地路徑作為檔案系統輸入處理。
- 後端
status=300是“圖片上無文字”的無需重試終態，必須跳過並快取，不要重複提交。 - 如果某張圖片超過大小限制或格式不支援，將該圖片記錄為失敗，並繼續處理剩餘圖片。
- 最終回覆優先使用簡潔摘要，不要預設向用戶傾倒完整結構化物件，除非使用者要求檢視原始返回結果。
🤖 AI 評測
這個圖片翻譯 Skill 功能齊全，支援批次處理和多語種翻譯，還自帶快取避免重複消耗額度，文件寫得很詳細。不足之處是 README 裡的倉庫地址還是示例佔位符，不夠專業；另外缺少測試覆蓋，程式碼質量的可信度打了折扣。整體質量中上，日常使用問題不大，但工程規範方面還有提升空間。
