用途
rikai 用于检验读者是否真正理解了资料中的主张、前提和例外,而不只是读过一遍。它以资料为依据生成选择题,并把讲解内容积累为两类不同用途的说明材料,最后把误读集中的段落反馈给写作者。
主要能力
- 从原文中抽取论点,依据“标题路径 + 原文开头引文”定位段落。
- 一次性生成全部题目,默认 10 题,用户指定数量时按指定数量出题。
- 以单页表单形式呈现题目,脚本会自动打乱题目顺序和选项顺序,并重新分配题号与 id。
- 采分后只在终端输出每题的答题情况表,包含正误、正确答案和原文依据一行。
- 讲解写入两类 explainer,不写入终端,也不写入 study.md:
- 图解笔记(HTML):用较大的图示和简短说明帮助读者建立直观理解。
- 教科书(PDF):用定义、公式和例题深入讲解细节。
- 学习状态保存在资料同级目录下的
.rikai/中,下次复习时从未掌握的论点出发,换角度重新出题。 - 状态分为“复习中”“已掌握”和“需重新抽取”:没有答错记录的论点在第一次答对时即视为已掌握;有答错记录的论点在累计答对 3 次后视为已掌握。
- 生成面向写作者的还流报告,汇总误读集中的段落。
使用方式
文件布局示例:
docs/report.md
docs/.rikai/report.study.md
docs/.rikai/report.explainer.html
docs/.rikai/report.explainer.tex 和 .pdf
主要脚本:
python3 "<SKILL_DIR>/scripts/build_quiz.py" --data "<出题数据>" --out "<出题表单>"
python3 "<SKILL_DIR>/scripts/quiz_server.py" serve --quiz "<出题表单>" --data "<出题数据>" --out "<回答文件>"
python3 "<SKILL_DIR>/scripts/quiz_server.py" code --data "<出题数据>" --out "<回答文件>" --code '1:b 2:a'
python3 "<SKILL_DIR>/scripts/build_textbook.py" --input "<原稿>" --output "<PDF>"
答题方式按环境优先级选择:后台运行 serve;带 --timeout 等待命令结束;用回答代码提交;或者完全以文本方式出题,回复形如 1:b 2:a 的答案。用户界面语言由请求语言决定,无法判断时使用日语;原文引用保持资料原语言。
适用场景
- 阅读日语资料后想确认自己是否读懂了。
- 想用某份资料做小测。
- 想测试自己是否真正掌握了资料内容。
- 想复习已读内容,尤其是曾经答错的论点。
限制
- 不处理无法读取正文的资料,也不处理缺少原文、无法确定正确答案依据的资料;遇到这类情况会要求提供可读格式或正文,不进行推测出题。
- 资料为只读,只写入与资料同级的
.rikai/文件夹。 - 不询问也不记录答错的原因。
- 不编造原文中并不存在的误导点。
- 不在内文中展示
topic-NNN这类内部论点 id。 - 生成物不发布到外部服务。
- PDF 生成依赖 xelatex;没有 python3 时无法构建 PDF,只保留原稿并说明。不会自行安装 LaTeX。
- 缺少对应语言字体的 PDF 会被跳过。