docs: 复习-01 记录反馈动作决策并收敛 4 项口径
This commit is contained in:
@@ -479,6 +479,25 @@
|
||||
|
||||
### 复习-01(原 DC-02)复习回路补全
|
||||
|
||||
> **已确认的决策(2026-10-09,维护者)**
|
||||
>
|
||||
> **以下 4 项无需决策——文档与实现已经收敛到同一口径,直接按此执行:**
|
||||
>
|
||||
> | 项 | 结论 | 文档依据 | 实现依据 |
|
||||
> |---|---|---|---|
|
||||
> | 1 | Feed **不含**学习报告 | `review-feed.md`:「Feed 的条目单位是知识碎片。学习报告不以条目形式出现在 Feed 中」 | `getReviewFeed` / `getSmartFeed` 均调用 `mergeAndConvert(List.of(), fragments)`,报告列表恒为空 |
|
||||
> | 3 | 覆盖率口径 = **最近一次**(不做加权) | `recall-review.md`:「为复习排序提供任务级掌握度:最近一条记录的覆盖率」;`review-loop.md` 同 | `ReviewServiceImpl.latestRecallRatioByTask()` 取 `created_time` 降序的第一条 |
|
||||
> | 4 | 待归类内容**两处都出现**(总览独立区块 + Feed 混排打标、就地归类) | `review-loop.md`:「待归类内容在复习总览中可见,在 Feed 中可归类」 | 待实现;口径见归属-01 决策 4 |
|
||||
> | 5 | 遗漏项 = **本次对比的快照,不做跨次累计** | `recall-review.md`:「遗漏项是本次对比的快照,不是跨次累计的待办集合」 | 对比结果写在单条回忆记录的 `compare_result` 里,不跨记录聚合 |
|
||||
>
|
||||
> **需要决策的第 2 项(已定)**:
|
||||
>
|
||||
> 2. **Feed 反馈动作:提供「已掌握」与「稍后再看」两个轻量动作**,另外把「上次复习时间」作为**第三个**权重信号(原只有时间衰减与任务级覆盖率两个)。
|
||||
> - 两个动作**只调整出现概率,不产生状态展示、不计总数、不做待复习列表**:`已掌握` 降低概率但**不归零**(保留文档要求的随机性——「每条内容都有机会出现」),`稍后再看` 提高概率。
|
||||
> - 展开查看 / 进入回忆对比会刷新「上次复习时间」,本身不产生额外数据。
|
||||
> - 不落进标记表:文档明确「标记不是状态」,因此反馈状态落在碎片自身的字段上。
|
||||
> - 已排除:只做「稍后再看」(无法低成本表达「这条我熟」,重复出现只能等时间衰减);只做「已掌握」(缺少正向「再巩固」入口,且回忆对比是任务级的);不做反馈(重复出现的痛点原样保留)。
|
||||
|
||||
- **文档**:`lpt-docs/docs/design/review-loop.md`(立场、内容来源、两个层级、排序、归类、反馈、AI 边界)、`lpt-docs/docs/concepts/review-overview.md`(新增)、`recall-review.md`(回忆记录、覆盖率、复习起点、遗漏项)、`review-feed.md`、`lpt-docs/docs/design/principles.md`、`module-boundaries.md`。
|
||||
- **背景**:复习此前只有零散描述(Feed、导图、回忆对比各自成文),缺少系统级口径:复习内容的完整来源、任务级与条目级两层入口、覆盖率与掌握度的定义、遗漏项的语义、反馈动作、归类动作落点、AI 边界都未定;文档写的是“Feed 展示碎片和学习报告”,实现只返回碎片。
|
||||
- **本次补全(已按以下取向写入文档)**:复习只做“低阻力反复出现 + 主动提取”,不做到期调度、打卡、评分;Feed 条目单位是碎片,报告从任务记录进入;覆盖率按任务聚合成掌握度,作为排序信号之一;遗漏项是每次对比的快照,不做跨次累计待办;归类动作落在复习里;AI 只做语义匹配与归属建议。
|
||||
|
||||
Reference in New Issue
Block a user