|
18 | 18 | | v0.11.1 | feed 进料口(功能开关默认关) | fragments 独立原料层(碎片不是笔记,身份诚实);feature_flags 开关机制(feed_capture 默认关,后端二次校验);碎片快速捕获(文本 + 剪贴板图片,解码验证落盘);DomainTag 自动归 feed 主题组;设置页开关 + 组侧栏捕获区 | |
19 | 19 | | 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 读数 | |
20 | 20 | | v0.11.3 | 组结算机制(防沼泽仪式) | settlement 双触发判据(≥50 条阈值 / ≥20 条且 ≥90 天周期);重复合并判据(字符 bigram 包含度 ≥0.7,贪心一对一,保留长文本);结算仪式(计划呈现→用户确认→执行:合并/归档/核心提炼笔记);settlements 留痕 + group_settled 埋点;归档不删除可恢复 | |
| 21 | +| **v0.11.4**(规划中) | 学习循环补齐 + feed 消费闭环 | 内容分型(N13 续:action 卡最小版)+ 周契约视图 UI(弹性承诺呈现层)+ feed 最小消费闭环(碎片生命周期 UI + 碎片卡徽标;开关默认关) | |
21 | 22 |
|
22 | 23 | ## 关键决策与纪律 |
23 | 24 |
|
@@ -57,3 +58,62 @@ settlements(id, group_id 级联, stats_json, created_at) |
57 | 58 | - Phase 4 测量层(显影报告/盲测仪器/常模库):以 fragment_upgraded 积累的 |
58 | 59 | 碎片升级率数据为启用前置,门控另议不预占版本号。 |
59 | 60 | - 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