Skip to content
ilynthnPublic

About

在保留原版体验的前提下阅读 Galgame 原文、学习语言的 Windows 工具|A Windows tool for reading visual novels in the original and learning languages without breaking the game|原作の体験を保ったまま原文で読み、言語を学ぶための Windows ツール

Topics

Resources

Stars

16 stars

Watchers

0 watching

Forks

Repository files navigation

MeguLit

Read the game, keep the game.

在 Galgame 里读日语的小魔导书 ✦

Version Platform License Sponsor

下载 v1.1.8  ·  简体中文  ·  English  ·  日本語  ·  常见问题  ·  更新日志  ·  ♡ 赞赏


MeguLit 首页

Warning

还在积极开发中,功能、数据格式和界面随时可能变  ·  Still in active development  ·  開発中です


简体中文

✦ v1.1 新内容

自动更新 每次启动检查新版本,有就直接在后台下载。卡片上写着版本号、更新内容、安装包变大还是变小,进度条是真实的。下载完先校验,再由你选「重启并更新」或「稍后」。只换程序文件,游戏库、学习记录和设置都保留
默认背景 自带浅色、深色两张背景,跟着主题自动切换;设了自己的图片就用你的
学习统计 魔导书 × 毛玻璃风格重做。日历、本月读的书、字数走势、阅读时段、星期分布、阅读手感、常查的词,每一块都能单独切换年 / 月 / 周 / 日
空页面 句子、单词、回收站、历史为空时,告诉你这里会出现什么、怎么让它出现;词典首页列出你常查的词
v1.1.2 修好「重启并更新」:更新脚本改由 Windows 启动,不会再随 MeguLit 一起退出 · 更新卡片写明安装包具体大了 / 小了多少 MB
v1.1.1 关闭游戏后主页停在半透明的问题从根上修好 · 本地模型缺运行组件时自动下载,阅读层直接写明原因,不再只显示「翻译暂不可用」
修复 部分电脑上「无法检查游戏是否已运行」导致游戏启动不了(Steam 游戏多见)· 关闭游戏后主窗口变半透明 · 多语言版游戏把日文、简中、繁中整串显示出来 · 日文原文还原认不出中日文路径下正在运行的游戏 · Rance02 匹配不到 VNDB

Note

v1.1.0 和 v1.1.1 的自动更新有 bug:点「重启并更新」后打开的还是旧版本。请手动下载 v1.1.8 覆盖安装一次,从 v1.1.2 开始就能正常自动更新了


为什么做这个

想靠 Galgame 学日语,可现有的工具都逼人二选一:要么玩原版,遇到生词就切出去查;要么在旁边外挂一个窗口,游戏里的原文照样显示,两份字叠在眼前

MeguLit 想做的只有一件事:游戏还是那个游戏,只是你能读懂了。原文、翻译、注音、查词、AI 讲解、生词本、Anki 复习,都在游戏旁边完成,不用来回切窗口

界面有简体中文、English、日本語。主要面向学日语的中文 / 英文用户,反过来用日语学中文或英文也可以


功能预览

游戏库

游戏库搜索
每打一个字母,不相关的封面就散开,剩下的排到中间

游戏库 作品详情
游戏库 · 扫描文件夹和 Steam,系列作品自动归到一起 作品详情 · 简介、各站评分、阅读记录、关联单词和收藏的句子
  1. 第一次打开时选好放游戏的文件夹,MeguLit 会自动找出日文原版 EXE
  2. 点封面进入作品详情,点「启动游戏」。需要转区的游戏可以单独开 Locale Emulator
  3. 游戏启动后阅读层自动接上,按 Alt + T 呼出菜单

自动更新

自动更新

  • 每次启动都会联网检查一次新版本,有的话直接在后台下载
  • 卡片上写着版本号、更新内容,以及安装包比现在大还是小多少
  • 下载有真实进度条,下完先校验,再由你选「重启并更新」或「稍后」
  • 也可以随时到「关于」页点「检查更新」手动检查
  • 只替换程序文件,游戏库、学习记录和设置都会保留

阅读层

浮在游戏上面,不抢焦点,点它也不会让剧情往下走

  • 点一下查单词,拖一段查短语,离线词典
  • 注音优先用游戏自带的 ruby,没有再用词典和上下文
  • 翻译支持 DeepL、Bing、Google、Gemini、DeepSeek、Sakura、Ollama 和 OpenAI 兼容接口,密钥加密存在本地
  • 选中词或整句,让 AI 讲语法和语境
  • 每部作品单独记字体、颜色和位置

历史

阅读会话 对话记录
阅读会话 · 每次玩了多久、读了多少字 对话记录 · 读过的每一句原文和译文

学习

Anki 复习 单词本
Anki 复习 · 直接用 Anki 的卡片和调度,评分写回 Anki 单词本 · 查过的词、读音、释义和掌握程度

学习统计

字数走势与阅读时段

学习统计 · 阅读字数、时长、查词、日历、每部作品的阅读量、字数走势、阅读时段和星期分布

空页面 工具
空页面 · 告诉你这里会出现什么、怎么让它出现 工具 · 日文原版恢复、修复内嵌替换
  • 在阅读层查词时点「制卡」,会带上游戏截图和原声;没配音的旁白用本地 TTS 补
  • Anki 需要自己安装 Anki 和 AnkiConnect,MeguLit 可以一键装好 AnkiConnect

五十音

给零基础的人:先认得每一个假名,再到游戏里把它读出来

五十音主页

学习 → 五十音 → 开始学习。主页记住你学到哪一课,右边是平假名熟悉度

一课 五十音图
一课四步 · 认识 → 辨认 → 回忆 → 混合。笔顺、字源、例词,还有你自己玩过的游戏里含这个假名的台词 五十音图 · 平 / 片假名,清音、浊音、拗音;点格子看笔顺、发音要点和易混字
假名游戏 行段识别
假名游戏 · 三种玩法、四档难度,规则都写在面板上 行段识别 · 先按辅音字母选行,再按元音选段
结算 学习手帐
结算 · 达成率、判定、答题轨迹和错题分析,一键错题再挑战 学习手帐 · 熟悉度、到期复习(1 → 3 → 7 → 21 天)、个人最佳
玩法、难度和评分规则
玩法 怎么玩
行段识别 看到「き」,答出 か行 · い段。键盘先按 k 再按 i
前后假名 按 あいうえお…わをん 的顺序说出前一个和后一个,空位直接跳过
平片转换 看平假名写片假名,反过来也一样。可以用日语输入法(F7 / F6),也可以按 K 打开屏幕假名键盘
难度 规则
入门 只考学过的假名,不限时,每题可看提示
标准 全部清音,每题限时,整局 3 次提示
进阶 加入浊音、拗音和易混字,限时更短
挑战 总计 90 秒,错 3 次结束,没有提示
  • 每道题是一个音符:普通假名算 TAP,最容易认错的几组(シ / ツ、ソ / ン、ぬ / め、ね / れ / わ…)算 BREAK,分量是 5 倍
  • 答得快是 CRITICAL PERFECT,稍慢 PERFECT,再慢 GREAT;用了提示算 GOOD,答错或超时算 MISS
  • 基础 100% 加 BREAK 奖励最多 1%,满分 101.0000%,评级从 SSS+ 到 D

快捷键:Enter 下一个,Space 发音,← → 切换假名,答题时按 1–4

汉字读音

汉字读音 · 学完假名可以玩《漢字でGO!》。MeguLit 只是在窗口里原样打开 PLiCy 上的官方页面(作者 Micelle,含广告),不是 MeguLit 的一部分;不想在 MeguLit 里玩,可以点「在浏览器打开」



安装

Important

游戏剧情必须是日文原文。MeguLit 读的是游戏正在显示的台词,剧情被汉化后读到的就不是日文。只汉化了菜单、剧情仍是日文的游戏不受影响;汉化版可以先试试「工具 → 日文原版恢复」

  1. 去 Releases 下载 MeguLit-v1.1.8-win-x64.zip(约 18 MB),解压后运行 MeguLit.exe
  2. 第一次启动会弹出安装窗口,二选一
    • 完整版:下载约 565 MB,一次装齐注音词典和 AivisSpeech 语音引擎,需要约 1.8 GB 空间(推荐)
    • 精简版:下载约 107 MB,能用阅读层、翻译和查词,其余组件以后在设置里补装
  3. 选好放游戏的文件夹,等游戏库扫描完
  4. 点一部作品 →「启动游戏」,用窗口模式玩
  5. 零基础的话,先去 学习 → 五十音

装过旧版:用新文件覆盖旧的 MeguLit 文件夹即可,组件和数据都保留

需要 Windows 10 / 11 x64 和 Microsoft Edge WebView2 Runtime。本地翻译模型比较大,不在安装包里,需要时在设置里下载


常见问题

全屏玩的时候翻译显示不全,或者文字跑到了桌面上

请把游戏切到窗口模式。全屏(独占全屏)现在有 bug:游戏会盖住其他所有窗口,阅读层没法稳定地画在游戏上面。窗口模式下效果最好,窗口拉大一点也没关系

点「启动游戏」提示「无法检查游戏是否已运行」

v1.1.0 已经修复。旧版本在部分电脑上(多半是杀毒软件拦了进程查询)会这样,更新就好

读到的是乱码,或者根本不是日文

剧情必须是日文原文。汉化版先试试「工具 → 日文原版恢复」

更新会不会弄丢我的数据

不会。自动更新只替换程序文件,data、logs、cache、runtime、models 都不碰。旧的 MeguLit.exe 还会留一份 MeguLit.rollback-update.exe

Anki 连不上

先打开 Anki,并装好 AnkiConnect(MeguLit 里可以一键安装)。端口 8765 被别的程序占用也会连不上

某个游戏读不到文字

不同引擎差别很大。请在 Issues 留下游戏名,最好附上 MeguLit 的 logs 文件夹


现在能做什么

功能 状态 说明
抓取游戏文本 ✅ 基于 LunaHook,自动挑文本流,不对可以手动换
阅读层 · 注音 · 点读 ✅ 游戏自带 ruby 优先;点读不推进剧情
实时翻译 · AI 讲解 ✅ 多家翻译和大模型接口,密钥加密存在本地
生词本 · Anki ✅ 单词、例句、回收站;制卡带截图和原声
游戏库 · 启动器 ✅ 扫文件夹和 Steam,自动认日文原版 EXE
学习统计 ✅ 年 / 月 / 周 / 日,每块单独切换
自动更新 · 备份恢复 ✅ 只换程序文件;备份恢复失败自动回滚
五十音 Beta 25 课、五十音图、三个小游戏、学习手帐
内嵌替换 实验中 部分引擎会报错甚至闪退
本地模型与 TTS 实验中 需要本地显卡环境

接下来

  • 第四个假名小游戏:太鼓风节奏游戏,随机用你装的 Galgame 的 BGM,检测 BPM 和鼓点,跟着节奏认假名
  • 五十音学习的英文、日文界面
  • 按引擎判断能不能安全内嵌;区分「重绘」和「真的又说了一遍」
  • 保住游戏原生 LOG 里的原文;开场、章节标题、独立字幕
  • 联网排行榜:阅读量、生词数、连续打卡天数
  • 更多学习语言,以及 Galgame 以外的游戏

从源码构建

.\Build.ps1 -Check

需要 Rust(Tauri)、Node.js 和 .NET Framework 的 C# 编译器

致谢

LunaHook(文本 Hook)· JMdict / EDRDG(词典)· SudachiDict(分词)· KanjiVG(© Ulrich Apel,CC BY-SA 3.0,笔顺)· AivisSpeech(语音)· Tauri · Anki & AnkiConnect · Tomoyo(最早的灵感)

推荐游戏:漢字でGO!(Micelle · PLiCy),只是推荐,与 MeguLit 无关

GPL-3.0-or-later,见 LICENSE;第三方组件按各自许可证,见 THIRD-PARTY.md



English

A small grimoire for reading Japanese inside visual novels. The game stays the same game; you just get to understand it. Original text, translation, furigana, lookups, AI explanations, a word list and Anki review all happen next to the game, with no alt-tabbing.

New in v1.1

Auto update Checks for a new release on every start and downloads it in the background, with the version, notes, size change and real progress. Only program files are replaced
Default backgrounds A light and a dark one that follow the theme
Statistics Redesigned; every panel switches between year / month / week / day
v1.1.2 "Restart and update" now really updates: Windows starts the update script, so it no longer exits with MeguLit
v1.1.1 Home no longer stays half transparent after a game closes · a local model with no runtime downloads it by itself and the overlay says why
Fixes Launch failing with "could not check whether the game was running" · window staying half transparent after a game closes · multilingual builds showing every language track

The updater in v1.1.0 and v1.1.1 reopens the old version, so download v1.1.2 by hand once; from v1.1.2 on it updates itself.

From then on MeguLit checks for a new release on every start and downloads it in the background (or check by hand under About → Check for updates). Only program files are replaced.

Library search Statistics
Kana lesson Kana results

Install

  1. Download MeguLit-v1.1.8-win-x64.zip (about 18 MB) from Releases, unzip it and run MeguLit.exe
  2. Pick Full (about 565 MB, furigana dictionaries and the AivisSpeech voice engine) or Lite (about 107 MB)
  3. Choose your game folder, pick a game and press Launch. Press Alt + T for the overlay menu

The game's story text must be the original Japanese. Needs Windows 10 / 11 x64 and the WebView2 Runtime.

FAQ

  • Translations cut off, or text on the desktop in fullscreen? Play in windowed mode. Exclusive fullscreen has a bug where the overlay cannot stay on top of the game.
  • "Could not check whether the game was running"? Fixed in v1.1.0.
  • Does an update delete my data? No. Only program files are replaced.

GPL-3.0-or-later · LICENSE · THIRD-PARTY.md



日本語

ギャルゲーの中で日本語を読むための小さな魔導書。 ゲームはそのまま、でも読めるようになる。原文、翻訳、ふりがな、辞書、AI 解説、単語帳、Anki 復習を、ゲームの横で全部済ませられます

v1.1 の新機能

自動アップデート 起動のたびに新しいバージョンを確認し、裏でダウンロード。バージョン、更新内容、サイズの増減、実際の進捗を表示。プログラムだけを置き換えます
デフォルト背景 ライト / ダークのテーマに合わせて切り替わる 2 枚
学習統計 作り直し。パネルごとに年 / 月 / 週 / 日を切り替え
v1.1.2 「再起動して更新」で実際に更新されるよう修正
v1.1.1 ゲーム終了後にホームが半透明のまま残る問題を根本修正 · ローカルモデルの実行環境がない場合は自動でダウンロード
修正 「ゲームが起動中か確認できません」で起動できない問題 · 終了後にウィンドウが半透明になる問題 · 多言語版で全言語の文が出る問題

v1.1.0 と v1.1.1 の自動更新には不具合があるため、今回だけ手動で v1.1.2 をダウンロードしてください。v1.1.2 からは自動で更新されます

五十音 学習手帳

インストール

  1. Releases から MeguLit-v1.1.8-win-x64.zip(約 18 MB)をダウンロードして展開し、MeguLit.exe を起動
  2. 初回セットアップで 完全版(約 565 MB)か 軽量版(約 107 MB)を選択
  3. ゲームフォルダを選び、作品を選んで「ゲーム起動」。Alt + T でメニュー

シナリオ本文は日本語原文である必要があります。Windows 10 / 11 x64 と WebView2 Runtime が必要です

よくある質問

  • フルスクリーンで翻訳が欠ける・文字がデスクトップに出る:ウィンドウモードで遊んでください。排他フルスクリーンには不具合があります
  • 「ゲームが起動中か確認できません」:v1.1.0 で修正済みです
  • アップデートでデータは消える?:消えません。プログラムだけを置き換えます

GPL-3.0-or-later · LICENSE · THIRD-PARTY.md



♡ Support MeguLit

和 Bug 魔王军的战斗还在继续,冒险经费倒是快见底了……(›´ω`‹ )

如果 MeguLit 为你的日语学习带来了一点帮助,欢迎赞助一点厄里斯,支持项目继续开发!

每一份支持,都能让这场冒险走得更远 ヾ(≧▽≦)o*


支付宝 / 微信赞赏码



MeguLit is free, open source, and built in my spare time.
If it helped you read a few more lines in Japanese, a small sponsorship keeps the updates coming.

Sponsor on GitHub

Every Eris counts ♡


Made by ilynthn with love, caffeine, and a concerning number of bugs ✦

About

在保留原版体验的前提下阅读 Galgame 原文、学习语言的 Windows 工具|A Windows tool for reading visual novels in the original and learning languages without breaking the game|原作の体験を保ったまま原文で読み、言語を学ぶための Windows ツール

Topics

Resources

Stars

16 stars

Watchers

0 watching

Forks

Releases

Packages

Contributors

Languages