Compare commits
10
Commits
c25417f4ad
...
main
| Author | SHA1 | Date | |
|---|---|---|---|
|
|
cd1c2a444e | ||
|
|
f6369b3b39 | ||
|
|
45cf039a6b | ||
|
|
4147ce94d5 | ||
|
|
5d784b2193 | ||
|
|
2be6f5024c | ||
|
|
8c55b865fd | ||
|
|
39efbb6612 | ||
|
|
804d53aaca | ||
|
|
a16cb4c9e5 |
@@ -1,26 +1,9 @@
|
||||
# LPT 文档项目规则
|
||||
# LPT 文档项目
|
||||
|
||||
## 职责
|
||||
本仓库维护 LPT 系统的概念定义与设计思路。
|
||||
|
||||
- 维护 LPT 系统的概念定义和设计思路。
|
||||
- 文档面向系统本身,而不是面向开发过程。
|
||||
## 规则与技能位置
|
||||
|
||||
## 保留内容
|
||||
|
||||
- 系统概念:学习任务、学习会话、学习预期、知识碎片、学习报告、复习、思维导图、回忆对比等。
|
||||
- 设计思路:为什么采用某个概念、概念之间如何协作、模块边界在哪里。
|
||||
- 稳定的术语映射:例如“学习报告残片”与“知识碎片”的关系。
|
||||
- 所有文档放在 `docs/` 下,`concepts/` 放概念,`design/` 放设计思路。
|
||||
|
||||
## 禁止内容
|
||||
|
||||
- 开发笔记、日志、个人感想、时间线。
|
||||
- 系统中间态、废弃方案、历史迁移过程。
|
||||
- 文件路径、代码片段、接口清单、环境配置、构建与部署信息。
|
||||
- 性能指标、问题修复记录、交付记录。
|
||||
|
||||
## 更新流程
|
||||
|
||||
- 概念变更时先更新对应概念文档,再更新术语表和设计文档。
|
||||
- 新增概念时按现有模板补充“定义、设计意图、相关概念、当前系统体现”。
|
||||
- 修改后同步 meta 仓库 `docs/README.md` 的文档地图。
|
||||
- 通用规则在 meta 仓库 `.agents/roles/`。
|
||||
- 本仓库专属规则在 `roles/`:`documentation-scope.md`。
|
||||
- 本仓库暂无专属技能目录。
|
||||
|
||||
@@ -1,6 +1,6 @@
|
||||
# LPT 概念与设计文档
|
||||
|
||||
> 更新日期:2026-09-19
|
||||
> 更新日期:2026-10-07
|
||||
|
||||
本项目只维护 LPT(Learning Progress Tracker)的系统概念与设计思路,不保存开发记录、系统中间态或开发过程中的中间产物。
|
||||
|
||||
|
||||
@@ -5,12 +5,15 @@
|
||||
| 概念 | 一句话定义 | 详细文档 |
|
||||
|------|-----------|----------|
|
||||
| 学习任务 | 一份学习材料或学习目标对应的最小可管理单元 | [学习任务](learning-task.md) |
|
||||
| 学习会话 | 针对某个学习任务的一次连续学习过程;误操作开启时可零数据关闭 | [学习会话](study-session.md) |
|
||||
| 学习会话 | 针对某个学习任务的一次连续学习过程;遗忘时会由系统收敛,误操作开启时可零数据关闭 | [学习会话](study-session.md) |
|
||||
| 学习预期 | 开始学习前对本次学习目标的描述 | [学习预期](learning-expectation.md) |
|
||||
| 学习录音 | 学习会话期间对设备全部播放声音的连续采集,只采系统输出 | [学习录音](study-recording.md) |
|
||||
| 知识碎片 | 学习中随手记录的不完整内容,也称“学习报告残片” | [知识碎片](knowledge-fragment.md) |
|
||||
| 错误记录 | 对一次用错/做错的记录,含错做法与正确做法,可关联概念 | [错误记录](error-record.md) |
|
||||
| 内容归属 | 一条知识碎片在知识结构上属于哪个学习任务 | [内容归属](knowledge-ownership.md) |
|
||||
| 记录上下文 | 碎片产生于哪次学习会话或复习行为,不可变且不可为空 | [内容归属](knowledge-ownership.md) |
|
||||
| 标记 | 附加在对象上的轻量元信息(来源、标签等),统一存放 | [标记](marker.md) |
|
||||
| 标签字典 | 尚未挂在任何对象上的候选标签;改名与删除只影响候选 | [标记](marker.md) |
|
||||
| 待归类 | 尚未确定内容归属的碎片状态 | [内容归属](knowledge-ownership.md) |
|
||||
| 学习报告 | 一次学习结束后汇总出的结构化学习结果 | [学习报告](learning-report.md) |
|
||||
| 有效学习时间 | 学习会话中未暂停的实际投入时间 | [时间与效率](time-and-efficiency.md) |
|
||||
@@ -18,11 +21,11 @@
|
||||
| 任务优先级 | 由多个维度综合计算出的学习任务排序依据 | [任务优先级](priority.md) |
|
||||
| 应用场景 | 学到的知识可以被使用到什么地方 | [应用场景](application-scenario.md) |
|
||||
| 复习总览 | 按任务汇总可复习内容、掌握度与最近复习时间的入口 | [复习总览](review-overview.md) |
|
||||
| 复习 Feed | 滚动展示知识碎片的记忆触发物,只显示摘要 | [复习 Feed](review-feed.md) |
|
||||
| 标准思维导图 | 每个学习任务对应的知识结构基准 | [标准思维导图](standard-mind-map.md) |
|
||||
| 复习 Feed | 滚动展示知识碎片的记忆触发物,只显示摘要;打标签与反馈在详情页 | [复习 Feed](review-feed.md) |
|
||||
| 标准思维导图 | 一个知识结构范围的基准,范围可以是学习任务或标签集合 | [标准思维导图](standard-mind-map.md) |
|
||||
| 回忆对比 | 用户凭记忆重建知识结构并与标准导图比较 | [回忆对比](recall-review.md) |
|
||||
| 回忆记录 | 一次回忆对比的存档,含起点、三类节点与覆盖率 | [回忆对比](recall-review.md) |
|
||||
| 覆盖率 | 本次对比命中节点占参与对比节点的比例 | [回忆对比](recall-review.md) |
|
||||
| 复习起点 | 用户指定的对比起始节点,只复习该子树 | [回忆对比](recall-review.md) |
|
||||
| 学习引导 | 用开放式问题引出回答、由 AI 纠正概念边界的复习行为 | [学习引导](learning-guidance.md) |
|
||||
| AI 任务 | 系统借助 AI 完成报告聚合、导图生成和语义对比 | [AI 任务](ai-task.md) |
|
||||
| AI 任务 | 系统借助 AI 完成报告聚合、导图生成和语义对比;以异步任务形态提交与查询 | [AI 任务](ai-task.md) |
|
||||
|
||||
@@ -23,6 +23,18 @@ AI 是增强能力,而不是单点依赖。AI 不可用时,系统应能用
|
||||
|
||||
例外:学习引导不提供降级形态。它不属于核心闭环,AI 不可用时该功能整体不可用。
|
||||
|
||||
## 任务的形态:提交与等待分离
|
||||
|
||||
AI 能力按「异步任务」组织,而不是让页面同步等一份结果:
|
||||
|
||||
- 用户确认发起后,系统立即可回一个任务标识;任务在后台执行,页面根据标识查询进度与结果。
|
||||
- **结果属于任务,不属于页面**:同一个任务标识可以反复查询,结果不会因为用户刷新、关页或切走而丢失,也不会因为“已经算过一次”而需要重新消耗 AI。
|
||||
- **完成时间不由用户承担**:生成期间用户可以去别处继续学习,回来时接着看结果。
|
||||
- **同一目标的重复发起不重复消耗**:如果同一个对象已经有进行中的任务,再次发起得到的是那个任务的状态,而不是又一次生成。对外呈现的是“正在生成中”,而不是一个尚不存在的成品。
|
||||
- **读取不产生副作用**:查看一个任务的导图、看一份报告,不会顺带触发一次 AI 生成;需要生成时必须是一个明确的发起动作。
|
||||
|
||||
任务有四种状态(等待执行、正在执行、已完成、失败),失败时用户可见的是可理解的原因,并且可以重新发起。
|
||||
|
||||
## 相关概念
|
||||
|
||||
- 学习报告:AI 聚合碎片的产出。
|
||||
|
||||
@@ -0,0 +1,55 @@
|
||||
# 错误记录
|
||||
|
||||
> 状态:设计已定,实现未开始。本文只记录概念与设计取向,未定项集中在「待定」。
|
||||
|
||||
## 定义
|
||||
|
||||
错误记录是对「一次用错 / 做错」的记录,回答的是「我在哪里用了错误的做法、正确做法是什么」。它与知识碎片互补:碎片记录刚学到的东西,错误记录记录应用时暴露的缺口。
|
||||
|
||||
一条错误记录至少包含:
|
||||
|
||||
- **题目或场景**:当时在做的一道题、一个操作或一个实际情境。
|
||||
- **当时的错误做法**:用户当时的判断或做法。
|
||||
- **正确的做法或正确答案**:事后确认的正确内容。
|
||||
- **关联的概念或导图节点**(可选):这条错误落到哪个知识点上。
|
||||
- **标签**(可选):复用[标记](marker.md)的自由标签。
|
||||
|
||||
## 设计意图
|
||||
|
||||
学习时间主要花在「识别概念」与「实际应用」上,而使用过程中产生的错误几乎全部发生在做题场景,不在学习页面。这类信息是查缺补漏最直接的线索:
|
||||
|
||||
- 它天然带有「我错了」的定位,比碎片更接近问题本身。
|
||||
- 它发生在应用场景里,能反向说明概念理解在哪一步断了。
|
||||
- 关联到概念或导图节点后,可以形成「概念 → 它的高频误区」的回看路径。
|
||||
|
||||
因此录入必须能脱离学习页面:从题目直接记录,不要求先回到学习任务或学习会话。
|
||||
|
||||
## 与现有概念的关系
|
||||
|
||||
- **知识碎片**:并列关系,不是同一实体的变体。碎片不要求「对错」,错误记录的核心恰是错与对的对照;把错误塞进碎片需要额外的类型字段与语义分支,会把残片体系拖向通用笔记。
|
||||
- **标准思维导图**:错误记录可以挂到导图节点或概念上,从而按概念聚合回看。
|
||||
- **标记**:错误记录可以使用自由标签,标签语义与碎片上的标签一致。
|
||||
- **复习**:错误记录**不进**复习 Feed 的随机排序。它需要的是集中回看,而不是偶遇式接触。
|
||||
- **内容归属**:与碎片的归属关系尚未确定,见「待定」。
|
||||
|
||||
## 复习方式
|
||||
|
||||
错误记录走**单独的回看列表**,可按概念或标签聚合。理由是错误需要密集、可检索地回看,与 Feed「无压力偶遇」的立场相反;把错误混进 Feed 会同时破坏两种节奏。
|
||||
|
||||
## AI 的边界
|
||||
|
||||
一期不做 AI。二期可选「把同一概念下的错误归并成高频误区」,且**必须由用户手动触发**:错误记录的产生不附带 AI 调用,避免录入成本被计费与等待抬高。具体提示词与归并口径在实现该阶段前另定。
|
||||
|
||||
## 待定
|
||||
|
||||
- 错误记录与[内容归属](knowledge-ownership.md)的关系:是像碎片一样拥有独立归属,还是只挂在概念 / 导图节点上。
|
||||
- 回看列表与[复习总览](review-overview.md)的入口关系:独立页面,还是总览内的一块。
|
||||
- 删除口径:软删除?关联的导图节点被删除后,错误记录如何保留。
|
||||
- 错误记录是否参与学习报告与导出。
|
||||
|
||||
## 相关概念
|
||||
|
||||
- 知识碎片:并列的记录形态,记录「学到什么」。
|
||||
- 标准思维导图:错误记录可挂在它的节点与概念上。
|
||||
- 标记:错误记录使用自由标签。
|
||||
- 复习总览与复习 Feed:错误记录只在单独的回看列表里出现。
|
||||
@@ -1,6 +1,6 @@
|
||||
# 内容归属
|
||||
|
||||
> 状态:**设计已确认,实现待安排**。三个待决问题已于 2026-09-19 由维护者确认,结论见文末。
|
||||
> 状态:**设计已确认**。三个待决问题于 2026-09-19 确认,四项实现级取舍于 2026-10-09 确认,结论均见文末。
|
||||
|
||||
## 定义
|
||||
|
||||
@@ -97,3 +97,11 @@
|
||||
1. **碎片不可脱离记录上下文。** 不存在没有记录上下文的内容:每一条碎片都产生于某次学习会话或某次复习行为(回忆对比、学习引导),因此一定有可追溯的产生场景。代价是系统不向可以随手记录的通用笔记工具演进,这是有意的边界。
|
||||
2. **学习报告改为结构化呈现。** 报告由会话摘要、预期达成判断、按归属分组的碎片和自由总结组成;旁支碎片仍留在本次报告中,只单独标注归属、不参与正文推演。自由总结必须保留,否则卡点与下一步无处表达。
|
||||
3. **内容归属保持单一,跨领域关联由标签承担。** 学习内容很少只属于一个领域:一份侧重 A 领域的材料仍会带来 B 领域的碎片,但它仍归属 A,与 B 的关联用标签表达。如果用户持续在同一领域积累旁支碎片,说明该领域已值得作为独立学习任务,此时走“待归类内容升格为学习任务”的路径,而不是给它第二个归属。
|
||||
|
||||
### 实现级结论(2026-10-09 确认)
|
||||
|
||||
4. **报告里的分组是实时聚合,不做快照。** 报告只保存三段文本(会话摘要、预期达成判断、自由总结);「按归属分组的碎片」在查看时按碎片的当前归属聚合。理由是它与标准导图的取材口径必须一致,否则会出现「报告说属于甲、导图放在乙」的两套口径,而这正是内容归属要消灭的东西。旁支碎片由此也不需要额外字段——它就是归属不等于本会话所属任务的那部分。
|
||||
5. **迁移历史内容时保留原会话。** 记录上下文「不可为空」是硬约束,不为迁移放宽。历史碎片会连同它产生时的那次会话一起进来,因此它仍然能回答「当时在学什么的时候记的」。
|
||||
6. **删除报告不连带删除碎片。** 两者是并列关系而不是包含关系:报告是这次会话的收敛结果,碎片是原料。删报告时如果连带删碎片,会删掉那些已经被归类到其他任务的内容。
|
||||
7. **删除学习任务时,碎片保留并降为空归属(进入待归类)**,会话、报告、标准导图、回忆记录与应用场景随任务一并软删除。删任务撤销的是「这次学习的时间记录与收敛结果」,不是知识本身;碎片不因归属消失而消失。
|
||||
8. **待归类在两处出现**:复习总览里独立成一块,复习 Feed 里混排并打标、归类就在卡片上完成。
|
||||
|
||||
@@ -30,9 +30,9 @@
|
||||
- 知识碎片:报告的主要来源,按内容归属分组。
|
||||
- 学习预期:报告中回答“实际学了什么”。
|
||||
- 内容归属:决定碎片在报告中的分组,也决定它进入哪份标准思维导图。
|
||||
- 标准思维导图:报告参与导图生成。
|
||||
- 标准思维导图:报告作为导图生成的参考上下文——只有实质讨论相关碎片同一主题、且领域一致时,其内容才由 AI 提取进导图。
|
||||
- 复习 Feed:Feed 的条目单位是碎片;报告以会话完整结果的形态从任务记录进入回顾。
|
||||
|
||||
## 设计思路
|
||||
|
||||
降低报告的仪式感:用户的主要书写单元是知识碎片,报告允许先由系统根据碎片生成结构化草稿(摘要、达成判断、分组建议、总结草稿),再由用户修改确认。AI 不可用时降级为规则拼接:按内容归属分组碎片并生成摘要,自由总结留给用户填写。
|
||||
降低报告的仪式感:用户的主要书写单元是知识碎片,报告允许先由系统根据碎片生成结构化草稿(摘要、达成判断、分组建议、总结草稿),再由用户修改确认;用户也可以在结束会话总结里点「AI 重新生成」重跑草稿(三段非空时先确认再覆盖)。AI 不可用时降级为规则拼接:按内容归属分组碎片并生成摘要,自由总结留给用户填写。
|
||||
|
||||
+16
-6
@@ -29,6 +29,15 @@
|
||||
|
||||
- **标签**(用户标签):用户自由建立的分类,多个、可为空、可变,只影响检索。
|
||||
- **来源标记**:例如「来自学习引导」。系统标记,由系统在产出时写入,用户不可编辑。
|
||||
- **自动任务名标签**:碎片获得内容归属时,由系统按所属任务自动写入一条用户标签,名字取任务当时的名字。它是用户标签而非系统标记:用户可以改名或删除;任务之后改名也不会回溯改写历史碎片上的标签。
|
||||
|
||||
## 标签字典
|
||||
|
||||
用户可以在打标签之前先把标签建出来,这些尚未挂在任何对象上的标签存放在统一的标签字典里。字典只是候选项的来源:
|
||||
|
||||
- 打标签时输入即过滤字典(含自动任务名标签),也可以直接输入一个新名字。
|
||||
- 字典的改名与删除只影响候选,不影响任何对象上已经打好的标记。
|
||||
- 名字按去空格、大小写不敏感的口径去重,展示时保留用户输入的原样。
|
||||
|
||||
## 相关概念
|
||||
|
||||
@@ -37,10 +46,11 @@
|
||||
- 学习引导:产出的碎片带来源标记。
|
||||
- 学习任务:标签也可以挂在任务上用于检索。
|
||||
|
||||
## 待决问题
|
||||
## 已确认的结论
|
||||
|
||||
1. 标记可以挂在哪些对象上(知识碎片 / 学习报告 / 学习任务 / 学习会话)?
|
||||
2. 标记名的受控方式:系统标记用固定词表、用户标签自由输入;是否允许用户在系统标记上叠加自己的值。
|
||||
3. 标记值是否只在需要时使用(布尔开关 / 枚举 / 自由文本)。
|
||||
4. 是否需要按标记检索的入口(例如“找出所有来自学习引导的碎片”),以及需要哪些索引。
|
||||
5. 标记名如何治理(能否重命名或废弃),以及哪些标记对用户展示。
|
||||
1. **可挂对象是知识碎片与学习任务**。报告是会话的派生结果,而且它自身已经有一个「按归属分组」的维度,再挂标记会出现两套「分组」语义;会话是时间轴对象,其流程性信息按边界要求留在主体上。
|
||||
2. **两类标记彻底分开**:系统标记的名字与值来自固定词表,由系统写入,用户只能查看;用户标签的名字由用户自由输入,可增删改。同一个对象上两类可以共存、互不覆盖。
|
||||
3. **系统标记成对、标签只有名**:系统标记表达的是「名 = 值」(来源 = 学习引导),用户标签的一个词本身就是全部信息,不再附值。
|
||||
4. **检索只做单一标记筛选**:点一个标记即筛选出带它的对象。不做多标记组合、不做跨对象统一搜索页——标签的唯一作用就是检索,检索入口是它存在的理由,但组合检索目前没有真实使用场景。
|
||||
5. **标签字典独立于标记存放**。标记描述的是「某个对象上有一个标记」,缺了对象就不再是标记;字典是候选项,与标记是两份数据,因此不为「空标签」在标记表里造没有对象的行。
|
||||
6. **标记对用户全部可见,用户标签可改名、可删除**。改名是安全的:标记不参与聚合口径,批量改名不会像改内容归属那样污染统计与检索口径。不做「废弃」这一状态——保留历史标记的收益很小,而它会给检索与展示增加判断分支。
|
||||
|
||||
@@ -2,7 +2,7 @@
|
||||
|
||||
## 定义
|
||||
|
||||
回忆对比是用户凭记忆重建某个学习任务的知识结构,并把它与标准思维导图进行比较的过程。
|
||||
回忆对比是用户凭记忆重建一个知识结构范围,并把它与对应的标准思维导图进行比较的过程。范围可以是一个学习任务(任务导图),也可以是一个标签集合(标签导图)。
|
||||
|
||||
对比结果把节点分为:
|
||||
|
||||
@@ -21,6 +21,7 @@
|
||||
每一次回忆对比都会留下一条回忆记录,包含:
|
||||
|
||||
- 发生时间。
|
||||
- 复习对象:这次对比的是任务导图还是标签导图,以及对应的任务或标签集合。
|
||||
- 复习起点(或整棵树)。
|
||||
- 命中、遗漏、额外的节点集合。
|
||||
- 覆盖率。
|
||||
@@ -56,7 +57,7 @@
|
||||
|
||||
## 相关概念
|
||||
|
||||
- 标准思维导图:对比的基准。
|
||||
- 标准思维导图:对比的基准,任务导图与标签导图各自对应一种复习范围。
|
||||
- 复习起点:用户可以选择从某个节点开始,只复习该子树。
|
||||
- 知识碎片与学习报告:遗漏项可追溯回原文。
|
||||
- 复习总览:消费覆盖率形成的任务级掌握度。
|
||||
|
||||
@@ -21,13 +21,26 @@ Feed 的条目单位是知识碎片。学习报告不以条目形式出现在 Fe
|
||||
- 复习总览:任务级入口,与 Feed 的条目级展示互补。
|
||||
- 回忆卡片:点击 Feed 内容后,先让用户尝试回忆再展开原文。
|
||||
- 回忆对比:Feed 是进入深度复习的入口之一。
|
||||
- 学习引导:Feed 卡片是它的入口之一。
|
||||
- 学习引导:详情页是它的入口之一。
|
||||
- 标记(标签):标签是任务之外的另一个聚合维度,打标签动作在详情页完成。
|
||||
- 复习排序:合并“多久没接触”与任务掌握度两个信号,只影响出现概率。
|
||||
|
||||
## 卡片上的动作
|
||||
|
||||
Feed 只做展示、导航与归类,不在卡片上做其他写操作:
|
||||
|
||||
- **展开查看**:本身是一次复习行为,会刷新“最近接触时间”,不产生额外数据。
|
||||
- **进入详情**:点击内容进入详情页;打标签、反馈、学习引导都在详情页内完成。
|
||||
- **待归类就地归类**:尚未确定内容归属的碎片,在卡片上直接选任务完成归类。
|
||||
|
||||
Feed 是“看到内容”的地方,详情页是“处理内容”的地方。把打标签、反馈与学习引导从滚动列表里移出,是为了让滚动保持低阻力:滚动时不该被迫做整理,也不该误触改变数据。归类是例外:它只是一次选择,而且复习是归类成本最低的时机。
|
||||
|
||||
反馈仍然刻意做得轻:不显示状态徽标、不统计总数、不形成待复习列表。一旦把这些结果展示成状态或数字,复习就会从“偶遇式接触”滑回“必须处理的清单”。
|
||||
|
||||
## 设计思路
|
||||
|
||||
滚动展示适合“播种”记忆,主动回忆适合“巩固”记忆。系统把两者结合:先低门槛展示,再在用户点击时引导回忆。
|
||||
|
||||
Feed 只给摘要,全文在详情里按需展开:滚动场景下全文既拖慢浏览,也让用户跳过“先尝试回忆”这一步。
|
||||
|
||||
Feed 同时是归类成本最低的位置:看到一条内容时顺手确认它属于哪个任务,不需要额外的整理流程。归类动作与复习动作放在一起的原因见[模块边界](../design/module-boundaries.md)。
|
||||
Feed 同时是归类成本最低的位置:看到一条内容时顺手确认它属于哪个任务,不需要额外的整理流程。归类动作与复习动作放在一起的原因见[模块边界](../design/module-boundaries.md)。打标签、反馈与学习引导不进 Feed 卡片,它们需要先展开内容、看到完整上下文再决定,放回详情页之后滚动列表也不再承担整理职责。
|
||||
|
||||
@@ -25,6 +25,7 @@
|
||||
|
||||
- 学习任务:总览的行单位。
|
||||
- 内容归属:决定内容进入哪个任务,也决定待归类内容是否出现在这里。
|
||||
- 标记(标签):任务之外的另一个聚合维度,按标签复习走标签导图,与总览的任务级入口并存。
|
||||
- 标准思维导图:从任务进入深度复习的对象。
|
||||
- 回忆记录与覆盖率:掌握度的来源。
|
||||
- 复习耗时:与学习时长并列的投入口径。
|
||||
|
||||
@@ -2,7 +2,7 @@
|
||||
|
||||
## 定义
|
||||
|
||||
标准思维导图是每个学习任务对应的知识结构基准,由系统从**归属为该任务**的学习报告、知识碎片和应用场景中提取整理而成。用户可以查看、编辑它,也可以用它作为复习的对照对象。
|
||||
标准思维导图是每个学习任务对应的知识结构基准,由系统从**归属为该任务**的知识碎片和应用场景中提取整理而成;与碎片同源会话的**学习报告**作为参考上下文参与生成(见「导图的范围」)。用户可以查看、编辑它,也可以用它作为复习的对照对象。
|
||||
|
||||
## 设计意图
|
||||
|
||||
@@ -14,10 +14,12 @@
|
||||
|
||||
## 相关概念
|
||||
|
||||
- 学习报告与知识碎片:导图的生成素材。
|
||||
- 知识碎片:导图的取材单位,按内容归属或标签集合取。
|
||||
- 学习报告:与碎片同源(同一学习会话)时作为参考上下文,由 AI 判断相关性后提取。
|
||||
- 内容归属:决定哪些碎片进入本导图;素材按归属取材,而不是按产生于哪个学习会话。
|
||||
- 应用场景:作为独立分支进入导图。
|
||||
- 回忆对比:标准导图是用户回忆结果的对照基准。
|
||||
- 回忆对比:标准导图是用户回忆结果的对照基准,任务导图与标签导图都可以作为对照对象。
|
||||
- 标记(标签):标签导图的取材范围。
|
||||
- 节点溯源:导图节点可以关联回原始报告、碎片或应用场景。
|
||||
- 学习引导:从导图节点发起,产出的碎片按归属进入本导图。
|
||||
|
||||
@@ -25,13 +27,32 @@
|
||||
|
||||
标准导图区分四种来源,用于说明当前这份导图是怎么来的:
|
||||
|
||||
- 内置规则:不依赖 AI,按学习会话分组,对报告、碎片和应用场景做去重与合并。
|
||||
- 内置规则:不依赖 AI,按学习会话分组,对碎片和应用场景做去重与合并(报告只作 AI 路径的参考,内置规则不使用)。
|
||||
- AI 生成:由 AI 从学习材料中提取缩进大纲后解析成树。
|
||||
- 用户编辑:用户直接修改导图内容。
|
||||
- 用户合并:增量生成时保留用户已编辑的内容,再追加新产生的学习内容。
|
||||
|
||||
重新生成导图时不覆盖用户的手工编辑,而是把新内容合并进来。
|
||||
|
||||
## 导图的范围
|
||||
|
||||
导图按取材范围分两种:
|
||||
|
||||
- **任务导图**:以学习任务为范围,取材于内容归属为该任务的碎片与应用场景。
|
||||
- **标签导图**:以一个标签集合为范围,取材于带这些标签的内容。多个标签时由用户选择取并集(带任一标签)或交集(同时带全部标签)。
|
||||
|
||||
两种范围并存,互不替代:任务导图回答「这个任务学到了什么结构」,标签导图回答「这个概念在不同任务里呈现出什么结构」。范围用规范化的标签集合表达,集合相同即同一张导图。
|
||||
|
||||
标签导图的重算与任务导图遵循同一口径:素材变化只把导图标记为待更新,重建由用户手动触发。
|
||||
|
||||
## 报告作为参考上下文
|
||||
|
||||
一次总结往往会把若干碎片拼接出新的定义与观点,这些内容只存在于报告里、不在碎片里。因此导图取材时,把碎片**同源会话**(报告与碎片按会话隐式绑定:碎片记录上下文为 SESSION 时,其 contextNum 即报告的 sessionNum)的报告一并带上作为参考。
|
||||
|
||||
报告只是参考而不是素材:是否采用由 AI 按相关性判断——只有当报告**实质讨论**了相关碎片的同一主题、且与本批碎片领域一致时,才可提取其中的新定义/观点进入导图;报告只是顺带提及或根本没有提到该主题时,完全不用;报告与主干强相关时可以参考其组织结构。内置规则降级路径不做语义判断,因此不携带报告。
|
||||
|
||||
报告的新增、编辑、删除与碎片、标签的变化同口径:只把相关导图置为待更新,重建仍由用户手动触发。
|
||||
|
||||
## 设计思路
|
||||
|
||||
标准导图应同时适合人工编辑和机器处理。它既可以用缩进大纲的形式让用户直接修改,也可以用树结构参与算法比较。
|
||||
|
||||
@@ -0,0 +1,77 @@
|
||||
# 学习录音
|
||||
|
||||
## 定义
|
||||
|
||||
学习录音是学习会话期间对用户设备上**全部播放声音**的连续采集。它记录的是系统输出——用户当时听到的一切(视频课、音频课、播客、他人的讲解),而不是麦克风输入(用户自己的声音或环境声)。
|
||||
|
||||
学习录音与学习会话绑定:一次会话对应一段录音,录音随会话开始而开始、随会话结束而结束。
|
||||
|
||||
## 设计意图
|
||||
|
||||
一次学习中真正需要沉淀的上下文,大部分存在于**当时播放的内容**里;而这些内容在会话结束后既无法复述,也无法检索。要求用户在学习的当下分心记录,会直接拉低记录率,进而削弱复习闭环的原料供给。
|
||||
|
||||
学习录音把「记录」从学习中剥离出去:
|
||||
|
||||
- 学习时专心听,不必边学边记。
|
||||
- 事后由 AI 从转写文本中提炼知识碎片与报告原料。
|
||||
- 复习时可以回到当时的原始材料,而不是只依赖当时写下的几行字。
|
||||
|
||||
它与「量化,但不评判」的原则一致:录音只增加可回看的原料,不产生评分,也不带来约束。
|
||||
|
||||
## 边界的划定
|
||||
|
||||
- **只采系统输出,不采麦克风。** 录音回答的是「用户听到了什么」,而不是「房间里发生了什么」。这条边界同时收敛了隐私范围与转写噪音。
|
||||
- **与输出设备无关。** 内置扬声器、有线耳机、蓝牙耳机、外接显示器的音频都汇入同一路系统混音,用户切换设备不改变录音行为,也不需要重新配置。
|
||||
- **采不到的内容属于正常边界。** 处于独占播放模式或受版权保护的内容可能无法被系统混音捕获,这类缺口不做补偿。
|
||||
- **录音时长不是学习时长。** 有效学习时间仍由学习会话定义;录音只是会话期间的一段素材。
|
||||
- **录音不代表内容归属。** 录音产出的碎片按内容归属规则处理,录音本身不参与归属判定。
|
||||
|
||||
## 采集与浏览器的分工
|
||||
|
||||
录制系统声音的能力不在浏览器里,因此分工是:
|
||||
|
||||
- **本机录音程序**:跟随系统默认输出设备采集、编码、上传。
|
||||
- **网页**:发起与结束录音、展示状态、在需要时回放。
|
||||
|
||||
由此得到的性质是:网页被关闭或崩溃不会中断录音;录音是否可用,不取决于当时打开了哪个页面。这也意味着学习录音是系统里第一个不运行在浏览器内的能力。
|
||||
|
||||
## 多设备的边界
|
||||
|
||||
录音必须发生在**声音实际播放的那台设备**上:声音从哪台设备发出,就在哪台设备上采集。这条约束决定了几件事:
|
||||
|
||||
- 录音能力是**按设备**存在的,不是按账号。同一账号在多台设备上学习,每台设备各自需要具备采集能力并各自授权。
|
||||
- 网页可以服务于任意设备(它只负责发起与展示),但录音不跟着网页走。在手机上浏览学习页面时,手机若没有采集能力,就没有录音。
|
||||
- 换一个播放设备就要重新具备采集能力,这与「切换输出设备不影响录音」并不矛盾:后者说的是耳机的插拔,前者说的是换了一台电脑或换到手机。
|
||||
|
||||
## 产物的去向
|
||||
|
||||
| 产物 | 去向 |
|
||||
|------|------|
|
||||
| 原始音频 | 长期保留,作为可回看的原始学习材料 |
|
||||
| 转写文本 | 作为 AI 任务的输入,用于生成学习报告草稿与知识碎片 |
|
||||
|
||||
原始音频长期保留的代价是存储随学习时长线性增长,属于需要单独规划容量的对象。
|
||||
|
||||
## 隐私边界
|
||||
|
||||
录音采集的是用户听到的一切,可能包含他人语音(线上会议、通话)。因此:
|
||||
|
||||
- 录制期间必须有持续且可见的指示,用户随时可停。
|
||||
- 采集范围由系统混音决定,用户不需要、也无法逐条挑选内容。
|
||||
- 是否在会议等场景下录音,属于用户自己的判断;系统只保证「可见、可停、可追溯」。
|
||||
|
||||
## 相关概念
|
||||
|
||||
- 学习会话:录音的绑定主体,提供开始与结束的时点。
|
||||
- 知识碎片:转写文本的主要产物形态。
|
||||
- 学习报告:转写文本的汇总结局之一。
|
||||
- 内容归属:录音产物按内容归属规则处理,录音不改变归属判定。
|
||||
- AI 任务:转写与提炼都通过 AI 任务执行。
|
||||
- 时间与效率:录音时长与有效学习时间是两个独立口径。
|
||||
|
||||
## 待决问题
|
||||
|
||||
1. 录音是否允许脱离学习会话独立存在(例如只录某一段材料)?
|
||||
2. 转写文本是直接进入学习报告,还是只作为碎片原料、由用户确认后再记录?
|
||||
3. 转写未完成或失败的录音,在复习与检索中如何呈现?
|
||||
4. 会话暂停期间是否继续录音?
|
||||
@@ -19,6 +19,25 @@
|
||||
- 必须输入确认语「我误操作导致开启了本次学习」才能关闭,防止用户误删真实的学习数据。
|
||||
- 仅当本次会话尚未产生学习残片时可用;一旦产生过残片,只能按正常流程结束。
|
||||
|
||||
## 系统收敛
|
||||
|
||||
用户忘记暂停或结束时,会话不应该永久停留在「进行中」:它会让时间统计持续失真,也会挡住后续的学习任务。因此除了用户主动暂停或结束,系统还会自己把这类会话收敛为暂停。
|
||||
|
||||
- **结算口径不变**:收敛仍然按遗忘判定规则结算,只计入一个番茄钟,见[时间与效率](time-and-efficiency.md)。
|
||||
- **只在明显遗忘时动手**:只有当最后一段学习远远超过遗忘判定阈值、已经不存在「用户其实还在学」的可能时,系统才会收敛。
|
||||
- **两个时机**:用户下次触达会话时会先收敛再返回结果(用户回到任何页面看到的都是修正后的数据);以及后台定期自查,保证用户长期不回来时统计也能收敛、新任务也不会被永久挡住。
|
||||
- **标记而不用新状态**:被系统收敛的会话会带一个「疑似忘记结束」的标注,只用于提醒用户,会话状态机仍然是进行中、暂停、已结束三种。
|
||||
|
||||
## 离开一个未结束的会话
|
||||
|
||||
用户开始新任务时,如果还有别的未结束会话,系统会先告知并让用户选择怎么处理它:
|
||||
|
||||
- 前往继续那个会话。
|
||||
- 结束它并开始当前任务(会为旧会话生成一份未填写总结的学习报告)。
|
||||
- 放弃它(仅限未产生学习残片的会话,等同「误操作结束」)。
|
||||
|
||||
这条出口存在的理由:用户不应该为了开始一个新任务,而被迫去回忆并找到很久以前那个被搁置的会话。
|
||||
|
||||
## 设计意图
|
||||
|
||||
学习会话把“学习”从模糊的时间块变成可记录、可恢复、可比较的过程。系统通过会话记录:
|
||||
|
||||
@@ -23,14 +23,17 @@
|
||||
|
||||
- 按任务汇总复习状态(复习总览)。
|
||||
- 滚动展示知识碎片(复习 Feed)。
|
||||
- 维护标准思维导图。
|
||||
- 提供回忆对比、回忆记录和遗漏项回溯。
|
||||
- 维护标准思维导图,包括任务导图与按标签聚合的标签导图。
|
||||
- 提供回忆对比、回忆记录和遗漏项回溯,复习对象可以是任务或标签集合。
|
||||
- 提供学习引导(开放式问题与概念边界纠正)。
|
||||
- 维护标记与标签字典(提前建标签、改名、删除、按标签检索)。
|
||||
- 记录复习耗时(回忆对比与学习引导)。
|
||||
- 承接内容归属的调整动作与待归类内容的处理入口。
|
||||
|
||||
复习模块不要求用户逐条整理学习材料,材料是自动整理和对照分析的数据来源。复习按内容归属聚合,而不是按内容产生于哪次会话:这是归类动作与复习动作放在一起的原因。复习不做调度:不生成到期清单,只影响内容的出现概率。
|
||||
|
||||
复习内部分两处:**展示层**是首页的复习 Feed(落地页上的滚动条),只展示内容与导航,外加一次性完成的归类;**操作层**是残片详情页,打标签、反馈与学习引导都在这里。拦断写操作是为了让滚动保持低阻力,不把“看到”变成“必须处理”。
|
||||
|
||||
## 应用场景
|
||||
|
||||
应用场景属于学习任务,而不是复习模块。它表示任务完成后用户希望具备的应用能力,参与标准导图生成,为复习提供现实语境。
|
||||
|
||||
+21
-12
@@ -33,6 +33,7 @@
|
||||
| 学习报告 | 一次会话的完整结果,从任务记录进入回顾 |
|
||||
| 标准思维导图 | 深度复习的对照基准与结构来源 |
|
||||
| 应用场景 | 复习的现实语境,参与导图 |
|
||||
| 标记(标签) | 复习的另一个聚合维度:标签导图按标签集合取材,跨任务聚合同一概念的碎片 |
|
||||
| 回忆记录 | 复习产生的历史,用于展示掌握变化与计算任务掌握度 |
|
||||
|
||||
学习时间与复习耗时都不进入复习内容:它们回答的是投入了多少,而不是记得怎么样。复习耗时只在复习总览里与学习时长并列呈现。
|
||||
@@ -40,6 +41,7 @@
|
||||
## 复习的两个层级
|
||||
|
||||
- **任务级**:复习总览回答“从哪个任务开始复习”,见 [复习总览](../concepts/review-overview.md)。
|
||||
- **标签级**:按标签复习回答“这个概念在哪些任务里出现过”,取材与导图口径见 [标准思维导图](../concepts/standard-mind-map.md)。
|
||||
- **内容级**:复习 Feed 回答“这次遇到哪条内容”,见 [复习 Feed](../concepts/review-feed.md)。
|
||||
|
||||
## 复习耗时
|
||||
@@ -88,9 +90,10 @@
|
||||
|
||||
## 进入回忆对比的入口
|
||||
|
||||
回忆对比不应该只有一个入口。系统提供三种入口,它们对应不同的复习心态:
|
||||
回忆对比不应该只有一个入口。系统提供四种入口,它们对应不同的复习心态:
|
||||
|
||||
- 从复习总览进入:用户主动想复习某个学习任务,此时默认面对整棵标准导图,可以选择任意节点作为起点。
|
||||
- 从按标签复习进入:用户想围绕一个概念复习,系统把带该标签(集合)的碎片聚合成标签导图作为对照基准。这一页以**已生成过导图的标签集合**为默认入口——导图生成后标签集合一般不再变化,用户通常直接从已有导图进入,或把新碎片补充进现有结构;手动选标签新建范围是次要入口。
|
||||
- 从某条知识碎片或学习报告详情进入:用户在看具体内容时想深挖,系统根据这段内容定位到最相关的节点,直接以该节点为复习起点。
|
||||
- 从首页回忆卡片进入:用户在滚动 Feed 上随手回忆后想继续,同样自动定位到对应节点。
|
||||
|
||||
@@ -100,10 +103,13 @@
|
||||
|
||||
复习内容不应完全随机,也不应被强制排序。系统综合两个信号调整内容的出现概率:
|
||||
|
||||
- **多久没接触**:距内容产生(或最近一次出现)越久,权重越高;时间效应在到达上限后不再增长。
|
||||
- **多久没接触**:距最近一次接触(展开查看或标记反馈都算接触,没有则取内容产生时间)越久,权重越高;时间效应在到达上限后不再增长。
|
||||
- **任务掌握度**:最近一次回忆对比的覆盖率越低,权重越高;从未回忆过的任务视为最需要复习。
|
||||
- **用户反馈**:主动标记「稍后再看」提高出现概率;标记「已掌握」降低但不归零。后者不归零是有意的——每条内容都应保留再次出现的机会。
|
||||
|
||||
两个信号只影响“出现的概率”,不产生到期、逾期、优先级标记。随机性被保留:每条内容都有机会出现,包括刚刚复习过的内容。信号强度可配置,默认值按“时间效应为主、掌握度为辅”设定。
|
||||
信号只影响“出现的概率”,不产生到期、逾期、优先级标记。随机性被保留:每条内容都有机会出现,包括刚刚复习过的内容。
|
||||
|
||||
前两个信号的相对强度按**三档预设**由用户选择:时间为主(默认,符合“时间效应为主、掌握度为辅”的默认口径)/均衡/掌握度为主。不做精确数值:两个信号是相乘关系而非加权求和,给出百分比只是假精度,而三档已经覆盖真实诉求——觉得“总给我看旧内容”或“总给我看已经熟的”。
|
||||
|
||||
## 复习中的归类
|
||||
|
||||
@@ -111,6 +117,7 @@
|
||||
|
||||
- 待归类内容在复习总览中可见,在 Feed 中可归类。
|
||||
- 归类动作就近提供,一次交互完成;AI 只给建议,用户可一键接受或忽略。
|
||||
- 内容获得归属(产生时即有,或之后归类)时,系统自动补上一条任务名标签,见[标记](../concepts/marker.md)。
|
||||
- 归属改变后,内容进入新任务的导图取材范围,原任务与新任务的导图都标记为待更新;复习排序权重按任务掌握度自动跟随,不需要单独处理。
|
||||
|
||||
## 复习中的反馈动作
|
||||
@@ -120,7 +127,7 @@
|
||||
- **无需记录的反馈**:展开查看、进入回忆对比,本身就是复习行为,不产生额外数据。
|
||||
- **需要记录的反馈**:用户主动标记“已掌握”或“稍后再看”,用于调整出现概率。
|
||||
|
||||
反馈动作的存在方式列入待决问题:它既可能帮助系统更准地安排内容,也可能把复习拖回清单模式。
|
||||
反馈动作确定为两个轻量动作:**已掌握**与**稍后再看**。它们只调整内容的出现概率,不产生状态展示、不统计总数、不形成待复习列表;「已掌握」降低出现概率但不归零,随机性仍然保留。此外,展开查看与进入回忆对比会刷新「上次复习时间」,让它成为继时间效应与任务掌握度之后的第三个信号。两个动作在残片详情页提供,Feed 卡片不再放置它们。
|
||||
|
||||
## AI 在复习中的边界
|
||||
|
||||
@@ -128,13 +135,15 @@
|
||||
- 归类建议由 AI 增强,AI 不可用时降级为关键词与历史归属的规则建议;规则也不可用时不做建议,不影响复习流程。
|
||||
- AI 不参与“该复习什么”的判定:排序信号来自时间与回忆记录,AI 只影响匹配与建议。
|
||||
|
||||
## 待决问题
|
||||
## 已确认的结论
|
||||
|
||||
以下问题需要维护者确认后再进入实现:
|
||||
以上问题已由维护者确认,结论如下:
|
||||
|
||||
1. **Feed 是否包含学习报告?** 本文档的取向是:Feed 只出知识碎片,报告以“会话完整结果”的形态从任务记录进入,不与碎片并列成条目,避免同一段内容以两种形态重复出现。
|
||||
2. **复习反馈动作的形态。** 可选:只读(现状)/加“已掌握 / 稍后再看”轻反馈并参与权重/只提供“稍后再看”而不提供“已掌握”。轻反馈是否会演变成清单,是本项的核心顾虑。
|
||||
3. **覆盖率口径。** 本文档暂按“最近一次回忆对比”计算;另一种做法是取最近若干次的加权结果,代价是变化被平滑、遗忘的征兆出现得更晚。
|
||||
4. **待归类内容的呈现方式。** 在复习总览中独立成一类“待归类”,还是在 Feed 中与其他内容混排并打标;以及归类动作是否必须在卡片上可完成。
|
||||
5. **遗漏项的语义。** 本文档按“每次对比的快照 + 可回看原文”设计,不做跨次累计的待处理集合。若改为累计,需要重新论证它不会变成待办清单。
|
||||
6. **排序信号是否可配置。** 掌握度与时间效应的强度是否像任务优先级权重那样对用户开放,还是固定为默认值。
|
||||
1. **Feed 不含学习报告。** Feed 只出知识碎片;报告以「一次会话的完整结果」的形态从任务记录进入,不与碎片并列成条目,避免同一段内容以两种形态重复出现。
|
||||
2. **反馈动作取「已掌握 + 稍后再看」两个轻量动作**,并让「上次复习时间」成为第三个权重信号。不统计「已掌握」的总数、不做待复习列表、不把动作结果展示成状态,以此避免演变成清单。
|
||||
3. **覆盖率取最近一次回忆对比。** 不做最近若干次的加权平均:加权会让变化被平滑、遗忘的征兆出现得更晚,而覆盖率是事实而非成绩,越直接越好。
|
||||
4. **待归类内容两处都要出现,归类留在 Feed 卡片上。** 复习总览里独立成一块(回答「还欠多少」),复习 Feed 里与其他内容混排并打标,且归类动作就在卡片上完成,一次交互可结。理由:复习的日常入口常常是 Feed 而不是总览,只放一处会漏;归类只是一次选择,留在这里不违背「Feed 不做整理」的口径。
|
||||
5. **遗漏项是每次对比的快照**,可回看原文,不做跨次累计的待处理集合。跨次累计会把它变成一份待办清单,与复习的立场冲突。
|
||||
6. **排序信号强度按三档预设对用户开放**:时间为主(默认)/均衡/掌握度为主。不给精确数值:现有排序是两个因子相乘而非加权求和,百分比是假精度,而三个档位已经覆盖真实意图。
|
||||
7. **详情页是残片的操作落点。** Feed 卡片只保留展开、导航与归类;打标签、反馈、学习引导改在残片详情页完成。Feed 负责「看到内容」,详情页负责「处理内容」,滚动列表不承担整理职责。
|
||||
8. **标签复习与任务复习并存。** 复习范围既可以是任务,也可以是标签集合;标签导图以规范化标签集合为键,多标签由用户选择并集或交集,素材变化只置待更新、重建由用户手动触发。
|
||||
|
||||
@@ -0,0 +1,29 @@
|
||||
# 文档范围与更新规则
|
||||
|
||||
- **功能**:界定 lpt-docs 收录什么、排除什么,并规定概念与设计文档的更新顺序。
|
||||
- **何时用**:新增或修改 lpt-docs 文档时;判断某类内容是否该写进本仓库时;概念变更后同步术语表与设计文档时。
|
||||
|
||||
## 职责
|
||||
|
||||
- 维护 LPT 系统的概念定义和设计思路。
|
||||
- 文档面向系统本身,而不是面向开发过程。
|
||||
|
||||
## 保留内容
|
||||
|
||||
- 系统概念:学习任务、学习会话、学习预期、知识碎片、学习报告、复习、思维导图、回忆对比等。
|
||||
- 设计思路:为什么采用某个概念、概念之间如何协作、模块边界在哪里。
|
||||
- 稳定的术语映射:例如“学习报告残片”与“知识碎片”的关系。
|
||||
- 所有文档放在 `docs/` 下,`concepts/` 放概念,`design/` 放设计思路。
|
||||
|
||||
## 禁止内容
|
||||
|
||||
- 开发笔记、日志、个人感想、时间线。
|
||||
- 系统中间态、废弃方案、历史迁移过程。
|
||||
- 文件路径、代码片段、接口清单、环境配置、构建与部署信息。
|
||||
- 性能指标、问题修复记录、交付记录。
|
||||
|
||||
## 更新流程
|
||||
|
||||
- 概念变更时先更新对应概念文档,再更新术语表和设计文档。
|
||||
- 新增概念时按现有模板补充“定义、设计意图、相关概念、当前系统体现”。
|
||||
- 修改后同步 meta 仓库 `docs/README.md` 的文档地图。
|
||||
Reference in New Issue
Block a user