Universal Translate Tool Free

SKILL.md

---
slug: universal-translate-tool-free
name: universal-translate-tool-free
version: 1.0.0
displayName: 通用翻译工具(免费版)
summary: 面向个人用户的多语言翻译工具,支持文本翻译、自动检测源语言,保留格式与术语。
license: Proprietary
edition: free
description: '通用翻译工具免费版为个人用户提供日常多语言翻译能力,覆盖文本翻译、自动源语言检测、格式保留与术语保护。核心能力:

  - 文本翻译(任意语言互译)

  - 自动检测源语言

  - 保留Markdown格式(标题/列表/代码块/表格)

  - 保留技术术语(变量名/函数名/URL)

  - 简单文件翻译(单文件)


  适用场景:

  - 个人阅读外文文档与资料

  - 编写多语言个人项目README

  - 日常对话翻译辅助


  差异化:免费版聚焦个人日常翻译需求,支持单文件翻译'
tags:
- 翻译
- 多语言
- 文档处理
- 个人开发
- 本地化
tools:
- - read
- exec
homepage: https://skillhub.cn
pricing_tier: L3
pricing_model: per_use
suggested_price: 29.9
tools: ["read", "write", "exec"]
tags: "翻译,语言,工具"
---
# 通用翻译工具(免费版)

## 概述

`universal-translate-tool-free` 为个人用户提供日常多语言翻译能力。它支持任意语言互译、自动源语言检测,并保留 Markdown 格式与技术术语,适合个人阅读外文资料、编写多语言项目文档与日常对话翻译。

本工具通过自然语言指令驱动 Agent 完成翻译,无需安装额外脚本或调用外部翻译 API。

## 核心能力

| 能力 | 说明 |
|---|---|
| 文本翻译 | 任意语言之间互译 |
| 自动源语言检测 | 自动识别源语言并标注 |
| 格式保留 | Markdown 标题、列表、代码块、表格、链接全保留 |
| 术语保留 | 变量名、函数名、CLI 命令、URL 不翻译 |
| 语气保留 | 正式保持正式,口语保持口语 |
| 单文件翻译 | 翻译单个 Markdown 文件并保存为带语言后缀的版本 |
**技术实现要点**：核心能力基于`input_params`参数与`output_format`配置实现,支持创建/查询/修改/删除等操作模式,通过`config_options`进行运行时配置。

### 核心功能执行
用`input_params`参数进行配置。

**输入**: 用户提供核心功能执行所需的指令和必要参数。
**处理**: 解析核心功能执行的输入参数,完成核心逻辑,返回结构化响应。
**输出**: 返回核心功能执行的响应数据,包含状态码、结果和日志。
- 执行此能力时使用`input_params`参数,支持创建/查询/导出操作

### 参数配置与调用
用`config_options`参数进行配置。

**输入**: 用户提供参数配置与调用所需的指令和必要参数。
**处理**: 解析参数配置与调用的输入参数,完成核心逻辑,返回结构化响应。
**输出**: 返回参数配置与调用的响应数据,包含状态码、结果和日志。
- 执行此能力时使用`config_options`参数,支持修改/重置/导入操作

### 结果处理与输出
用`output_format`参数进行配置。

**输入**: 用户提供结果处理与输出所需的指令和必要参数。
**处理**: 解析结果处理与输出的输入参数,完成核心逻辑,返回结构化响应。
**输出**: 返回结果处理与输出的响应数据,包含状态码、结果和日志。
- 执行此能力时使用`output_format`参数,支持导出/保存/转换操作
**能力覆盖范围**：本skill的核心能力覆盖以下场景关键词：面向个人用户的多、语言翻译工具、支持文本翻译、自动检测源语言、保留格式与术语、通用翻译工具免费、版为个人用户提供、日常多语言翻译能、覆盖文本翻译、格式保留与术语保、任意语言互译、保留技术术语、简单文件翻译等。这些关键词对应description中声明的使用场景,均已在上述能力点中提供对应的操作支持。

## 使用场景

### 场景 1:日常文本翻译

```
把这段翻译成日语:你好,你最近怎么样?
```

输出:

```text
**中文 → 日语**
こんにちは、最近いかがですか?
```

### 场景 2:自动检测源语言

```
Xin chào, tôi là Ha Le
```

输出:

```text
**检测到:越南语 → 英语**
Hello, I am Ha Le
```

### 场景 3:Markdown 文件翻译

```
把 README.md 翻译成中文
```

工具会:
1. 读取文件
2. 翻译时保留所有 Markdown 格式
3. 保存为 `README.zh.md`
4. 输出:`已翻译 README.md → README.zh.md(中文,245 行)`

### 场景 4:代码注释翻译

翻译代码文件时,只翻译注释与字符串,不翻译代码:

```python
# 翻译前
variable_name = "Hello"  # 此变量保存问候语
# ...
# 翻译后(中文)
variable_name = "你好"  # 此变量保存问候语
```

## 不适用场景

以下场景通用翻译工具(免费版)不适合处理：

- 专业医学法律翻译认证
- 同声传译
- 文学创作翻译

## 触发条件

需要文本翻译、多语言转换、本地化处理时使用。不适用于非本工具能力范围的需求。

## 快速开始

### 第一步:提供文本与目标语言

直接在对话中提供要翻译的内容与目标语言,例如:

```
把以下内容翻译成法语:
这是一个使用 TypeScript 编写的 REST API 项目,依赖 Express 框架。
```

### 第二步:获取翻译结果

工具会自动检测源语言,保留格式与术语,输出带语言对标注的翻译结果。

### 第三步:文件翻译(可选)

如需翻译文件,提供文件路径与目标语言:

```
把 docs/getting-started.md 翻译成日语
```

## 示例

### 常见语言代码

| 代码 | 语言 | 代码 | 语言 |
|:-----|:-----|:-----|:-----|
| `en` | 英语 | `zh` | 中文 |
| `ja` | 日语 | `ko` | 韩语 |
| `es` | 西班牙语 | `pt` | 葡萄牙语 |
| `fr` | 法语 | `de` | 德语 |
| `it` | 意大利语 | `ru` | 俄语 |
| `ar` | 阿拉伯语 | `hi` | 印地语 |
| `vi` | 越南语 | `th` | 泰语 |
| `id` | 印尼语 | `ms` | 马来语 |

### 文件命名约定

翻译后的文件使用语言代码后缀:

| 原文件 | 翻译后(中文) | 翻译后(日语) |
|---:|---:|---:|
| `README.md` | `README.zh.md` | `README.ja.md` |
| `guide.md` | `guide.zh.md` | `guide.ja.md` |

## 最佳实践

1. **明确目标语言**:始终指定目标语言,避免工具猜测。若文本已是英语且未指定目标,工具会询问。
2. **保留格式**:翻译 Markdown 时,标题层级、列表缩进、代码块语言标识全部保留。
3. **术语不翻译**:变量名、函数名、CLI 命令、URL、路径保持原样。
4. **专有名词处理**:人名、品牌、地名保留原文,除非有标准本地化译名。
5. **歧义词选最常见译法**:根据上下文选择最常见翻译,必要时在括号中保留原文。
6. **代码文件只翻译注释与字符串**:不翻译代码本身,避免破坏可运行性。
7. **不添加内容**:仅翻译已有内容,不主动添加解释或补充。

## 常见问题

### Q1: 工具支持多少种语言?

理论上支持所有有书面文字的语言互译,包括主流语言与小语种。常见语言代码见上方表格。

### Q2: 翻译 Markdown 文件时格式会丢失吗?

不会。工具会保留所有 Markdown 格式:标题、加粗、斜体、代码块、表格、列表、链接。代码块内容不翻译。

### Q3: 技术术语会被翻译吗?

不会。变量名、函数名、CLI 命令、URL、文件路径保持原文。例如 `npm install` 不会被翻译。

### Q4: 翻译质量如何保证?

工具会根据上下文选择最合适的译法,保留原文语气(正式/口语)。对于无良好译法的词,保留原文并在括号中标注。

### Q5: 免费版与 Pro 版的区别?

免费版支持单文件翻译与日常文本翻译;Pro 版扩展批量翻译、对话模式、术语库管理、API 集成与企业级本地化流程。

## 依赖说明

### 运行环境

- **Agent 平台**:支持 SKILL.md 的任意 AI Agent(Claude Code / Cursor / Codex / Gemini CLI 等)
- **操作系统**:Windows / macOS / Linux

### 依赖详情

| 依赖项 | 类型 | 是否必需 | 获取方式 |
|:---:|:---:|:---:|:---:|
| LLM API | API | 必需 | 由 Agent 内置 LLM 提供 |

### API Key 配置

- 本 Skill 完全基于 Markdown 指令,无需额外 API Key
- 翻译能力由 Agent 内置 LLM 提供,不调用外部翻译 API

### 可用性分类

- **分类**: MD+EXEC(纯 Markdown 指令,部分功能需要 exec 命令行执行能力)
- **说明**: 基于自然语言指令驱动 Agent 完成翻译;文件翻译需要 Agent 的文件读写能力

## 错误处理

| 错误场景 | 原因 | 处理方式 |
|:------|------:|:------|
| 配置错误 | 参数缺失或格式错误 | 检查依赖说明中的配置要求 |
| 运行时错误 | 运行环境不满足 | 确认运行环境符合依赖说明 |
| 网络错误 | 连接超时或不可达 | 执行ping命令测试网络连通性,检查防火墙和代理设置连接后执行ping命令测试网络连通性,检查防火墙和代理设置连接后重新执行命令，参考国内替代方案 |

## 已知限制

- 需要API Key，无Key环境无法使用
- 当前为免费版本,如需完整功能请升级到付费版获取全部能力