metadata

title: EasyTranslator
emoji: 🏃
colorFrom: gray
colorTo: pink
sdk: gradio
sdk_version: 5.0.2
app_file: app.py
pinned: false
license: apache-2.0

EasyTranslator v1.1.0

基于gradio的汉化辅助工具

使用

至少需要安装python3(作者使用的版本是3.10, 其它版本尚未测试)

Install

git clone https://github.com/alienet1109/EasyTranslator.git

不想安git可以直接下载压缩包

Preparation

1. 安装依赖

pip install -r requirements.txt

2. 文本准备

需要使用者自行准备原文本json文件, 或使用本程序将原文本csv文件转换为json文件
csv文件格式要求为：

至少包含人名列、文本列, 按顺序排列的表格

只有文本没有人名也可以使用, 在csv里新建空列'name'即可。
若不指定id列名, 程序会自动生成id。
可以指定人名和文本的列名, 将会分别以'name'、'text'为键输入json文件；其它列将会以原列名为键输入, 以防数据丢失。
生成json文件后, 下载, 然后输入其路径（不一定要与代码同一文件夹）即可使用。

json文件格式要求为：

由key为id, value为{'name':'原文人名','text':'原文文本'}的键值对组成, 按文本顺序正序排序的字典。

运行途中会频繁修改json文件, 所以最好做好备份。
可以随时在页面中修改json文件路径, 修改前务必保存, 修改后请按Load按钮以同步更新否则不知道会有什么bug。
上次编辑文本编号将会重置, 路径与编号将直接更新至config文件。

3. 修改配置文件`config.json`

必须：
1. 设置文本文件file_path及人名词典name_dict_path的路径(推荐使用绝对路径)。之后结果会直接保存至对应路径。
可选：
1. 设置替换词典replace_dict_path路径, 如不使用此功能则不需要；
2. 可设置api key和分隔符等, 也可以直接在程序更改。程序中的修改会改变预设api key, 但不会改变预设的分隔符。

Run

直接点开EasyTranslator.py或在文件夹下执行命令:

python EasyTranslator.py

然后在网页中打开程序给出的网址（eg: http://127.0.0.1:7860 ）

v1.1.0更新内容

现支持通常翻译和批量翻译中gemini, claude, qwen, deepseek...等模型的自由选择和调用。请在config.json中或API页填写api key (注：当设置了OpenRouter的api时，会优先使用OpenRouter的接口)。使用gemini, claude, doubao等的官方接口请安装相关依赖包。可以自行修改utils.py中的MODEL_LIST以调整可选模型，避免冗余。
修改了键盘快捷键设置
alt+w: ↑
alt+x: ↓
alt+s: save json
alt+r: replace
alt+q: model1 translate
alt+e: model2 translate

v1.0.6更新内容

更新文件合并功能，方便多人协作。在文件合并页中可将依照指示将两个json文件合并，同步人工翻译进度。并支持导出小规模json文件方便传输。

v1.0.5更新内容

支持键盘快捷键

v1.0.4更新内容

追加摸鱼模式, 将必要组件集中在半个屏幕内。在config.json中moyu_mode设为1开启, 设为0关闭
加入对GPT翻译的超时检测, 时间上限在config.json的openai_api_settings中的time_limit处设置, 单位为秒。若请求超时, 会打印超时提示, 但不会报错）
GPT翻译现在将不返回重复结果

v1.0.3更新内容

支持预览页直接修改译文, 建议保存JSON后再使用此功能
可选是否即时更新上次编辑id

config.json中设置"if_save_id_immediately"参数, 若为1则逻辑与之前一样, 在切换id时立刻保存进config.json；若为0则会显示保存编辑id按钮SAVE last edited position, 在点击后存入config.json。

v1.0.2更新内容

支持批量机翻

v1.0.1更新内容

优化文件读取逻辑
增加错误提示、警告等。保存JSON成功时会提示更新的译文条数
允许自定义传输到gpt的prompt、自定义百度翻译的原文及目标语言
追加上下文预览功能, 并允许自定义预览条数和编号。指定id将会以双星号标记, 修改过的译文将会在前面加星号标记
优化按钮手感

特性

一键机翻接口, 提供复制到剪贴板按钮
便捷的上下句切换, 直接跳转功能
记忆上次编辑位置功能
人名翻译记忆功能, 一次修改将会同步到全体。人名词典在程序启动时读取并在保存JSON文件时保存。开启程序时可以直接改name_cn, 关闭程序后可以修改人名词典。下次开启程序时人名词典中的内容将会覆盖JSON文件中的name_cn。
文本翻译记忆功能, 机翻/修改后只要不关闭程序, 切换上下句, 刷新网页都不会影响
译文缓存。相对地原文不会缓存, 所以手滑改或删掉只要切换或者刷新即可恢复。因此想查看原文具体某个词的翻译也可以直接编辑原文再机翻, 不会影响原文本。
一键替换功能, 用于专有名词错译的情况。会将机翻及手翻文本中的对象全部替换。替换词典可以在运行中直接更改, 不用重开程序。
便利的api key管理及prompt修改等
提供JSON文件与CSV文件互转
上下文预览功能