🌸 Japanese Verb Master（日语动词活用专家）

一个精准、优雅的日语动词活用在线工具与 RESTful API。

English | 日本語

---

✨ 项目特色

• 🎯 极高准确率：完美支持五段动词、一段动词及各类不规则动词（サ变、カ变）的变形规则。
• ⚡ 极致响应：基于 Vue 3 + Vite 构建的前端，提供丝滑的实时交互体验。
• 📚 全面覆盖：一键生成 10+ 种常用活用形式（包含て形、た形、被动、使役、可能形等）。
• 🤖 AI 深度解析：集成 Ollama 本地模型，自动校对变形结果并生成实用例句。
• 🔌 开箱即用的 API：提供轻量级的 Express RESTful API，方便其他开发者接入自己的应用。
• 📱 响应式设计：无论是手机背单词还是电脑查资料，都有完美的视觉体验。

🚀 快速开始

1. 克隆项目

git clone https://github.com/yuaiccc/japanese-verb-master.git
cd japanese-verb-master

2. 启动后端服务

cd backend
npm install
npm run dev # 默认运行在 3000 端口

3. 启动前端页面

cd frontend
npm install
npm run dev # 默认运行在 5173 端口

📖 API 接入文档

你可以直接调用本项目的 API 来开发你自己的日语学习工具！

请求接口： GET /api/conjugate

curl "http://localhost:3000/api/conjugate?verb=食べる&type=ICHIDAN"

返回结果：

{
  "dictionaryForm": "食べる",
  "verbType": "ICHIDAN",
  "negative": "食べない",
  "polite": "食べます",
  "teForm": "食べて",
  "taForm": "食べた",
  "potential": "食べられる",
  "passive": "食べられる",
  "causative": "食べさせる",
  "imperative": "食べろ",
  "volitional": "食べよう"
}

🧠 动词分类指南

本项目引擎支持完整的现代日语动词分类体系：

1. 五段动词 (Godan / Group 1)：词尾为 う、く、ぐ、す、つ、ぬ、ふ、ぶ、む、る（例：飲む、書く）
2. 一段动词 (Ichidan / Group 2)：词尾为 える、いる（例：食べる、見る）
3. サ变动词 (Group 3)：词尾为 する（例：勉強する）
4. カ变动词 (Group 3)：来る

🤝 参与贡献

非常欢迎提交 Issue 和 Pull Request！如果你发现了任何动词变形的 Edge Case，或者想添加新的特性（如敬语/谦让语生成），请随时参与进来！ 详细指南请参考 CONTRIBUTING.md。

📄 开源协议

本项目基于 MIT License 开源。欢迎自由使用、修改和分发。

---

如果这个工具对你有帮助，请给它点个 ⭐️ 吧！