首页 / 技能 / 翻译 TXT

📦 翻译 TXT

v1.0.0

使用兼容 OpenAI 的 API（如 SiliconFlow、DeepSeek、OpenAI）翻译文本文件。适用于用户想要：翻译 txt 文件、将文本翻译为 C...

0· 17·0 当前·0 累计
litousteven 头像by @litousteven
文件处理AI模型访问API工具
下载技能包
0
安全扫描
VirusTotal
无害
查看报告
OpenClaw
可疑
medium confidence
该技能的代码与指令符合其翻译目的，但注册表元数据遗漏了必需的 API key，且该技能会将此 key 存储并传输至你配置的任意 base_url——这些不匹配之处及任意端点能力需引起警惕。
评估建议
This 技能 应用ears to implement a legitimate translator, but take these precautions before 安装ing or 运行ning it: - Expect to provide a translation API key (TRANSLATE_API_KEY). The registry metadata omitted this — confirm you or your org are comfortable storing that key in the 技能's .env file (~/.comate/技能s/translate-txt/.env) before 运行ning 设置up.sh. Treat it like any other API secret. - 验证 the TRANSLATE_BASE_URL you 配置. The script will POST your API key and chunks to whatever base_url you 设置; only use ...
详细分析 ▾
ℹ 用途与能力
SKILL.md、setup.sh 和 scripts/translate.py 均使用 OpenAI 兼容 API（SiliconFlow、DeepSeek、OpenAI）实现文件翻译工具，功能（分块、术语表、滑动窗口、并发调用）与描述一致。
ℹ 指令范围
运行time instructions are scoped to configuring an API key (via .env or env vars), 运行ning the translation script, and 报告ing an 输出:<path>. They instruct the 代理 to 运行 the included 设置up.sh non-interactively (which writes TRANSLATE_API_KEY into a .env in the 技能 directory). There is nothing in 技能.md that 请求s unrelated 系统 files or secrets, but the non-interactive 设置up path means an 代理 could be asked to persistently write keys to disk.
✓ 安装机制
No external 安装/下载s are performed. This is an instruction+code bundle shipped in the 技能. No remote 归档s, package 安装s, or URL 下载s are used.
⚠ 凭证需求
The 技能 requires an API key (TRANSLATE_API_KEY) and other translation-related env vars (base URL, 模型, etc.), which are proportionate. However the registry metadata provided to the evaluator 列出s no required env vars/primary 凭证 while 技能.md marks TRANSLATE_API_KEY as required — this metadata mismatch is an incoherence and increases risk because automated 工具ing or 权限 检查s may not surface the need to supply a secret. 添加itionally, the base URL is user-configurable, so the API key will be sent to whatever 端点 is 配置d; a malicious or mis配置d base_url could exfiltrate the key.
✓ 持久化与权限
always is false and 模型 invocation is allowed (default). The 技能 writes a .env in its own 技能 directory via 设置up.sh, which is normal for 凭证s storage. The 技能 does not attempt to modify other 技能s or 系统-wide configs.
安全有层次，运行前请审查代码。

运行时依赖

无特殊依赖

安装命令

点击复制
官方npx clawhub@latest install smart-translate-txt
镜像加速npx clawhub@latest install smart-translate-txt --registry https://cn.longxiaskill.com

技能文档

translate-txt Skill 使用任意兼容 OpenAI 的 API 翻译 .txt 文件。默认使用 SiliconFlow 的 Qwen 模型，将外语译为中文。

特性

  • 支持任意 OpenAI-compatible API（SiliconFlow、DeepSeek、OpenAI 等）
  • 自动检测源语言，默认译成中文
  • 按段落/句子分块处理大文件
  • 并发翻译——多段并行
  • 滑动窗口上下文——每段携带附近段落的术语表与背景；新术语自动传播，旧上下文随窗口滑动自然淡出
  • 超时与瞬错自动指数退避重试
  • 保留原文格式与结构

文件结构 translate-txt/ ├── SKILL.md # Skill 定义 ├── .env # 用户配置（由 setup 生成） ├── setup.sh # 安装脚本（交互/非交互） └── scripts/ └── translate.py # 翻译脚本

配置 脚本优先读取 skill 根目录的 .env，其次环境变量。

变量 默认值 说明 TRANSLATE_API_KEY 无（必填） 翻译服务 API key TRANSLATE_BASE_URL https://api.siliconflow.cn/v1 OpenAI-compatible 接口基址 TRANSLATE_MODEL Qwen/Qwen2.5-7B-Instruct 模型名 TRANSLATE_THINKING auto 思考模式：auto/disabled（推荐）或 enabled TRANSLATE_MAX_TOKENS 4096 每段最大输出 token TRANSLATE_TEMPERATURE 1 模型 temperature TRANSLATE_TIMEOUT 300 API 请求超时（秒）

优先级：环境变量 > .env 文件 > 默认值

使用方法

Step 1：检查并配置 首次使用确认 API key。若 .env 不存在或 TRANSLATE_API_KEY 为空，脚本会提示输入并运行：

# 非交互（AI agent） bash ~/.comate/skills/translate-txt/setup.sh --api-key --provider # 提供商：siliconflow（默认）、deepseek、openai # 或完整指定 bash ~/.comate/skills/translate-txt/setup.sh --api-key --base-url --model

示例 # SiliconFlow（默认） bash ~/.comate/skills/translate-txt/setup.sh --api-key sk-xxx --provider siliconflow # DeepSeek bash ~/.comate/skills/translate-txt/setup.sh --api-key sk-xxx --provider deepseek # OpenAI bash ~/.comate/skills/translate-txt/setup.sh --api-key sk-xxx --provider openai # 自定义端点 bash ~/.comate/skills/translate-txt/setup.sh --api-key sk-xxx --base-url https://my-api.example.com/v1 --model my-model

也可手动交互运行： bash ~/.comate/skills/translate-txt/setup.sh

成功输出 CONFIG_SAVED:<路径>。若已配置，直接进入 Step 2。

Step 2：执行翻译 python3 ~/.comate/skills/translate-txt/scripts/translate.py [选项]

选项 --output <路径> 输出文件（默认：_translated.txt） --target-lang <语言> 目标语言（默认：Chinese） --source-lang <语言> 源语言提示（默认：auto） --chunk-size <整数> 每块最大字符数（默认：3000） --concurrency <整数> 最大并发 API 数（默认：3） --context-window <整数> 滑动窗口大小（默认：3）

示例 # 默认译成中文 python3 ~/.comate/skills/translate-txt/scripts/translate.py document.txt # 译成日语 python3 ~/.comate/skills/translate-txt/scripts/translate.py document.txt --target-lang Japanese # 指定输出路径 python3 ~/.comate/skills/translate-txt/scripts/translate.py document.txt --output result.txt

Step 3：报告结果 成功后输出 OUTPUT:<路径>，向用户报告。若失败，查看错误： CONFIG_ERROR - 未配置 API key，请提供后重跑 setup.sh FILE_ERROR - 输入文件不存在或为空 API_ERROR - API 调用失败，检查 key、URL、模型及网络

工作原理 多段文件采用三步：

  • 关键词提取——轻量提示并发提取每段专有名词及译文。
  • 构建段上下文——滑动窗口合并前 N 段关键词（默认 3），新术语自动向后传播，背景描述取自开头段并前置。
  • 翻译——并发翻译所有段。
数据来源：ClawHub ↗ · 中文优化：龙虾技能库