Skip to content

Commit a4752f2

Browse files
AparenciaAparencia
committed
docs(archive): archive 2026-09-04
1 parent 3c1fcce commit a4752f2

3 files changed

Lines changed: 82 additions & 0 deletions

File tree

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

Lines changed: 22 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,22 @@
1+
# 归档 2026-09-04
2+
3+
> 归档 SOP：见 [../README.md](../README.md)。归档当日：2026-09-04。
4+
> 关联版本实施：v0.19.2 / v0.19.3（今日完成三段并行审查并即修，见 [tech-debt](./tech-debt.md)）。
5+
6+
## 归档清单
7+
8+
| 源 | 目的 | 说明 |
9+
|----|------|------|
10+
| — | — | 本日无文档归档（v0.19.2/v0.19.3 属版本文档常驻 [versions/](../../versions/README.md)，不入归档） |
11+
12+
## 技术债变更摘要
13+
14+
- 承继（carried）：**8 笔**（TD-040、TD-2026-08-19-D、TD-2026-08-24-A、TD-2026-08-30-A/B、TD-2026-08-31-A/B/C）——逐笔核验，均未发生偿还条件，全数滚动至 [tech-debt](./tech-debt.md)
15+
- 偿还/关闭：**0 笔**
16+
- 即修（不立债）：**14 项**审查定位即修项（提交 3c1fcce9），含 5 M + 9 L，另有 5 项登记观察不立债
17+
- 权威清单：本日 [tech-debt.md](./tech-debt.md)
18+
19+
## 提交
20+
21+
- `3c1fcce9` fix(rag): v0.19.2/3 审查即修——锁窗外移/启动兜底/建议区竞态/文案收口（审查修复，10 文件）
22+
- 本归档提交：见 git log（`docs(archive): archive 2026-09-04`）

‎docs/archive/2026-09-04/tech-debt.md‎

Lines changed: 59 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,59 @@
1+
# 技术债清单（权威：2026-09-04）
2+
3+
> 本清单为当前唯一权威债务清单，归档日滚动更新；旧归档清单仅历史追溯。
4+
> 来源：2026-09-04（v0.19.2/v0.19.3 交付后新增代码三段并行审查即修；
5+
> 昨日（2026-09-03）8 笔逐条核验：均未发生偿还条件 → 继承 carried）
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 超 600 硬限——实测 872（v0.19.3 模块/命令再 +5）；generate_handler 单点展开不可拆，拆分计划维持顺延 | 有意 | P1 | 2026-08-24 | carried |
14+
| TD-2026-08-30-A | ClassroomPage 超 600 硬限——实测 745（v0.19.2 +59、v0.19.3 审查即修 +43）；拆分计划（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-04 全量复现仍 2 例（2058 通过/2 失败） | 预存 | 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.19.2/3 零新增，余 13 处未决 | 有意 | P2 | 2026-08-31 | carried |
18+
| TD-2026-08-31-C | App.css 从未被引入（死样式）——引入改全局暗色观感，需单独裁决 | 环境变化 | P3 | 2026-08-31 | carried |
19+
20+
## 今日已偿 / 即修
21+
22+
**无既有债务偿还**。新增代码三段并行审查（Rust 采集/系统层 + Rust v0.19.3 后端 + 前端 v0.19.2/3）定位并**即修 14 项**（不立债，审查修复提交 3c1fcce9）：
23+
24+
1. **[M] capture-1**：lifecycle start 15s 等待全程持 active 锁（主线程 pause/resume/status 命令排队冻结）+ async 命令同步阻塞——**锁外等待重构**（快速初检→锁外等待→最终登记闸；并发双 start 后到者回滚自身并报错）
25+
2. **[M] capture-2**：超时分支用字符串相等做行为分支（文案改动即静默退回双引擎）——**WaitError 枚举化**（Timeout/LoadFailed/Exited + Display）
26+
3. **[M] FE-1（capture）**：非就绪启动成功路径「引擎就绪中…」文案整段会话残留——recording 迁移统一覆写「实时捕获已开始」
27+
4. **[M] FE-2（capture）**：starting 过渡态无超时兜底（事件丢失=按钮永久禁用无停止出口）——**20s 看门狗**查询 live_session_status 收口（对齐 TD-042 stopping 先例）
28+
5. **[M] FE-3（rag）**：DiscoverySuggestSection 无 seq 守卫——概念快速切换 A 旧候选可被确认挂到 B（真实错链）——**序号守卫 + 切换/拉取即清屏**
29+
6. **[L] rag-1**：essence 无落库上限拼入查询（跨 token FTS 表达式可膨胀）——查询截断 240 字符 + 单测
30+
7. **[L] rag-2**：跨体系相似提示含 archived 概念、take 先于排序无口径——过滤 archived + 排序后 truncate + 注释
31+
8. **[L] capture-3**：mark_session_failed 静默（真孤儿 recording）——失败 eprintln 可观测
32+
9. **[L] capture-4**：注释-实现矛盾三处（≤5s/永不失败/回退覆盖）——随重构同步更新
33+
10. **[L] capture-5**：is_system_window 精确相等依赖进程名输出无防护（尾部 \0 风险）——trim_end 防御
34+
11. **[L] FE-4（rag）**：确认成功文案被紧随 load() 清空——load(reset) 参数化，成功文案保留
35+
12. **[L] FE-5（capture）**：liveActiveRef useEffect 后置同步防护概率失效——事件监听器内直写 ref
36+
13. **[L] FE-6（capture）**：release 注释失实 + TTL 回收后 prepareState 陈旧误判——注释如实化 + 点击预同步 prepare 状态
37+
14. **[L] FE-7（capture）**：系统窗口残留选择与折叠卡无标记——折叠卡加 🖥 系统窗口 徽标
38+
39+
## 审查观察项（登记不立债）
40+
41+
| ID | 摘要 | 处置 |
42+
|----|------|------|
43+
| 观察 2026-09-04-1 | 超时路径残留加载窗口：被取消线程加载完才退出，期间重试/重挂载 prepare 会与残留并行双引擎加载（加载不可中断；建议 CancelPending 状态机扩展） | 登记后续（随预热状态机强化批评估） |
44+
| 观察 2026-09-04-2 | B站独立客户端首页标题若为裸「哔哩哔哩」会被 homepage demote 清零（与抖音不同——抖音未入首页表）；待真机实测客户端窗口标题形态 | 登记后续（实测后再定 demote 是否按进程限定） |
45+
| 观察 2026-09-04-3 | 建议排除后不回填致候选稀疏（spec 允许截顶）；符合设计，quality 改进登记 | 登记后续 |
46+
| 观察 2026-09-04-4 | 设置页关闭 kb_discovery 与已挂载建议区不联动（旧候选仍可见；影响面小，人工确认流兜底） | 接受（登记说明） |
47+
| 观察 2026-09-04-5 | FE 测试缺口续：ClassroomPage starting 状态机/看门狗、WindowSelectCard 折叠徽标无组件测试（Starting 死锁面本可拦截） | 登记后续（随组件测试批补测） |
48+
| 观察（继承 09-03） | kb 保存钩子事务化候选 / kb_chunk 切块线性化候选 / reindex 报告口径说明 / FE 测试缺口 / 播放中真检测（OCR/音频轮询） | 登记后续（延续） |
49+
50+
## 验证记录
51+
52+
- Rust 全量 `cargo test`：**2058 通过 / 2 失败（note_filter 预存，TD-30-B）/ 6 ignored**；clippy 零警告（预存 lib.rs 多 target 提示除外）
53+
- 前端：vitest **528/528 全绿**；`tsc --noEmit` 零错误
54+
- 提交：审查修复 3c1fcce9（10 文件，Rust+FE+豁免登记+v0.19.3 文档口径同步）
55+
56+
## 关联
57+
58+
- 版本与需求：[v0.19.2 版本文档](../../versions/v0.19.2.md) · [v0.19.3 版本文档](../../versions/v0.19.3.md)（交付 dd5f9b2/cf41a46c + 审查修复 3c1fcce9，REQ-261/262/271~273）
59+
- 归档快照：[2026-09-04 README](./README.md)

‎docs/archive/README.md‎

Lines changed: 1 addition & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -106,3 +106,4 @@ docs/archive/
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 项 |
107107
| 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 项 |
108108
| 2026-09-03 | v0.19.0~1「检索与发现层」交付（2da0281b/970bea58：kb 派生索引 + 学习库问答，REQ-258/260/262 部分）+ 新增代码三段并行审查即修 13 项（bdd63383：焦点陈旧重定向/failed 引用保留/regenerate 流标志泄漏/fts-only limit 8× 超发（补挂漏编译的 kb_search 测试）/引号 token 静默漏检/滑窗膨胀有界/reindex 整清+元数据落点/编辑态注入守卫/轮询 active 门控）+ 预存红测试对齐（budget pack，402da10，v0.18.2 遗留）；v0.19 设计规格归档（[ ] 已归档，v0.19.0/1 实施交付，v0.19.2/3 沿用——v0.18 M1 同批先例）；Rust 2048/2 预存（TD-30-B）+ vitest 525/525 + tsc 0 | TD-040 + TD-19-D/24-A/30-A/30-B/31-A/31-B/31-C（carried 8 笔），共 8 笔 + 观察 5 项 |
109+
| 2026-09-04 | v0.19.2/3 交付后新增代码三段并行审查即修 14 项（3c1fcce9：锁外等待重构+WaitError 枚举化/20s 启动看门狗兜底/建议区序号守卫+时序文案收口/essence 240 截断+archived 概念过滤/系统窗口折叠徽标+失败可观测/注释口径，5 M + 9 L）+ 观察登记 5 项不立债（超时残留双引擎/客户端首页 demote 待实测/排除不回填/flag 关闭不联动/FE 测试缺口续）+ 预存红测试保持 2 例复现；Rust 2058/2（TD-30-B）+ vitest 528/528 + tsc 0 + clippy 0；本日无文档归档（v0.19.2/3 属 versions/ 不归档类，无新 spec/ADR 入夹） | TD-040 + TD-19-D/24-A/30-A/30-B/31-A/31-B/31-C（carried 8 笔），共 8 笔 + 观察 5 项 |

0 commit comments

Comments
 (0)