Skip to content

Commit 17bc9ef

Browse files
committed
docs(archive): archive 2026-09-02
1 parent 57c4dd7 commit 17bc9ef

7 files changed

Lines changed: 92 additions & 5 deletions

File tree

‎docs/adr/ADR-027-goal-layer-modeling.md‎

Lines changed: 2 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -1,7 +1,7 @@
11
# ADR-027:学习目标层建模——意图层对象(N:M / 判据配方 / 四态状态机 / 库即记忆)
22

33
> 状态:已接受(2026-09-02,随 v0.18.0 M1 实施批补登)
4-
> 关联:[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(知识体系层)
4+
> 关联:[v0.18 设计规格(已批准,[ ] 已归档)](../archive/2026-09-02/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(知识体系层)
55
66
## 背景
77

@@ -41,6 +41,6 @@
4141

4242
## 参考
4343

44-
- [v0.18 学习目标层设计:意图层 · 访谈式设定 · 库即记忆](../superpowers/specs/2026-09-02-v0.18-learning-goals-design.md)
44+
- [v0.18 学习目标层设计:意图层 · 访谈式设定 · 库即记忆([ ] 已归档)](../archive/2026-09-02/2026-09-02-v0.18-learning-goals-design.md)
4545
- [v0.18.0 版本文档(M1 范围/验收)](../versions/v0.18.0.md)
4646
- [v4 路线图构建顺序分析(P17 意图轴)](../Foresight/v4-roadmap-build-order-analysis.md)

docs/superpowers/specs/2026-09-02-v0.18-learning-goals-design.md renamed to docs/archive/2026-09-02/2026-09-02-v0.18-learning-goals-design.md

File renamed without changes.

‎docs/archive/2026-09-02/README.md‎

Lines changed: 37 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,37 @@
1+
# 归档:2026-09-02
2+
3+
> 归档日期:2026-09-02(v0.18.0「学习目标层 M1」交付 + 新增代码七维审查即修)
4+
> 关联:v0.18.0 交付 4 提交(7a369cf7~6eb28c67)+ 审查修复 2 提交(60f4d1e/57c4dd7,本日)· [债务清单](./tech-debt.md)
5+
6+
## 归档清单
7+
8+
| 源路径 | 归档路径 | 状态 |
9+
|--------|----------|------|
10+
| [docs/superpowers/specs/2026-09-02-v0.18-learning-goals-design.md](../superpowers/specs/2026-09-02-v0.18-learning-goals-design.md) | [2026-09-02-v0.18-learning-goals-design.md](./2026-09-02-v0.18-learning-goals-design.md) | [ ] 已归档(学习目标层意图式设计:M1 目标对象+访谈式设定+聚合视图已实施交付;M2/M3(毕业仪式/回顾流/AI 教练默认关)按批次实施时沿用归档 spec——v0.13.6~9 同批先例;git mv 保留历史链) |
11+
12+
## 不归档说明
13+
14+
- **ADR-027**(goal-layer-modeling)——当前生效 ADR,不归档(归档规则:生效 ADR 持续活跃)
15+
- **v0.18.0 版本文档**(versions/)——versions/ 内容不归档(同 v0.15/v0.16.x 先例)
16+
- **requirements-pool REQ-030/REQ-248~250 登记**——活跃登记区,不归档
17+
- **v0.18.1/v0.18.2 系列规划引用**——归档后 3 个活跃区链接已改指归档路径并标 `[ ] 已归档`
18+
19+
## 活跃区链接更新
20+
21+
| 文件 | 变更 |
22+
|------|------|
23+
| docs/adr/ADR-027-goal-layer-modeling.md | spec 链接改指归档路径 + `[ ] 已归档`(2 处) |
24+
| docs/product/requirements-pool.md | 同上(v0.18 区段设计行) |
25+
| docs/versions/v0.18.0.md | 同上(header 依据行 + 关联行,2 处) |
26+
27+
## 技术债摘要
28+
29+
- 昨日 8 笔校核:**均未发生偿还条件 → 继承 carried**(TD-040 / TD-19-D / TD-24-A / TD-30-A / TD-30-B / TD-31-A / TD-31-B / TD-31-C;其中 **TD-30-B note_filter 预存 2 例于本日全量复现并经独立 HEAD worktree 复核确认为预存**;TD-31-B 备注更新——本批新增 1 处 window.confirm,余 13 处未决)
30+
- **今日已偿 0 笔**(无既有债务偿还);**新增代码七维审查即修 8 项**(P1×2 / P2×4 / P3×2,详见债务清单「今日已偿」;核心:访谈时限 chips 创建丢失 / skipped 里程碑拖死判据 / 重访谈改名不落地 / 两命令未接线 / 无期限宣言病句 / 防御取数 / 文本上限 / 热词预填)
31+
- **新增 open 0 笔**;观察项新增 2(2026-09-02-1/2:GoalDetail 组件级测试未覆盖(核心命令契约已由后端单测覆盖,登记后续);删除确认 window.confirm 与 TD-31-B 合并追踪)
32+
33+
## 验证记录
34+
35+
- 前端 vitest 66 文件 507 用例全绿(含审查新增断言);`tsc --noEmit` 零错误
36+
- Rust 全量 `cargo test`:1932 通过;仅 2 例 note_filter 预存失败(TD-30-B,与本批无关);clippy 零警告
37+
- 归档链路:spec 已跟踪确认 → git mv 保留历史 → 3 个活跃区文件改指归档路径
Lines changed: 49 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,49 @@
1+
# 技术债清单(权威:2026-09-02)
2+
3+
> 本清单为当前唯一权威债务清单,归档日滚动更新;旧归档清单仅历史追溯。
4+
> 来源:2026-09-02(v0.18.0「学习目标层 M1」交付 4 提交 + 新增代码七维审查即修;
5+
> 昨日 8 笔逐条核验:均未发生偿还条件 → 继承 carried,TD-31-B 备注更新)
6+
7+
## 未偿债务
8+
9+
| ID | 摘要 | 类型 | 优先级 | 来源归档 | 状态 |
10+
|----|------|------|--------|----------|------|
11+
| TD-040 | bundle.resources 未含 ffmpeg(deliberate 有意不修:体积权衡) | 有意 | P2 | 2026-08-18 | carried |
12+
| TD-2026-08-19-D | image_stream_store 已交付未接线(REQ-110/123/088)——lib.rs 仅 mod 声明,接线条件未发生 | 有意 | P2 | 2026-08-19 | carried |
13+
| TD-2026-08-24-A | lib.rs/live_session_frame.rs 超 600 硬限——lib.rs 仍 >600(generate_handler 单点展开不可拆);拆分计划顺延;**备注:v0.18.0 目标层注册使 lib.rs 再增 ~30 行(824),拆分计划维持顺延** | 有意 | P1 | 2026-08-24 | carried |
14+
| TD-2026-08-30-A | ClassroomPage 607 行超 600 硬限——拆分计划(LiveCaptureCard)未启动 | 有意 | P1 | 2026-08-30 | carried |
15+
| TD-2026-08-30-B | note_filter 预存失败 2 笔(session29_live_ui_excluded_from_points / ocr_points_exclude_watermark_junk_and_dupes)——2026-09-02 全量复现 2 例失败(独立 HEAD worktree 复核确认与本批零触及,独立排查) | 预存 | P2 | 2026-08-30 | carried |
16+
| TD-2026-08-31-A | BrowserChrome 对 contenteditable 右键无应用内文本菜单——当前应用无该编辑面 | 有意 | P3 | 2026-08-31 | carried |
17+
| TD-2026-08-31-B | window.prompt/confirm/alert 替换为应用内对话框——**部分进展**:精修授权确认已改写(v0.17.0),**本批 GoalDetail 删除目标新增 1 处 window.confirm(存量一致)**,余 13 处未决(用户裁决后续批) | 有意 | P2 | 2026-08-31 | carried |
18+
| TD-2026-08-31-C | App.css 从未被引入(死样式)——引入改全局暗色观感,需单独裁决 | 环境变化 | P3 | 2026-08-31 | carried |
19+
20+
## 今日已偿
21+
22+
无既有债务偿还;本日新增代码七维审查定位并**即修 8 项**(不立债,均在本批修复提交内):
23+
1. **审查-P1-1(P1)**:访谈模式第 3 问时限选择(a.horizon)创建时丢失——create_goal 收到面板默认值「3m」而非用户选择;改 effectiveHorizon 口径(前端 57c4dd7)+测试断言 6m 透传
24+
2. **审查-P1-2(P1)**:skipped 里程碑(废弃计划项)计入进度分母与毕业判据——跳过拖死整个目标(里程碑 2/4 永远差一条);SQL 排除 skipped+单测(60f4d1e)
25+
3. **审查-P2-1(P2)**:重访谈(update_goal_interview)名称修改不落库——对话框允许改名但后端忽略;名称随对话窗口生效(空名回退旧名)+单测(60f4d1e)
26+
4. **审查-P2-2(P2)**:update_goal / update_goal_milestone 两命令无前端调用方(接入性缺口);详情页改名+里程碑标题行内编辑接线(57c4dd7)
27+
5. **审查-P2-3(P2)**:horizon=none 宣言文案「用无期限学会…」病句——前后端对齐为「长期目标(无期限):学会…」(60f4d1e/57c4dd7 golden 同步)
28+
6. **审查-P2-4(P2)**:命令层 require 后 .unwrap() 防御缺口(检查-取数窗口并发删除会 panic)——ok_or_else 化(60f4d1e)
29+
7. **审查-P2-5(P2)**:访谈答案文本无上限入库——bounded 200 字截断(intent/配方边界同口径)+单测(60f4d1e)
30+
8. **审查-P3-1(P3)**:InterviewDialog 编辑态 onCreated 伪 Goal 对象 + 空态热词不预填——无参回调清理+initialName 预填(57c4dd7)
31+
32+
## 审查观察项(登记不立债)
33+
34+
| ID | 摘要 | 处置 |
35+
|----|------|------|
36+
| 观察 2026-09-02-1 | GoalDetail 组件级测试未覆盖(改名/里程碑编辑/弱项渲染)——核心命令契约已由后端单测(commands_goals 13 项)覆盖,交互层登记后续 | 登记后续(随 v0.18.1 组件批补测) |
37+
| 观察 2026-09-02-2 | 删除目标确认沿用 window.confirm(与 TD-31-B 存量一致,13 处余量含本处)——不单独立债 | 并入 TD-2026-08-31-B 追踪 |
38+
| 观察 2026-09-02-3 | GoalPage 常驻挂载(display:none)启动即 list_goals——与既有页面同模式(TD-004 保留挂载纪律),无新增窗口期负担 | 无问题(登记说明) |
39+
40+
## 验证记录
41+
42+
- 前端 vitest 66 文件 507 用例全绿(含审查新增断言);`tsc --noEmit` 零错误
43+
- Rust 全量 `cargo test`:1932 通过;仅 2 例 note_filter 预存失败(TD-30-B,与本批无关);clippy 零警告
44+
- docs-check:本批文档(spec 归档/ADR-027/REQ/versions/v0.18.0)链接同步,活跃区改指归档路径
45+
46+
## 关联
47+
48+
- 版本与需求:[v0.18.0 版本文档](../../versions/v0.18.0.md)(交付 7a369cf7~6eb28c67 + 审查修复 60f4d1e/57c4dd7,REQ-030/248~250)· [ADR-027](../../adr/ADR-027-goal-layer-modeling.md)(当前生效)
49+
- 归档快照:[2026-09-02 README](./README.md)

‎docs/archive/README.md‎

Lines changed: 1 addition & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -104,3 +104,4 @@ docs/archive/
104104
| 2026-08-29 | v0.14.1 交付(20da94e7:笔记组 CRUD + 画布连线/布局偏好)+ 新增代码七维审查即修(313dd9ff:三区域并行 agent——Rust 1中7低 / 前端纯函数 2高3中6低(双实证 bug:fishbone 鱼头丢位、dualRing 浮动项压树)/ 前端组管理 4中6低,全部即修或登记观察)+ v0.14.1 设计规格归档([ ] 已归档,实施完成生命周期终结);**无新增 open 债**——昨日 2 open(TD-28-A/B)核实为 carried(D4 未接线,修复前提未发生) | 继承 11 笔 carried + 观察项 6(新增 28-29-1/2/3) |
105105
| 2026-08-30 | v0.15 交付(51896a7f~71640416:标题切换语义/全站列自适应/分组树+整列折叠/图片落盘三入口/剪贴板导入/remark-breaks 换行一致,6 提交)+ 新增代码七维审查:接入/牵连/性能/规范/安全通过,逻辑 中1(b64 解码前尺寸防线)+中低1(拖拽监听 window 泄漏改 pointer capture)+低2(列布局 window 守卫/死代码清理)即修 aece95f;v0.15 设计规格归档([ ] 已归档);**新增 open 1 笔**(TD-30-A ClassroomPage 607 超 600 硬限,拆分计划已登记) | 继承 3 carried + TD-2026-08-30-A(open 1 笔),共 4 笔 + 观察 7 项 |
106106
| 2026-08-31 | v0.16.1 用户反馈批交付(7 提交 4e30af1f~09f9689f:图片 RangeError 修复/正文多色/对话转笔记双入口/AI 任务对话化+工作台深链/右键菜单完整/浏览器原生菜单去除)+ 新增代码审查即修 7 项(含 REQ 编号冲突修正 REQ-238~244);本日无文档归档(v0.16.1 版本文档与需求池属不归档类,无新 spec/ADR) | TD-040 + TD-19-D/24-A/30-A/30-B(carried 5 笔)+ TD-2026-08-31-A/B/C(open 3 笔),共 8 笔 + 观察 15 项 |
107+
| 2026-09-02 | v0.18.0 学习目标层 M1 交付(4 提交 7a369cf7~6eb28c67 + 代码审查即修 8 项 60f4d1e/57c4dd7:P1×2/P2×5/P3×1——访谈时限丢失/skipped 判据/重访谈改名/命令接线/无期限宣言/防御取数/文本上限/热词预填);v0.18 设计规格归档([ ] 已归档,M1 实施交付;M2/M3 批次沿用归档 spec——v0.13.6~9 同批先例) | TD-040 + TD-19-D/24-A/30-A/30-B/31-A/31-B/31-C(carried 8 笔),共 8 笔 + 观察 3 项 |

‎docs/product/requirements-pool.md‎

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -428,7 +428,7 @@
428428
### v0.18.0 · 学习目标层(2026-09-02 用户裁决立项)
429429

430430
> 依据:用户指令「探讨学习目标(长期/短期)是否偏离产品」「目标设定需通过询问明确真正需求,而非『我要学习 xx』」+优化评审 10 项全部采纳(删缓存列/删 draft 态/单组件双展开/单行卡/FSRS 弱项/里程碑草案/table-driven golden/切分微调/预算档位化);
431-
> 设计:[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);
431+
> 设计:[spec 2026-09-02-v0.18-learning-goals-design.md([ ] 已归档)](../archive/2026-09-02/2026-09-02-v0.18-learning-goals-design.md) + [ADR-027](../adr/ADR-027-goal-layer-modeling.md);
432432
> 系列规划详见 [versions/v0.18.0.md](../versions/v0.18.0.md)(M1 目标对象+访谈+聚合视图(无 AI)→ M2 毕业仪式+回顾流 → M3 AI 教练默认关)。
433433
434434
| REQ | 需求 | 优先级 | 状态 | 目标版本 | 备注 |

‎docs/versions/v0.18.0.md‎

Lines changed: 2 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -1,7 +1,7 @@
11
# v0.18.0:学习目标层 M1——目标对象 + 访谈式设定 + 聚合视图(无 AI)
22

33
> 状态:**M1 已实施**(设计已批准 2026-09-02,含优化评审 10 项;M1 代码已交付 2026-09-02,真机验收待执行)
4-
> 依据:用户指令「探讨学习目标是否偏离产品 / 目标设定需询问明确真正需求 / 讨论实现方式 / 优化评审全部采纳」+ 设计规格 [2026-09-02-v0.18-learning-goals-design.md](../superpowers/specs/2026-09-02-v0.18-learning-goals-design.md)
4+
> 依据:用户指令「探讨学习目标是否偏离产品 / 目标设定需询问明确真正需求 / 讨论实现方式 / 优化评审全部采纳」+ 设计规格 [2026-09-02-v0.18-learning-goals-design.md([ ] 已归档)](../archive/2026-09-02/2026-09-02-v0.18-learning-goals-design.md)
55
> 需求:激活 [REQ-030(学习计划系统 · P17)](../product/requirements-pool.md)(P3 远期 → v0.18 系列);实施批内拆分/编号 REQ-248~250 + [ADR-027 目标层建模](../adr/ADR-027-goal-layer-modeling.md) 补登
66
77
## 一句话
@@ -43,7 +43,7 @@
4343

4444
## 关联
4545

46-
- 规格:[2026-09-02-v0.18-learning-goals-design.md](../superpowers/specs/2026-09-02-v0.18-learning-goals-design.md)
46+
- 规格:[2026-09-02-v0.18-learning-goals-design.md([ ] 已归档)](../archive/2026-09-02/2026-09-02-v0.18-learning-goals-design.md)
4747
- 复用:v0.11 组/结算/周契约/指标 · v0.13 概念/决策(应用判据)· FTS5(远期 L3 检索)· v0.16 AI 对话(M3 注入)
4848
- 后续:REQ-024(问我的笔记)· REQ-021(生成式复习)· REQ-231(上下文注入 L1-L4.5)· ADR-027(实施批补登)
4949

0 commit comments

Comments
 (0)