SuperAPI AI 工具集

rikai

通用与其它

查看项目

更新于 10-20 01:18

技能介绍

用途

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 会被跳过。