Japanese Tutor

核心功能

Japanese Tutor 是一款面向日语学习者的智能辅导技能，整合词汇训练、语法讲解、测验练习、对话模拟及文档处理五大核心模块。

显著优点

• 多模态学习支持：不仅提供传统词汇语法教学，更创新性地支持 PDF/DOCX 课程材料解析，通过 Gemini Vision OCR 技术提取图文内容，自动归档至个人知识库
• 作业辅导伦理：坚持"引导而非代答"原则，解释概念原理并提供类比示例，培养用户独立解题能力
• 实时 OCR 翻译：对图片中的日文文字进行识别、注音（假名/罗马音）与释义，解决阅读中的即时障碍
• 知识持久化：自动将新材料中的词汇语法追加至 references/ 目录，形成可累积的个人学习档案

潜在局限

• 依赖外部脚本（parse_pdf_gemini.py 等）进行文档处理，若环境配置不当可能影响体验
• 当前预设词汇为 N5 级别，高阶学习者需自行导入材料扩展
• 缺乏语音识别与发音纠正功能，口语训练限于文字模拟

适合人群

零基础至初级日语学习者、需要处理日文课件/作业的学生、希望系统化整理学习资料的自学用户。

使用注意

上传作业文件时，技能仅提供解题思路与相似例题，不会直接输出答案，需用户主动参与推导过程。

核心功能与使用方式

Japanese Tutor 是一款面向日语学习者的交互式辅导 Skill，功能覆盖词汇积累、语法讲解、测验练习、对话角色扮演，以及 PDF/DOCX 课件解析。用户可通过自然语言指令触发学习模块：发送「Parsin ini dong」即可解析上传的 PDF/DOCX 文件，提取其中的词汇与语法点并自动归档至本地知识库；「Bantuin PR ini」则进入作业辅导模式，Skill 不会直接给出答案，而是讲解概念、提供类似示例并引导用户自主解题；「Artinya apa ini？」支持图片 OCR 翻译或文本翻译，输出包含假名/罗马音、释义及语境说明。

显著优点

1. 结构化知识管理：自动将解析到的词汇追加至 references/vocab.md、语法追加至 references/grammar.md，支持按课程创建独立文件，形成可长期复用的个人学习资料库。
2. 教学伦理设计：作业辅导模式坚持"引导而非代劳"，通过解释原理和类比示例培养用户独立解题能力。
3. 多模态输入支持：结合 Gemini Vision 实现 PDF 版面分析与图片 OCR，降低数字化学习资料的门槛。
4. 轻量化与可审计：代码仅 434 行、79 行可执行逻辑，无硬编码密钥，依赖通过环境变量注入，便于审查与部署。

潜在局限与风险

• 外部 API 依赖：PDF 解析与 OCR 完全依赖 Google Gemini API，若服务不可用或网络受限则功能中断。
• T3 来源可信度：维护者为个人开发者，无 GitHub 仓库公开，代码更新与长期维护存在不确定性。
• 环境变量配置门槛：需用户自行配置 GEMINI_API_KEY，对非技术用户存在一定操作门槛。
• 文件大小未限流：当前实现未对上传 PDF/DOCX 做大小限制，超大文件可能导致资源耗尽。

适合人群

• 日语自学者（N5-N4 基础阶段为主）
• 需要数字化整理课件资料的学生
• 寻求作业辅导而非答案投喂的学习者
• 具备基础环境变量配置能力的技术用户

常规风险提示

• 课件内容上传至 Google Gemini 处理，虽经 TLS 加密传输，但仍涉及第三方云服务的数据驻留。
• 建议仅上传公开或已脱敏的学习资料，避免包含个人隐私信息的文档。
• 定期备份 references/ 目录，防止知识库意外丢失。