1. 基本信息
| 项目 | 内容 |
|---|---|
| 名称 | iflytek-translate-iflytek-ifly-skills |
| 项目自述名称 | iFly Translate（讯飞机器翻译）（README/SKILL.md 标题；SKILL.md 内部标识符为 iflytek-translate，与正式名称含义一致，不作为名称使用） |
| 作者/维护者 | iFLYTEK（科大讯飞）官方 GitHub 组织 iflytek |
| 来源链接 | https://github.com/iflytek/iFly-Skills/tree/main/skills/iflytek-translate |
| 许可证 | Apache-2.0（GitHub API 确认，适用于整个 iFly-Skills 仓库） |
| GitHub Stars | 213（GitHub API，仓库整体；iFly-Skills 是含 11 个独立技能的合集仓库，此数字不代表本技能自身热度） |
| Forks | 27（GitHub API，仓库整体） |
| 最新版本 | 同目录 _meta.json 标注 version 1.0.0；对应脚本首次提交于 2026-06-17，此后未再变更 |
| 安装方式 | git clone 后置入对应 Agent 的 skills 目录，或通过 Skills.sh 等第三方技能市场安装（见第 10 章） |
2. 功能介绍与亮点
iFly Translate 是 iFLYTEK 官方机器翻译能力的技能封装，通过一条命令调用讯飞机器翻译 API 完成文本互译：
- 多语言覆盖：支持中、英、日、韩、法、德、西、俄、阿拉伯语、泰语、越南语等 70 余种语言两两互译，并内置常用语言别名（如
zh→cn、english→en） - 多种输入方式：直接传入文本、从标准输入管道读取、或指定文件批量翻译，覆盖单句翻译到文档翻译的常见用法
- 纯标准库实现：脚本仅使用 Python 内置的
urllib/hmac/hashlib/json等模块完成 HMAC-SHA256 签名与 HTTP 调用，无需安装任何第三方依赖 - 鉴权实现符合时区规范：脚本使用
datetime.now(timezone.utc)生成签名日期，正确处理了本地时区与协调世界时的转换，避免部分同类脚本在非中国时区部署环境下可能出现的签名时间窗口问题 - 详尽的调用指南：SKILL.md 内含完整参数表、常见语言代码对照表、多个使用示例，以及认证失败、服务未开通、额度不足、文本过长、语种不支持等场景的错误排查步骤
主要亮点：iFLYTEK 官方出品、完全开源可审计；零第三方依赖使安装与审计成本降到最低；文档覆盖了从正常使用到常见故障排查的完整路径。
3. 适用场景
固定分类：内容创作与知识管理
面向需要在对话中直接完成文本翻译的用户：内容创作者翻译多语言素材、跨境团队处理外文邮件或文档、学习者翻译外语资料、客服或社区运营人员处理多语种用户消息。产出为纯文本翻译结果，可直接用于后续写作或沟通，尤其适合以中文为主要工作语言、需要频繁在中文与其他语种间互译的场景。
4. 跨 Agent 兼容性
| Agent | 结论 | 依据 |
|---|---|---|
| Claude Code | 原生支持 | 标准 SKILL.md 格式，直接放入 skills 目录即可 |
| Codex | 原生支持 | Codex CLI 原生支持 SKILL.md 标准，技能文件放入 .codex/skills/ 即可被发现；脚本无 Claude 专属工具调用语法，亦可直接复用 Claude Code 目录下已安装的技能 |
| OpenClaw | 原生支持 | SKILL.md 内置 openclaw 元数据块（emoji、维度标签、用户指令示例），为该合集技能库明确适配对象之一 |
| Hermes Agent | 需适配 | Hermes 技能规范仅要求 SKILL.md 含 name/description，本技能已满足；但仓库未提供 Hermes 专属安装清单或市场条目，需手动复制目录后自行验证加载 |
5. 推荐理由
对经常需要中外文互译的用户来说，这个技能一条命令即可完成 70 余种语言的文本翻译，零第三方依赖、鉴权实现规范，文档覆盖了从基础用法到故障排查的完整路径——是一款开箱即用、维护成本极低的官方翻译工具。
6. 评分
| 维度 | 分数 | 说明 |
|---|---|---|
| 受欢迎程度 | 7 | iFLYTEK 系科大讯飞官方出品；所属 iFly-Skills 是 11 个技能共享的合集仓库，213 star 不代表本技能个体热度；本技能自身在第三方技能市场暂无独立可查的采用数据 |
| 可用性 | 8 | 纯 Python 标准库实现、零第三方依赖，安装即用；参数表、语言代码表、多场景示例与错误排查步骤齐全；鉴权代码正确使用协调世界时，未见签名时间窗口相关的已知问题 |
| 安全性 | 8 | 人工审查脚本源码确认仅通过标准库网络接口向讯飞官方固定翻译端点发起请求、传输用户提供的待译文本，无 shell 命令执行、无 eval/exec；凭据经环境变量读取，脚本内不落盘；License 为 Apache-2.0，明确；SKILL.md 与脚本全文未见可疑指令或夹带推广内容 |
| 综合 | 7.67 | 三项均值 |
安全检查清单逐项结果：① 脚本本身不执行任意 shell 命令，仅由本地 Python 进程发起 HTTPS 请求，权限范围明确（人工审查 scripts/translate.py 源码确认）；② 会将用户提供的待译文本发送至讯飞官方翻译端点，数据流向在文档中已注明且目标域名固定透明；③ 要求讯飞 API 凭据（AppID/Key/Secret），通过环境变量存储，为标准做法；④ 全文及脚本源码未发现可疑指令、混淆代码或隐蔽外发逻辑；⑤ 作者为科大讯飞官方组织，无信誉造假迹象；⑥ License 为 Apache-2.0，明确；⑦ 所属仓库近期（6 天前）仍有其他子技能的维护提交，整体处于活跃状态。
7. 跟同类 Skills 相比的优势
| 技能 | 使用形态 | 语言覆盖 | 依赖与定价 |
|---|---|---|---|
| iFly Translate（本技能） | 直接运行的 CLI 脚本，输入文本即得译文 | 中、英、日、韩等 70 余种语言 | 讯飞官方 API 凭据，纯标准库零依赖 |
| azure-ai-translation-text-py-microsoft-skills | 教 Agent 用 Azure 官方 Python SDK 编写调用代码，用于集成进开发项目 | 依托 Azure AI Translator，覆盖语种同样广泛，另含音译与词典查询能力 | Azure 订阅 + 凭据链配置，面向开发场景 |
两者定位不同：iFly Translate 面向“直接要一个翻译结果”的即时使用场景，零配置门槛最低；azure-ai-translation-text-py 面向“往自己的应用里集成翻译功能”的开发场景，功能更丰富（含音译、词典）但需要 Azure 账号与项目级代码集成。日常翻译选前者更快，构建翻译类产品选后者更合适。
8. 用户评价
该技能目前在第三方平台尚无具名用户评价。所属仓库的其他子技能存在真实第三方开发者提交并被合并的 bug 修复记录，显示该合集有真实使用者在跟进维护，但这些反馈并非专门针对本技能撰写的评价。
9. 其他补充
iFly-Skills 合集除本技能外还包含图片理解、通用 OCR、票据识别、文本校对、超拟人语音合成、语音转写、视频翻译、声音克隆、合同智能审核等技能，均调用讯飞自有云 API；仓库同时向 ClawHub、Skills.sh、腾讯云 SkillHub、LobeHub 等多个第三方技能市场分发。
10. 安装使用方式
方式一：直接克隆子目录
git clone https://github.com/iflytek/iFly-Skills.git
cp -r iFly-Skills/skills/iflytek-translate ~/.claude/skills/方式二：通过第三方技能市场安装（以 Skills.sh 为例）
npx skills add iflytek/ifly-skills/iflytek-translate使用前配置（必需环境变量，在讯飞控制台开通“机器翻译”服务后获取）：
export XFYUN_APP_ID="your_app_id"
export XFYUN_API_KEY="your_api_key"
export XFYUN_API_SECRET="your_api_secret"基本用法：
# 中译英（默认方向）
python3 scripts/translate.py "你好世界"
# 指定源语言与目标语言
python3 scripts/translate.py -s en -t cn "Hello world"
# 从文件翻译
python3 scripts/translate.py -f document.txt -s cn -t en安装后无需重启 Agent，下一次对话中提及“翻译成英文”“帮我翻译一下”等意图即可触发。
11. 注意事项
- 使用前需在讯飞控制台自行开通“机器翻译”服务并生成 API 凭据，非零配置即用；新用户通常有免费试用额度，额度用尽后需付费购买套餐
- 单次翻译文本长度不得超过 4096 字节，超长文本需自行拆分后分段调用
- 待翻译文本会发送至讯飞官方服务器处理，若涉及需要保密的内容需自行评估是否适合通过云端 API 处理
- 脚本支持传入
auto作为源语言参数，但该功能是否可用取决于账号权限与接口实际能力，官方文档未明确保证 - 本技能脚本的鉴权实现方式与同合集其他技能存在代码重复、且环境变量命名前缀与部分姊妹技能不一致（合集维护者已在一个公开 issue 中记录该问题并计划后续整合），目前未见因此导致的实际翻译故障报告