From df5cd79aab774d52773a408277e323cdcef3b951 Mon Sep 17 00:00:00 2001 From: cat-shark Date: Fri, 9 Oct 2026 17:28:38 +0800 Subject: [PATCH] =?UTF-8?q?docs:=20=E5=A4=8D=E4=B9=A0-01=20=E8=AE=B0?= =?UTF-8?q?=E5=BD=95=E5=8F=8D=E9=A6=88=E5=8A=A8=E4=BD=9C=E5=86=B3=E7=AD=96?= =?UTF-8?q?=E5=B9=B6=E6=94=B6=E6=95=9B=204=20=E9=A1=B9=E5=8F=A3=E5=BE=84?= MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit --- OPTIMIZATION_BACKLOG.md | 19 +++++++++++++++++++ 1 file changed, 19 insertions(+) diff --git a/OPTIMIZATION_BACKLOG.md b/OPTIMIZATION_BACKLOG.md index 0bf07c8..ee3fe45 100644 --- a/OPTIMIZATION_BACKLOG.md +++ b/OPTIMIZATION_BACKLOG.md @@ -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 只做语义匹配与归属建议。