cat-shark/lpt-meta
1
0
Fork 0
Code Issues Pull Requests Actions Packages Projects Releases Wiki Activity

docs: 登记学习引导与标记条目

Browse Source
This commit is contained in:
cat-shark
2026-09-20 00:28:21 +08:00
parent 595e89d5cd
commit 4cca4cddb0
1 changed files with 25 additions and 16 deletions
Download Patch File Download Diff File Expand all files Collapse all files
OPTIMIZATION_BACKLOG.md
+25 -16
View File
@@ -35,12 +35,13 @@
| | 会话-05 活跃会话拦截无出路 | P1 | 待决策 | 出口形式（结束并开始新任务 / 放弃会话），建议与会话-04 同批 |
| 内容归属与报告 | 归属-01 内容归属与待归类 | 待实施 | 设计已确认 | 实现级取舍：碎片表如何承载归属、报告字段拆分、归类交互落点 |
| | 报告-01 报告与碎片不可修订 | P1 | 待设计 | 与归属-01 同批改报告结构；修订与删除的边界（软删除、历史报告标记） |
| 标记与元信息 | 标记-01 统一标记存储 | P1 | 待决策 | 可挂对象；标记名受控方式；标记值类型；按标记检索；标记名治理与可见性 |
| 复习 | 复习-01 复习回路补全 | 待确认 | 待决策（6 项） | Feed 是否含报告；反馈动作形态；覆盖率口径；待归类呈现；遗漏项语义；排序可配置性 |
| | 复习-02 Feed 只读无反馈动作 | P1 | 依赖复习-01 | 反馈动作形态（复习-01 第 2 项） |
| | 复习-03 Feed 随机取样 | P3 | 待决策 | id 区间随机 / 候选池 / 时间窗口随机 |
| | 复习-04 覆盖率查询拉全量 | P3 | 依赖复习-01 | 覆盖率口径（复习-01 第 3 项） |
| | 复习-05 Feed 返回全文 | P3 | 依赖复习-01 | 条目单位与摘要口径（复习-01 第 1 项） |
| | 复习-06 引导追问 | P1 | 待决策 | 命名；追问碎片的来源标记；轮数与长度上限；入口位置；无 AI 时的降级形态 |
| | 复习-06 学习引导 | P1 | 已确认待实施 | 依赖 AI-02 / AI-03，以及标记-01 的存储设计 |
| | 复习-07 复习耗时统计 | P2 | 可直接实施（口径已定） | — |
| AI 链路 | AI-01 事务内同步等 AI | P2 | 待决策 | 事务外纯读对比（小改）/ 任务表 + 异步回写 |
| | AI-02 全链路同步阻塞 | P2 | 可实施（方案已定） | 若 AI-01 选任务表方案，则与 AI-01 同批 |
@@ -165,13 +166,22 @@
- **建议**：导出学习报告、知识碎片、任务统计为 Markdown / JSON，按任务或时间范围筛选。
- **验收**：导出内容可独立阅读，包含报告/碎片原文与时间信息。
### 复习-06 学习引导
- [ ] 未完成
- **涉及仓库**：`lpt-be` + `lpt-fe` + `lpt-ai`（概念文档已写入 `lpt-docs`）
- **依据**：复习只有接触（Feed）与结构提取（回忆对比），概念边界上的误解（例如把“参数量”当成能决定磁盘占用）不会被覆盖率捕捉。
- **已定**：开放式问题引导（例：“1B 参数量的 LLM 模型，会占用多少磁盘空间？”），无标准答案、不判分；AI 在对话中纠正回答里隐含的边界问题；对话不设轮数上限；产出是知识碎片，由用户确认后记录；复用碎片全链路（归属、待归类、导图取材、Feed 回收）；碎片默认归属“被引导概念所属的学习任务”，并带「来自学习引导」标记（仅标记，不做特殊处理）；记录上下文为复习行为；耗时计入复习-07；不进入学习报告；入口为 Feed 卡片与导图节点；不提供降级形态，AI 不可用时该功能整体不可用。
- **前置条件**：依赖 AI-02 / AI-03（多轮对话不能建在当前同步阻塞的链路上）；「来自学习引导」标记的存储依赖标记-01。
- **验收**：一次学习引导结束后，用户确认可生成一条归属正确、带来源标记的碎片，并随导图增量更新出现；不确认则不产生任何数据；AI 不可用时入口不可用，且不影响复习其他部分。
### 复习-07 复习耗时统计
- [ ] 未完成
- **涉及仓库**：`lpt-be` + `lpt-fe`
- **依据**：复习总览目前只展示来自会话的“累计有效学习时长”（`ReviewTaskStats.effectiveTime`），复习行为本身没有任何计时，投入不可见。
- **已定口径**：只对回忆对比与引导追问计时，滚动浏览不计时；超过 5 分钟无交互则截断到上一次交互时间（复习没有暂停动作）；命名“复习耗时”，不叫有效复习时间、不套用 10 分钟最小阈值；复习总览按任务与学习时长并列展示；不做跨任务汇总大数字、不设目标、不参与复习排序。
- **建议**：把复习行为作为时间记录的主体（回忆对比已有记录实体，追问新增），耗时写在该行为上；前端补空闲检测并上报交互时间。
- **已定口径**：只对回忆对比与学习引导计时，滚动浏览不计时；超过 5 分钟无交互则截断到上一次交互时间（复习没有暂停动作）；命名“复习耗时”，不叫有效复习时间、不套用 10 分钟最小阈值；复习总览按任务与学习时长并列展示；不做跨任务汇总大数字、不设目标、不参与复习排序。
- **建议**：把复习行为作为时间记录的主体（回忆对比已有记录实体，学习引导新增），耗时写在该行为上；前端补空闲检测并上报交互时间。
- **验收**：完成一次回忆对比后，复习总览该任务行出现复习耗时且与学习时长分列；页面挂机超过 5 分钟不再继续累计。
---
@@ -334,8 +344,8 @@
同一模块内的条目触碰同一批表结构、口径或配置，建议一个模块一次性改完，避免出现双口径并存的中间态。
1. **学习会话生命周期**：会话-03（结束幂等）+ 会话-01（结算口径统一）一批，修正时间数据口径并补用例；再做会话-02；最后做会话-04 + 会话-05（需先给收敛方式与出口形式的决策）。
2. **内容归属与报告**：归属-01 与报告-01 合并一次改完碎片表与报告结构（碎片归属、报告四段结构、导图待更新标记、检索口径）。
3. **复习**：先落复习-01 的六项结论（口径与内容边界），再依次做复习-02 / 复习-03 / 复习-04 / 复习-05（排序与摘要都建立在口径之上）。
2. **内容归属与报告**：归属-01 与报告-01 合并一次改完碎片表与报告结构（碎片归属、报告四段结构、导图待更新标记、检索口径）；标记-01（统一标记存储）随同定下，学习引导的来源标记依赖它。
3. **复习**：先落复习-01 的六项结论（口径与内容边界），再做复习-07（复习耗时，可独立先做）与复习-02 / 复习-03 / 复习-04 / 复习-05；复习-06（学习引导）依赖 AI-02 / AI-03 与标记-01，排在 AI 链路之后。
4. **AI 链路**：AI-01（先把 AI 移出事务）→ AI-02 + AI-03（异步任务与队列可靠性）→ AI-04（并发锁与生成中语义）。
5. **数据与检索 + 导出**：数据-01（补索引）→ 数据-02 / 数据-03，导出-01 可并行。
6. **安全与运维清理**：安全-01 ~ 安全-04、运维-01、清理-01，彼此独立，可并行推进。
@@ -371,19 +381,18 @@
6. 排序信号是否对用户可配置（掌握度与时间效应的强度）。
- **关联实现**：复习-02（反馈动作）、复习-03（Feed 随机取样）、复习-04（覆盖率查询）、复习-05（Feed 摘要）。
### 复习-06 引导追问
### 标记-01 统一标记存储
- **文档**：`lpt-docs` 待新增概念文档「引导追问」（命名待定），并接入 `review-loop.md`、`ai-task.md`、`standard-mind-map.md`、术语表。
- **背景**：复习目前只有接触（Feed）与结构提取（回忆对比）；概念边界上的误解（例：把“参数量”当成能决定磁盘占用）不会被覆盖率捕捉。
- **已定**：用开放式问题引导用户回答（例：“1B 参数量的 LLM 模型，会占用多少磁盘空间？”），无标准答案；AI 在对话中纠正边界；产出物是知识碎片而不是新实体，复用碎片全链路（归属、待归类、导图取材、Feed 回收）；碎片默认归属“被追问概念所属的学习任务”；记录上下文为复习行为；耗时走复习耗时口径（复习-07）；追问碎片不进入学习报告。
- **文档**：`lpt-docs/docs/concepts/marker.md`（新增，含 5 个待决问题）
- **背景**：来源标记、用户标签等弱信息分散在各功能里考虑，缺少统一存放位置；每新增一种标记就要改一次功能表结构。
- **已定**：标记统一存放，至少包含对象类型与标识、标记名与值、种类（系统标记 / 用户标签）、建立者与时间；标记不是状态——会话状态、报告可否修订、导图是否待更新这类流程判断留在主体上；学习引导产出的碎片带「来自学习引导」系统标记。
- **待确认**：
1. 命名：引导追问 / 追问 / 辨析对话。
2. 是否给追问碎片加来源标记，用于导图区分“延伸概念”（关系到回忆对比覆盖率是否会立即被新概念拉低）。
3. 单次轮数与长度上限（默认值待定）。
4. 入口位置：Feed 卡片 + 导图节点 / 再加任务总览与详情页。
5. 无 AI 时的降级形态：自问自记（仍产出碎片，不评估）/ 功能缺席。
- **前置条件**：多轮对话不能建在当前同步阻塞的 AI 链路上，依赖 AI-02 / AI-03。
- **验收**：一次追问结束后可生成一条归属正确的碎片，并随导图增量更新出现；AI 不可用时仍能记录问题与结论。
1. 标记可挂在哪些对象上（碎片 / 报告 / 任务 / 会话）。
2. 标记名的受控方式（系统标记固定词表、用户标签自由输入；是否允许在系统标记上叠加）。
3. 标记值的类型（布尔开关 / 枚举 / 自由文本）。
4. 是否需要按标记检索的入口，以及需要哪些索引。
5. 标记名的治理（重命名、废弃）与对用户的可见性。
- **关联实现**：复习-06（来源标记）、归属-01（用户标签）。
---