基于 Markdown、Git 和 Python 的本地 JLPT 学习系统,收录 N5–N1 语法卡,以语法联想网(分组学习+按学习日复习,网页作答在 jlpt-web 的 /review/)组织练习。
- Python 3.10 或更高版本,使用
uv管理解释器与依赖(uv sync --locked)。 - Git,用于学习资料版本管理和审核记录。
jlpt-notes/ 学习资料、试卷、作答与复习记录
src/jlpt_notes/ Python 模块与命令行工具
scripts/ はごろも 归类与(已结束的)视频制卡工具
tests/ 自动化测试
docs/ 设计与流程说明
项目名称为 jlpt-study,资料目录为 jlpt-notes,Python 包名与模块名分别为 jlpt-notes、jlpt_notes。
# 语法联想网:查看当前计划、校验分组数据、按语法与混淆对筛查错题
uv run python -m jlpt_notes plan-status --root jlpt-notes
uv run python -m jlpt_notes validate-groups --root jlpt-notes
uv run python -m jlpt_notes weak-report --root jlpt-notes
# 检查图片链接;检查文档本地链接与图片
uv run python -m jlpt_notes validate-links --root jlpt-notes
uv run python -m jlpt_notes validate-doc-links --root jlpt-notes
# 完整测试
uv run python -m pytest分组总表 jlpt-notes/groups/index.md 由 uv run python -m jlpt_notes render-group-index --root jlpt-notes 生成,不手写。新建空资料库时使用 uv run python -m jlpt_notes init --root jlpt-notes。