Skip to content

Commit cdbfd3e

Browse files
committed
docs(product): v0.11.4 立项登记(内容分型+周契约+feed 消费闭环)
1 parent 290a085 commit cdbfd3e

2 files changed

Lines changed: 73 additions & 0 deletions

File tree

‎docs/product/requirements-pool.md‎

Lines changed: 13 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -309,10 +309,12 @@
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) |
312313

313314
> Phase 4(测量层:显影报告/盲测仪器/常模库)以 v0.11.2 碎片升级率数据为启用前置,**门控另议不预占版本号**(防测量层过度建设死法)。
314315
> 前置事项(Step 0):REQ-146 真机验收总清(待用户真机执行)+ 七轮安全加固代码批提交(✅ 2026-08-22 已提交 6 个原子 commit)。
315316
> 全系列代码交付见 [versions/v0.11.md](../versions/v0.11.md),真机验收待执行。
317+
> **v0.11.4 规划详见 [versions/v0.11.md 规划章节](../versions/v0.11.md)**(进入论证/接入方案/边界清单)。
316318
317319
#### v0.11.0 · 笔记组基建·容器侧
318320

@@ -323,6 +325,17 @@
323325
| REQ-197 | 容器侧组化:会话→笔记落库按 series_detect 自动归课程组(REQ-078 语义升级为容器组)+ 无系列会话按结构密度自成一组 + 组列表 UI(按钟分域:容器组在每日/会话面) | P0 | 已实施 | v0.11.0 | 接线优先于新建;存量资产重组;**代码已交付(2026-08-22,convert_to_note 接线 + 组侧栏)** |
324326
| REQ-198 | 路由决策可见可改:组卡片显示路由理由(命中信号明细)+ 一键改判(修改即记忆,v0.9.0 检测卡交互哲学延续) | P1 | 已实施 | v0.11.0 | 防路由误判埋没/空洞;改判样本反哺阈值校准;**代码已交付(2026-08-22,route_reason JSON + override_group_route)** |
325327

328+
#### v0.11.4 · 学习循环补齐 + feed 消费闭环(2026-08-22 用户裁决立项)
329+
330+
> 用户裁决:feed 进入范围为**最小消费闭环**(三根柱子与测量层维持 Phase 4 门控);
331+
> 内容分型 + 周契约 UI + feed 闭环合并为单版本。规划详见 [versions/v0.11.md](../versions/v0.11.md)。
332+
333+
| ID | 需求 | 优先级 | 状态 | 目标版本 | 备注 |
334+
|----|------|--------|------|---------|------|
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);零新界面;碎片→笔记升级不做(身份诚实);契约二兑现 |
338+
326339
### V1.0 · 体验增强(远期)
327340

328341
| ID | 需求 | 优先级 | 状态 | 目标版本 | 备注 |

‎docs/versions/v0.11.md‎

Lines changed: 60 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -18,6 +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 + 碎片卡徽标;开关默认关) |
2122

2223
## 关键决策与纪律
2324

@@ -57,3 +58,62 @@ settlements(id, group_id 级联, stats_json, created_at)
5758
- Phase 4 测量层(显影报告/盲测仪器/常模库):以 fragment_upgraded 积累的
5859
碎片升级率数据为启用前置,门控另议不预占版本号。
5960
- AI 闪卡生成(可选增强):复用 ai_client 授权/成本/审计全套,默认关,V1.0 评估。
61+
62+
---
63+
64+
# v0.11.4 规划:学习循环补齐 + feed 消费闭环(2026-08-22 用户裁决立项)
65+
66+
> 状态:已立项(规划中,代码未动)
67+
> 用户裁决(2026-08-22):① feed 进入范围为**最小消费闭环**(三根柱子与测量层维持
68+
> Phase 4 门控);② 内容分型 + 周契约 UI + feed 闭环**合并为单版本 v0.11.4**
69+
> 依据:pain-points v2 §8.1(内容分型 N13)· §8.2(弹性承诺 P31+N10 的呈现层)·
70+
> v4 §7.4 契约二(两种来源共享同一学习循环)· §11.3(feed 默认关)· 差距检查(2026-08-22)
71+
> 需求登记:[需求池 v0.11 区段 REQ-199~201](../product/requirements-pool.md)
72+
73+
## 一、范围(三块)
74+
75+
### 1. 内容分型(N13 续)—— action 卡最小版
76+
77+
- `flashcards.kind` 枚举扩展:fact / action(model 留接口不做)
78+
- 动作卡生成规则(纯函数,golden TDD):碎片文本含步骤语义信号
79+
("第一步/步骤/先…然后/做法"等)→ kind=action;front=动作名(首句),
80+
back=步骤清单(按句号/序号拆分);无步骤信号 → 维持 fact
81+
- **不做**:动手闭环 UI(N12 暂停-操作-比对,practice_detect 接线另议)
82+
83+
### 2. 周契约视图 UI(弹性承诺呈现层)
84+
85+
- `contracts` 表(幂等建表):group_id、week_start(周一零点)、target_days、
86+
target_cards、created_at——用户声明本周契约,非打卡 KPI
87+
- 命令:`upsert_week_contract`(幂等覆盖本周)/ `week_contract_status`
88+
(本周承诺 vs 实际——review_logs 按周聚合纯函数)
89+
- 组面板展开区"周契约"卡:本周目标设定 + 完成进度 + 断签不清零视觉 +
90+
**最小可行日徽标**(本周完成 3 卡即算成立,N9/N11 低谷生存的最轻形态)
91+
- 弹性承诺纪律不变:无 streak、无惩罚、欠账不追
92+
93+
### 3. feed 消费闭环(最小范围,用户裁决)
94+
95+
- **新增** `delete_fragment` 命令(后端,带存在性校验);`list_group_fragments` /
96+
`update_fragment_group`(已建未接)接线
97+
- 组面板 feed 组展开区:碎片列表(文本预览 + 图片缩略,图片 resolve 复用
98+
app_data_dir 先例)+ 删除/移出组操作 + **空态引导**("捕获几条试试")
99+
- 复习面/卡片列表"碎片卡"徽标(前端 Flashcard.fragmentId 已有)
100+
101+
## 二、进入论证摘要(feed 最小闭环)
102+
103+
- **半截体验**:原料层已建无消费面——捕获后看不见/删不掉/动不了
104+
- **边际成本低**:学习循环与结算按组实现且不区分地形——是接线不是新建
105+
- **门控死锁**:碎片升级率数据只有真实走通闭环才有——不接通则 Phase 4 永不解锁
106+
- **纪律保持**:开关默认关;零新界面(全部复用组面板/复习面/结算仪式);
107+
单句碎片不出卡已防御;碎片→笔记自动升级不做(身份诚实)
108+
109+
## 三、边界(不做清单)
110+
111+
碎片→笔记升级 · 三根柱子(显影/时机/容器层)· 测量层基座(技能地图/盲测/常模)·
112+
feed 专属界面 · 碎片卡 AI 生成 · 动手闭环 UI · 社交见证结构
113+
114+
## 四、测试与验收
115+
116+
- 纯函数:动作卡生成规则 golden / 周聚合纯函数(AAA)
117+
- 数据层:contracts CRUD / delete_fragment(内存库)
118+
- 命令:入参校验(id>0、target 有界、kind 白名单)
119+
- 端到端走查(REQ-146 批内):捕获→归组→生卡→复习→结算全链路

0 commit comments

Comments
 (0)