前言¶
在 Cursor、Claude Code 等环境里做翻译，常见做法是每次让模型「顺便翻一下」：术语不一致、格式被改乱、长文档和结构化内容（JSON、Markdown）更容易出问题。若希望翻译请求都走同一套能力——多语言、术语表、风格约束、保留分隔符与结构——需要把翻译从通用对话里拆出来，交给专门的 Skill。
下面介绍 SkillHub 上的 Tencent Hy-MT2-Translator（坐标 @tencent-adm/hy-mt2-translator）。它基于腾讯混元 Hy-MT2 模型，面向 Agent 场景封装机器翻译；官方说明要求所有翻译类请求均通过该 Skill 处理。
这是什么¶
Tencent Hy-MT2-Translator 是腾讯混元团队发布的企业向 Skill（来源：enterprise），当前版本 1.0.0，SkillHub 分类为 knowledge-management。SkillHub 页面标注 requires_api_key=true，使用前需自行准备并配置 API Key（具体字段以安装后 Skill 目录内的 SKILL.md 为准）。
- 官方 API 入口：https://api.skillhub.cn/tencent-adm/hy-mt2-translator
- SkillHub 展示页：https://www.skillhub.cn/skills/tencent-adm/hy-mt2-translator
它解决的是：在 Agent 工作流里提供可复用的 Hy-MT2 翻译能力，而不是依赖主模型即兴翻译。
核心功能¶
以下能力均来自 SkillHub 与已抓取元数据中的官方简介，未单独列出的细节不作延伸。
语言与输入形态¶
- 支持 38 种语言。
- 单段文本、多行文件，以及 JSONL 批量翻译。
六种翻译模式¶
- basic：基础文本翻译。
- terminology-constrained：术语约束（词表/术语表）。
- style-controlled：风格控制（如正式、口语等，以你在对话中给出的约束为准）。
- delimiter-preserving：翻译时保留指定分隔符。
- structured-data：在 JSON / HTML / XML / YAML / Markdown 等结构化内容上翻译，并尽量保持结构。
- context-aware：结合上下文信息的翻译。
安装与启用¶
SkillHub 推荐两种方式：用 skillhub CLI 安装，或把安装提示交给当前 Agent 执行。后者在 SkillHub 页面给出的原文为：
请根据 https://skillhub.cn/install/skillhub.md，安装 `@tencent-adm/hy-mt2-translator`。
1、安装 SkillHub CLI（若尚未安装）¶
先检查是否已有 CLI：
command -v skillhub && skillhub --version
未安装时，可按 SkillHub 安装文档执行完整安装（含 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
说明见：https://skillhub.cn/install/skillhub.md
2、安装本 Skill 到当前 Agent 的 skills 目录¶
安装技能时必须用 --dir 指向当前 Agent 实际读取的 skills 目录；否则默认会装到 ./skills/，Agent 可能无法加载。SkillHub 文档记载的常用路径如下：
| 环境 | skills 目录 |
|---|---|
| Cursor | ~/.cursor/skills/ |
| Claude Code | ~/.claude/skills/ |
| Codex | ~/.codex/skills/ 或项目下的 .agents/skills/ |
安装命令形式（将 <skills 目录> 换成上表对应路径）：
skillhub install tencent-adm/hy-mt2-translator --dir <skills 目录>
若 skillhub search / install 的包名与坐标不一致，以 CLI 搜索结果或 Agent 按官方提示安装的结果为准。
3、配置 API Key¶
元数据标签为 requires_api_key=true。安装完成后，在对应 skills 目录中打开该 Skill 的 SKILL.md，按文档配置密钥与后端；未在 SkillHub 公开页列出的配置项，以 SKILL.md 为准。
安装或更新 skills 后，按你所用客户端的要求重启或刷新 Agent，以便加载新 Skill。
典型用法¶
本 Skill 通过 Agent 对话触发，而非单独的可执行应用。在 Skill 已启用且 API Key 已配置的前提下，可按官方定义的六种模式组织请求。下列为与官方能力描述对应的可复现对话方向（具体措辞与参数以 SKILL.md 为准）。
基础翻译
使用 Hy-MT2 翻译 Skill，将下面英文译成简体中文（basic 模式）：
Our API returns JSON with stable field names.
术语约束
翻译以下段落为英文，术语表：「混元」→ Hy，「SkillHub」不译。使用 terminology-constrained 模式。
风格控制
将下面中文译为日语，商务邮件语气，style-controlled 模式。
保留分隔符
翻译下列字符串为法语，不要改动 `{{name}}` 与 `|` 分隔符，delimiter-preserving 模式。
Hello|{{name}}|welcome
结构化数据
翻译此 JSON 中的字符串值为德语，键名不变，structured-data 模式：
{"title":"Release notes","body":"Fixed login bug."}
上下文感知
上文讨论的是云 API 计费。翻译下面句子为英文，context-aware 模式：
本次变更不影响按量计费项。
多行文件或 JSONL
翻译当前打开的多行文本文件，源语言自动检测，目标语言为韩语。
按 Skill 说明批量翻译此 JSONL 文件，每行一条记录，目标语言为西班牙语。
适用场景与注意¶
适合谁
- 在 Agent 里频繁做文档、接口文案、结构化配置的多语言处理，且希望统一走 Hy-MT2。
- 需要术语表、风格、分隔符或 JSON/Markdown 等格式约束的翻译任务。
- 已有或可申请翻译相关 API Key 的团队（企业向 Skill）。
限制与注意
- 依赖外部 API Key；未配置时 Skill 无法完成真实翻译调用。
- 官方简介强调用于全部翻译请求；若项目里还有别的翻译脚本，需自行统一入口，避免同一任务多套逻辑。
- SkillHub 统计（以已抓取资料为准）：评分 100000，下载 815；安装量等会随时间变化，以 SkillHub 页面为准。
https://api.skillhub.cn/tencent-adm/hy-mt2-translator在浏览器直接访问可能返回 405；查阅说明以 SkillHub 技能页与本地SKILL.md为主。
结尾¶
Tencent Hy-MT2-Translator 把 Hy-MT2 的 38 语言与六种翻译模式收进 Agent Skill，覆盖单句、多行文件与 JSONL 批量场景。安装时走 SkillHub 坐标 @tencent-adm/hy-mt2-translator，并配置 API Key。
- SkillHub：https://www.skillhub.cn/skills/tencent-adm/hy-mt2-translator
- 官方地址：https://api.skillhub.cn/tencent-adm/hy-mt2-translator
