Skip to content

Commit 383a7e5

Browse files
authored
Update README.md
1 parent 76343be commit 383a7e5

1 file changed

Lines changed: 72 additions & 1 deletion

File tree

README.md

Lines changed: 72 additions & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -1 +1,72 @@
1-
# -Universal-Language-Tool
1+
🌍 Universal Language Tool (多语言处理工具)
2+
Version 1.0.0 基于大语言模型(LLM)的自动化 Excel 翻译工具,支持批量对游戏文本进行初步翻译;支持自定义源语言、多种目标语言。
3+
4+
✨ 核心特性
5+
🚀 多模型支持:预设了 DeepSeek (V3/Chat)、GPT-4o、Gemini 2.5、Llama 3 等国内外主流大模型接口,支持手动扩展自定义 API。
6+
7+
🛡️ 专业本地化保护:
8+
9+
占位符保护:强制保留 {0}, {name} 等程序占位符,严禁修改。
10+
11+
富文本标签保护:识别并保留 <color>, <size> 等渲染标签及其结构。
12+
13+
上下文感知:系统提示词针对游戏 UI 文案优化,保持用语简洁、严谨。
14+
15+
📂 流程自动化:
16+
17+
Excel 批处理:支持读取指定起始单元格(如 A2)并纵向扩展。
18+
19+
拖拽上传:集成 TkinterDnD,支持直接将 Excel 文件拖入界面。
20+
21+
断点续传逻辑:自动识别已翻译内容,避开报错行,节省 Token。
22+
23+
🛠️ 易用性设计:
24+
25+
配置记忆:自动保存 API Key、Base URL 及最后使用的模型。
26+
27+
实时日志:滚动显示翻译进度与单行状态,翻译完成后可一键跳转文件夹。
28+
29+
📦 环境准备
30+
确保你的 Python 环境(推荐 3.8+)已安装以下依赖库:
31+
32+
Bash
33+
pip install pandas openai tkinterdnd2 openpyxl
34+
注意:由于使用了 tkinterdnd2,如果打包为 .exe,请确保包含相关的 tkdnd 动态库。
35+
36+
🚀 使用指南
37+
1. API 配置
38+
在界面顶部的 “大模型 API 配置” 栏中,输入你的 API Key。
39+
40+
从下拉菜单选择预设模型(如 deepseek-chat),系统会自动填充对应的 Base URL。
41+
42+
支持手动修改 Base URL 以适配中转站或私有部署模型。
43+
44+
2. 任务设置
45+
选择文件:点击“浏览”或直接拖拽 Excel 文件到输入框。
46+
47+
翻译范围:输入起始坐标(例如 A2 代表从第二行第一列开始翻译)。
48+
49+
语言设置:填入源语言(默认中文)及目标语言(支持多个,用逗号分隔,如 英语,日语,韩语)。
50+
51+
3. 执行翻译
52+
点击 “🚀 开始执行翻译”。
53+
54+
工具会按目标语言顺序在原 Excel 中插入新列存放翻译结果。
55+
56+
支持自命名输出文件;若未命名,文件将以 多语言处理完成_[时间戳].xlsx 命名保存。
57+
58+
🛠️ 技术实现细节
59+
GUI 框架:Tkinter + TkinterDnD2 (实现跨平台拖拽)。
60+
61+
数据处理:Pandas (用于高效处理 Excel 读写)。
62+
63+
通信协议:OpenAI SDK 兼容协议 (适配绝大多数 LLM 提供商)。
64+
65+
配置文件:translator_config.json (本地持久化存储)。
66+
67+
⚠️ 注意事项
68+
网络环境:使用 OpenAI、Gemini 等国外模型时,需确保网络环境能够正常访问其 API 地址。
69+
70+
费用提示:翻译过程会消耗相应模型的 Token,建议先用小规模数据测试 Prompt 效果。
71+
72+
格式限制:目前版本仅支持 .xlsx 和 .xls 格式。

0 commit comments

Comments
 (0)