Skip to content

Commit 4420bbe

Browse files
committed
docs(versions): v0.20 支线补录——交互层与命令面草稿
1 parent 586d77e commit 4420bbe

1 file changed

Lines changed: 60 additions & 0 deletions

File tree

‎docs/versions/v0.20.md‎

Lines changed: 60 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -127,3 +127,63 @@
127127
**复用链**:SOP 版本化→notes 版本链;证据图→图片三入口+`notes-images/`;AI 拟稿→AiSettings+精修协议(后置);REST 凭据→ADR-016 keyring(后置);迁移→既有迁移机制。
128128

129129
**命令面落位(占位)**:`commands_tasks.rs`(索引/裁决)· `commands_sop.rs`(模板/run)· `commands_history.rs`(史/回填)。
130+
131+
## 交互层草稿(2026-09-05 · 三块新 UI + 触点改造,全锚定既有组件)
132+
133+
### ①「✅ 行动中心」(待办裁决 + SOP 库 + 完成史)
134+
- 入口:笔记页组侧栏顶行,与 `🎴 复习 N` 并列 `✅ 行动 N`(N=逾期+到期徽标,复用 GroupSidebar 全量入口模式;行动跨组聚合故入口在组侧栏)
135+
- 形态:全屏 Overlay(锚定 ReviewSessionOverlay「复习面 UI 最小化」先例)三页签:
136+
- **裁决队列**:逾期·标红 / 计划日 / 搁置 / 待提炼(产物 ☑️ 行)——每条行操作:✓完成 · 📅改期 · 🎴转卡 · ⤴迁出(通道菜单) · ✗放弃(留一行原因)
137+
- **SOP 库**:模板 + 最近 run + 失败频次徽标
138+
- **完成史**:周视图条(周回顾裁决仪式);同时喂 GoalsPage 既有回顾流时间线(不建第二通道)
139+
- 周回顾裁决队列 = 行动中心仪式视图——"裁决机制而非自动清理"
140+
141+
### ② SOP 执行模式(Overlay 双态)
142+
- 入口:笔记阅读态步骤段落 / 模板库行 →「▶ 执行」(建 run 后全屏执行 Overlay,ReviewSessionOverlay 样式)
143+
- 单步卡:做法 + **预期结果** + 证据上传(关键步骤必填)+ ✓完成 / ✗失败+原因 / ⏭跳过;顶部 `[逐步引导|总览核对]` 切换(READ-DO/CONFIRM);暂停点提示条;上次失败步骤 ⚠ 徽标(复跑对比)
144+
- 单步引导交互锚定 InterviewDialog(目标访谈四步向导先例)
145+
- 结束 → 结算页:轨迹 / 失败点 / 保鲜 diff("笔记有出入?")/ 归档入史
146+
147+
### ③ 捕捉与提炼触点(零新入口哲学)
148+
- 捕捉零成本:编辑器写 `- [ ]` 即被 task_index 自动收录,不新增捕捉 UI
149+
- 产物 ☑️ 行 → 行动中心「待提炼」页签一键「提炼为任务行」(转标准 `- [ ]` 插回笔记)
150+
- SOP 模板生成:编辑态选中步骤段落 → 工具栏「生成 SOP」(写行范围引用,不复制正文——G6)
151+
- 🎴 转卡动作:先置灰提示规划中(G7 预留)
152+
153+
### 明确不做(交互层 YAGNI)
154+
全局热键/浮动待办条(浮窗技术底座留给采集不扩权)· 日历视图/四象限/看板 · 完成史图表库依赖(轻量自绘,复用知识画布自绘先例)
155+
156+
## 命令面草稿(2026-09-05 · 三模块 + 共享原子层)
157+
158+
### 共享回写原子层(纯逻辑先行)
159+
`parse_task_line(text) -> {is_task, status, payload}`(认 `- [ ]`/`- [x]`/`- ☑️ 待办`)· `migrate_status(line, to) -> line`(字符级,NoteMarkdown 同源逻辑提纯)· `replace_line(body, line_no, new_text) -> body`
160+
前端编辑器勾选 / 行动中心操作 / 未来通知全入口收敛于此;全部配单测。
161+
162+
### `commands_tasks.rs`
163+
| 命令 | 要点 |
164+
|---|---|
165+
| `list_action_queue` | filter{scope, tab: overdue\|planned\|someday\|unrefined};task_index JOIN notes |
166+
| `set_task_plan_date` | 只落索引列不进正文(计划日是元数据) |
167+
| `resolve_task` | done→[x];abandon→[x]+史留 reason;to_card / export(channel) 出口 |
168+
| `export_tasks` / `list_export_channels` | clipboard_todotxt \| file_todotxt \| scheme_todoist \| scheme_ticktick(先探测注册) |
169+
| `manual_fill_export_done` | 周回顾手动回填 → export_manual_done |
170+
| `set_task_disposition` | learning\|practice\|sop\|export 纠偏 |
171+
172+
### `commands_sop.rs`
173+
| 命令 | 要点 |
174+
|---|---|
175+
| `create_sop_template` | 校验范围在正文内、≤50 步 |
176+
| `list_sop_templates` / `delete_sop_template` | 删除不动正文(只删引用) |
177+
| `start_sop_run` | **启动时校验段漂移**(当前段 vs 上次快照不符 → stale 提示) |
178+
| `run_step_update` | done\|skipped\|failed + evidence_path(白名单 `notes-images/`)+ failure_note |
179+
| `finish_sop_run` | 结算统计 + 保鲜 diff + 写 completion_history(sop_run) |
180+
| `list_sop_runs` / `get_sop_run` | 轨迹回看 |
181+
| `suggest_sop_revisions` | v1 纯本地聚合(步骤 N 失败 M 次);AI 拟稿后置 |
182+
183+
### `commands_history.rs`
184+
`list_completion_history`(week/source_type/scope 过滤——同时喂回顾流)· `batch_weekly_resolve`(单事务周回顾批提交)
185+
186+
### 横切
187+
- 事件:`data:tasks` / `data:sop` 并入 v0.19.4 通用变更事件总线(行动中心徽标订阅刷新)
188+
- 校验:入参白名单/长度/一致性;属主校验(既有 IPC 红线)
189+
- capabilities 增补新命令域;前端钩子 `useActionQueue` / `useSopRuns` / `useCompletionHistory`

0 commit comments

Comments
 (0)