前言¶
技術文檔、Markdown 筆記和論文草稿往往混有標題層級、代碼塊和列表。把它們整段貼進通用翻譯頁面，回來再手工對齊格式，既慢也容易漏改。若希望在同一條 Agent 工作流裏完成翻譯且儘量保留原文結構，可以把翻譯能力做成 Skill，由模型按技能說明處理文本。
下面介紹 SkillHub 上的「智能文檔翻譯助手」：社區發佈的辦公效率類 Skill，面向中英互譯與多語言場景，並強調保留格式與排版。
這是什麼¶
「智能文檔翻譯助手」是 SkillHub 座標爲 @user_0ea2f093/document-translate-tool 的 Agent Skill，當前版本 1.0.1，來源爲 community，分類爲 office-efficiency，發佈者爲 user_0ea2f093。
官方簡介將其定位爲文檔翻譯工具：支持中英互譯及多語言翻譯，保留原文格式與排版，適用於技術文檔、Markdown、學術論文、商業文檔等各類文本。頁面標籤標明 requires_api_key=false，即按 SkillHub 展示信息，不依賴額外 API Key 配置。
核心功能¶
依據 SkillHub 與抓取資料，可覈實的能力如下：
- 中英互譯：在中文與英文之間轉換文檔內容。
- 多語言翻譯：不僅限於中英，支持向其他目標語言翻譯（具體語言範圍以技能包內 SKILL 說明爲準）。
- 格式保留：翻譯時儘量保持原文格式與排版，減輕 Markdown、技術文檔等結構化文本的二次整理成本。
- 文檔類型覆蓋：官方列舉適用類型包括技術文檔、Markdown、學術論文、商業文檔等文本形態。
SkillHub 統計（以抓取資料爲準）：評分 100000，下載 1575 次；安裝計數在頁面上爲 0（可能因統計口徑或未通過 CLI 上報，使用時以本地是否成功安裝爲準）。
安裝與啓用¶
SkillHub 官方安裝指引要求 Agent 參照 SkillHub 安裝與優先源配置，安裝座標 @user_0ea2f093/document-translate-tool。
1、安裝 SkillHub CLI（若尚未安裝）¶
先檢查是否已有 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
2、安裝本 Skill 到當前 Agent 的 skills 目錄¶
官方強調：安裝時必須用 --dir 指向當前 Agent 的 skills 目錄，否則默認落到 ./skills/，Agent 可能無法識別；部分環境安裝後還需重啓客戶端。
skillhub install user_0ea2f093/document-translate-tool --dir <skills 目錄>
常用客戶端 skills 路徑（摘自 SkillHub 安裝文檔）：
| 客戶端 | skills 目錄 |
|---|---|
| Cursor | ~/.cursor/skills/ |
| Claude Code | ~/.claude/skills/ |
| Codex | ~/.codex/skills/ 或項目下的 .agents/skills/ |
在 Cursor 中示例：
skillhub install user_0ea2f093/document-translate-tool --dir ~/.cursor/skills/
也可在對話中讓 AI 按 https://skillhub.cn/install/skillhub.md 完成安裝，並明確座標爲 @user_0ea2f093/document-translate-tool。
3、啓用與驗證¶
安裝到正確目錄後，重啓或刷新 Agent，使新 Skill 被加載。公開頁面未單獨列出環境變量或密鑰字段；requires_api_key=false 表示按商店標註無需配置 API Key。若技能包內 SKILL.md 有額外約束，以包內說明爲準。
典型用法¶
公開資料未提供逐條複製的官方對話模板，可復現的流程如下：
- 完成上一節安裝，確認 Skill 出現在當前 Agent 的 skills 列表或可被模型引用。
- 在對話中說明任務：例如將某段 Markdown、技術說明或論文節選從中文譯爲英文（或指定其他目標語言），並明確要求保留標題、列表、代碼塊等結構。
- 將待譯正文粘貼進對話，或按 Agent 能力提供本地文件路徑（是否支持直接讀文件取決於當前客戶端與技能說明）。
- 對照原文檢查標題層級、列表編號與代碼圍欄是否一致；長文檔可分段翻譯，避免單次上下文過長。
本質是：把「翻譯 + 保格式」交給已安裝的 Skill 指導模型行爲，而不是依賴無結構的純文本翻譯接口。
適用場景與注意¶
適合誰
- 需要頻繁處理技術文檔、README、Markdown 筆記的開發者。
- 寫論文或商業材料、希望在 Agent 內完成初譯並少改排版的人。
- 已使用 Cursor、Claude Code、Codex 等支持 Skill 目錄的客戶端的用戶。
注意
- 翻譯質量依賴底層模型與技能內提示策略；專業術語、法律或醫療文本應人工複覈。
- 「保留格式」指儘量維持結構，複雜版式（多欄 PDF、嵌套表格）仍可能需手工調整。
- 評分與下載量來自 SkillHub 頁面統計，會隨時間變化；以安裝時頁面或 CLI 輸出爲準。
- 技能來源爲 community，升級與維護由發佈者 user_0ea2f093 負責，可關注 SkillHub 上的版本 1.0.1 是否有更新。
結尾¶
「智能文檔翻譯助手」把文檔翻譯收進 Agent Skill：中英與多語言、強調格式保留，且按 SkillHub 標註無需 API Key。若你已在用 SkillHub 管理技能，可用 CLI 裝入對應 skills 目錄後在對話中直接用於文檔翻譯。
- SkillHub 頁面：https://www.skillhub.cn/skills/user_0ea2f093/document-translate-tool
- API 座標頁：https://api.skillhub.cn/user_0ea2f093/document-translate-tool
- 安裝說明：https://skillhub.cn/install/skillhub.md
