struct-review 是什么(人格锚:无,纯专业结构化域)
struct-review 是 struct-* 知识结构化系列的第七个成员,定位「复习调度」。它读取一张卡片集(每行一张卡片,可选难度标注),按艾宾浩斯遗忘曲线排成「间隔重复」复习计划,并量化排程合理度。
它不是语义级「复习决策引擎」(哪些卡片你其实已经记住、何时该提前 / 推迟,那是专业间隔重复软件或大模型的事),而是更日常的「排程收口」——你攒了一堆要背的卡片,却说不清第几天该回看哪张。本引擎在你列完卡片时,替你把每张按难度排好间隔,并告诉这张排程有多合理地贴合遗忘曲线。
能做什么 / 不能做什么
能做的:
- 把卡片集切成「复习排程表」:概念 / 难度 / 首次复习 / 复习间隔序列 / 末次复习。
- 按难度给间隔(易疏、中标准、难密),遵循遗忘曲线:越难早期越频、整体越往后越稀。
- 算排程合理度 schedule_score(0-100,structure_gain 同值);产物末尾附
STRUCT_RESULT尾块供程序消费。
不能做的(诚实边界):
- 不做语义级复习决策——「你其实已记住」「该提前复习」由调用方或专业间隔重复软件完成,本引擎只做确定性排程计算。
- 不生成新卡片、不改写、不跨材料联想;产出的每一行都来自你给的卡片集。
- 不调用任何模型,纯计算、确定性、可重跑。
边界说明
- 输入应为一行一张的卡片集,建议至少 3 张(少于 3 张触发样本过薄惩罚 ×0.5);含 http 的行与空行忽略,不算卡片。
- 难度标注可选:「概念 | 难度」或「概念 难度」,取值 易/中/难 或 1-5 数字或 简单/普通/困难,缺省 中。
- 与 struct-summary / struct-meeting / struct-note / struct-concept / struct-map 分工明确:review 处理「卡片集 → 复习计划」,不处理摘要、派活、笔记提炼、单概念讲解或织网。
怎么用
python scripts/struct_review.py build --input 卡片集.md --output 排程.md
python scripts/struct_review.py rules # 查看量化阈值与各难度间隔
python scripts/struct_review.py ledger # 归集历史产物的 schedule_score
python scripts/struct_review.py version # 打印版本
排程生成后会输出复习排程表与 schedule_score,并在产物末尾附上机器可读的 STRUCT_RESULT {...} 判定块,供流水线程序化消费。
量化模型(原创点)
排程合理度 schedule_score(0-100,structure_gain = schedule_score):间隔严格递增占比(权 0.40)+ 平均相邻间隔增长率(权 0.30,期望 >=1.3 呈指数式,封顶 min(1, 比值/1.8))+ 覆盖率(权 0.30,全部排程=1.0)。卡片数 < 3 整体 ×0.5。struct-review 的本职,就是帮你确认这张排程是否插在遗忘临界点之前。阈值见 resources/thresholds.json。退出码 0/1/2/3/4(struct 非阻断型,4 保留)。
理论底座
- 艾宾浩斯遗忘曲线:记忆留存率随天数近似指数衰减,复习须插在遗忘临界点之前才能再巩固;间隔重复即据此把复习点前移。
- 难度调制间隔:越难的素材遗忘越快,需更密的早期复习(难卡同日二次强化),越易的遗忘慢、间隔可拉大。
- 确定性优先:纯计算排程稳定、可重跑、不幻觉,每行的间隔都能回卡片核对。
与其他成员的关系
struct-review 常接在卡片生产之后,是知识链里「把卡片变成复习资产」的一环;上游可接 struct-note(攒笔记卡片)、struct-concept(建概念卡片)、struct-map(抽关系后拆考点),下游可接专业间隔重复软件(真复习)或大模型(按掌握度调整)。与 guard / check 不重叠(那是防护 / 验证,这是复习排程)。