GameStringer - 完整指南

June 25, 2026 · View on GitHub

目录

  1. 初始设置
  2. 商店连接
  3. 游戏库
  4. 翻译游戏(自动翻译)
  5. 引擎补丁
  6. Unity CSV翻译器
  7. BepInEx + XUnity
  8. AI流水线多代理
  9. AI翻译器
  10. OCR翻译器与多引擎
  11. 语音翻译器
  12. 批量与离线翻译
  13. 弹丸论破补丁
  14. 预测工具与QA检查
  15. 词汇表、TM与自适应MT
  16. 高级工具
  17. 安全与恢复密钥
  18. 故障排除
  19. 社区聊天(实时) (v1.5.0 新功能)

阶段1:初始设置

首次启动

启动GameStringer。首次运行时会出现个人资料创建界面。

创建个人资料

  • 名称:选择一个名称(例如"Mario Gaming")
  • 头像:选择颜色/渐变
  • 密码:至少4个字符
  • 点击**"创建个人资料"** — 自动认证

界面

  • 侧边栏(左侧):各板块导航
  • 仪表盘(中央):游戏概览、统计、AI引擎小部件
  • Ctrl+K:全局快速搜索,可访问任何页面

阶段2:商店连接

支持的商店

Steam、Epic Games、GOG、Ubisoft Connect、Origin/EA、Battle.net、Itch.io、Rockstar、Amazon Games。

Steam配置(优先)

  1. https://steamcommunity.com/dev/apikey 获取API密钥
  2. https://steamid.io/ 查找你的Steam ID64
  3. 在GS中:设置 → 输入API密钥和Steam ID
  4. Steam个人资料必须设为公开

GS还会检测Steam家庭共享的游戏。


阶段3:游戏库

  • 侧边栏 → "游戏库" 或 仪表盘 → "更新游戏库"
  • 数百款游戏加载需1-2分钟
  • 点击游戏:详情、检测到的引擎、路径、**"翻译游戏"**按钮

阶段4:翻译游戏

侧边栏 → "翻译游戏"(自动翻译)。GameStringer的核心功能。

工作流程

  1. 选择游戏 — 从游戏库或手动输入路径
  2. 扫描:检测引擎(Unity、Unreal、Godot、RPG Maker、Ren'Py等)和可翻译文件
  3. 智能自动选择:为检测到的引擎推荐最佳方法
  4. AI翻译:使用配置的AI引擎翻译字符串
  5. 审核:审查、编辑、批准
  6. 应用补丁:自动备份 + 应用

Unity智能自动选择

类型推荐方法替代方案
Unity Mono(无BepInEx)Unity CSV翻译器BepInEx + XUnity
Unity Mono(已有BepInEx)Unity CSV翻译器AI翻译已捕获字符串
Unity IL2CPPUnity CSV翻译器无(BepInEx不兼容)

已检测引擎

Unity(Mono/IL2CPP)、Unreal Engine、Godot、RPG Maker、Ren'Py、Source Engine、CryEngine、RE Engine、Frostbite、id Tech、Creation Engine、Construct、AGS、Defold、Love2D。


阶段5:引擎补丁

侧边栏 → 补丁引擎补丁。5个专用补丁工具:

  • Unity:用于Mono的BepInEx + XUnity AutoTranslator
  • Unreal Engine:.locres文件翻译(UE4/UE5)
  • Godot:.pck文件提取/翻译/重新打包(Godot 3/4)
  • RPG Maker:MV/MZ的JSON翻译(对话、物品、技能)
  • Ren'Py:.rpy文件翻译(视觉小说)

阶段6:UNITY CSV翻译器

Unity游戏(Mono和IL2CPP)的最佳方法

工作原理

  1. 扫描Unity资源(resources.assets等)
  2. 提取CSV本地化表
  3. 使用AI翻译(Ollama或云端)
  4. 通过调整大小注入注入翻译(零截断)

优势

  • 适用于所有Unity游戏(Mono和IL2CPP)
  • 调整大小确保零截断
  • 完整覆盖(所有字符串,不仅是屏幕上的)
  • 无外部依赖
  • 自动备份(.backup)和恢复

阶段7:BEPINEX + XUNITY

用于Unity Mono游戏 — 游戏过程中的实时翻译。

  1. GS检测Unity游戏并找到exe
  2. 点击**"安装BepInEx + XUnity"**
  3. 启动游戏 — XUnity捕获屏幕字符串
  4. 关闭并返回GS — 使用AI翻译捕获的字符串

限制:不适用于IL2CPP(会导致崩溃)。IL2CPP请使用Unity CSV翻译器。


阶段8:AI流水线

使用Ctrl+K搜索**"AI Pipeline"**。高质量的多步骤系统。

6个步骤

收集 → 翻译 → QA检查 → 自动修复 → 审核 → 评分

3种模式

  • 快速:翻译 + QA(快速)
  • 均衡:+ 自动修复(推荐)
  • 最高质量:全部6步,阈值75,最多3次尝试

多代理

为每个步骤分配不同模型(例如qwen用于翻译,gemma用于审核)。4个预设:默认、速度、最高质量、多样化。

基准测试

执行历史,包含分数、持续时间、每字符串毫秒数。预设比较。


阶段9:AI翻译器

侧边栏 → 翻译AI翻译器

提供商

  • Ollama(本地、免费)、OpenAI/GPT-4ClaudeGeminiDeepLLingva

功能

  • 单条或批量翻译
  • 自动检测源语言
  • 风格:自然、直译、游戏
  • 占位符保留({0}、%s、\n)
  • 集成词汇表 + 翻译记忆 + 自适应MT

阶段10:OCR翻译器

侧边栏 → 翻译OCR翻译器

实时翻译屏幕文本:

  • 手动截图或选择区域
  • 持续实时OCR
  • 全局快捷键:Ctrl+Shift+T

OCR多引擎

4个引擎:OneOCR(Win11)、PaddleOCR(CJK)、RapidOCR(ONNX)、Tesseract(后备)。

  • 自动引擎探测
  • 自动后备链
  • 并行比较模式

阶段11:语音翻译器

侧边栏 → 翻译语音翻译器

  • 游戏内语音识别
  • 音频 → 翻译文本
  • 实时字幕叠加

阶段12:批量与离线翻译

批量

侧边栏 → 翻译批量。翻译整个文件夹:

  • 支持 .txt、.json、.csv、.po、.xml、.rpy、.ini
  • 每个文件的实时进度
  • AI流水线选项以获得最高质量

离线(Ollama)

侧边栏 → 翻译离线翻译器

  • 使用Ollama完全本地翻译
  • 无需互联网连接
  • 完全隐私 — 数据不会离开你的电脑

阶段13:弹丸论破补丁

使用Ctrl+K搜索**"Danganronpa"**。

功能

  1. 应用补丁标签:选择Steam游戏,查看WAD文件,应用补丁
  2. WAD提取器标签:提取、搜索、过滤和翻译35,865个字符串
  3. AI批量翻译:选择字符串 → AI翻译 → 导出JSON
  4. 导出可分发.zip:已补丁WAD + 自动安装器 + 说明
  5. 游戏内:设置 → Control Hints → "Keyboard and Mouse"

阶段14:预测工具与QA检查

预测工具

使用Ctrl+K搜索。翻译前分析游戏:

  • 估计字符串和单词数量
  • 每个提供商的估计成本(DeepL、OpenAI、本地)
  • 每种方法的估计时间
  • 推荐的翻译链

QA检查

使用Ctrl+K搜索。翻译后质量控制:

  • 占位符验证
  • 数字和值检查
  • 字符串长度验证
  • 格式和标点检查
  • 每字符串质量评分

阶段15:词汇表、TM与自适应MT

词汇表

使用Ctrl+K搜索。每个游戏的自定义术语:

  • 添加术语(例如"quest" → "任务")
  • 类别:游戏性、UI、角色、世界观
  • 自动集成到AI翻译中

智能词汇表

从游戏文件分析自动生成词汇表。

翻译记忆

仪表盘 → "TM条目"小部件。翻译记忆:

  • 自动保存每个翻译对
  • 重用先前的翻译
  • Rust后端确保性能

自适应MT

从你的修正中学习:

  • 保存:原文 → AI → 人工修正
  • 通过三元组/词语相似度查找相似修正
  • 将少样本示例注入AI提示
  • 随时间改进

阶段16:高级工具

上下文收集器

扫描游戏文件并提取AI翻译的上下文。

翻译编辑器

带有过滤和搜索功能的高级字符串审核编辑器。

字幕叠加

游戏内实时翻译字幕叠加。

ROM补丁

应用和创建IPS/BPS补丁用于复古翻译(SNES、GBA等)。

导出格式

导出翻译为:PO、XLIFF、CSV、JSON、TMX。

社区中心

分享翻译、投票、评论、下载社区翻译。


阶段17:安全

恢复密钥

创建个人资料时会生成恢复密钥(12个助记词)。

  • 复制或下载为.txt
  • 请保存在安全的地方!

密码恢复

登录界面 → "忘记密码?" → 输入12个词 → 新密码。


阶段18:故障排除

游戏未找到

  • 确认已安装且Steam/Epic已打开
  • 更新游戏库并重启GS

翻译未应用

  • 完全重启游戏
  • 检查文件写入权限
  • 以管理员身份运行GS

AI无响应

  • 检查互联网连接(云提供商)
  • Ollama:确认正在运行(侧边栏绿点)
  • 尝试其他引擎

补丁后游戏崩溃

  • 在使用的工具中点击**"恢复备份"**
  • 在Steam上验证文件完整性(右键 → 属性 → 本地文件)

Unity IL2CPP + BepInEx = 崩溃

  • GS现在自动阻止IL2CPP的BepInEx
  • 改用Unity CSV翻译器

Ollama缓慢或无响应

  • 侧边栏:绿点 = 在线,红点 = 离线
  • Ollama管理器 → 检查已安装模型
  • 推荐:7B模型用于速度,13B+用于质量

阶段19:社区聊天

(v1.5.0 新功能)

集成到Community Hub的实时聊天,由Supabase Realtime驱动。

访问方式

  1. 从侧边栏进入Community Hub
  2. 点击聊天标签或右下角的聊天图标
  3. 如果您已登录GameStringer个人资料,将自动连接

默认聊天室

  • 综合:GameStringer社区自由聊天
  • 翻译:讨论翻译、寻求帮助、分享进展
  • 反馈与Bug:报告错误和建议改进
  • 公告:官方新闻和更新

功能

  • 实时消息:通过Supabase Realtime即时显示
  • 在线状态:查看谁在线
  • 回复消息:点击回复
  • 编辑/删除:编辑或删除您的消息
  • 创建自定义聊天室:为项目或游戏创建专用聊天室
  • 自动登录:通过GameStringer个人资料自动连接

v1.9.0 新功能

Bethesda 引擎补丁器

  • 支持游戏: Skyrim LE/SE/AE、Fallout 3/NV/4、Oblivion、Starfield
  • 归档格式: BSA v103/v104/v105 和 BA2 (GNRL + DX10)
  • 插件: ESP/ESM 解析并提取可翻译记录
  • 本地化字符串: STRINGS、DLSTRINGS、ILSTRINGS

CRI 中间件补丁器

  • 支持游戏: 女神异闻录5皇家版、如龙、Tales of、七龙珠等 CRI 作品
  • 归档: CPK 和 CRILAYLA 解压
  • 消息格式: MSG、BMD、FTD

Unity Localization 包

  • 官方 Unity Localization 包的完整流水线 (Unity 2021.3+)
  • StringTable + SharedTableData、Addressables、Smart Strings
  • 占位符和复数形式验证器

通用 PO 导出

  • 各补丁器的 gettext PO 导出(含完整元数据)
  • 兼容 Poedit、Weblate、Crowdin

无障碍 WCAG 2.1 AA

  • aria-label、语义标题、focus-visible
  • 跳转链接、prefers-reduced-motion、Windows 高对比度

设计系统和 OCR

  • 通过 cva 的 Card 变体、Button xs/icon-sm
  • 使用真实 Tauri Tesseract 后端替换 OCR 桩
  • 修复: 托盘模式下 Windows 控制台闪烁循环

Patch Hub(社区翻译包)

Patch Hub 是一个类似 Steam Workshop 的市场,用于分享和下载社区翻译包,由 GameStringer 社区服务器提供支持。可从侧边栏中的 Patch Hub 入口打开(橙色/琥珀色区域)。

浏览翻译包

主视图列出已发布的翻译包,并提供搜索和排序功能(下载量最多、评分最高、最近更新、完成度)。每张卡片显示游戏、源语言→目标语言、完成度百分比、评分和下载次数。点击某个翻译包可打开其详情页面,查看统计数据、说明、包含的文件和更新日志。

下载翻译包

在翻译包的详情页面上,点击 Download(下载)。GameStringer 会从社区服务器获取该翻译包的所有文件,并将它们作为 .gspack 包保存到本地的翻译包库中(Documents/GameStringer/packs)。在那里你可以管理该翻译包,并从游戏的详情页面将其导入以应用翻译。

发布翻译包

点击 Publish patch(发布补丁)以打开发布表单。填写翻译包名称、游戏、源语言和目标语言、可选的说明和标签,并附上你的翻译文件。当你登录到 Community Hub 后,翻译包会上传到社区服务器,并在公开可见之前进入审核队列。如果你未登录,翻译包会保留为本地草稿——登录后再次发布即可将其分享到线上。

在线发布需要 Community Hub 账户(与你的本地配置文件不同)。浏览和下载无需账户即可使用。


v1.8.1 新功能

实时翻译叠加层

  • 前往 /live-translate 页面或按 Ctrl+Alt+O
  • 选择源语言/目标语言和AI提供商
  • 点击 开始 — 叠加层出现在游戏上方
  • 通过OCR每2秒捕获文本
  • 翻译以透明叠加框形式显示
  • 差异检测跳过未更改的文本(节省API调用)

Hub市场

  • 前往 Community Hub 浏览翻译包
  • 一键安装:下载 → 验证 → 导入
  • 评价和评论社区翻译包
  • 将自己的翻译发布为 .gspack 文件
  • 带有声望和徽章的用户资料

翻译记忆网络

  • 设置 → TM网络 中启用
  • 选择加入:您的高质量翻译贡献到全球池
  • 隐私优先:源文本经过哈希处理,不共享用户数据
  • 翻译同一游戏的下一个用户获得预填充建议
  • 自动集成到翻译流水线

AI配音流水线

  • 前往 /dubbing 页面
  • 选择游戏文件夹并配置语言/语音
  • 7步流水线:扫描 → 转录 → 翻译 → 合成 → 补丁 → 口型同步 → 字幕
  • 时长匹配使翻译音频与原始音频保持相同长度
  • 16种原型的角色语音配置文件

插件系统

  • 社区可以使用JavaScript创建新的游戏引擎补丁工具
  • 无需Rust编译
  • 模板生成器创建完整的插件脚手架
  • 插件以 .gsplugin 包形式分发

v1.9.0 新功能

Community Hub UI 改进

  • 重新设计的 Community Hub: 更干净、一致的设计,没有过度的渐变和装饰性 blob
  • 紧凑的 KPI 卡片: 更小、更微妙的统计卡片,颜色最小化
  • 极简 Category Cards: 没有重渐变和阴影的干净设计
  • 统一的 Trending 卡片: 所有卡片类型的一致风格

紧凑的朋友侧边栏

  • 宽度减小: 从 72 减到 56 (w-56) 以获得更多屏幕空间
  • 紧凑的朋友卡片: 更小的头像 (7x7),更紧凑的间距
  • 更小的部分: 在线/离线标题文本减小
  • 超细滚动条: 4px,默认不可见,悬停时显示

持久聊天改进

  • 离散聊天按钮: 右下角优雅的小按钮
  • 在所有页面上可见: 在整个应用程序中可访问聊天
  • 更干净的设计: 移除了过度的动画和装饰

Supabase 社交功能

  • 兼容模式: 与前端期望对齐的 Supabase 社交模式 (tools/supabase_social_compatible.sql)
  • RLS 临时禁用: 为了更容易调试社交功能
  • 修复聊天参与者: 为 UUID 验证修正列名

错误修复

  • 修复聊天循环: 添加 chatAttempted 状态以防止 startDirectChat 中的无限循环
  • 删除 Mock 数据: 删除导致 400 错误的无效 UUID 模拟数据 (user-123 等)
  • 修复 Ollama IPC: 所有 check_ollama_status IPC 调用替换为直接 HTTP 到 localhost:11434
  • 商店链接: 在侧边栏资源部分添加商店链接
  • Epic 连接: 从损坏的 OAuth 更改为凭据模态
  • 连接测试: testConnection 现在使用真实的 Tauri 命令而不是模拟 API
  • 修复断开连接: 在 Tauri 后端添加 Epic/Steam 凭据删除
  • 修复 Presence: 在 updatePresence 中添加会话守卫以避免 400 Bad Request

v1.9.0 新功能

🟢 统一在线状态

结合 Supabase Realtime 和数据库的统一在线状态系统:

  • 即时更新:在线用户实时显示(Supabase Realtime Presence)
  • 全局心跳:在线状态每30秒自动更新
  • 自动离开:窗口2分钟以上未聚焦,状态变为"离开"
  • 自动在线:窗口重新获得焦点时,状态恢复为"在线"
  • 数据库回退:Realtime不可用时,系统使用数据库作为回退
  • 更新的小组件:"在线用户"小组件显示用户名、头像和Realtime指示器

🔔 系统托盘通知

重要事件的原生操作系统通知:

  • 💬 聊天消息:在社区聊天中收到消息时的操作系统通知
  • ✅ 翻译完成:翻译成功完成时的通知
  • ❌ 翻译/系统错误:严重错误的通知(始终可见)
  • 🔄 应用更新:GameStringer有可用更新时的通知
  • 🎮 游戏更新:更新的游戏可能使补丁失效时的通知
  • 🟢 好友在线:好友上线时的通知
  • 📰 新闻:社区新闻和更新的通知

配置:设置 → 通知 → 系统托盘通知

  • 每种通知类型的开关
  • 静默时段:在特定时间段抑制通知(如23:00-07:00)
  • 测试按钮:发送测试通知以验证功能
  • 托盘提示:托盘图标显示未读通知数量

🛡️ 错误边界 + 崩溃恢复

组件崩溃保护:

  • WidgetErrorBoundary:小组件崩溃时显示简洁消息,5秒后自动尝试恢复(最多3次)
  • AppErrorBoundary:整个应用崩溃时显示错误界面和"重新加载应用"选项
  • 自动恢复:小组件无需用户干预即可自动恢复

🌐 网络韧性 / 离线模式

断连的优雅处理:

  • 网络监控:检测在线/离线状态 + 每30秒Supabase健康检查
  • 连接状态栏:离线时顶部红色条,Supabase宕机时琥珀色,连接恢复时绿色
  • 退避重试:失败的网络操作自动以指数退避(1秒、2秒、4秒)重试
  • 离线队列:离线时操作(聊天消息、状态更新)排队,连接恢复时执行
  • "离线模式":连接恢复时更改将自动同步

🎙️ 角色语音档案(语音克隆)

翻译时保留角色"声音"的系统:

  • 自动提取:分析游戏对话字符串以识别角色及其语言风格
  • 16种可用语调:正式、随意、激进、温柔、神秘、幽默、戏剧、坚忍、讽刺、睿智、童真、高贵、海盗、军事、学术、街头
  • 5个正式级别:非常正式 → 非常非正式
  • 5个年龄组:儿童、青少年、青年、成人、老年
  • 语音模式:自动识别模式(古词、感叹、频繁提问)
  • 口头禅:自动识别角色重复表达
  • 提示注入:语音档案自动注入翻译提示以保持角色一致性
  • 默认档案:为未识别角色设置回退档案

使用方法

  1. 在自动翻译页面加载文件后,出现"角色语音档案"面板
  2. 点击**"自动提取"**分析对话
  3. 或使用**"新建档案"**手动创建
  4. 档案在翻译时自动应用

🧠 微调基础设施

生成训练数据集和管理游戏专用模型的系统:

  • 从修正生成数据集:从人工修正生成JSONL数据集(Adaptive MT)
  • 4种导出格式:OpenAI JSONL、Ollama JSONL、Alpaca JSON、ChatML TXT
  • 仅已批准:数据集中仅使用已批准修正的选项
  • 模型管理:注册和管理游戏专用微调模型
  • Ollama集成:检查Ollama可用性以进行本地训练
  • 数据集统计:示例数量、平均长度、质量评分

使用方法

  1. 前往设置 → AI → 微调基础设施
  2. 选择语言对并点击**"生成"**
  3. 点击**"导出"**以所需格式下载
  4. 使用数据集通过Ollama或云提供商进行微调

⚡ 代码分割 / 懒加载

启动时间优化:

  • 8个重型组件(聊天、后台任务、命令面板等)仅在需要时加载
  • 应用启动更快,内存使用更少

GameStringer v1.9.0 - 指南更新于 2026/04/26