ifly-translate — 机器翻译（多语言）

Name: ifly-translate — 机器翻译（多语言）
Author: Iflytek AIcloud

Iflytek AIcloud

ifly-translate — 机器翻译（多语言）

v1.0.0

使用讯飞机器翻译 API，支持 70+ 语言之间的文本翻译。纯 Python 实现，无外部依赖。支持文件、标准输入或直接文本输入，具有可自定义源/目标语言、详细输出和调试模式。

0· 118·0 当前·0 累计

by @qingzhe2020 (Iflytek AIcloud)·MIT-0

API工具 AI模型访问文件处理

下载技能包

License

MIT-0

最后更新

2026/4/8

安全扫描

VirusTotal

无害

查看报告

OpenClaw

可疑

medium confidence

该技能实现了 iFlytek 翻译客户端，但包元数据中缺少必需的 XFYUN 凭据，并包含不相关的本地权限条目，安装前应谨慎确认。

评估建议

虽然看似合法的 iFlytek 翻译客户端，但在安装/运行前，请：（1）确认来源可信；（2）仅提供可控的 XFYUN 凭据；（3）检查/删除 `.claude/settings.local.json`；（4）在隔离环境运行；（5）验证网络访问仅指向 `itrans.xfyun.cn`；（6）如果计划发布，请更新元数据声明环境变量。...

详细分析 ▾

ℹ 用途与能力

技能名称、SKILL.md 和 translate.py 脚本均描述并实现了向 itrans.xfyun.cn 发送请求的讯飞机器翻译客户端。代码、用例和 SKILL.md 中的必需环境变量与此目的一致。但注册元数据未声明任何必需环境变量或主凭据，与运行指令和脚本对三项 XFYUN 凭据的明确依赖不一致。

✓ 指令范围

SKILL.md 指示代理（和用户）设置 XFYUN_APP_ID、XFYUN_API_KEY、XFYUN_API_SECRET 并运行捆绑的 Python 脚本；脚本仅读取标准输入或输入文件、声明的环境变量，并向 itrans.xfyun.cn 发送 HTTPS 请求。指令不指向读取无关系统文件或向意外外部端点发送数据。

✓ 安装机制

无安装规格（仅指令 + 一个捆绑脚本）。无第三方包下载或执行；Python 代码仅使用标准库。这是较低风险的安装模型。

⚠ 凭证需求

运行时需要三个秘密（XFYUN_APP_ID、XFYUN_API_KEY、XFYUN_API_SECRET），适用于 iFlytek API，但技能注册元数据未声明任何必需环境变量或主凭据——元数据遗漏，隐藏了对自动审查员/用户的敏感要求。另外，仓库包含 `.claude/settings.local.json` 条目，授予针对特定用户路径的 Bash zip 命令，与翻译无关，可能指示包装/权限设置的残留或本地配置的意外包含。

✓ 持久化与权限

技能不请求持久存在（always:false），不修改其他技能或全局代理设置，且不包含修改系统配置的安装脚本。它作为按需 CLI 脚本运行，执行向 API 端点的网络调用。

安装前注意事项

确认来源可信 — 技能元数据缺少三项必需 XFYUN 凭据，但脚本需要它们。
仅提供可控的 XFYUN 凭据，考虑使用有限/测试密钥。
检查/删除 `.claude/settings.local.json` 文件（包含指向本地用户路径的 Bash zip 权限，与翻译无关）。
如果不确定，请在隔离环境或容器中运行脚本。
验证网络访问仅指向 `itrans.xfyun.cn`。
如果计划发布/共享技能，请更新注册元数据声明必需环境变量。

安全有层次，运行前请审查代码。

License

MIT-0

可自由使用、修改和再分发，无需署名。

查看条款 ↗

运行时依赖

无特殊依赖

版本

latestv1.0.02026/3/19

["ifly-translate 初始发布。","使用 iFlytek 机器翻译 API 支持 70+ 语言翻译。","Python CLI 支持文件、标准输入或直接文本输入，源/目标语言可自定义。","仅使用 Python 标准库，无 pip 依赖。","提供详细输出和原始输出选项，适合灵活使用和调试。"]

● 无害

安装命令点击复制

官方npx clawhub@latest install ifly-translate

镜像加速npx clawhub@latest install ifly-translate --registry https://cn.clawhub-mirror.com

技能文档

请查看下方翻译后的 SKILL.md 内容（保留原始 YAML frontmatter 不翻译，代码块、命令行指令和 Markdown 格式不变）

Translate text using iFlytek's Machine Translation API (机器翻译). Supports 70+ language pairs.

Setup

Create an app at 讯飞控制台 with 机器翻译 service enabled
Set environment variables:

   export XFYUN_APP_ID="your_app_id"
   export XFYUN_API_KEY="your_api_key"
   export XFYUN_API_SECRET="your_api_secret"

Usage

Basic translation (Chinese → English by default)

python3 scripts/translate.py "你好世界"

Specify source and target language

python3 scripts/translate.py -s en -t cn "Hello world"

Read from stdin

echo "こんにちは" | python3 scripts/translate.py - -s ja -t cn

Read from file

python3 scripts/translate.py -f document.txt -s cn -t en

Options

Flag	Short	Description
`text`	Text to translate (use `-` for stdin)
`--file`	`-f`	Read text from a file
`--from`	`-s`	Source language code (default: `cn`)
`--to`	`-t`	Target language code (default: `en`)
`--verbose`	`-v`	Show source/target language labels
`--raw`	Output raw JSON response

Common language codes

Code	Language	Code	Language
`cn`	中文	`en`	English
`ja`	日语	`ko`	韩语
`fr`	法语	`de`	德语
`es`	西班牙语	`ru`	俄语
`ar`	阿拉伯语	`th`	泰语
`vi`	越南语	`pt`	葡萄牙语
`it`	意大利语	`tr`	土耳其语

Aliases are supported: zh→cn, chinese→cn, english→en, japanese→ja, etc.

Full language list:

Examples

# Chinese to English python3 scripts/translate.py "人工智能改变世界" # English to Chinese python3 scripts/translate.py -s en -t cn "Artificial intelligence changes the world" # Japanese to Chinese python3 scripts/translate.py -s ja -t cn "おはようございます" # Verbose output with language labels python3 scripts/translate.py -v "你好"

# Raw JSON for debugging python3 scripts/translate.py --raw "测试翻译"

Output

Default: translated text only (stdout)
--verbose: shows source and target with language labels
--raw: full API JSON response

Notes

Auth: HMAC-SHA256 with Digest header (SHA-256 of body) — different from some other xfyun APIs
Endpoint: POST https://itrans.xfyun.cn/v2/its
Env vars: XFYUN_APP_ID, XFYUN_API_KEY, XFYUN_API_SECRET
Text is base64-encoded in the request body
No pip deps: Uses only Python stdlib (urllib, hmac, hashlib, json, etc.)

# 常见问题 FAQ (´,,•ω•,,)♡

机器翻译的主要功能是什么？

答：支持文本到文本的机器翻译 ✨

机器翻译支持哪些语种？

答：目前支持包括英、日、法、西、俄等70多种语言，详细的语种可见语种列表~

机器翻译支持什么应用平台？

答：目前仅支持webapi接口哦 (,,•́ . •̀,,)

机器翻译支持的文本长度是多少？

答：单次文本长度不得超过4096字节~

是否支持源语种的自动识别？

答：目前不支持，后续会开放，新消息请关注平台动态 (◕‿◕)

机器翻译如何购买？

答：机器翻译产品页对应产品价格 → 点击申请购买，填好相关信息，商务工作人员会及时与您联系~

📦 查看套餐包：讯飞控制台
💰 价格详情：价格页面

❌ 常见错误及解决方案 (´,,•ω•,,)♡

错误：认证失败 / Invalid credential

表现：返回 401 Unauthorized 或 authentication error

可能原因：

API Key 或 API Secret 填写错误啦 (´；ω；)


环境变量没有正确设置

解决方法：

确认你正确设置了环境变量：

   export XFYUN_APP_ID="你的APP_ID"
   export XFYUN_API_KEY="你的API_KEY"
   export XFYUN_API_SECRET="你的API_SECRET"


检查是否有空格或多余的引号哦 ✧(≖ ◡ ≖)
去 讯飞控制台 确认你的密钥是否正确复制~
错误：服务未开通 / Service not enabled
表现：返回

403 Forbidden

 或提示服务未开通
可能原因：

机器翻译服务还没有开通呢 (；´ДA)

解决方法：

登录讯飞控制台
点击「创建新应用」或选择已有应用
在「产品服务」中找到「机器翻译」并开通
开通后可能需要几分钟生效，稍等一下下~ (,,•́ . •̀,,)

错误：额度不足 / Quota exceeded

表现：返回 402 Payment Required 或提示额度不足

可能原因：

免费额度用完啦，或者套餐包到期了 (╥_╥)

解决方法：

登录讯飞控制台查看剩余额度
如果需要更多资源，可以：

- 购买机器翻译套餐包 👉 价格页面 - 联系商务工作人员申请更大额度~

错误：文本过长 / Text too long

表现：返回错误提示文本过长

可能原因：

单次翻译的文本超过4096字节啦 (⊙_⊙)

解决方法：

将长文本拆分成多个小段落进行翻译
每个段落单独调用翻译接口
最后将结果拼接起来~ ✨

错误：网络连接失败 / Connection error

表现：连接超时或网络错误

可能原因：

网络不稳定 or 防火墙拦截了 (；・∀・)

解决方法：

检查网络连接是否正常
如果是企业网络，尝试关闭防火墙或代理
确认 itrans.xfyun.cn 是否可访问
可以ping一下试试看：ping itrans.xfyun.cn

错误：语种不支持 / Language not supported

表现：返回语种错误或无法识别

可能原因：

使用的语言代码不在支持列表中 (￣▽￣)

解决方法：

请参考上方「Common language codes」表格
语言代码要使用标准的双字母代码哦，比如 cn、en、ja
支持的语言列表详见：讯飞机器翻译API文档

❓ 其他常见问题

Q: 为什么翻译结果返回为空？

A: 检查一下输入的文本是否为空，或者是否包含特殊字符导致编码问题哦~ (｡・ω´・)

Q: 翻译速度很慢怎么办？

A: 可以检查一下网络状况，或者将长文本拆分处理~

Q: 如何查看我的使用量？

A: 登录讯飞控制台即可查看详细的使用统计和账单信息！

💡 小提示：

使用 --raw` 参数可以看到完整的API响应，方便调试哦~
遇到不确定的错误时，可以把错误信息复制到搜索引擎搜索一下，或者查看官方文档寻求帮助 (◕‿◕)
购买套餐包请访问：讯飞控制台或价格页面 ✨

数据来源：ClawHub ↗ · 中文优化：龙虾技能库

OpenClaw 技能定制 / 插件定制 / 私有工作流定制

免费技能或插件可能存在安全风险，如需更匹配、更安全的方案，建议联系付费定制

了解定制服务

License

运行时依赖

版本

安装命令 点击复制

技能文档

Setup

Usage

Basic translation (Chinese → English by default)

Specify source and target language

Read from stdin

Read from file

Options

Common language codes

Examples

Output

Notes

机器翻译的主要功能是什么？

机器翻译支持哪些语种？

机器翻译支持什么应用平台？

机器翻译支持的文本长度是多少？

是否支持源语种的自动识别？

机器翻译如何购买？

❌ 常见错误及解决方案 (´,,•ω•,,)♡

错误：认证失败 / Invalid credential

错误：服务未开通 / Service not enabled

错误：额度不足 / Quota exceeded

错误：文本过长 / Text too long

错误：网络连接失败 / Connection error

错误：语种不支持 / Language not supported

❓ 其他常见问题

安装命令点击复制