AI 驱动的全能日语私教

基于 Google Gemini 的日语学习助手，支持词汇语法教学、PDF/DOCX 材料解析及 OCR 翻译，适合初学者系统提升日语能力。

基本信息

• 技能名称?japanese-tutor
• 中文名称?AI 驱动的全能日语私教
• 作者?chndranndr
• 分类?专业技能
• 版本?v1.0.2
• 标签?education-research, productivity, content-media, docs, automation

使用方法

使用说明
核心用法
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// 目录文件会被追加写入，建议定期备份以防数据污染。
   路径遍历隐患 ：脚本对输入文件路径的验证较基础，极端情况下可能存在安全风险。