|
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