GameStringer - 完整指南
June 25, 2026 · View on GitHub
目录
- 初始设置
- 商店连接
- 游戏库
- 翻译游戏(自动翻译)
- 引擎补丁
- Unity CSV翻译器
- BepInEx + XUnity
- AI流水线多代理
- AI翻译器
- OCR翻译器与多引擎
- 语音翻译器
- 批量与离线翻译
- 弹丸论破补丁
- 预测工具与QA检查
- 词汇表、TM与自适应MT
- 高级工具
- 安全与恢复密钥
- 故障排除
- 社区聊天(实时) (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配置(优先)
- 从 https://steamcommunity.com/dev/apikey 获取API密钥
- 从 https://steamid.io/ 查找你的Steam ID64
- 在GS中:设置 → 输入API密钥和Steam ID
- Steam个人资料必须设为公开
GS还会检测Steam家庭共享的游戏。
阶段3:游戏库
- 侧边栏 → "游戏库" 或 仪表盘 → "更新游戏库"
- 数百款游戏加载需1-2分钟
- 点击游戏:详情、检测到的引擎、路径、**"翻译游戏"**按钮
阶段4:翻译游戏
侧边栏 → "翻译游戏"(自动翻译)。GameStringer的核心功能。
工作流程
- 选择游戏 — 从游戏库或手动输入路径
- 扫描:检测引擎(Unity、Unreal、Godot、RPG Maker、Ren'Py等)和可翻译文件
- 智能自动选择:为检测到的引擎推荐最佳方法
- AI翻译:使用配置的AI引擎翻译字符串
- 审核:审查、编辑、批准
- 应用补丁:自动备份 + 应用
Unity智能自动选择
| 类型 | 推荐方法 | 替代方案 |
|---|---|---|
| Unity Mono(无BepInEx) | Unity CSV翻译器 | BepInEx + XUnity |
| Unity Mono(已有BepInEx) | Unity CSV翻译器 | AI翻译已捕获字符串 |
| Unity IL2CPP | Unity 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)的最佳方法。
工作原理
- 扫描Unity资源(resources.assets等)
- 提取CSV本地化表
- 使用AI翻译(Ollama或云端)
- 通过调整大小注入注入翻译(零截断)
优势
- 适用于所有Unity游戏(Mono和IL2CPP)
- 调整大小确保零截断
- 完整覆盖(所有字符串,不仅是屏幕上的)
- 无外部依赖
- 自动备份(.backup)和恢复
阶段7:BEPINEX + XUNITY
用于Unity Mono游戏 — 游戏过程中的实时翻译。
- GS检测Unity游戏并找到exe
- 点击**"安装BepInEx + XUnity"**
- 启动游戏 — XUnity捕获屏幕字符串
- 关闭并返回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-4、Claude、Gemini、DeepL、Lingva
功能
- 单条或批量翻译
- 自动检测源语言
- 风格:自然、直译、游戏
- 占位符保留({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"**。
功能
- 应用补丁标签:选择Steam游戏,查看WAD文件,应用补丁
- WAD提取器标签:提取、搜索、过滤和翻译35,865个字符串
- AI批量翻译:选择字符串 → AI翻译 → 导出JSON
- 导出可分发.zip:已补丁WAD + 自动安装器 + 说明
- 游戏内:设置 → 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驱动。
访问方式
- 从侧边栏进入Community Hub
- 点击聊天标签或右下角的聊天图标
- 如果您已登录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个年龄组:儿童、青少年、青年、成人、老年
- 语音模式:自动识别模式(古词、感叹、频繁提问)
- 口头禅:自动识别角色重复表达
- 提示注入:语音档案自动注入翻译提示以保持角色一致性
- 默认档案:为未识别角色设置回退档案
使用方法:
- 在自动翻译页面加载文件后,出现"角色语音档案"面板
- 点击**"自动提取"**分析对话
- 或使用**"新建档案"**手动创建
- 档案在翻译时自动应用
🧠 微调基础设施
生成训练数据集和管理游戏专用模型的系统:
- 从修正生成数据集:从人工修正生成JSONL数据集(Adaptive MT)
- 4种导出格式:OpenAI JSONL、Ollama JSONL、Alpaca JSON、ChatML TXT
- 仅已批准:数据集中仅使用已批准修正的选项
- 模型管理:注册和管理游戏专用微调模型
- Ollama集成:检查Ollama可用性以进行本地训练
- 数据集统计:示例数量、平均长度、质量评分
使用方法:
- 前往设置 → AI → 微调基础设施
- 选择语言对并点击**"生成"**
- 点击**"导出"**以所需格式下载
- 使用数据集通过Ollama或云提供商进行微调
⚡ 代码分割 / 懒加载
启动时间优化:
- 8个重型组件(聊天、后台任务、命令面板等)仅在需要时加载
- 应用启动更快,内存使用更少
GameStringer v1.9.0 - 指南更新于 2026/04/26