【教程】给生肉 Galgame 加上假名、音调和语境解释：KotobaSenpai 安装与使用

Labrynth Oneisan — Invalid Date

啃生肉 Galgame 时，汉字不会读、单词查完还是看不懂整句话？ KotobaSenpai 是一款免费开源的 Windows 日语阅读助手，通过 OCR 识别游戏台词，把读音和解释放回正在看的游戏画面里，减少切出去查词、查语法对阅读的打断。

它主要帮你做三件事：

适合正在尝试原版 Galgame、希望边推剧情边学日语的朋友。下面先看实际效果，再按步骤完成安装、API 配置和窗口识别。

1. 安装前准备

本文按 v1.0.2 正式版整理（2026-11-15），后续版本请以发布页和软件界面为准。

完整安装包包含 .NET 10 运行环境、两种 OCR 模型和日语词典，不需要先安装 Python、开发环境或另下词典。词典在首次启动时自动准备；但语境分析仍需配置可用的 AI 服务，不能把“内置词典”理解为整个流程都能离线运行。

打开上面的“下载最新版”，找到发布页下方的 Assets。
下载 KotobaSenpai-1.0.2-win-x64-Setup.exe。不带版本号的 KotobaSenpai-win-x64-Setup.exe 在当前版本中是同一个安装包，任选一个即可。
运行安装包，按向导完成安装，再启动 KotobaSenpai。当前安装器采用用户级安装，无需管理员权限。
等待内置词典和识别资源准备完成，进入首次引导。

Source code (zip) / Source code (tar.gz) 是源码，普通使用请选择上面的 Setup 安装包。

在首次引导的“配置大模型”步骤，或之后的设置页中，按服务商接入文档填写：

项目	怎么填
协议	服务商支持的 OpenAI Chat Completions、OpenAI Responses 或 Anthropic Messages
API 地址	服务商给出的 API 基础地址或完整接口地址，不能直接填聊天网页地址
API Key	从该服务商取得的有效密钥
模型	点击“获取模型”后选择，或填写准确的模型 ID

填好后点击 “检测配置是否可用”。看到绿色勾和“下方配置可以使用”，再继续选择游戏窗口。检测会执行真实的日语分析请求，可能产生少量 API 费用。

如果服务商不提供模型列表，“获取模型”失败不一定代表服务不可用，可以按文档手动填写模型 ID 后检测。手动检测只检查当前填写内容，不会替你切换协议或修正地址。

平时使用 Codex、Claude Code、Cursor 等本机编程助手的朋友，可以使用 “让 AI 帮我配置 API” → “复制配置提示词”：

这一步需要 Agent 在安装 KotobaSenpai 的那台 Windows 电脑上操作。保存配置时软件会暂时退出并中断识别，随后恢复界面；若已提示保存成功但界面没恢复，手动打开软件即可。

API Key 只填到自己的配置流程中，发帖求助时不要贴出来。

选窗本身不会开始识别。识别区域尽量只包含要读的文字，少带菜单、背景和其他 UI；区域越小，识别处理也越快。游戏窗口关闭后，需要重新选择。

可以先自己读原文，卡住时看读音和词义，最后再展开译文。AI 解释也可能有误，拿不准的专有名词和句子，仍建议结合原文、语音和词典确认。

现象	优先检查
API 认证失败	Key 是否填对，以及服务商账号是否有可用额度
能填模型，但检测失败	协议、API 地址、模型 ID 是否互相匹配；查看错误详情
窗口预览失败或捕获超时	恢复游戏窗口、保持未最小化，再重试预览或重新选窗
提示选区没有可识别日语	游戏是否已显示日文台词，区域是否框到了文字；特殊字体也可能影响识别
翻页后标注没有更新	是否已开始识别、开启自动识别，或处于“隐藏并暂停”状态；可先手动识别确认
暂无整句译文	开启整句翻译后需要重新识别，旧结果可能没有生成译文

API 检测失败时，可以使用 “复制错误信息” 获取脱敏详情。反馈时附上软件版本、Windows 版本、游戏名、问题截图和复现步骤，发到本帖或 GitHub Issues，会更方便定位。

打开左侧 “关于”，检查最新正式版。有新版时点“下载更新”，下载并校验完成后点 “更新并重启”；正常升级会保留设置、API 配置和词典。

完整说明见 API 配置文档和应用更新文档。如果某个游戏或某一步遇到问题，欢迎带上具体情况一起讨论。