Skip to content

Commit 64c2db0

Browse files
committed
docs(archive): archive 2026-08-22(v0.11.7 spec/plan 补归档 + 六轮技术债滚动)
1 parent 25386d9 commit 64c2db0

8 files changed

Lines changed: 55 additions & 8 deletions

File tree

‎docs/adr/ADR-020-session-kind-field.md‎

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -88,5 +88,5 @@ v0.11.7(图文会话)新增第三采集动线:用户连续框选截屏组
8888

8989
## 参考
9090

91-
- [v0.11.7 设计 spec](../superpowers/specs/2026-08-22-v0.11.7-photo-session-design.md)
91+
- [v0.11.7 设计 spec](../archive/2026-08-22/2026-08-22-v0.11.7-photo-session-design.md)([ ] 已归档)
9292
- [v0.11.7 版本文档](../versions/v0.11.7.md)

docs/superpowers/specs/2026-08-22-v0.11.7-photo-session-design.md renamed to docs/archive/2026-08-22/2026-08-22-v0.11.7-photo-session-design.md

File renamed without changes.

docs/superpowers/plans/2026-08-22-v0.11.7-photo-session.md renamed to docs/archive/2026-08-22/2026-08-22-v0.11.7-photo-session.md

File renamed without changes.

‎docs/archive/2026-08-22/README.md‎

Lines changed: 10 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -1,10 +1,10 @@
1-
# 归档索引:2026-08-22(pain-points v2/v3 被 v4 统一卷取代归档 + v0.11.5 设计文档/实现计划归档 + v0.11.6 M1 实现计划归档)
1+
# 归档索引:2026-08-22(pain-points v2/v3 被 v4 统一卷取代归档 + v0.11.5 设计文档/实现计划归档 + v0.11.6 M1 实现计划归档 + v0.11.7 spec/plan 归档)
22

33
> 归档判定见 [archive README](../README.md)。本日归档夹为技术债滚动快照(唯一权威清单)。
44
55
## 归档清单
66

7-
**本日归档 5 份**:
7+
**本日归档 7 份**:
88

99
| 源路径 → 归档路径 | 归档原因/状态 |
1010
|------|-----------|
@@ -13,6 +13,8 @@
1313
| `docs/superpowers/specs/2026-08-22-v0.11.x-capture-notes-polish-design.md` → `docs/archive/2026-08-22/2026-08-22-v0.11.x-capture-notes-polish-design.md` | **[ ] 已归档**——v0.11.5 设计 spec,11 项已全部实施交付 |
1414
| `docs/superpowers/plans/2026-08-22-v0.11.5-capture-notes-polish.md` → `docs/archive/2026-08-22/2026-08-22-v0.11.5-capture-notes-polish.md` | **[ ] 已归档**——v0.11.5 实现计划,14 Task 全部执行完成 |
1515
| `docs/superpowers/plans/2026-08-22-v0.11.6-m1-ai-provider.md` → `docs/archive/2026-08-22/2026-08-22-v0.11.6-m1-ai-provider.md` | **[ ] 已归档**——v0.11.6 M1 实现计划,7 Task 全部执行完成 + 两轮审查闭环(TDD/Subagent-Driven) |
16+
| `docs/superpowers/specs/2026-08-22-v0.11.7-photo-session-design.md` → `docs/archive/2026-08-22/2026-08-22-v0.11.7-photo-session-design.md` | **[ ] 已归档**——v0.11.7 设计 spec,T1-T7 全链路实施交付 + 六维审查 8 项即修闭环(25386d9) |
17+
| `docs/superpowers/plans/2026-08-22-v0.11.7-photo-session.md` → `docs/archive/2026-08-22/2026-08-22-v0.11.7-photo-session.md` | **[ ] 已归档**——v0.11.7 实现计划,7 Task 全部执行完成(T1~T6 五提交 + T7 文档收尾 172f490) |
1618

1719
**取代文档**:`docs/product/pain-points-v4.md`(统一卷:两地形、一产物、一循环)成为唯一主导规划文档。
1820

@@ -29,6 +31,12 @@
2931
- **新登记 open 0 笔**(M1 审查无遗留 open;观察项 4 条登记见 tech-debt.md)
3032
- **未偿 5 笔继承 + 1 笔补登**(TD-040 / TD-2026-08-19-D/F/G / TD-2026-08-21-B→closed / TD-2026-08-21-C 补登 carried);详见本目录 tech-debt.md
3133

34+
### 六轮补充(v0.11.7 图文会话交付 + 六维审查 + 归档)
35+
36+
- **已偿 8 项**:v0.11.7 六维审查 P1-P8 全部即修(25386d9:store 失败回滚/像素上限/计数口径/互斥 TOCTOU 窗口/Esc+resize/裁剪越界/再来一组);cargo test 1521 全绿 + tsc 零错误 + vitest 49 通过
37+
- **新登记 open 1 笔**:TD-2026-08-22-A(clippy --all-targets -D warnings 20 项错误——存量 + v0.11.6 M1 引入,未随 M1 验收闭环)
38+
- **未偿 6 笔**(TD-040 / TD-2026-08-19-D/F/G / TD-2026-08-21-C 保持 carried + TD-2026-08-22-A open);详见本目录 tech-debt.md
39+
3240
## 备注
3341

3442
- 本日归档完成后即最新归档,下个归档日需先整理本日清单

‎docs/archive/2026-08-22/tech-debt.md‎

Lines changed: 38 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -57,6 +57,44 @@
5757
| 观察 M1-3 | 授权文案 SiliconFlow 特指(AiRefineCard/EnrichPanel) | M3 已登记 |
5858
| 观察 M1-4 | ai_balance 余额接口为 SiliconFlow 专属路径,非 SiliconFlow 默认 Provider 时余额查询失败(调用方宽容放行) | M3 退役范围 |
5959

60+
## 六轮补充(v0.11.7 图文会话交付 + 六维审查 + 归档,2026-08-22)
61+
62+
> 来源:v0.11.7 代码建设(T1~T7,9866c50→172f490 九提交)+ 新增代码六维审查(8 项问题全部即修 25386d9)
63+
> 验证:cargo test 1521 passed + vitest 49 passed + tsc 零错误 + 前端 build 通过;**clippy --all-targets -D warnings 未过(见下 TD-2026-08-22-A)**
64+
65+
### 未偿核对(逐笔)
66+
67+
| ID | 摘要 | 状态 |
68+
|----|------|------|
69+
| TD-040 | bundle.resources 未含 ffmpeg(deliberate 体积权衡) | carried(v0.11.7 未涉及) |
70+
| TD-2026-08-19-D | image_stream_store 已交付未接线 | carried(v0.11.7 未涉及) |
71+
| TD-2026-08-19-F | detect_pause_icon 可能误报暂停 | carried(v0.11.7 未涉及) |
72+
| TD-2026-08-19-G | db_ocr_search 500 会话静默截断 + 图路径不校验 | carried(v0.11.7 未涉及) |
73+
| TD-2026-08-21-C | db_sessions/db_ai_tasks 的 lock().expect 未迁移 with_conn | carried(v0.11.7 未涉及 db 层) |
74+
75+
### 今日已偿(v0.11.7 六维审查即修,可经提交验证 25386d9)
76+
77+
| ID | 摘要 | 偿还方式 |
78+
|----|------|----------|
79+
| P1 | start_photo_session store 创建失败不释放互斥槽 + 残留会话 | 先建 store 再占用槽;失败回滚删会话 |
80+
| P2 | decode_image 无像素上限(压缩炸弹)+ 限长检查在解码后 | MAX_PIXELS 40MP 解码后拒绝 + base64 长度解码前预估 |
81+
| P3 | block_count 落库失败也计数(与 import_frame 口径分叉) | 成功落库才 count += 1 |
82+
| P4 | finish_photo_session store 异常被当"无图"误删会话 | store 创建失败传播 Err |
83+
| P5 | 图文/实时互斥 TOCTOU 窗口 | live_active 读取移入 photo_session 锁内 + 注释残余窗口 |
84+
| P6 | 遮罩 Esc 提示无监听 + resize 不重算 letterbox | window keydown/resize 监听 |
85+
| P7 | photoCrop 输出矩形可越界(canvas 透明带) | 起点收至末行末列 + 宽高收至边界 + 测试 |
86+
| P8 | 完成态无法原地开始新采集 | done 态"再来一组"按钮 |
87+
88+
### 新登记(open)
89+
90+
| ID | 摘要 | 处置 |
91+
|----|------|------|
92+
| TD-2026-08-22-A | clippy --all-targets -D warnings 20 项错误(enrich_placement/live_session_manager/commands_ai_enrich/db_settlements/feature_flags/watermark_filter/note_filter doc 列表等——存量 6 项 + v0.11.6 M1 引入 ~14 项;M1 验收"clippy 新增零警告"未覆盖 all-targets) | open——M2 或专项批次清偿;目标:clippy -D warnings 全绿 |
93+
94+
### 观察项(登记不立债)
95+
96+
无新增(v0.11.7 审查低危项全部即修,无观察遗留)。
97+
6098
## 关联
6199

62100
- 版本与需求:[v0.11.md 系列(v0.11.0~5)](../../versions/v0.11.md)

‎docs/archive/README.md‎

Lines changed: 1 addition & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -89,3 +89,4 @@ docs/archive/
8989
| 2026-08-21(十轮) | 日收工归档:v3 建设顺序分析沉淀至 Foresight(待裁决)+ docs-check 治理(四/七轮归档遗留失效链接 10 处修复 + extractLinks 补剔除代码块根治 v0.10.1 假阳性 5 处 + 索引缺漏 4 处补登记);无文档移入归档夹(screen-ocr spec 未实施保持活跃);纯文档变更 | TD-040 + TD-D~G(carried 4 笔)+ TD-B(open)+ TD-C(随七轮代码批待提交),共 6 笔 |
9090
| 2026-08-22 | pain-points v2/v3 归档(被 v4.0 统一卷取代:按主题重组而非按文档史;v2 双卷平行结构合并为统一框架的地形分叉表述;v3 三裁决内化为正文;零信息丢失);纯文档变更 | 继承十轮 6 笔,无增减 |
9191
| 2026-08-22(五轮) | v0.11.6 M1 AI Provider 层交付(T1~T7 十二提交:Provider 配置/凭据 scope 化/AiClient 泛化/命令层/前端面板,1521 单测全绿)+ 新增代码七维审查(双区域 agent:Ollama 门禁/预设单源/密钥错配等 11 项即修)+ 实现计划归档([ ] 已归档);累计已偿 112 笔 + M1 审查 11 项 | TD-040 + TD-D/F/G(carried 4 笔)+ TD-C(补登 carried),共 5 笔 |
92+
| 2026-08-22(六轮) | v0.11.7 图文会话交付(T1~T7 九提交:kind 字段/图文采集 5 命令/截屏面板/徽标空态,1521 单测全绿 + vitest 49)+ 新增代码六维审查 8 项即修(25386d9)+ spec/plan 归档([ ] 已归档);累计已偿 112 笔 + M1 11 项 + v0.11.7 8 项 | TD-040 + TD-D/F/G/C(carried 5 笔)+ TD-2026-08-22-A(open 1 笔:clippy all-targets 20 项),共 6 笔 |

‎docs/versions/v0.11.6.md‎

Lines changed: 2 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -1,7 +1,7 @@
11
# v0.11.6:AI 平台化——Provider 抽象 + 能力声明化 + 产出策略定制
22

33
> 状态:M1 已交付(2026-08-22),M2 排期
4-
> 依据:[设计 spec](superpowers/specs/2026-08-22-v0.11.6-ai-platform-design.md)(已批准)·
4+
> 依据:[设计 spec](../superpowers/specs/2026-08-22-v0.11.6-ai-platform-design.md)(已批准)·
55
> 市场调研:Notion AI 官方博客 / Braintrust×Notion / Obsidian Copilot / Granola / ZenML(缓存 `.firecrawl/`)·
66
> 旧项目参照:ai-gateway(providers/fallback/circuit_breaker/key_pool + 40+ chains)
77
> 前置决策:充值系统远期(本版本只留桩)
@@ -76,5 +76,5 @@ AI 从"单 Provider 直连 + 3 个散装适配器"升级为"Provider 抽象 +
7676

7777
## 关联
7878

79-
- [设计 spec](superpowers/specs/2026-08-22-v0.11.6-ai-platform-design.md) · [v0.11 系列总览](v0.11.md) ·
79+
- [设计 spec](../superpowers/specs/2026-08-22-v0.11.6-ai-platform-design.md) · [v0.11 系列总览](v0.11.md) ·
8080
- 调研缓存:`.firecrawl/`(notion-ai-way.md / notion-braintrust-eval.md / obsidian-copilot-docs.md / granola-transcription.md / search-*.json)

‎docs/versions/v0.11.7.md‎

Lines changed: 3 additions & 3 deletions
Original file line numberDiff line numberDiff line change
@@ -1,7 +1,7 @@
11
# v0.11.7:图文会话——截屏导入 + 跨链路采集体验同步
22

3-
> 状态:规划中(2026-08-22 设计已批准,排期于 v0.11.6 AI 平台化之后)
4-
> 依据:[设计 spec](superpowers/specs/2026-08-22-v0.11.7-photo-session-design.md)(已批准)·
3+
> 状态:代码已交付(2026-08-22,T1-T7 全链路 + 六维审查 8 项即修闭环;真机验收待执行)
4+
> 依据:[设计 spec](../archive/2026-08-22/2026-08-22-v0.11.7-photo-session-design.md)([ ] 已归档)· [实现计划](../archive/2026-08-22/2026-08-22-v0.11.7-photo-session.md)([ ] 已归档)
55
> 前置:v0.11.6(AI 平台化)交付后开工
66
77
## 一句话
@@ -60,5 +60,5 @@
6060

6161
## 关联
6262

63-
- [设计 spec](superpowers/specs/2026-08-22-v0.11.7-photo-session-design.md) · [v0.11 系列总览](v0.11.md) ·
63+
- [设计 spec](../archive/2026-08-22/2026-08-22-v0.11.7-photo-session-design.md)([ ] 已归档)· [实现计划](../archive/2026-08-22/2026-08-22-v0.11.7-photo-session.md)([ ] 已归档)· [v0.11 系列总览](v0.11.md) ·
6464
- 复用资产:`capture/gdi_capture.rs` · `image_store.rs` · `import_frame.rs`(960px 口径)· `screens.rs`(屏卡聚类)· `BoxSelectOverlay.tsx`(框选范式)

0 commit comments

Comments
 (0)