Skip to content

Commit 586d77e

Browse files
committed
docs(versions): v0.20 支线补录——场景走查 G1-G7 裁决与数据模型草稿
1 parent 9db87d2 commit 586d77e

1 file changed

Lines changed: 40 additions & 1 deletion

File tree

‎docs/versions/v0.20.md‎

Lines changed: 40 additions & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -56,7 +56,7 @@
5656
|---|---|---|
5757
| 1 | 功能区架构 | 待办 / SOP **两区分设,共用行动底座**(任务索引+回写原子层+完成史) |
5858
| 2 | 待办形态 | **裁决漏斗**替代清单墙:捕捉 → 聚合(计划日/逾期标红/搁置,不造伪死线)→ 周回顾裁决队列(执行/改期/转闪卡/迁出/有意识放弃留因)→ 完成史 |
59-
| 3 | Act 归宿 | 判定树两问:驱动"习得"?在熵减上下文内执行?——双"是"→**内建**(练习条目/SOP run);否则→**迁出**(内容上下文随迁出文本携带) |
59+
| 3 | Act 归宿 | 判定树两问:驱动"习得"?在熵减上下文内执行?——双"是"→**内建**(练习条目 / SOP run / **学习行动**[找料/剪藏等 app 内执行的习得服务动作,G1 补录]);否则→**迁出**(内容上下文随迁出文本携带) |
6060
| 4 | 迁出回执 | **策略 A:放手+手动回填**——迁出只记事件(快照+链接+时间),外部完成与否由外部系统记;周回顾可手动回填"已完成"入史;**不做 API 轮询回调**(入站依赖/违背本地优先) |
6161
| 5 | SOP 模板 | **用户自定义是一等约束**:三源创建(课堂素材半自动草稿 / 框选任意段生成 / 从零手写)→ 机器只产草稿,人永远是作者;步骤增删排序、要素(预期结果/参数/暂停点)、双模式标注均可编辑 |
6262
| 6 | SOP 执行 | **双模式执行器**(READ-DO 单步引导 / DO-CONFIRM 总览核对)+ 暂停点 + 每步预期结果(可观测信号)+ 证据自评(关键步骤数值/照片/输出必填)+ 轻分支(失败点→跳过/降级/重试) |
@@ -88,3 +88,42 @@
8888
3. 循环执行(`.+` / `++` / `+` 三型)P2,作任务配置字段不作文法
8989
4. REQ 编号登记(需求池)与核心处理/闪卡轮次的衔接裁决
9090
5. run 完成后可选写一行 meta 到正文末尾(默认关)
91+
92+
## 场景走查补录(2026-09-05 · G1-G7 裁决)
93+
94+
> 方法:以「眼影晕染进阶」技能场景全流程走查(捕捉→裁决→执行→复盘)反推缺口,逐项裁决定案。
95+
96+
| # | 缺口 | 裁决 |
97+
|---|---|---|
98+
| G1 | 素材获取类 Act("找 2 篇文剪藏")无处可归 | 判定树确认内建第三类**学习行动**(app 内执行、服务于习得);决策记录 #3 已修订 |
99+
| G2 | 练习需要周期 | 练习条目带周期字段:v1 `daily\|manual`;`.+`/`++`/`+` 三型循环 P2 统一(配置字段不作文法);缺勤宽容只记史 |
100+
| G3 | 证据从哪来 | run_steps.evidence 复用图片三入口(剪贴板/文件/外链)+ `notes-images/` + import_note_image,存相对路径 |
101+
| G4 | 修订建议 | v1 纯本地聚合提示("步骤 N 累计失败 M 次");AI 拟稿后置(AiSettings 闸门 + 精修协议,默认关) |
102+
| G5 | 迁出后正文行处置 | 标 [x] + 迁出事件入史(通道/链接入 meta);完成时间戳只落史不落正文 |
103+
| G6 | SOP 模板形态 | 模板=段落行范围引用(note_id+start/end line),编辑段落即编辑模板无双写;run 快照与当前段 diff 驱动"执行即保鲜" |
104+
| G7 | "转闪卡"裁决 | 周回顾队列预留"转卡"出口动作,本体接闪卡引擎接口(本规划不实现) |
105+
106+
## 数据模型草稿(v1 · 六张新表 + 复用链,2026-09-05)
107+
108+
**① `task_index`**——正文任务行增量索引(真相仍在 md 行;只作聚合查询缓存,无回写职责)
109+
`id / note_id FK / line_no / task_text(快照去前缀) / status todo|done / disposition generic|learning|practice|sop|export / plan_date NULL / created_at / updated_at · UNIQUE(note_id,line_no)`
110+
维护:note 保存钩子(versioned_save 路径)重扫重建索引——行号漂移由"重扫式刷新"吸收;勾选仍走既有字符级回写(NoteMarkdown 先例)。
111+
112+
**② `practice_items`**——练习条目(内建①类)
113+
`id / note_id NULL / kb_concept_id NULL / text / frequency daily|manual / goal NULL / mastery NULL(1-5) / next_due NULL / status active|paused|archived / created_at / updated_at`
114+
打点 = completion_history 事件(practice_tick);练习曲线由史聚合,不另建 tick 表(YAGNI)。
115+
116+
**③ `sop_templates`**——SOP 模板 = 段落行范围引用
117+
`id / note_id / name / start_line / end_line / mode readdo|confirm / created_at / updated_at`
118+
无双写:编辑段落=编辑模板;**版本化=复用 notes 既有 versioned_save 版本链**(不建模板独立版本表)。
119+
120+
**④ `sop_runs` + ⑤ `sop_run_steps`**——执行档案
121+
`sop_runs: id / template_id FK / note_id / mode / status active|done|aborted / started_at / finished_at`
122+
`sop_run_steps: id / run_id FK / step_no / text_snapshot / status todo|done|skipped|failed / evidence_path NULL / failure_note NULL / checked_at NULL`
123+
124+
**⑥ `completion_history`**——完成史(统一证据,唯一数据源)
125+
`id / ts / event_type done|abandoned|exported|export_manual_done|practice_tick|sop_run / source_type task_line|practice_item|sop_run|learning_action|export / source_id NULL / note_id NULL / text(快照) / note NULL(放弃原因等) / meta JSON NULL(迁出通道/链接等)`
126+
127+
**复用链**:SOP 版本化→notes 版本链;证据图→图片三入口+`notes-images/`;AI 拟稿→AiSettings+精修协议(后置);REST 凭据→ADR-016 keyring(后置);迁移→既有迁移机制。
128+
129+
**命令面落位(占位)**:`commands_tasks.rs`(索引/裁决)· `commands_sop.rs`(模板/run)· `commands_history.rs`(史/回填)。

0 commit comments

Comments
 (0)