如何使用YUKI Galgame翻译器：让日语游戏秒变中文的完整指南

YUKI Galgame翻译器是一款专为Galgame爱好者设计的实时翻译工具，采用Electron框架和原生Windows API打造，帮助玩家轻松突破语言障碍，享受沉浸式游戏体验。无论是离线词典还是在线API，YUKI都能提供流畅、高效的翻译服务，让你告别传统翻译软件的卡顿与繁琐！

🚀 核心功能：为什么选择YUKI？

YUKI翻译器凭借以下特性脱颖而出，成为Galgame玩家的必备工具：

✅ 多引擎支持，翻译精准无忧

内置J北京词典、灵格斯词典等离线资源，同时兼容百度、有道等在线API（配置文件路径：config/baiduApi.js）。无论有无网络，都能稳定输出高质量翻译结果。

✅ 实时文本提取，零延迟体验

通过TextractorCLI（路径：lib/textractor/TextractorCLI.exe）深度整合Windows系统，精准捕获游戏文本，毫秒级响应速度让翻译与剧情同步。

✅ 高度自定义，打造专属翻译流程

支持编写个性化翻译插件（源码路径：src/main/translate/），从文本过滤、分词到合并，全流程可通过中间件灵活配置，满足你对翻译细节的极致追求。

✅ 简洁UI设计，操作一目了然

现代化界面布局（主界面组件：src/renderer/components/GamesPage.vue）让新手也能快速上手，一键启动翻译、切换词典、调整窗口透明度，所有操作触手可及。

📥 快速上手：3步开启翻译之旅

1️⃣ 环境准备：轻松配置依赖

YUKI基于Node.js开发，确保系统已安装Node.js（建议v14+）和yarn。克隆仓库后执行以下命令安装依赖：

git clone https://gitcode.com/gh_mirrors/yu/YUKI
cd YUKI
yarn install

2️⃣ 词典配置：离线/在线双选择

• 离线词典：将J北京词典文件放入lib/dict/jb/目录，支持@jichi、@najizhimo等多个词典版本。
• 在线API：编辑config/baiduApi.js填入你的API密钥，即可启用百度翻译接口。

3️⃣ 启动游戏翻译：3种方式任你选

• 进程挂钩：通过游戏进程名称自动关联（配置路径：src/main/config/GamesConfig.ts）。
• 手动选择：在主界面点击「添加游戏」，手动定位游戏可执行文件。
• 快捷键启动：自定义全局热键，游戏中一键呼出翻译窗口（设置路径：src/renderer/components/TranslatorSettings.vue）。

⚙️ 进阶技巧：让翻译体验更上一层楼

📝 文本优化：告别乱码与重复

• 过滤规则：通过src/main/middlewares/FilterMiddleware.ts设置关键词过滤，自动屏蔽系统提示文本。
• 合并长句：启用TextMergerMiddleware（路径同上），解决游戏文本碎片化问题，让翻译更连贯。

🖥️ 窗口美化：自定义你的翻译面板

调整透明度、字体大小和背景色，让翻译窗口完美融入游戏场景。配置文件路径：src/main/config/GuiConfig.ts。

🧪 调试模式：轻松排查问题

开启调试日志（路径：test/unit/specs/main/），实时查看文本提取与翻译过程，快速定位异常。

📚 资源与支持

• 官方文档：docs/ConfigFiles_CN.md 提供详细配置说明。
• 常见问题：docs/FAQ_CN.md 解答90%用户遇到的问题。
• 源码贡献：项目采用TypeScript开发，核心翻译逻辑位于src/main/translate/TranslationManager.ts，欢迎提交PR！

🌟 为什么选择YUKI？

相比传统翻译工具，YUKI以高性能、可扩展性和用户友好三大优势，重新定义Galgame翻译体验。无论是日语小白还是资深玩家，都能通过YUKI轻松跨越语言障碍，专注于剧情本身。现在就加入YUKI社区，让每一款Galgame都不再有语言门槛！

提示：首次使用建议先阅读docs/ConfigFiles_CN.md，获取最佳配置方案。