@@ -0,0 +1,46 @@
+# ADR-027：学习目标层建模——意图层对象（N:M / 判据配方 / 四态状态机 / 库即记忆）
+
+> 状态：已接受（2026-09-02，随 v0.18.0 M1 实施批补登）
+> 关联：[v0.18 设计规格（已批准）](../superpowers/specs/2026-09-02-v0.18-learning-goals-design.md) · [v0.18.0 版本文档](../versions/v0.18.0.md) · REQ-030 激活/REQ-248~250 · ADR-010（AI 为增强层·本地兜底铁律）· ADR-018（FSRS 调度）· ADR-024（知识体系层）
+
+## 背景
+
+提取管线（v0.1~0.9）、学习循环（v0.11：FSRS/周契约/组结算/指标）、知识体系层（v0.13）、AI 平台（v0.11.6/v0.16/v0.17）均已交付——但缺「意图轴」：用户「我要学 Python」没有对象化，周契约/组结算/概念升格各自为政，AI 对话没有意图上下文可注入。2026-09-02 用户裁决：目标层按意图层建模（不并入知识体系层、不接 agent 框架/记忆模块），本 ADR 补登数据建模与硬约束。
+
+## 决策
+
+1. **目标＝组的容器（N:M）**：组仍是唯一容器（v4 契约二不破）。`goals` 主表 + `goal_milestones`（判据型里程碑）+ `goal_groups`（UNIQUE(goal_id, group_id)）三表；组删除走既有 CASCADE 纪律——goal_groups 级联清、goal_milestones.ref_group_id SET NULL（绑定该组的 group_settled 里程碑降级手动确认，提示 UI 属 M2）。
+2. **判据配方＝快照**：`success_criteria_json`（tier 档位展开为可观测信号要求值：组结算历史数/应用记录数/自测通过率（M1/M2 占位不判定）/近 90 天复习活跃天数），毕业后冻结；**进度信号一律现算**（聚合皆毫秒级 SQLite），目标层零进度副本/零缓存（优化评审 #1：缓存层是过度设计）。
+3. **四态状态机无 draft**：active⇄paused、active→graduated（毕业仪式用户确认，M2 落 goal_settle 写快照）、active/paused→abandoned（显式动作+可选原因，无惩罚）；grad/abandon 为终态（无复活——弹性承诺的放弃不追责也不回滚）。
+4. **库即记忆（预算硬约束）**：唯一事实源=本地库；AI 无记忆模块/无状态/无缓存层，每次调用经「检索管道」（L1/L2/L3 + L4.5 目标摘要**每次现算**）取现拼；**调用成本与库规模解耦**——上下文预算档位化（轻量 ~4K/标准 ~10K/深度 ~30K，默认标准），检索点查代替全量注入（库增长 O(N)、调用成本 O(1)）；深读/跨片段综合走「先预估后确认」（复用 ai_refine_estimate 范式）。
+5. **M1/M2 零 AI 代码**：goal_interview/progress/rules 全部本地纯函数；AI 教练（目标摘要注入/复盘/追问/概念低激活弱项/图片影子缓存）严格属 M3 且默认关（content_gate 双闸门）；生成式复习（REQ-021）单独立项。
+
+## 备选（否决）
+
+- **agent 记忆模块/自主规划**（裁决引用）：本地 SQLite 即比任何 agent 记忆更可靠的长记忆（结构化/版本化/可审计/不出本机）；agent 循环不可确定性 vs 项目可测试性与防御性降级两条铁律；桌面单用户无多代理编排需求。
+- **目标嵌入体系层（知识结构=意图）**：体系层是「知识结构」（概念/模型/决策），目标是「意图轴」（要成为什么）——分开建模，概念库不塞进目标（意义链 ≠ 体系）。
+- **目标进度缓存列/派生表**：读少写多 + 现算毫秒级，缓存/物化引入双写一致性风险（优化评审 #1 采纳删除）。
+- **目标间依赖/优先级图、FTS5 检索重排、AI 动态自适应预算**：YAGNI/不可测（优化评审主动排除）。
+
+## 影响
+
+- 正向：学习循环获得意图上下文（"被 AI 问"的原料）；里程碑有客观判据信号（结算历史/FSRS 弱项/应用记录）；本地优先零云端依赖（M1/M2 全本地）。
+- 代价：三表 + 一处既有模块最小钩子（execute_settlement 后自动通过 group_settled 里程碑——目标层为只读聚合+事件钩子，不侵入结算状态机；钩子失败仅记日志，结算仪式不因目标层失败）。
+- 兼容：新表幂等建表（旧库升级零破坏）；notes/groups/settlements/flashcards/review_logs/contracts/knowledge_decisions 只读复用不加列；metrics_events.kind 补值式扩展（既有读取不受影响）。
+
+## 合规性验证
+
+- 三表 :memory: CRUD + 组删除 CASCADE 行为测试（绑定消除/ref SET NULL/里程碑保留降级手动）
+- 判据配方 table-driven golden（6 条端到端 + 参数矩阵）；四态状态机 16 对转移矩阵 + 终态守卫（重复毕业/放弃后毕业非法）
+- 进度聚合边界测试（0 结算/历史计数/周契约双达标/90 天窗口/弱项占比与排序/应用记录 GROUP 引用命中）
+- 回归：cargo test / clippy 零警告 / vitest / tsc 全绿（v0.18.0 验收 9）
+
+## 相关决策
+
+- ADR-010（AI 为增强层·本地兜底铁律）· ADR-018（FSRS 调度——弱项信号 state_json 读取）· ADR-024（知识体系层——本 ADR 与其明确划界）· ADR-026（AI 精修策略化——预算估费范式复用）
+
+## 参考
+
+- [v0.18 学习目标层设计：意图层 · 访谈式设定 · 库即记忆](../superpowers/specs/2026-09-02-v0.18-learning-goals-design.md)
+- [v0.18.0 版本文档（M1 范围/验收）](../versions/v0.18.0.md)
+- [v4 路线图构建顺序分析（P17 意图轴）](../Foresight/v4-roadmap-build-order-analysis.md)
@@ -425,6 +425,18 @@
 | REQ-246 | 笔记级 AI 能力：编辑态「🤖 AI」菜单（AI 精修/知识补充/预留）+ NoteAiDialog + 笔记级精修（输入=编辑器当前内容直接传参、基线=当前笔记版、版本链 source=ai-refine 复用）+ handwritten 档案（笔记式，仅笔记级请求，采集端零改动）+ ai_note_refine_estimate/start + 工作台笔记级模式 + 阅读态 AI 入口直接进入编辑态 + 阅读态独立 EnrichPanel 移除 | P0 | 已立项 | v0.17.0 | 手写笔记刚需；image 块前缀白名单化（session-images/+notes-images/，向后兼容） |
 | REQ-247 | 精修流式会话化：Tauri IPC 流式通道（progress/block_done/slice_failed/done 帧）+ 后端片级流式（片完成 validate 后推渲染，协议强校验/失败回退不变）+ 对话页消息流（消息1=提示词全文立即显示/消息2=片级解析流）+ 完成自动升工作台（diff 同步打开）+ 消息底部 [回到会话][查看笔记] 双入口 + 追问保留（10 分钟窗口） | P0 | 已立项 | v0.17.0 | B+ 档（片级解析流）；任务表语义（幂等/成本/审计/重试/trajectory 终态）全保留——流式=呈现增强 |
 
+### v0.18.0 · 学习目标层（2026-09-02 用户裁决立项）
+
+> 依据：用户指令「探讨学习目标（长期/短期）是否偏离产品」「目标设定需通过询问明确真正需求，而非『我要学习 xx』」＋优化评审 10 项全部采纳（删缓存列/删 draft 态/单组件双展开/单行卡/FSRS 弱项/里程碑草案/table-driven golden/切分微调/预算档位化）；
+> 设计：[spec 2026-09-02-v0.18-learning-goals-design.md](../superpowers/specs/2026-09-02-v0.18-learning-goals-design.md) ＋ [ADR-027](../adr/ADR-027-goal-layer-modeling.md)；
+> 系列规划详见 [versions/v0.18.0.md](../versions/v0.18.0.md)（M1 目标对象+访谈+聚合视图（无 AI）→ M2 毕业仪式+回顾流 → M3 AI 教练默认关）。
+
+| REQ | 需求 | 优先级 | 状态 | 目标版本 | 备注 |
+|----|------|--------|------|---------|------|
+| REQ-248 | 学习目标数据模型：goals/goal_milestones/goal_groups 三表（db_migrations 幂等；N:M 绑定 UNIQUE(goal_id,group_id)；判据配方/访谈答案 JSON；status 四态无 draft）+ metrics_events kind 扩展（goal_created/goal_milestone_done 写入；self_test_passed/failed 占位契约）+ 组删除 CASCADE 行为测试（goal_groups 级联清、ref_group_id SET NULL） | P1 | 已实施 | v0.18.0 | 意图层对象（目标=组的容器，组仍是唯一容器）；进度信号现算零双写；**代码已交付（2026-09-02，db_goals + 三表 + CASCADE/结算钩子测试）** |
+| REQ-249 | 访谈式目标设定：一套 InterviewDialog 双展开（访谈=四步向导+宣言确认，第 1/3 问必答、2/4 问折叠可跳过；快速=名称+期限判据走默认档）+ goal_interview 纯函数（答案→判据配方/suggest_milestones 里程碑草案/宣言组装，table-driven golden 6 条端到端+参数矩阵）+ 答案可回溯编辑（重新访谈配方重推） | P1 | 已实施 | v0.18.0 | 0 AI 本地规则（M3 叠加 AI 追问）；访谈中断不落库；**代码已交付（2026-09-02，goal_interview + 里程碑草案命令 + InterviewDialog/InterviewSteps）** |
+| REQ-250 | 目标聚合视图：GoalPage 独立 Tab（单行卡：名称/状态徽标/一句话进度/🎓可毕业）+ GoalDetail（里程碑勾选/关联组 N:M/判据明细/弱项块=FSRS 低稳定性卡占比 Top 组）+ goal_rules 四态状态机与毕业判据 + 埋点 + 组结算里程碑自动通过钩子 | P1 | 已实施 | v0.18.0 | 毕业仪式/回顾流/pause-abandon UI 属 M2（状态机纯函数与守卫已先行）；**代码已交付（2026-09-02，GoalPage/GoalCard/GoalDetail + goal_rules/goal_progress + 结算钩子）** |
+
 ### V1.0 · 体验增强（远期）
 
 | ID | 需求 | 优先级 | 状态 | 目标版本 | 备注 |
@@ -457,7 +469,7 @@
 | REQ-027 | 重点标记→闪卡自动联动 | P3 | 待评估 | V1.1 | 竞品无此闭环 |
 | REQ-028 | 中英混说识别 | P3 | 待评估 | V1.1 | 先做本地模型 spike |
 | REQ-029 | 知识图谱可视化（P13） | P3 | 待评估 | 远期 | 高成本；**2026-08-23 联动（ADR-024）**：体系层（有界体系）落地后本项含义降为"体系数据可视化补充"，维持 P3；不做力导向图（Heptabase 已占位 + P13） |
-| REQ-030 | 学习计划系统（P17） | P3 | 待评估 | 远期 | 目标→任务→追踪 |
+| REQ-030 | 学习计划系统（P17） | P3 | 已激活（v0.18.0 系列立项） | v0.18.0 | 目标→任务→追踪；**2026-09-02 激活**：目标层定位=意图层（目标＝组的容器 N:M、访谈式设定、判据配方、四态生命周期），拆分登记为 REQ-248~250；后续：生成式复习（REQ-021 单独立项）依赖本线自测链路 |
 | REQ-096 | 跨会话图指纹关联：相同图跨课程出现 → 课程关联（P13 轻量版） | P3 | 待评估 | V1.1 | 2026-08-19 头脑风暴（图像复用）；REQ-067 指纹的消费端 |
 | REQ-097 | 测验引用图：测验自生成时图表作题干素材 | P3 | 待评估 | V1.1 | 2026-08-19 头脑风暴（图像复用）；依赖 K2 测验自生成 |
 
 
@@ -62,6 +62,8 @@
 | app/src-tauri/src/commands_video.rs | 370 | v0.5.0 M1（REQ-043）起：视频档案命令域（检测装配/领域检测/预热/记忆）；v0.13.6（REQ-219~222）形态/领域/细目/记忆命令 + 分区映射形态接线再增；审查轮（H1 领域记忆兜底顺序修复/L2 独立 try）微增 | 若再增长：领域命令组拆至 commands_video_domain.rs |
 | app/src-tauri/src/commands_live.rs | 362 | 实时采集命令域（启动/停止/档案热切换/剪辑监听）；v0.13.6（REQ-220）update_live_profile 细目参数与校验 + 审查轮（clear sentinel 空串语义/fine 计入至少一项）再增 | 若再增长：档案覆写命令拆至 commands_live_profile.rs |
 | app/src-tauri/src/live_session.rs | 368 | 会话装配/状态（LiveSessionParams 聚合 + run_session_after_engine 骨架 + ProfileOverride 细目字段）；v0.13.6 +2 | 若再增长：ProfileOverride 与参数分拆至 live_session_params.rs |
+| app/src-tauri/src/commands_goals.rs | 498 | v0.18.0（REQ-248~250）：学习目标命令域（14 命令 + inner 纯编排 + 访谈校验/埋点/宣言组装/进度收集）——命令薄壳与 inner 同域（commands_knowledge_core 先例）；列表/详情/进度三视图共用 collect_signals/goal_card_metrics | 若再增长：里程碑命令组拆至 commands_goals_milestones.rs |
+| app/src-tauri/src/db_goals.rs | 313 | v0.18.0（REQ-248）：goals 三表 DDL + 实体 CRUD/绑定/结算钩子内聚；行映射与事务建目标共享 add_milestone 族 | 若再增长：里程碑操作拆至 db_goals_milestones.rs |
 
 ## 前端（app/src/，数字来自前端审查快照；Task #9/10 拆分进行中）
 
 
@@ -46,7 +46,7 @@
 | v0.16.1 | [v0.16.1.md](./v0.16.1.md) — 用户反馈批·体验修复与 AI 对话闭环：图片插入 RangeError 修复 + 正文多色 `==[色]文本==`（含 hName 缺陷修复）+ 对话转笔记双入口 + 任务对话化（线程卡/追问/`/`命令/精修自动跳转）+ 工作台深链 + 右键菜单完整性 + 浏览器原生右键菜单去除（REQ-238~244） | 版本文档（代码已交付 2026-08-31） |
 | v0.17.0 | [v0.17.0.md](./v0.17.0.md) — AI 精修可到达度：策略化提示词（JSON v3 声明/四档阶梯/六旋钮/书面目标 chips/预览所见即所发）+ 笔记级 AI 能力（编辑态 🤖 AI 统一入口/手写档案/内容传参/工作台笔记级）+ 精修流式会话化（片级解析流事件/对话卡流式正文/完成双入口）（REQ-245~247，ADR-026） | 版本文档（代码已交付 2026-09-01） |
 | v0.17.1 | [v0.17.1.md](./v0.17.1.md) — bug 修复：知识补充轨迹 NULL 列崩溃（get_ai_task_trajectory Option 化）+ 笔记级精修卡住（NoteAiDialog hook taskIdRef 接线 + 结果取回防御） | 版本文档（代码已交付 2026-09-01） |
-| v0.18.0 | [v0.18.0.md](./v0.18.0.md) — 学习目标层 M1：目标对象 + 访谈式设定（四步+宣言+里程碑草案）+ 跨组聚合看板（REQ-030 激活；设计已批准 2026-09-02，待实施） | 版本文档（规划定稿） |
+| v0.18.0 | [v0.18.0.md](./v0.18.0.md) — 学习目标层 M1：目标对象 + 访谈式设定（四步+宣言+里程碑草案）+ 跨组聚合看板（REQ-030 激活/REQ-248~250，ADR-027；M1 代码已交付 2026-09-02，真机验收待执行） | 版本文档（M1 已实施） |
 
 ## 沉淀规则
 
 
@@ -1,8 +1,8 @@
 # v0.18.0：学习目标层 M1——目标对象 + 访谈式设定 + 聚合视图（无 AI）
 
-> 状态：**规划定稿**（设计已批准 2026-09-02，含优化评审 10 项；实施待启动）
+> 状态：**M1 已实施**（设计已批准 2026-09-02，含优化评审 10 项；M1 代码已交付 2026-09-02，真机验收待执行）
 > 依据：用户指令「探讨学习目标是否偏离产品 / 目标设定需询问明确真正需求 / 讨论实现方式 / 优化评审全部采纳」＋ 设计规格 [2026-09-02-v0.18-learning-goals-design.md](../superpowers/specs/2026-09-02-v0.18-learning-goals-design.md)
-> 需求：激活 [REQ-030（学习计划系统 · P17）](../product/requirements-pool.md)（P3 远期 → v0.18 系列）；实施批内拆分/编号 + [ADR-027 目标层建模] 随实施批补登
+> 需求：激活 [REQ-030（学习计划系统 · P17）](../product/requirements-pool.md)（P3 远期 → v0.18 系列）；实施批内拆分/编号 REQ-248~250 + [ADR-027 目标层建模](../adr/ADR-027-goal-layer-modeling.md) 补登
 
 ## 一句话
 
@@ -49,6 +49,6 @@
 
 ## 待办（实施时执行）
 
-- [ ] 需求池登记：REQ-030 激活 + 拆分编号（沿用项目惯例，REQ 与代码同批）
-- [ ] ADR-027 目标层建模（N:M、判据配方、四态状态机、预算硬约束）——M1 实施批补登
+- [x] 需求池登记：REQ-030 激活 + 拆分编号（REQ-248~250，与代码同批）
+- [x] ADR-027 目标层建模（N:M、判据配方、四态状态机、预算硬约束）——M1 实施批补登
 - [ ] 真机验收（REQ-146 批）：建目标→访谈→绑定组→里程碑随结算自动通过 全链路走查