Skip to content

Latest commit

 

History

History
197 lines (113 loc) · 9.92 KB

File metadata and controls

197 lines (113 loc) · 9.92 KB

ReciteHelper 用户手册

版本号:v3.1

更新日期:2026.01.25

简介

ReciteHelper 是一款AI驱动的、旨在帮助用户高效记忆和复习知识内容的工具。通过提供多种学习与复习方法,该项目可以辅助用户管理、巩固和测试自己的学习内容,尤其适用于考试、背诵和知识点梳理等应用场景。本项目支持多种类型的数据输入与输出,并可根据用户需求进行灵活定制。

手册中带有(Preview)的为预览功能,其实是还没做好


使用之前

使用之前,您应该先完成软件的配置。使用记事本或者其他文本编辑器打开文件目录下的Config.xml文件,可以看下如下内容:

<Config>
	
	<Version>2</Version>
	
	<DeepSeekKey>%Environment.GetEnvironmentVariable("DSAPI")%</DeepSeekKey>
	<MissingStrategy>Ignore</MissingStrategy>
	
	<OCRAccess></OCRAccess>
	<OCRSecret></OCRSecret>
	
	<PhonkOptions>
		<EnablePhonk>false</EnablePhonk>
		<WrongCount>3</WrongCount>
	</PhonkOptions>
	
</Config>

必须配置项是 DeepSeekKey,从官网的开发平台获取 Key 后(格式:sk-xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx),直接替换其中的%符号和其中的所有字符,改为这个 Key 即可。

当然,如果担心安全问题,您可以将 Key 配置到环境变量中,之后将 %Environment.GetEnvironmentVariable("DSAPI")% 中的 DSAPI 改为自己配置的环境变量名称。

配置项 MissingStrategy 表示如果部分知识点因为AI产生幻觉而被迫舍弃后的行为,默认为 IgnoreIgnore 表示被舍弃后不做任何操作,可能会产生小于10%的知识点丢失,但是速度相对较快;Replay 表示对舍弃知识点进行提取后重放,保证所有内容均被保留,但相应的可能会占用更多时间。在测试中,缺失的一小部分也会被分块补全大部分,如无特殊情况,强烈不建议修改该项。

"如果把 EnablePhonk 设置为 true 会发生什么?"

"连续答错 WrongCount 道题,会有 jumpscare 哦。"


普通项目

普通项目即经典复习项目,是游戏等项目的根项目。该项目中提供了题库、考试、知识点查看等基本功能。

在主界面点击“创建新的项目”,在弹出的选择项目类型窗口中选择经典复习项目,即可创建普通项目。

09

创建项目

本软件以“学科”为单位组织复习项目,您应该为每一门不同的学科创建一个新的复习项目。

你需要准备这门学科的复习资料pdf格式文件,这份pdf应该是文字,而不是图片。文件的图片支持(OCR光学识别或多模态方法)将在后续版本中更新。

01

之后,填写课程名称、项目保存路径和复习资料路径,点击“确认创建”即可。软件将自动提取文档文字进行智能分析和聚类。这个过程可能耗时较长,耐心等待直到出现提示框即可。之后再选择“从已有项目加载”,之后选择创建项目路径打开。之后该项目将会出现在最近项目列表中,可以直接点击打开。

知识点学习

打开项目之后将会弹出章节选择窗口,显示通过复习资料分割而来的所有章节。

02

此时通过右上角的“学习知识点”按钮即可打开知识点学习页面,该页面罗列了聚类后的每一个章节以及章节内的所有知识点。点击左侧章节名称即可展开知识点页面,之后点击具体知识点就可以查看知识点内容。当掌握该知识点后,可以点击右上角的“标记为已掌握”,此时该知识点的状态将自动更新为“已掌握”,并在显示时显示一个打钩的复选框。如果复习时发现该知识点忘记,反选右上角即可标记为未掌握状态。切换新知识点时可能发生一次闪烁,这是因为渲染文本造成的,属正常现象。

为方便更好的复习知识点,软件将在未来提供基于Ebbinghaus遗忘曲线的知识点复习推荐与掌握度检测。

03

题目练习

在学习了一部分知识点后,可以在章节选择界面,选择需要练习的章节,此时将打开对应章节的做题界面。

04

目前支持填空题,将在不久后支持选择题、解释题、简答题等诸多题型。在答案框输入答案后点击“提交答案”,软件将判断答案是否正确并记录。不同于市面上常见软件的错一个字就算答案错,我们引入了包括但不限于LCS、相关系数、TF-IDF、余弦相似度等诸多方法接受不同或模糊的答案。比如在图中,正确答案是像素,输入的像素点与像素意义是相近的,所以该答案被接受,并判定为回答正确。退出软件后,也会完整保存答题进度,再次进入可继续答题。同时,答题数据也会被用于计算掌握度并显示在章节选择界面,供给复习参考使用。

模拟考试

为了模拟考试环境,软件搭载了模拟考试功能。当前版本下模拟考试将自动从各个考点中随机抽取30道题目,限时60分钟完成。后续版本将支持自定义题目类型,双向细目表出题等。点击选择章节右上角的“模拟考试”页面进入模拟考试,之后会打开考试配置界面。

08

在该页面中,可以配置考试的相关设置,例如课程号、考试时间、考试题量、每题分数等。可以通过右侧的各个滑块从知识点按照比例进行抽题,总权重不必保证为100%,软件会自动计算权重比例进行抽题。

05

选择“我已阅读并同意以上考试规则”后,便可以开始考试。完成题目后点击右上角的交卷按钮,便可查看自己的成绩和错题。

06

点击“查看答案”按钮后,将打开考试答案回顾窗口,可以查看各个题目的作答情况、正确答案和解析。当然也可以选择再考一次,检验本次考试知识是否得以掌握。

07

导出项目

软件支持导出项目,在导出项目时,导出的项目不会保存进度,可以将项目备份或发送给他人使用。

打开一个项目,在选择章节界面中,点击右上角的功能菜单,在弹出的菜单中选择导出即可。

导出的项目可以通过起始页面的导入功能导入。


游戏项目

游戏项目即旮旯给木项目,该项目以基础项目为根项目,只需要在创建游戏项目界面内选择 .rhproj 项目文件即可。

在弹出的选择项目类型窗口中选择旮旯给木项目,即可创建游戏项目。

创建项目

在选择了创建旮旯给木项目后,就会弹出创建窗口。选择 .rhproj 项目文件,之后点击开始创建按钮,创建过程就会开始。该过程可能持续5分钟以上,在此过程中只需坐和放宽即可,不需要再次点击创建按钮。

10

创建完成之后,就会弹出一个信息框,之后便可关掉创建窗口。

启动游戏

启动游戏跟导出项目一样,先打开原本的 .rhproj 文件,之后点击选择章节窗口的右上角的功能菜单按钮,在弹出的功能菜单中点击运行游戏按钮。这时就会弹出游戏窗口,之后便可以游玩创建好的游戏。

11

需要退出游戏时,从右上角窗口上的x按钮关闭窗口。游戏进度将自动保存 (preview)

智能复习

可以在选择章节界面的菜单中选择智能复习选项,软件将根据近期的答题情况,自动筛选出复习效果最差的30题进行复习。

区别于市面上传统软件使用的艾宾浩斯曲线记忆法不适用于需要在短时间内复习的情况,ReciteHelper 使用了经过机器学习与自学习机制优化的 Supermono-2 算法。该算法将会从你答题的行为中不断学习,并依此预测出几个关键参数,帮助你更好的复习。

得益于自学习机制,软件做到了为根据个人的复习习惯,每个人提供一套独一无二的方法,使用软件答题越多,复习时候推送的题目就越精准。真正的实现了“因材施教”。


常见问题(FAQ)

Q:项目创建后没有出现章节怎么办?
A:请确认所上传的PDF是否为可识别文字内容,图片型PDF暂不被当前版本支持。建议使用文字版PDF文档。

Q:知识点标记为已掌握后如何再次复习?
A:在知识点学习页面可以通过筛选功能切换显示“全部”、“已掌握”、“未掌握”的知识点,自主选择复习内容。

Q:如何查看学习进度?
A:可在“项目设置”中选择导出,支持json格式,便于进度管理和数据分析。


更新日志

v4-preview (2026.01.28)

  • 引入智能复习功能
  • 实现了预设考试功能
  • 增加连错3题以上播放特效效果

(v4版本尚在开发中)

v3 (2026.01.14)

  • 增加自定义考试功能
  • 引入了重放算法支持长pdf文件
  • 支持多文件合并项目
  • 接入自研Avg引擎,支持创建游戏项目(预览)

v2(2025.11.25)

  • 增加回顾考试题目功能
  • 增加知识点学习功能
  • 完善了导出项目功能
  • 添加文档与规范

v1(2025.11.11)

  • 支持PDF导入与知识点自动聚类
  • 增加模拟考试功能
  • 优化自动聚类与章节识别算法
  • 支持相似答案模糊判定技巧

联系我们与反馈

  • 软件主页:GitHub 项目工程
  • 问题反馈邮箱:arab@methodbox.top
  • 用户交流群:1053379975
  • 欢迎在issue,或者直接邮件提出建议与问题,开发团队将及时答复