Skip to content

Commit 6db80a7

Browse files
committed
docs(goal): v0.18.2 版本文档(AI 规划师 M1 批已实施)+ 版本索引更新
1 parent e489137 commit 6db80a7

2 files changed

Lines changed: 42 additions & 0 deletions

File tree

‎docs/versions/README.md‎

Lines changed: 1 addition & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -48,6 +48,7 @@
4848
| v0.17.1 | [v0.17.1.md](./v0.17.1.md) — bug 修复:知识补充轨迹 NULL 列崩溃(get_ai_task_trajectory Option 化)+ 笔记级精修卡住(NoteAiDialog hook taskIdRef 接线 + 结果取回防御) | 版本文档(代码已交付 2026-09-01) |
4949
| v0.18.0 | [v0.18.0.md](./v0.18.0.md) — 学习目标层 M1:目标对象 + 访谈式设定(四步+宣言+里程碑草案)+ 跨组聚合看板(REQ-030 激活/REQ-248~250,ADR-027;M1 代码已交付 2026-09-02,真机验收待执行) | 版本文档(M1 已实施) |
5050
| v0.18.1 | [v0.18.1.md](./v0.18.1.md) — 学习目标层 M2:毕业仪式 + 回顾流时间线 + 暂停/放弃 + 组删除降级提示(REQ-255~257;报告快照目标删除后仍可读) | 版本文档(M2 已实施 2026-09-02,真机验收待执行) |
51+
| v0.18.2 | [v0.18.2.md](./v0.18.2.md) — AI 目标规划师:规划建议+体系深度联动(建议制·默认关;协议/预算/摘要/弱项/双入口确认流已交付——REQ-251~254,ADR-028) | 版本文档(M1 批已实施 2026-09-02,设置段/`/goal` 下批) |
5152

5253
## 沉淀规则
5354

‎docs/versions/v0.18.2.md‎

Lines changed: 41 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,41 @@
1+
# v0.18.2:AI 目标规划师——规划建议 + 体系深度联动(建议制 · 默认关)
2+
3+
> 状态:**M1 批已实施**(2026-09-02;真机验收待执行)
4+
> 依据:用户 2026-09-02 重裁决(双入口/建议制确认落库/联动四项全选/AI 提供初步体系/默认关+授权确认)· [设计规格(已批准)](../superpowers/specs/2026-09-02-v0.18.2-ai-goal-planning-design.md) · [ADR-028](../adr/ADR-028-ai-goal-planner.md) · REQ-251~254
5+
6+
## 一句话
7+
8+
AI 结果=**草案蓝图**(里程碑/组/体系/周契约),人类逐项确认后落库;AI 默认关(content_gate + 目标 AI 独立开关双闸门);AI 失败/超限/未开启 → M1 规则草案永远可用(目标规划永不依赖 AI)。
9+
10+
## 本批已交付
11+
12+
| 层 | 内容 |
13+
|---|---|
14+
| 纯函数 | goal_plan_protocol(Proposal 强校验 golden:白名单/体系门槛/超限丢弃登记)· budget_allocator(4K/10K/30K 档位,O(1) 恒量截断+诚实信号)· goal_summary(L4.5 现算 <1K)· concept_weakness(90 天低激活)· goal_plan_prompt(prompts/goal_plan.json 声明式+兜底) |
15+
| 数据层 | knowledge_links 白名单 +'goal'(零迁移)· link_goal_to_system(幂等查重先行)· goal_concept_activities(应用记录 Rust 解析防坏 JSON 中断)· goal_plan_context(库即记忆最小面)· apply_plan_core(替换/增量双语义事务,周契约落主组) |
16+
| AI 层 | ai_goal_plan_estimate(先预估)· ai_goal_plan(双闸门/授权/余额硬拦/预算截断/ai_tasks 审计轨迹+成本;spawn_blocking 同步交互,任务化轮询登记观察项) |
17+
| 确认流 | goal_apply_plan(存在性校验/体系骨架 create 逐条独立事务——部分失败不污染目标层;link 幂等) |
18+
| 前端 | GoalPlanApprovalDialog(勾选/编辑/体系 create-vs-link/周契约可改/清洗登记/规则回退)· 双入口(InterviewDialog ✨ / GoalDetail 💡)· 最弱概念块 · 设置字段(goal_plan_enabled 默认关 + 档位)与 ai_set_goal_plan |
19+
20+
## 本批未含(登记观察项)
21+
22+
- **设置页「目标 AI」段 UI**(开关/档位选择器)——后端命令与字段已就绪,UI 下批(当前可从错误文案引导 + ai_set_goal_plan 直调)
23+
- **对话页 `/goal` 命令**(L4.5 注入问答)——后端口径命令 goal_chat_context 已交付,前端命令解析下批(验收④顺延)
24+
- 任务化轮询(同步交互 10-30s loading 可接受;审计轨迹已落库 ai_tasks)
25+
26+
## 测试与验收
27+
28+
- 纯函数 golden:协议校验矩阵/预算 O(1)/摘要边界/弱概念边界/模板捆绑(45 目标组用例)
29+
- 数据/命令:apply_plan_core 事务(替换/增量/无绑定组拒绝)/link 幂等/概念弱信号链路(80 用例)
30+
- 验证:vitest 509 全绿 · tsc 零错误 · clippy 零警告(预存 note_filter 2 例除外)
31+
- 验收(用户真机):默认关灰显引导 → 开启后 ✨/💡 双入口出草案 → 逐项确认 → 里程碑/组/体系骨架/周契约落库 → 体系页见「服务于目标 X」(反查命令已备,UI 展示下批)→ 断开 AI 全流程规则草案可用
32+
33+
## 关联
34+
35+
- 设计:[2026-09-02-v0.18.2-ai-goal-planning-design.md](../superpowers/specs/2026-09-02-v0.18.2-ai-goal-planning-design.md) · ADR-028
36+
- 后续:设置段/`/goal`/反查 UI(下批)· REQ-024(L3 检索与摘要合流)· REQ-021(生成式复习——目标内弱项出题)
37+
38+
## 待办
39+
40+
- [ ] 真机验收(默认关引导/双入口/确认落库/断 AI 降级/成本审计可见)
41+
- [ ] 设置页「目标 AI」段 UI + `/goal` 对话命令前端解析

0 commit comments

Comments
 (0)