简易日语学习 / 视觉小说阅读辅助工具
KS的日语学习工具 v0.4
下载 • Bug 反馈在主窗口的“系统设置”面板中，首先点击“选择窗口”按钮，然后把鼠标移到想要吸附的窗口，点一下左键。此时右边选框中的文字会变成“与 xxx 对齐”，把选框勾上，窗口就吸附到游戏窗口边上了。
本项目并没有内置游戏文本提取的功能，但是可以实时读取剪贴板。建议使用 Textractor、manga-ocr 等文本提取工具将游戏文本提取至剪贴板，然后在本软件中勾选“读取剪贴板”，即可实时同步游戏文本。配合 Textractor 的使用效果如图：
目前支持了谷歌翻译和 GPT 翻译。其中“谷歌翻译”无需配置，可以免费无限制使用，而 GPT 需要配置 API Key，消耗 API 余额。
这是两个不同的接口，“谷歌翻译”会得到与网页版谷歌翻译相同的翻译结果，但不是正规 API，以后可能会失效。
“谷歌生草机”的翻译结果与网页版不同，质量普遍低于网页版。
如果你的网络环境无法访问谷歌翻译，可以尝试使用 GoodCoder666/GoogleTranslate_IPFinder 等工具扫描可用 IP，然后修改 HOST。
在 appsettings.json 中配置 GPT 相关字段：
"GPT": {
"ApiKey": "sk-xxx",
"ApiUrl": "https://api.openai.com/v1", // 实际调用为 https://api.openai.com/v1/chat/completions
"Model": "gpt-4o-mini", // 兼容 OpenAI API 的模型
"ExtraPromptDir": "extra_prompts", // 额外的 Prompt，比如指定某些角色名字怎么翻译
"TranslatePrompt": "...", // 翻译 Prompt
"ExplainPrompt": "..." // 分析 Prompt
}除了 ChatGPT，也支持其它兼容 OpenAI API 的模型，比如 Ollama、Deepseek 等。
Ollama：
"ApiKey": "whatever",
"ApiUrl": "http://localhost:11434/v1",
"Model": "qwen2.5:3b",Deepseek：
"ApiKey": "sk-xxx",
"ApiUrl": "https://api.deepseek.com/v1",
"Model": "deepseek-chat",如果对默认的 Prompt 不满意也可以自行更改，配置好 ApiKey 就可以使用 AI 翻译和解说文本了。
Anki 是一款经典的记忆卡片软件，它的设计理念影响了很多背单词软件。如果你不了解 Anki，可以看这个简短的介绍视频。
在 appsettings.json 中，与 Anki 有关的字段有以下这些：
"AnkiEnabled": true,
"Anki": {
"AnkiConnectUrl": "http://127.0.0.1:8765", // AnkiConnect 默认端口
"Deck": "test", // 添加卡片的目标牌组
"Model": "ja-learner", // 卡片的模板名
"FieldNames":{ // 模板中的字段
"Word": "单词", // 存储单词的字段名
"Example": "例句", // 存储例句的字段名
"Explain": "解释" // 存储解释的字段名
}
}使用 Anki 的准备工作如下：
AnkiEnabled 默认为 false，改为 true 以显示与 Anki 有关的界面。Deck 以及下面的几项修改为对应的牌组名称、模板名称、字段名称。完成配置后只要在词典页面点击“添加到Anki”，就可以一键将当前文本例句、MOJi 单词和解释创建为新卡片，添加到卡组中。
自动导入的单词卡片如图所示：
本项目的分词与注音功能基于 MeCab，虽然整体准确率还算可以，但有时会犯一些低级错误，比如在某些语境下把身体からだ注音为 しんたい、把二人ふたり注音为 ににん，遇到读音特殊的人名也无法正确注音。用词汇更丰富的 UniDic 词典替换 dic 文件夹中默认的 IPADIC 效果会稍好一些。
翻译毕竟都是机翻，准确率有限。谷歌翻译日译中会用英语作为中间语言，有时候结果很怪；ChatGPT 比谷歌懂更多俗语、流行语，但比较不稳定，偶尔会使用简体中文以外的语言回复、唐突地使用塞氏翻译法。建议把本软件当做一个精读工具而不是翻译器，把注意力放在日语原文上，只在不确定的时候使用翻译作为参考。
外来语标注功能使用谷歌翻译将片假名单词翻译为英语，但不是所有片假名单词都是外来语，外来语也不一定来源于英语，还有像 supplies 和 surprise 这样的“同音词”也不好区分，因此也会出现标注错误的情况。
根据作者自己的使用体验，整体准确率还可以接受，但还是不建议完全初学者使用，以免被误导。如果遇到可疑的注音或翻译，建议查询更权威的词典，比如 Weblio 辞書、大辞林、小学馆日中，网络用语可以查 ニコニコ大百科。
开坑的想法主要来源于 YUKI 翻译器 和 Translation-Aggregator，前者支持了丰富的翻译接口，内置了文本提取功能，但使用起来比较复杂，且缺少快速查词的功能；后者虽然可以鼠标悬停查词，但只有日英词典、界面比较古老，而且翻译接口几乎炸完了，于是我决定搓一个更简单、更符合自己需求的工具。
v0.4 更新了添加 Anki 卡片的功能，想法来源于 2DIPW/novel2anki 和 Yomichan。novel2anki 可以用视觉小说解包文件生成精美的带例句、语音的 Anki 卡片，Yomichan 作为经典好用的日语学习工具也能与 Anki 联动快速添加卡片。为了适应自己的工作流，我在本项目中加入了类似的 Anki 功能。Yomichan 作者开发的 AnkiConnect 插件使此功能得以实现，感恩大佬。
使用的第三方工具与参考资料：
两个开箱即用的网页小工具，都直接部署在 github.io 上，有兴趣的也可以试试看。
ks233
Harvey Wang
Mikka
No open issues yet, or sync has not completed.