Skip to content

Commit 1403368

Browse files
committed
docs: v0.11.4 交付记录与需求池状态同步(REQ-199~201)
1 parent aa341c4 commit 1403368

5 files changed

Lines changed: 34 additions & 10 deletions

File tree

‎CHANGELOG.md‎

Lines changed: 9 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -5,6 +5,15 @@
55

66
## [Unreleased] - 2026-08-21
77

8+
### v0.11 大目标系列:笔记组与学习循环(2026-08-22 全系列交付,详见 [docs/versions/v0.11.md](docs/versions/v0.11.md))
9+
10+
- **v0.11.0 笔记组基建·容器侧(REQ-195~198)**:note_groups 表(terrain container/feed + kind course/topic/standalone + domain_tag + series_key 唯一)+ notes.group_id 幂等迁移;group_route 结构密度路由纯函数(加权投票三态 + 7 个 golden 用例);容器侧组化接线(会话→笔记自动归课程组/主题组/独立组);组侧栏 UI(路由理由可见/一键改判/笔记移动)
11+
- **v0.11.1 feed 进料口(功能开关默认关)**:fragments 独立原料层(碎片不是笔记);feature_flags 开关机制(feed_capture 默认关 + 后端二次校验);碎片快速捕获(文本 + 剪贴板图片 base64,解码验证落盘);DomainTag 自动归 feed 主题组;设置页开关 + 组侧栏捕获区
12+
- **v0.11.2 学习循环统一(REQ-199 前置基建)**:FSRS-6 调度器(fsrs crate,ADR-018;无 streak 弹性承诺);flashcards/review_logs/metrics_events 三表;组→闪卡本地规则生成(词汇表术语卡 + 碎片多句卡,幂等查重);复习面最小化 UI(front→回忆→back→四档评分);北极星/过程指标埋点 + learning_metrics 读数
13+
- **v0.11.3 组结算机制(防沼泽仪式)**:settlement 双触发判据(≥50 条阈值 / ≥20 条且 ≥90 天周期);重复合并判据(bigram 包含度 ≥0.7 贪心一对一);结算仪式(计划呈现→确认→执行)+ settlements 留痕 + group_settled 埋点;归档不删除可恢复
14+
- **v0.11.4 学习循环补齐 + feed 消费闭环(REQ-199~201)**:内容分型 action 卡最小版(步骤信号→kind=action,front=动作名 back=步骤清单,golden TDD);周契约视图 UI(contracts 表 + upsert_week_contract 幂等 + week_contract_status 周聚合纯函数 + 周契约卡:目标设定/进度/断签不清零视觉/最小可行日徽标);feed 消费闭环(delete_fragment/update_fragment_group/resolve_fragment_image 三命令 + feed 组碎片列表(文本+图片缩略+删除/移出+空态引导)+ 复习面碎片卡/动作卡徽标)
15+
- 验收:card_generate 22 测 + week_contract 16 测独立验证通过;cargo build + clippy 零错误;前端 tsc + vite + vitest 35 通过;**环境备注**:cargo test 运行受阻(test harness 0xc0000139,2026-08-12 Windows 更新引入的加载期兼容问题,与本版代码无关,纯函数已独立编译验证)
16+
817
### 视频档案框架 v2 四维解耦(任务 5:v0.9.0 M1~M5 代码建设,2026-08-21)
918

1019
- **四维解耦数据模型(REQ-188)**:新增 `video_profile_spec.rs` + `video_profile_spec_data.rs`——形态 7 类(讲授/实操/解说/对话/题目/代码/音频)× 画面档 4 档(高/中/低/无)× 领域 × 语言 四维解耦;13→7 映射(whiteboard→讲授=高、podcast/live→音频=无档);参数矩阵(形态→产物模板+后处理、画面档→采样/OCR/存储);记忆库 kind 映射迁移(MemoryEntry.form 字段 + remember_form/lookup_form,旧 JSON 零回归);新 command(video_profile_for_spec / video_profile_spec_by_kind / remember_video_profile_form)

‎docs/product/requirements-pool.md‎

Lines changed: 4 additions & 4 deletions
Original file line numberDiff line numberDiff line change
@@ -309,7 +309,7 @@
309309
| **v0.11.1** | Phase 1 后半(Step 3) | feed 进料口:碎片快速捕获 + fragments 原料层 + DomainTag 归组;功能开关默认关 | **已交付**(2026-08-22) |
310310
| **v0.11.2** | Phase 2(Step 4+5) | 学习循环统一:FSRS 间隔重复引擎(SM-2 降级;提取优先 + 弹性承诺)+ 组级复习/自测 UI(最小化)+ 北极星/过程指标埋点 | **已交付**(2026-08-22,fsrs crate 引入成功,ADR-018) |
311311
| **v0.11.3** | Phase 3(Step 6) | 组结算机制:阈值/周期触发 + 核心提炼 + 重复合并 + 低价值归档(防沼泽仪式) | **已交付**(2026-08-22) |
312-
| **v0.11.4** | 学习循环补齐 + feed 消费闭环 | 内容分型(N13 续:action 卡最小版)+ 周契约视图 UI(弹性承诺呈现层)+ feed 最小消费闭环(碎片生命周期 UI + 碎片卡徽标;开关默认关) | **已立项**(2026-08-22 用户裁决:feed 最小闭环入版、三块合并单版本;REQ-199~201) |
312+
| **v0.11.4** | 学习循环补齐 + feed 消费闭环 | 内容分型(N13 续:action 卡最小版)+ 周契约视图 UI(弹性承诺呈现层)+ feed 最小消费闭环(碎片生命周期 UI + 碎片卡徽标;开关默认关) | **已交付**(2026-08-22,REQ-199~201 实施) |
313313

314314
> Phase 4(测量层:显影报告/盲测仪器/常模库)以 v0.11.2 碎片升级率数据为启用前置,**门控另议不预占版本号**(防测量层过度建设死法)。
315315
> 前置事项(Step 0):REQ-146 真机验收总清(待用户真机执行)+ 七轮安全加固代码批提交(✅ 2026-08-22 已提交 6 个原子 commit)。
@@ -332,9 +332,9 @@
332332
333333
| ID | 需求 | 优先级 | 状态 | 目标版本 | 备注 |
334334
|----|------|--------|------|---------|------|
335-
| REQ-199 | 内容分型动作卡(N13 续):flashcards.kind 扩展 fact/action(model 留接口);动作卡生成规则纯函数(碎片含步骤语义信号→action 卡,front=动作名 back=步骤清单;无信号维持 fact);golden TDD | P1 | 待评估 | v0.11.4 | v2 §8.1 内容分型最小版;不做动手闭环 UI(N12 另议) |
336-
| REQ-200 | 周契约视图 UI(弹性承诺呈现层 P31+N10):contracts 表(group_id/week_start/target_days/target_cards)+ upsert_week_contract 幂等 + week_contract_status(review_logs 周聚合纯函数);组面板周契约卡(目标设定/完成进度/断签不清零视觉/最小可行日徽标) | P1 | 待评估 | v0.11.4 | 弹性承诺纪律不变:无 streak、无惩罚、欠账不追 |
337-
| REQ-201 | feed 消费闭环(最小范围):delete_fragment 命令 + list_group_fragments/update_fragment_group 接线;feed 组展开区碎片列表(文本+图片缩略,resolve 复用 app_data_dir)+ 删除/移出 + 空态引导;复习面"碎片卡"徽标(fragmentId) | P1 | 待评估 | v0.11.4 | 开关默认关(v4 §11.3);零新界面;碎片→笔记升级不做(身份诚实);契约二兑现 |
335+
| REQ-199 | 内容分型动作卡(N13 续):flashcards.kind 扩展 fact/action(model 留接口);动作卡生成规则纯函数(碎片含步骤语义信号→action 卡,front=动作名 back=步骤清单;无信号维持 fact);golden TDD | P1 | 已实施 | v0.11.4 | v2 §8.1 内容分型最小版;不做动手闭环 UI(N12 另议);**代码已交付(2026-08-22,card_generate 分型规则 + 5 个 golden 用例,22 测通过)** |
336+
| REQ-200 | 周契约视图 UI(弹性承诺呈现层 P31+N10):contracts 表(group_id/week_start/target_days/target_cards)+ upsert_week_contract 幂等 + week_contract_status(review_logs 周聚合纯函数);组面板周契约卡(目标设定/完成进度/断签不清零视觉/最小可行日徽标) | P1 | 已实施 | v0.11.4 | 弹性承诺纪律不变:无 streak、无惩罚、欠账不追;**代码已交付(2026-08-22,week_contract 纯函数 16 测通过 + contracts 表 + 周契约卡)** |
337+
| REQ-201 | feed 消费闭环(最小范围):delete_fragment 命令 + list_group_fragments/update_fragment_group 接线;feed 组展开区碎片列表(文本+图片缩略,resolve 复用 app_data_dir)+ 删除/移出 + 空态引导;复习面"碎片卡"徽标(fragmentId) | P1 | 已实施 | v0.11.4 | 开关默认关(v4 §11.3);零新界面;碎片→笔记升级不做(身份诚实);契约二兑现;**代码已交付(2026-08-22,delete/移组/图片 resolve 三命令 + feed 碎片列表 + 复习面徽标)** |
338338

339339
### V1.0 · 体验增强(远期)
340340

‎docs/standards/line-limit-exemptions.md‎

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -65,7 +65,7 @@
6565
| app/src/components/SessionDetailPanel.tsx | 371 | 会话详情面板:质量报告/段列表/OCR 概览/操作区单一面板完整交互流内聚(前端审查登记) | 若再增长:质量报告区拆至 SessionQualityReport.tsx |
6666
| app/src/components/ProfileDetector.tsx | 346 | 档案检测组件:投票/确认流/记忆偏好 UI 内聚(前端审查登记) | 若再增长:确认流拆至 ProfileConfirmFlow.tsx |
6767
| app/src/components/NoteEditView.tsx | 315 | 笔记编辑视图:编辑态/标签/结构面板内聚(前端审查登记) | 若再增长:结构面板拆至 NoteStructurePane.tsx |
68-
| app/src/components/NoteGroupPanel.tsx | 371 | v0.11.0~3 笔记组侧栏:组列表/路由可见可改/碎片捕获/闪卡生成与复习入口/结算仪式——组域交互单一面板内聚 | 若再增长:结算仪式区拆至 GroupSettlementPane.tsx |
68+
| app/src/components/NoteGroupPanel.tsx | 391 | v0.11.0~4 笔记组侧栏:组列表/路由可见可改/碎片捕获/闪卡生成与复习入口/结算仪式/周契约卡/feed 碎片列表(周契约与碎片列表已拆独立组件 WeekContractCard/FeedFragmentList)——组域交互单一面板内聚 | 若再增长:结算仪式区拆至 GroupSettlementPane.tsx |
6969

7070
> 前端 **拆分中**(Task #9 笔记域修复进行中,暂不登记行数):`app/src/types.ts`、`app/src/pages/NotesPage.tsx`——待前端拆分完成后以实测行数重新评估。
7171
> 前端 SessionsPage.tsx 审查快照 304 行(登记值),v0.7.1 硬拆后长期 ≤300,本轮审查期间轻微越线;随 NotesPage/types.ts 拆分任务一并复核,若仍越线按上表模式登记。

‎docs/versions/README.md‎

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -25,7 +25,7 @@
2525
| v0.10.0 | [v0.10.0.md](./v0.10.0.md) — 第十阶段:笔记能力建设(单笔记)——「活沉淀」定位:渲染/编辑/版本/时间戳回链/标签(2026-08-21 头脑风暴定稿,含市场优点融合+舍弃清单) | 发版文档(已实施 2026-08-21,真机验收待执行) |
2626
| v0.10.1 | [v0.10.1.md](./v0.10.1.md) — 笔记编辑机制修复 + 笔记图片功能(串写修复/版本去重/resolve_note_image 三命令 + NoteImage) | 发版文档(已实施 2026-08-21) |
2727
| v0.10.2 | [v0.10.2.md](./v0.10.2.md) — 结构图准确性重构:参考图集单一分析 + 三层过滤(L0 字幕重叠 / L1 版面类型 / L2 OCR 置信度反向 / L3 位置约束) | 发版文档(规划定稿 2026-08-21) |
28-
| v0.11 | [v0.11.md](./v0.11.md) — 大目标版本系列:笔记组与学习循环(v0.11.0 组基建容器侧 / v0.11.1 feed 进料 / v0.11.2 FSRS 学习循环 / v0.11.3 组结算,v4 Phase 1-3 落地) | 系列文档(代码已交付 2026-08-22,真机验收待执行) |
28+
| v0.11 | [v0.11.md](./v0.11.md) — 大目标版本系列:笔记组与学习循环(v0.11.0 组基建容器侧 / v0.11.1 feed 进料 / v0.11.2 FSRS 学习循环 / v0.11.3 组结算 / v0.11.4 内容分型+周契约+feed 消费闭环,v4 Phase 1-3 落地) | 系列文档(代码已交付 2026-08-22,真机验收待执行) |
2929

3030
## 沉淀规则
3131

‎docs/versions/v0.11.md‎

Lines changed: 19 additions & 4 deletions
Original file line numberDiff line numberDiff line change
@@ -1,9 +1,9 @@
11
# v0.11 大目标版本系列:笔记组与学习循环(v4 路线图 Phase 1-3 落地)
22

3-
> 状态:代码已交付(2026-08-22),真机验收待执行
3+
> 状态:代码已交付(2026-08-22,含 v0.11.4),真机验收待执行
44
> 依据:[v4 路线图建设顺序规划](../Foresight/v4-roadmap-build-order-analysis.md)(已裁决采纳)·
55
> [pain-points-v4](../product/pain-points-v4.md) §7.4/§7.5/§11 ·
6-
> [需求池 v0.11 区段](../product/requirements-pool.md)(REQ-195~198)
6+
> [需求池 v0.11 区段](../product/requirements-pool.md)(REQ-195~201)
77
> 设计文档:[specs/2026-08-22-v0.11-note-group-learning-loop-design.md](../superpowers/specs/2026-08-22-v0.11-note-group-learning-loop-design.md)
88
99
## 一句话
@@ -18,7 +18,7 @@
1818
| v0.11.1 | feed 进料口(功能开关默认关) | fragments 独立原料层(碎片不是笔记,身份诚实);feature_flags 开关机制(feed_capture 默认关,后端二次校验);碎片快速捕获(文本 + 剪贴板图片,解码验证落盘);DomainTag 自动归 feed 主题组;设置页开关 + 组侧栏捕获区 |
1919
| v0.11.2 | 学习循环统一(最大新建块) | FSRS-6 调度器(fsrs crate,ADR-018;目标留存率 0.9);flashcards/review_logs/metrics_events 三表;组→闪卡本地规则生成(词汇表块术语卡 + 碎片多句卡,幂等查重);复习面最小化 UI(front→回忆→back→四档评分,提取优先,无 streak);北极星/过程指标埋点(card_reviewed/fragment_upgraded)+ learning_metrics 读数 |
2020
| v0.11.3 | 组结算机制(防沼泽仪式) | settlement 双触发判据(≥50 条阈值 / ≥20 条且 ≥90 天周期);重复合并判据(字符 bigram 包含度 ≥0.7,贪心一对一,保留长文本);结算仪式(计划呈现→用户确认→执行:合并/归档/核心提炼笔记);settlements 留痕 + group_settled 埋点;归档不删除可恢复 |
21-
| **v0.11.4**(规划中) | 学习循环补齐 + feed 消费闭环 | 内容分型(N13 续:action 卡最小版)+ 周契约视图 UI(弹性承诺呈现层)+ feed 最小消费闭环(碎片生命周期 UI + 碎片卡徽标;开关默认关) |
21+
| **v0.11.4**(已交付 2026-08-22) | 学习循环补齐 + feed 消费闭环 | 内容分型(N13 续:action 卡最小版,REQ-199)+ 周契约视图 UI(弹性承诺呈现层,REQ-200)+ feed 最小消费闭环(碎片生命周期 UI + 碎片卡徽标;开关默认关,REQ-201) |
2222

2323
## 关键决策与纪律
2424

@@ -63,12 +63,15 @@ settlements(id, group_id 级联, stats_json, created_at)
6363

6464
# v0.11.4 规划:学习循环补齐 + feed 消费闭环(2026-08-22 用户裁决立项)
6565

66-
> 状态:已立项(规划中,代码未动)
66+
> 状态:**代码已交付(2026-08-22),真机验收待执行**
6767
> 用户裁决(2026-08-22):① feed 进入范围为**最小消费闭环**(三根柱子与测量层维持
6868
> Phase 4 门控);② 内容分型 + 周契约 UI + feed 闭环**合并为单版本 v0.11.4**
6969
> 依据:pain-points v2 §8.1(内容分型 N13)· §8.2(弹性承诺 P31+N10 的呈现层)·
7070
> v4 §7.4 契约二(两种来源共享同一学习循环)· §11.3(feed 默认关)· 差距检查(2026-08-22)
7171
> 需求登记:[需求池 v0.11 区段 REQ-199~201](../product/requirements-pool.md)
72+
> 交付实现摘要:card_generate 步骤信号分型(golden 5 例)/ week_contract 周聚合纯函数
73+
> (16 测)/ contracts 表 + upsert/status 命令 / delete_fragment + update_fragment_group +
74+
> resolve_fragment_image 三命令(开关准入)/ WeekContractCard + FeedFragmentList + 复习面徽标
7275
7376
## 一、范围(三块)
7477

@@ -117,3 +120,15 @@ feed 专属界面 · 碎片卡 AI 生成 · 动手闭环 UI · 社交见证结
117120
- 数据层:contracts CRUD / delete_fragment(内存库)
118121
- 命令:入参校验(id>0、target 有界、kind 白名单)
119122
- 端到端走查(REQ-146 批内):捕获→归组→生卡→复习→结算全链路
123+
124+
### 交付验证记录(2026-08-22)
125+
126+
- card_generate 22 测通过(含 action 分型 golden 5 例:步骤元词/先然后成对/单然后不误判/
127+
单句含信号不出卡);week_contract 16 测通过(周一零点边界/跨年/聚合去重/最小可行日阈值)
128+
- cargo build + clippy --all-targets 零错误;前端 tsc + vite 构建通过、vitest 35 通过
129+
- **环境备注**:`cargo test` 运行受阻(test harness exe 启动报 0xc0000139
130+
STATUS_ENTRYPOINT_NOT_FOUND,旧 test exe 同样失败——2026-08-12 Windows 更新后
131+
System32 出现内置 onnxruntime 1.17 的加载期兼容问题,与本版本代码无关);
132+
纯函数层已用 rustc 独立编译验证全量通过,数据层/命令层测试编译通过待环境修复后补跑
133+
- 真机验收待执行(feed 开关开启 → 捕获 → 归组 → 生卡(含动作卡)→ 复习(碎片卡/动作卡
134+
徽标)→ 周契约设定/进度 → 碎片删除/移出 → 结算全链路走查)

0 commit comments

Comments
 (0)