关于本站

这是什么

「日语语法笔记」是一份免费、双语（中文 + 日语）的 JLPT N5 → N2 语法学习材料，按 8 周节奏规划，共 73 课、400+ 个语法点。每个语法点包含：

  • 接续规则：动词 / 形容词 / 名词的具体接续方式
  • 3+ 例句：覆盖日常对话和考试常见语境
  • 辨析：和易混淆语法的对比（如「は」vs「が」、「たら」vs「なら」）
  • 易错点：中文母语者特别容易踩的坑
  • 间隔复习：当天 → 1 → 4 → 7 → 14 → 30 天勾选清单

内容免费、无广告、无追踪。

为什么做这个

我从 2026 年 4 月开始系统学日语，目标 8 周内拿下 JLPT N2。准备过程中发现：

  • 中文圈的日语语法资料要么过于碎片化（散落在各种论坛、知乎回答），要么过于学院派
  • 教科书（《大家的日本语》《新完全マスター》等）对中文母语者来说，「中文翻译」和「中文讲解」之间有断层——很多语感差异翻译里讲不清楚
  • 没有一份完整覆盖 N5 → N2、又用中文母语者视角讲解的免费在线资料

所以我决定边学边记，把整套笔记开源出来。最初是给自己复习用，后来发现可能对其他中文母语日语学习者也有用，于是托管成网站。

关于作者

  • GitHub：Ralphbupt
  • 邮箱：pengcheng199@gmail.com
  • 这是个人项目，无团队、无商业目的
  • 目前 JLPT 级别：学习中（按本站节奏从 N5 推进到 N2）
  • 反馈渠道首选 GitHub Issues（公开追踪、其他读者也能看到），邮箱用于一对一的隐私沟通

内容生产方式

每节课的笔记结构来自我自己学日语的实际节奏。例句和辨析参考了：

  • 教科书：《大家的日本语 初级 I / II》、《新完全マスター 文法 N3 / N2》、《日本語総まとめ N3 / N2 文法》
  • 在线参考：沪江日语、Bunpro、Tofugu、日本語教師の広場
  • 真题：JLPT 历年 N5 - N2 文法真题（公开发布部分）

每个语法点完成后，会在我自己的学习中先验证 2-3 周（用配套的间隔复习清单），确认讲解清晰、例句到位之后再公开发布。

如果你发现某个例句直接来自上述资料而我没标注出处，请提 issue，我会立刻修正。

站点开源

整个站的源代码（build 脚本、全部 markdown 内容）都在 GitHub：

https://github.com/Ralphbupt/japanese-grammar

技术栈：

  • marked：Markdown → HTML
  • kuroshiro + kuromoji：自动给汉字加 furigana 注音
  • sharp：生成 OG 图片
  • GitHub Pages + Cloudflare Registrar：托管 + 自定义域名 jpnotes.dev

完全静态站点，无后端、无数据库、无 cookies。每次推送 main 分支，GitHub Actions 自动构建并部署。

「问 AI」两分钟上手

课程页右上角的 🤖 按钮会打开一个侧栏，AI 已经读过这一课，可以直接问；点任意例句后面的「讲解」，它会简明地拆解这句的语法、给出翻译和易错点；在正文里选中一段文字再点「💬 问 AI」，会把这段放进输入框，问什么由你自己写。

打开就能用：默认使用本站提供的免费模型（OpenAI 的开源模型 gpt-oss-120b，运行在 Cloudflare 上），不用注册、不用 key，每人每天 50 次。想不限次数或换更强的模型，可以用你自己的 API key，推荐 Groq：免费、不用绑卡、回答基本秒出。

  1. 打开 console.groq.com/keys，用 Google 或 GitHub 账号登录。
  2. 点 Create API Key，起个名字，复制生成的 key（以 gsk_ 开头）。
  3. 回到任意课程页，点右上 🤖，点「用自己的 API key」，选「Groq」，粘贴 key，点「连接并开始」。

注意别选成 xAI Grok，那是马斯克家的付费模型，名字只差一个字母。

其他免费选择

  • 在国内：智谱 GLM 的 glm-4.7-flash 永久免费、不限量，在 open.bigmodel.cn 创建 key。
  • Google Gemini：Flash 系列有免费额度，在 aistudio.google.com 创建 key。
  • 完全不出本机：装 Ollama，ollama pull qwen3:14b，然后按设置里的提示用 OLLAMA_ORIGINS=https://jpnotes.dev ollama serve 启动。本地 14B 模型一个问题要等 30 秒左右，设置里选「快速」可以跳过思考。

常见问题

  • 提示 429 / rate limit：Groq 免费档每分钟 8000 token，整课提问一次要 5–6k，所以约一分钟只能问一次。输入框上方的 📎 默认「跟随阅读位置」，只发送你正在看的那一节，字数少得多；也可以手动选某一节。
  • 提示 Failed to fetch：服务商不允许浏览器直连，或本地 Ollama 没有带 OLLAMA_ORIGINS 启动。换 Groq / OpenRouter 这类明确支持浏览器直连的服务商即可。
  • 换服务商或模型：点侧栏标题里的模型名，已配置的几家都在菜单里，随时切换；「思考深度」三档也在那里。

你自己的密钥只存在你的浏览器里，不会经过本站，详见下面的隐私说明。

「问 AI」功能的隐私与安全

课程页右上角的 🤖「问 AI」侧栏可以把当前课的内容连同你的问题发给一个大模型。它的设计原则是：本站永远拿不到你的密钥，也不保存你的对话。

  • 默认的免费模型经过本站中转。 「本站免费」这一项由一个 Cloudflare Worker（ai.jpnotes.dev）把你的问题和这一课的正文交给 Cloudflare Workers AI 上的模型，再把回答传回来。它不记录问题、回答，也不开启请求日志；为了每天限次，它只保存 IP 的加盐哈希，按天计数，两天后自动删除；另外只统计每次请求来自哪个按钮（讲解、快捷提问等）和消耗了多少额度，不含内容和 IP。中转源码同样公开。不想经过本站，就用你自己的 key。
  • 你自己的 key 不经过本站。 网站本身是 GitHub Pages 上的静态 HTML。你填的 API key 只存在你这台设备的浏览器里（默认 localStorage；勾选「只在本次会话保存」则关闭标签页即清除）。
  • 用自己的 key 时请求直连服务商。 提问时，你的浏览器把这一课的正文和你的问题直接发到你选的服务商（Anthropic、OpenAI、DeepSeek、通义千问……或你本机的 Ollama）。中间没有任何中转。
  • 浏览器层面的白名单。 每个页面都带有 Content-Security-Policy 的 connect-src 规则，只允许连接本站、Google Analytics、预设的服务商域名，以及 localhost / 127.0.0.1。即使页面上某段脚本被篡改，浏览器也会拒绝把数据发往白名单之外的任何地址。
  • 明文保护。 设置里只接受 https:// 或本机地址；把服务商地址改成非官方域名时会显示醒目警告。
  • 自行验证。 按 F12 打开开发者工具的 Network 面板，再提一个问题：用自己的 key 时你只会看到对该服务商域名的请求。侧栏的全部源码只有一个文件，欢迎审阅。
  • 本地方案。 想完全不出本机，用 Ollama / LM Studio 跑本地模型即可，浏览器只会访问 localhost。

免费模型的费用为零，由本站承担额度；用自己的 key 时费用由你和服务商结算，本站不参与、不抽成。

播客

Japanese Daily News 是本站的姊妹播客——慢速日语新闻 + 英语解说，帮助学习者边听边学。网站上提供逐句精听、transcript 和 furigana 标注，Spotify / Apple Podcasts 同步更新。

反馈与贡献

发现错别字？例句别扭？讲解不清楚？

我会回复每一个反馈。

许可

内容采用 CC BY 4.0 许可：

  • ✅ 自由分享、引用、改编、用于教学（包括商业教学）
  • ✅ 标注来源即可（链接到 jpnotes.dev）
  • ❌ 不要做全站镜像——会稀释 Google 索引，对原站和镜像都没好处。引用任意片段、章节都欢迎，但请不要批量复制整个语法点列表