前言¶
技术文档、论文 PDF 和带固定术语的原文,用通用对话式翻译往往会出现专名被改写、版式丢失、难以对照审校等问题。若希望在 Agent 里用同一套流程处理纯文本与 PDF,并产出可浏览的双语对照结果,同时能维护术语表,可以留意 SkillHub 上的社区 Skill Gxpcode-translator(坐标 @user_321f4e87/zhonghe1991,当前版本 3.0.0)。页面标注 requires_api_key=false,不依赖额外 API Key 配置项。
这是什么¶
Gxpcode-translator 是 SkillHub 分类 office-efficiency 下的专业翻译工具,由发布者 user_321f4e87 维护,来源为 community。官方简介概括为:支持文本和 PDF 输入;对 PDF 可输出双语对照 HTML + Markdown;并围绕术语与词典提供可触发的能力。SkillHub 页面当前显示评分 100000、下载 824 次(统计以页面为准,会随时间变化)。
Skill 详情与安装入口:
- 页面:https://www.skillhub.cn/skills/user_321f4e87/zhonghe1991
- 坐标引用:https://api.skillhub.cn/user_321f4e87/zhonghe1991
核心功能¶
以下能力均来自 SkillHub 简介与标签,未在资料中出现的细节不展开。
- 文本翻译:可直接对粘贴或对话中的文本做翻译处理。
- PDF 翻译:接受 PDF 作为输入,适合整份文档类任务。
- 双语对照输出:针对 PDF 流程,产出双语对照的 HTML 与 Markdown,便于在浏览器或笔记工具里对照阅读。
- 术语与词典:支持术语保护、更新术语、词典(glossary)及「保留特定词」类需求;官方列出的触发关键词包括:
翻译、术语保护、更新术语、词典、glossary、保留特定词。
安装与启用¶
SkillHub 推荐两种方式:让 Agent 按安装文档执行,或在本机用 skillhub CLI 安装到当前 Agent 的 skills 目录。安装时必须使用 --dir 指向会被识别的目录,否则默认落在 ./skills/ 且 Agent 可能读不到。
方式一:提示词安装(官方页面文案)
将下面意图发给支持 Skill 的 AI,由其按 SkillHub 安装说明拉取 Skill:
请根据 https://skillhub.cn/install/skillhub.md,安装 `@user_321f4e87/zhonghe1991`。
方式二:CLI 安装
先确认是否已安装 skillhub:
command -v skillhub && skillhub --version
未安装时可按 SkillHub 文档执行完整安装(示例为官方推荐命令):
curl -fsSL https://skillhub-1388575217.cos.ap-guangzhou.myqcloud.com/install/install.sh | bash
安装本 Skill 时,将 --dir 换成你当前客户端的 skills 路径。SkillHub 文档给出的常见路径如下:
| 环境 | skills 目录 |
|---|---|
| Cursor | ~/.cursor/skills/ |
| Claude Code | ~/.claude/skills/ |
| Codex | ~/.codex/skills/ 或项目下的 .agents/skills/ |
示例(以 Cursor 为例):
skillhub install @user_321f4e87/zhonghe1991 --dir ~/.cursor/skills/
也可先搜索再安装:
skillhub search zhonghe1991
skillhub install @user_321f4e87/zhonghe1991 --dir ~/.cursor/skills/
安装后按你所用客户端的惯例刷新或重启 Agent,使新 Skill 被加载。公开资料未单独列出 Cursor 与 Codex CLI 在触发方式上的差异,此处不臆测。
典型用法¶
公开页面未附带逐步教程,下面示例仅复述官方已声明的输入类型、输出形态与触发词,便于在对话中复现意图。
1. 翻译一段文本
在已启用 Skill 的对话中,用自然语言说明要翻译的内容,并包含触发词「翻译」即可对齐 Skill 设计,例如:
请翻译下面这段技术说明,并尽量保持术语一致:
(粘贴原文)
2. 翻译 PDF 并需要双语对照
说明输入为 PDF,并点明需要双语对照输出(HTML / Markdown),例如:
翻译这份 PDF,输出双语对照的 HTML 和 Markdown。
(附上 PDF 或指明工作区中的 PDF 路径)
3. 术语保护与 glossary
在翻译前或翻译中维护术语表,可使用官方关键词,例如:
更新术语:将 "Kubernetes" 保留不译,"Pod" 统一译为「Pod」。
翻译时做术语保护,按 glossary 处理。
具体文件落盘路径、PDF 解析粒度等实现细节未在本次抓取的官方摘要中出现,若对话结果与预期不符,应以 Skill 包内 SKILL.md(安装后位于 skills 目录)为准。
适用场景与注意¶
适合谁
- 需要在 Agent 内处理中英(或多语)技术文本,并希望 PDF 能产出可对照阅读的 HTML / Markdown。
- 文档中含产品名、协议字段等固定译法,希望通过「术语保护 / glossary / 保留特定词」减少漂移。
- 希望使用 SkillHub 统一分发、且不愿额外配置 API Key(页面标签为
requires_api_key=false)。
限制与注意
- 版本以 SkillHub 为准,撰写时页面为 v3.0.0;升级后行为可能变化,安装前可用
skillhub查看版本信息。 - 社区来源(community)Skill,质量与维护节奏依赖发布者,重要稿件仍建议人工终审。
- 大体积 PDF、扫描版或复杂版式可能受 Skill 实现与模型上下文限制,资料未承诺 OCR 或版式还原,不宜默认等同专业排版工具。
- 下载量、评分等为平台统计,仅作选型参考,不代表翻译质量承诺。
结尾¶
Gxpcode-translator 把文本与 PDF 翻译、双语对照导出和术语词典维护收进一个 office-efficiency 类 Skill,适合在 Cursor、Claude Code、Codex 等支持 SkillHub 安装路径的环境里按需启用。安装与详情见 SkillHub 页面 https://www.skillhub.cn/skills/user_321f4e87/zhonghe1991 ,坐标安装为 @user_321f4e87/zhonghe1991。