前言¶
英文 PDF 要改成中文可讀版本,常見做法是整份導出再貼進 Word 或在線翻譯,公式、圖表和目錄往往錯位,批註和背景色也容易丟。若你希望在 Cursor、Claude Code 等支持 Skills 的環境裏,用自然語言觸發「翻譯這份 PDF」,並得到結構仍貼近原稿的新文件,下面介紹 SkillHub 上的 多語言文檔翻譯保版式(座標 @org-b6kzcl68/translate-pdf)。該技能標註 requires_api_key=false,不依賴額外 API Key 配置即可按官方說明安裝使用。
這是什麼¶
多語言文檔翻譯保版式 是面向辦公效率(分類 office-efficiency)的 Agent Skill,版本 1.0.0,來源爲 enterprise,由 重慶途光網絡傳媒有限責任公司 發佈。
一句話定位:將 PDF 從一種語言譯成目標語言,並在過程中儘量保留原文檔的結構、版式與樣式(含顏色、背景和文字位置),輸出帶語言後綴的新 PDF。
- SkillHub 展示頁:https://www.skillhub.cn/skills/org-b6kzcl68/translate-pdf
- 官方地址:https://api.skillhub.cn/user_e263a450/translate-pdf
核心功能¶
以下能力均來自 SkillHub 頁面與已抓取簡介,未列出的能力不寫。
-
三步流水線
- 用腳本提取 PDF 內全部去重文本。
- 生成原文與譯文對照的 JSON 映射文件。
- 調用腳本將譯文按指定字體回寫進 PDF,得到新文件。 -
版式與樣式
強調保留結構、版式與樣式;回寫時使用透明填充,以便儘量保持原背景色不變。 -
多語言字體
內置拉丁語系、簡體中文、繁體中文、日文、韓文等字體;中日韓字體自動縮放至 90%,用於提升排版貼合度。 -
觸發方式
當用戶需要把 PDF 從一種語言譯成另一種、轉換 PDF 語言版本或製作已翻譯副本時使用。典型說法包括:翻譯 PDF、把 PDF 翻譯成中文或英文、translate this PDF等。
安裝與啓用¶
安裝流程遵循 SkillHub 通用文檔 skillhub.md。先確認本機是否已有 CLI:
command -v skillhub && skillhub --version
若未安裝,可執行完整安裝(CLI + 默認 Skill):
curl -fsSL https://skillhub-1388575217.cos.ap-guangzhou.myqcloud.com/install/install.sh | bash
僅安裝 CLI 時:
curl -fsSL https://skillhub-1388575217.cos.ap-guangzhou.myqcloud.com/install/install.sh | bash -s -- --cli-only
安裝本技能時,必須用 --dir 指向當前 Agent 的 skills 目錄;默認裝到 ./skills/ 可能不會被 Agent 識別。SkillHub 頁面給出的包名爲 @org-b6kzcl68/translate-pdf。
skillhub install @org-b6kzcl68/translate-pdf --dir <skills 目錄>
常用客戶端 skills 目錄(摘自官方安裝文檔,按你實際使用的客戶端選擇其一):
- Cursor:
~/.cursor/skills/ - Claude Code:
~/.claude/skills/ - Codex:
~/.codex/skills/或項目下的.agents/skills/
安裝後按你所用客戶端的慣例重啓或刷新 Agent,使技能被加載。
典型用法¶
公開資料未給出獨立 shell 示例子命令名,可復現的流程是:在已啓用該 Skill 的對話裏說明源 PDF 路徑與目標語言,由 Agent 按技能內腳本執行三步——提取去重文本、維護原文/譯文 JSON、回寫並輸出帶語言後綴的新 PDF。
示例意圖(自然語言,非固定 API):
- 「把
/path/to/paper.pdf翻譯成簡體中文,保留版式。」 - 「translate this PDF to English, keep layout.」
- 「製作這份 PDF 的中文副本,不要改背景色。」
具體腳本路徑與參數以安裝包內 SKILL.md 及附帶腳本爲準;本文不編造未在官方簡介中出現的後端或配置項。
適用場景與注意¶
適合誰
- 需要英中或其他語言 PDF 副本,且希望版式、顏色、文字位置儘量與原件一致的用戶。
- 已在 Cursor、Claude Code、Codex 等環境使用 Skills,希望通過對話批量或單次處理 PDF 的團隊。
使用上需注意
- SkillHub 當前統計(以頁面爲準):評分 100000,下載 105,安裝 0;數據會隨時間變化,以 SkillHub 實時展示爲準。
- 技能側重文本提取—翻譯映射—字體回寫;掃描版 PDF、複雜矢量圖或強依賴 OCR 的頁面,效果取決於源文件與技能腳本能力,官方簡介未承諾單獨 OCR 管線。
- 頁面註明如需更多技能與使用幫助,可在淘寶搜索「AI靈匣」——僅爲官方引流說明,與安裝命令無關。
- 用戶線索中曾出現 pdf2zh-next、多翻譯後端等描述,當前 SkillHub 簡介與展示頁未寫明,本文不將其列爲已覈實功能。
結尾¶
多語言文檔翻譯保版式 把 PDF 翻譯收成 Agent 可觸發的三步流程:去重提取、JSON 對照、按字體回寫,並針對 CJK 做了 90% 縮放與透明填充,適合「要譯文 PDF、又要儘量像原排版」的場景。安裝與包座標以 SkillHub 爲準:
- https://www.skillhub.cn/skills/org-b6kzcl68/translate-pdf
- https://api.skillhub.cn/user_e263a450/translate-pdf