docs: 登记复习-06与复习-07
This commit is contained in:
+28
-3
@@ -40,6 +40,8 @@
|
|||||||
| | 复习-03 Feed 随机取样 | P3 | 待决策 | id 区间随机 / 候选池 / 时间窗口随机 |
|
| | 复习-03 Feed 随机取样 | P3 | 待决策 | id 区间随机 / 候选池 / 时间窗口随机 |
|
||||||
| | 复习-04 覆盖率查询拉全量 | P3 | 依赖复习-01 | 覆盖率口径(复习-01 第 3 项) |
|
| | 复习-04 覆盖率查询拉全量 | P3 | 依赖复习-01 | 覆盖率口径(复习-01 第 3 项) |
|
||||||
| | 复习-05 Feed 返回全文 | P3 | 依赖复习-01 | 条目单位与摘要口径(复习-01 第 1 项) |
|
| | 复习-05 Feed 返回全文 | P3 | 依赖复习-01 | 条目单位与摘要口径(复习-01 第 1 项) |
|
||||||
|
| | 复习-06 引导追问 | P1 | 待决策 | 命名;追问碎片的来源标记;轮数与长度上限;入口位置;无 AI 时的降级形态 |
|
||||||
|
| | 复习-07 复习耗时统计 | P2 | 可直接实施(口径已定) | — |
|
||||||
| AI 链路 | AI-01 事务内同步等 AI | P2 | 待决策 | 事务外纯读对比(小改)/ 任务表 + 异步回写 |
|
| AI 链路 | AI-01 事务内同步等 AI | P2 | 待决策 | 事务外纯读对比(小改)/ 任务表 + 异步回写 |
|
||||||
| | AI-02 全链路同步阻塞 | P2 | 可实施(方案已定) | 若 AI-01 选任务表方案,则与 AI-01 同批 |
|
| | AI-02 全链路同步阻塞 | P2 | 可实施(方案已定) | 若 AI-01 选任务表方案,则与 AI-01 同批 |
|
||||||
| | AI-03 单 worker 串行无重试 | P2 | 可直接实施 | — |
|
| | AI-03 单 worker 串行无重试 | P2 | 可直接实施 | — |
|
||||||
@@ -123,7 +125,7 @@
|
|||||||
|
|
||||||
---
|
---
|
||||||
|
|
||||||
## 5. P1 会挡路的功能缺口
|
## 5. P1 会挡路的功能缺口与待补能力
|
||||||
|
|
||||||
### 会话-05(原 LPT-07)活跃会话拦截没有出路,会永久堵住新任务
|
### 会话-05(原 LPT-07)活跃会话拦截没有出路,会永久堵住新任务
|
||||||
|
|
||||||
@@ -163,6 +165,15 @@
|
|||||||
- **建议**:导出学习报告、知识碎片、任务统计为 Markdown / JSON,按任务或时间范围筛选。
|
- **建议**:导出学习报告、知识碎片、任务统计为 Markdown / JSON,按任务或时间范围筛选。
|
||||||
- **验收**:导出内容可独立阅读,包含报告/碎片原文与时间信息。
|
- **验收**:导出内容可独立阅读,包含报告/碎片原文与时间信息。
|
||||||
|
|
||||||
|
### 复习-07 复习耗时统计
|
||||||
|
|
||||||
|
- [ ] 未完成
|
||||||
|
- **涉及仓库**:`lpt-be` + `lpt-fe`
|
||||||
|
- **依据**:复习总览目前只展示来自会话的“累计有效学习时长”(`ReviewTaskStats.effectiveTime`),复习行为本身没有任何计时,投入不可见。
|
||||||
|
- **已定口径**:只对回忆对比与引导追问计时,滚动浏览不计时;超过 5 分钟无交互则截断到上一次交互时间(复习没有暂停动作);命名“复习耗时”,不叫有效复习时间、不套用 10 分钟最小阈值;复习总览按任务与学习时长并列展示;不做跨任务汇总大数字、不设目标、不参与复习排序。
|
||||||
|
- **建议**:把复习行为作为时间记录的主体(回忆对比已有记录实体,追问新增),耗时写在该行为上;前端补空闲检测并上报交互时间。
|
||||||
|
- **验收**:完成一次回忆对比后,复习总览该任务行出现复习耗时且与学习时长分列;页面挂机超过 5 分钟不再继续累计。
|
||||||
|
|
||||||
---
|
---
|
||||||
|
|
||||||
## 6. P2 AI 链路(收益成本比最高)
|
## 6. P2 AI 链路(收益成本比最高)
|
||||||
@@ -337,8 +348,8 @@
|
|||||||
|
|
||||||
- **文档**:`lpt-docs/docs/concepts/knowledge-ownership.md`(设计已确认,见文末结论)、`lpt-docs/docs/concepts/learning-report.md`(结构化报告形态)、`lpt-docs/docs/design/system-structure.md`(设计总纲)
|
- **文档**:`lpt-docs/docs/concepts/knowledge-ownership.md`(设计已确认,见文末结论)、`lpt-docs/docs/concepts/learning-report.md`(结构化报告形态)、`lpt-docs/docs/design/system-structure.md`(设计总纲)
|
||||||
- **背景**:学习 A 内容时顺手记下的旁支知识(例:学 AI 时记下“1B = one billion”)目前会被算作 A 的知识,进 A 的导图与回忆对比基准。根因是把「记录地点」当成了「内容归属」。
|
- **背景**:学习 A 内容时顺手记下的旁支知识(例:学 AI 时记下“1B = one billion”)目前会被算作 A 的知识,进 A 的导图与回忆对比基准。根因是把「记录地点」当成了「内容归属」。
|
||||||
- **变更内容**:拆分记录上下文(不可变、不可为空,时间统计用)与内容归属(可变、单一、可为空);时间按会话统计、内容按归属聚合;新增待归类视图;归类动作挂在复习 Feed 里;AI 只给归属建议;待归类内容可升格为学习任务;学习报告改为结构化(会话摘要、预期达成判断、按归属分组的碎片、自由总结,旁支碎片留在本次报告单独标注)。
|
- **变更内容**:拆分记录上下文(不可变、不可为空;取值是学习会话或复习行为)与内容归属(可变、单一、可为空);时间按行为统计(学习会话→学习时间,复习行为→复习耗时)、内容按归属聚合;新增待归类视图;归类动作挂在复习 Feed 里;AI 只给归属建议;待归类内容可升格为学习任务;学习报告改为结构化(会话摘要、预期达成判断、按归属分组的碎片、自由总结,旁支碎片留在本次报告单独标注)。
|
||||||
- **影响范围**:碎片表结构、学习报告结构(字段、AI 草稿生成与降级拼接、前端展示、历史自由文本报告兼容)、标准导图取材、按任务的复习与检索(`StandardMindMapServiceImpl.doGenerate()`、`ReviewServiceImpl.getTaskReview()`、`getTaskFragments()` / `getTaskReports()`)。时间与状态机不受影响。
|
- **影响范围**:碎片表结构、学习报告结构(字段、AI 草稿生成与降级拼接、前端展示、历史自由文本报告兼容)、标准导图取材、按任务的复习与检索(`StandardMindMapServiceImpl.doGenerate()`、`ReviewServiceImpl.getTaskReview()`、`getTaskFragments()` / `getTaskReports()`)。学习会话的时间与状态机不受影响。
|
||||||
- **前置条件**:已满足—— 2026-09-19 维护者确认:碎片不可脱离学习会话;报告改为结构化并保留自由总结;归属保持单一,跨领域关联由标签承担。结论原文见 `knowledge-ownership.md`「已确认的结论」。
|
- **前置条件**:已满足—— 2026-09-19 维护者确认:碎片不可脱离学习会话;报告改为结构化并保留自由总结;归属保持单一,跨领域关联由标签承担。结论原文见 `knowledge-ownership.md`「已确认的结论」。
|
||||||
- **实施要求**:一次替换干净,禁止出现“导图按归属、检索仍按会话”的双口径并存;归属变更后需标记导图待更新。
|
- **实施要求**:一次替换干净,禁止出现“导图按归属、检索仍按会话”的双口径并存;归属变更后需标记导图待更新。
|
||||||
|
|
||||||
@@ -360,6 +371,20 @@
|
|||||||
6. 排序信号是否对用户可配置(掌握度与时间效应的强度)。
|
6. 排序信号是否对用户可配置(掌握度与时间效应的强度)。
|
||||||
- **关联实现**:复习-02(反馈动作)、复习-03(Feed 随机取样)、复习-04(覆盖率查询)、复习-05(Feed 摘要)。
|
- **关联实现**:复习-02(反馈动作)、复习-03(Feed 随机取样)、复习-04(覆盖率查询)、复习-05(Feed 摘要)。
|
||||||
|
|
||||||
|
### 复习-06 引导追问
|
||||||
|
|
||||||
|
- **文档**:`lpt-docs` 待新增概念文档「引导追问」(命名待定),并接入 `review-loop.md`、`ai-task.md`、`standard-mind-map.md`、术语表。
|
||||||
|
- **背景**:复习目前只有接触(Feed)与结构提取(回忆对比);概念边界上的误解(例:把“参数量”当成能决定磁盘占用)不会被覆盖率捕捉。
|
||||||
|
- **已定**:用开放式问题引导用户回答(例:“1B 参数量的 LLM 模型,会占用多少磁盘空间?”),无标准答案;AI 在对话中纠正边界;产出物是知识碎片而不是新实体,复用碎片全链路(归属、待归类、导图取材、Feed 回收);碎片默认归属“被追问概念所属的学习任务”;记录上下文为复习行为;耗时走复习耗时口径(复习-07);追问碎片不进入学习报告。
|
||||||
|
- **待确认**:
|
||||||
|
1. 命名:引导追问 / 追问 / 辨析对话。
|
||||||
|
2. 是否给追问碎片加来源标记,用于导图区分“延伸概念”(关系到回忆对比覆盖率是否会立即被新概念拉低)。
|
||||||
|
3. 单次轮数与长度上限(默认值待定)。
|
||||||
|
4. 入口位置:Feed 卡片 + 导图节点 / 再加任务总览与详情页。
|
||||||
|
5. 无 AI 时的降级形态:自问自记(仍产出碎片,不评估)/ 功能缺席。
|
||||||
|
- **前置条件**:多轮对话不能建在当前同步阻塞的 AI 链路上,依赖 AI-02 / AI-03。
|
||||||
|
- **验收**:一次追问结束后可生成一条归属正确的碎片,并随导图增量更新出现;AI 不可用时仍能记录问题与结论。
|
||||||
|
|
||||||
---
|
---
|
||||||
|
|
||||||
## 附录 A 核对方式(可复现)
|
## 附录 A 核对方式(可复现)
|
||||||
|
|||||||
Reference in New Issue
Block a user