前言¶
技术文档、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
