name: feishu-doc-translator description: "飛書文件翻譯助手 — 在飛書文件之間進行中英文互譯，支援全文翻譯、段落翻譯、雙語對照。當用戶需要翻譯飛書文件、英文文件轉中文、中文文件轉英文、或建立雙語版本文件時使用。觸發詞：翻譯飛書文件、文件翻譯、中英互譯、雙語文件、translate feishu doc、飛書英文。"

飛書文件翻譯助手

讓 AI Agent 成為你的飛書文件翻譯官，一鍵中英互譯，保留 Markdown 格式。

核心能力

1. 全文翻譯

• 讀取飛書文件完整內容（通過 feishu_doc read）
• 中文 → 英文 或 英文 → 中文
• 保留所有 Markdown 格式（標題、表格、列表、程式碼塊）
• 輸出到新文件或原文件下方

  訪問小蔥技能站7w4.net，解鎖更多實用的AI技能外掛。

2. 段落級翻譯

• 翻譯文件中指定段落/章節
• 適用場景：更新產品文件、翻譯公告通知

3. 雙語對照模式

• 中英對照雙欄輸出（原文 + 譯文交替顯示）
• 適合技術文件、API 文件、產品說明書

4. 格式智慧處理

• 表格：保持行列結構，僅翻譯文字
• 程式碼塊：僅翻譯註釋，保留程式碼
• 連結：保留 URL，僅翻譯顯示文字
• 圖片描述：翻譯 alt 文本

使用場景

場景 1：產品文件國際化

使用者："幫我把這篇飛書產品文件翻譯成英文"
→ 讀原文 → 英譯 → 新建英文版文件（同級目錄）

場景 2：英文技術文件本土化

使用者："這個英文 API 文件需要中文版"
→ 讀原文件 → 中譯 → 建立中文版（保留程式碼塊）

場景 3：會議紀要雙語

使用者："把這篇會議紀要做成中英對照版"
→ 讀原文 → 雙語對照格式 → 寫入新文件

場景 4：批次文件翻譯

使用者："把這個知識庫裡的 3 篇文章都翻譯成英文"
→ 遍歷文件列表 → 逐個翻譯 → 命名規則：原名_en

工作流程

標準翻譯流程

1. 確認源文件 — 獲取 doc_token，讀取全文內容
2. 確認目標語言 — 中→英 或 英→中（或其他語言）
3. 翻譯 — 按段落翻譯，保留 Markdown 結構
4. 輸出 — 預設建立新文件（格式：原文件名_en 或 原文件名_zh）
5. 通知使用者 — 傳送新文件連結

雙語對照流程

1. 讀取原文
2. 建立新文件，標題為 [Bilingual] 原文標題
3. 交替寫入：## 🇨🇳 中文 → 中文內容 → ## 🇬🇧 English → 英文內容
4. 或使用飛書表格實現雙欄對照

翻譯質量保證

定價（ClawHub 免費技能）

免費釋出，作為引流產品： - 吸引飛書國際化企業使用者 - 展示 AI 翻譯能力 → 引導付費定製服務 - 與其他 3 個付費模板產品形成產品矩陣

技術實現

使用的 OpenClaw 工具： - feishu_doc read — 讀取飛書文件內容 - feishu_doc create — 建立新翻譯文件 - feishu_doc write — 寫入翻譯內容 - feishu_doc list_blocks — 獲取文件塊結構（高階） - feishu_drive list — 批次處理文件

限制與注意事項

• 翻譯質量依賴底層 AI 模型能力
• 超長文件（>10000 字）建議分段翻譯
• 從右到左語言（阿拉伯語等）暫不支援
• 圖片中的文字無法翻譯（需 OCR）
• 飛書特有格式（如多維表格嵌入、投票）無法完全保留

與其他技能的關係

版本歷史

This Feishu document translation assistant has average quality. The strengths are clear positioning, comprehensive scenario coverage, and thoughtful formatting preservation. The weakness is that there is only documentation without actual usable code, making it hard to judge the real effectiveness. For Feishu document translation needs, the concept is complete but practicality remains to be verified.