japanese-tutor

核心用法

Japanese Tutor 是一款面向日语学习者的交互式辅导工具，核心功能涵盖五大模块：词汇练习（每日单词、主题词汇组）、语法讲解（规则简化+例句）、学习材料解析（PDF/DOCX 上传后自动提取词汇语法并持久化存储）、OCR 翻译（图片/文字识别与翻译）以及测验模式。用户可通过自然语言指令如"Parsin ini dong"（解析这个）或"Bantuin PR ini"（辅导作业）快速触发功能，系统会调用 parse_pdf_gemini.py 或 parse_docx.py 处理文件，并将新知识追加至 references// 目录的词汇表和语法库中。

显著优点

1. 教学伦理设计：作业辅导坚持"引导而非代答"原则，解释概念后提供类似例题，培养用户自主解题能力。
2. 知识持久化：自动将新材料中的词汇语法保存至本地引用文件，形成可累积的个人知识库。
3. 多模态支持：结合 Gemini Vision 实现 PDF 布局分析与图片 OCR，降低日语学习者处理纸质/扫描材料的门槛。
4. 轻量化交互：支持印尼语混合指令（Jaksel 风格），降低非英语用户的使用门槛。

潜在缺点与局限性

• 网络强依赖：PDF 解析必须调用 Google Gemini API，离线环境完全不可用。
• 隐私边界模糊：用户上传的 PDF 内容会被传输至 Google 服务器，虽文档有说明但无二次确认机制。
• 权限声明缺失：SKILL.md 未明确列出文件读写、网络访问、环境变量读取等权限清单。
• 来源可信度有限：T3 级个人开发者账号，无组织背书或代码签名。

适合的目标群体

• 日语 N5-N4 级别初学者，需要结构化词汇语法积累
• 使用日语教材 PDF/Word 文档的自学者
• 需要作业辅导但希望理解解题思路的学生
• 需要快速翻译日语图片/菜单的旅行者

使用风险

• 数据外泄风险：敏感文档（含个人信息、商业机密）切勿通过 PDF 解析功能上传。
• API 可用性风险：Gemini API 服务中断或额度耗尽将导致核心功能失效。
• 文件修改风险：references// 目录文件会被追加写入，建议定期备份以防数据污染。
• 路径遍历隐患：脚本对输入文件路径的验证较基础，极端情况下可能存在安全风险。