Skip to content

Commit dad00da

Browse files
AparenciaAparencia
committed
docs(archive): archive 2026-09-06
1 parent 99b1d22 commit dad00da

4 files changed

Lines changed: 129 additions & 1 deletion

File tree

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

Lines changed: 24 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,24 @@
1+
# 归档 2026-09-06
2+
3+
> 归档 SOP：见 [../README.md](../README.md)。归档当日：2026-09-06（v0.20.0/0.20.1 交付收口 + 新增代码六维审查即修 + 技术债滚动）。
4+
> 关联实施：v0.20.0（REQ-263）· v0.20.1（REQ-264~267，rule3=12s 定案）——见 [v0.20 版本文档](../../versions/v0.20.md)（versions/ 属不归档类常驻）与需求池。
5+
6+
## 归档清单
7+
8+
| 源 | 目的 | 说明 |
9+
|----|------|------|
10+
| —（新建于当日） | [asr-v020-review](./asr-v020-review.md) | v0.20.0/0.20.1 新增代码六维审查报告（问题清单/通过项/修复验证；修复提交 152cf56）——当日产物直接入夹 |
11+
| —（滚动） | [tech-debt](./tech-debt.md) | 权威清单自 2026-09-05 滚动：未偿表 10 笔核验（closed 3 哈希不变 / carried 7），无新增债 |
12+
13+
活跃区候选判读（不入夹）：`docs/Foresight/web-capture-ingestion-path.md`（v0.20.4 已立项仍活跃）、`docs/versions/v0.20.md` 与需求池（机制常驻）、两篇并行线 Foresight 文档（未跟踪/非本线）——均保持原样。
14+
15+
## 技术债变更摘要
16+
17+
- **closed：0 笔新增**（既有 3 笔 closed 状态与哈希不变：TD-2026-08-30-B `3f6413e`、TD-2026-09-05-A `6b8f365`、TD-2026-09-05-B `14e3988`）
18+
- **carried：7 笔**（TD-040、TD-2026-08-19-D、TD-2026-08-24-A、TD-2026-08-30-A、TD-2026-08-31-A/B/C——无偿还条件发生）
19+
- 新增债务：**0 笔**（审查问题全部即修不立债）
20+
21+
## 提交（当日全部）
22+
23+
- 代码/修复：`152cf56`（审查修复）· 收口链 `c433485` `7a7ff7c` `8fbcd2c` 等（详见 v0.20.md 交付记录）
24+
- 本归档提交：`docs(archive): archive 2026-09-06`

‎docs/archive/2026-09-06/asr-v020-review.md‎

Lines changed: 34 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,34 @@
1+
# v0.20.0/0.20.1 新增代码六维审查报告（2026-09-06）
2+
3+
> 范围：v0.20.0（REQ-263）与 v0.20.1（REQ-264~267）新增/变更代码及其直接关联调用（eval_* 纯函数四模块、bin/asr_eval{,_session,_stream}、dtw_align 校正包装、live_keyframes 接线、streaming_asr 配置化、title_rules/commands_video/前端 ProfileDetector 接线、回归修复批测试文件、Cargo.toml autobins/bin 声明）。
4+
> 方法：六维逐项（接入性/逻辑性/牵连性/性能流畅度/冗余死代码/规范+安全性）；阶段分配=原子层（eval_*/cer/dtw）→ 业务层（streaming/engine 接线）→ 系统层（bin/前端）。发现均修复后回归验证。
5+
6+
## 一、问题清单（按严重程度排序，全部已修复）
7+
8+
| # | 严重度 | 位置 | 问题描述 | 影响 | 修复（最佳方案，已实施） |
9+
|---|---|---|---|---|---|
10+
| 1 | 中 | `src/cer.rs` | CER 底层 levenshtein 为 O(n·m)（滚动行内存安全但时间二次方）；harness 弱参考路径拼接整会话文本，长会话（如 55.wav≈110min、数十万字）会触发分钟~小时级 CPU 消耗 | 工具路径可用性退化（非生产路径；cer 无 lib 内调用方） | 方案对比：分块测量（失真）/采样（偏差）/**长度护栏**（最优：诚实+零失真+零成本）——>20k 字任一侧 → None（不可比），调用方跳过；配套单测 |
11+
| 2 | 低 | `src/eval_samples.rs` parse_srt | 旧实现按"序号相同即合并文本"跨块累积——两块同显式序号（畸形 srt）时内容被跨块误并为一条 cue，参考文本错序 | 畸形字幕样本参考失真（CER/画像错偏） | **块内累积、块末一次性入 cue**（每块独立，天然隔离同号块）；单测全绿 |
12+
| 3 | 低 | `src/bin/asr_eval.rs` | 文件 386 行 > 300 行规范线（300-600 需登记豁免）；进度输出 `print!` 无换行（控制台粘连） | 规范不合规；控制台可读性 | 豁免登记入 v0.20.md 交付记录（工具 CLI 编排单用途，拆分会反损内聚，≤600 硬限内）；进度行尾补换行 |
13+
| 4 | 低 | `src/streaming_asr_tests.rs` | rule3 默认断言 8s（旧值）——默认值定案后未同步 | 全量回归红 1 例 | 断言更新为 12s 并注释裁决依据 |
14+
15+
## 二、六维检查明细
16+
17+
**接入性 — 通过**：eval_* 四模块 lib.rs pub 注册且 bin 全量消费（无新增未调用）；`dtw_align` pub 导出仅 harness/bin 使用（crate 内另有原测试消费）；`asr_eval`/`asr_eval_session`/`asr_eval_stream` Cargo [[bin]] 声明 + autobins=false（防辅助模块误识别）；preheat title 参数后端声明与前端 invoke 及测试三方一致；commands_* 无重复注册。
18+
19+
**逻辑性 — 见问题 1/2**（修复后复核）：其余检查通过——`correct_drift_if_any` 门槛（段数/带内/带外拒动）与 harness 会话信道同口径；streaming 档端点命中重建流、尾部 flush 收尾与生产 handle_endpoint 语义一致；排空单测覆盖"积压逐条 Err 清空 + 空队列 no-op"；参数档案缺省字段/坏文件/缺失文件均回落默认；session 过滤/属主、wav 缺失跳过路径均无悬空分支。
20+
21+
**牵连性 — 通过（含 1 项外部观察）**：rule3 默认 8→12s 属受控默认变更（文档+断言同步，配置零迁移可回退）；dtw 校正仅作用于融合入口且无字幕短路不变；既有 2149→2159 用例无意外破坏。**观察**：工作区存在并行 WIP（asr_pass2/v0.20.2 线，未入库）——其失败用例非本批回归，待并行线入库后终跑全量。
22+
23+
**性能与流畅度 — 见问题 1**：其余通过——画像 2000 字护栏、SRT/样本 IO 线性、配置加载仅装配期两次、drain/心跳无新增热点；前端仅 invoke 参数扩展（零渲染成本）。
24+
25+
**冗余与死代码 — 通过**：eval_report::render_table 现无 bin 调用但有单测覆盖（工具层通用渲染，保留理由注明）；无未用变量/导入/死分支（clippy 全目标零新增告警）；新常量均有消费。
26+
27+
**开发提交规范 — 通过（见问题 3 豁免登记）**：Conventional Commits、原子提交、@ai-context 注释齐全、类型安全（无 any/无裸 unwrap 新增——live_keyframes 处 clippy 指正已改 let-else）；前端变更同步 vitest。
28+
29+
**安全性 — 通过**：无新增 IPC 面（preheat title 为既有命令参数扩展，输出经候选函数限量）；SQL 全参数化（params!）；无硬编码密钥/凭证；下载走既有 hf-mirror HTTPS + 断点/原子改名脚本；文件读写限用户指定样本/输出目录与数据目录。
30+
31+
## 三、修复与验证
32+
33+
- 修复提交：`152cf56`（CER 护栏+SRT 块隔离+进度换行）；断言/豁免同步见 v0.20.md
34+
- 验证：eval_ 28/28、cer 11/11（含新护栏测）、`cargo build --bin asr_eval` 通过、clippy 零新增；v0.20.0/0.20.1 交付时点全量 2159 绿（并行 WIP 入库后复跑）

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

Lines changed: 69 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,69 @@
1+
# 技术债清单（权威：2026-09-06）
2+
3+
> 本清单为当前唯一权威债务清单，归档日滚动更新；旧归档清单仅历史追溯。
4+
> 来源：2026-09-06（自 2026-09-05 滚动核验——未偿表 10 笔逐条核对：无新偿还条件发生（closed 行状态/哈希不变），无新增债务；v0.20.0/0.20.1 交付后新增代码六维审查即修不立债，见文末「2026-09-06」节）。
5+
6+
## 未偿债务
7+
8+
| ID | 摘要 | 类型 | 优先级 | 来源归档 | 状态 |
9+
|----|------|------|--------|----------|------|
10+
| TD-040 | bundle.resources 未含 ffmpeg（deliberate 有意不修：体积权衡） | 有意 | P2 | 2026-08-18 | carried |
11+
| TD-2026-08-19-D | image_stream_store 已交付未接线（REQ-110/123/088）——lib.rs 仅 mod 声明，接线条件未发生 | 有意 | P2 | 2026-08-19 | carried |
12+
| TD-2026-08-24-A | lib.rs 超 600 硬限——实测 872（v0.19.3 模块/命令再 +5）；generate_handler 单点展开不可拆，拆分计划维持顺延 | 有意 | P1 | 2026-08-24 | carried |
13+
| TD-2026-08-30-A | ClassroomPage 超 600 硬限——实测 745；拆分计划（LiveCaptureCard）未启动 | 有意 | P1 | 2026-08-30 | carried |
14+
| TD-2026-08-30-B | note_filter 预存失败 2 笔（session29_live_ui_excluded_from_points / ocr_points_exclude_watermark_junk_and_dupes）——受限会话无法复跑全量；**2026-09-05 closed（3f6413e）**：根因=v0.12.0 正文源多态后无 asr 纯块输入走 OcrDirect（ocr_points 恒空/净化链极简），golden 断言的是旧视频路径语义——补占位 asr 段激活视频路径，全部断言天然满足；全量 2149 绿 | 预存 | P2 | 2026-08-30 | closed（3f6413e） |
15+
| TD-2026-08-31-A | BrowserChrome 对 contenteditable 右键无应用内文本菜单——当前应用无该编辑面 | 有意 | P3 | 2026-08-31 | carried |
16+
| TD-2026-08-31-B | window.prompt/confirm/alert 替换为应用内对话框——余 13 处未决 | 有意 | P2 | 2026-08-31 | carried |
17+
| TD-2026-08-31-C | App.css 从未被引入（死样式）——引入改全局暗色观感，需单独裁决 | 环境变化 | P3 | 2026-08-31 | carried |
18+
| TD-2026-09-05-A | 挂体系空体系「去建体系」引导按钮未交付（spec §2.5-4/需求池文本要求按钮跳体系页向导）——组件无跨页跳转通道；当前为空态提示文案 | 有意 | P3 | 2026-09-05 | closed（6b8f365） |
19+
| TD-2026-09-05-B | 模型 disciplines 入参三形态契约漂移：Rust `disciplines:String`（JSON 数组字符串）vs knowledge.ts `string[]` vs 存量两调用点传数组（KnowledgeModelDialog/KnowledgeDetailPanel）——本批新路径已按 JSON 字符串修正，存量待统一 | 无意 | P3 | 2026-09-05 | closed（14e3988） |
20+
21+
## 今日审查即修（不立债，四批提交）
22+
23+
审查基准 `4c7dad0^..HEAD(a3a7b781)`，四区并行（A 捕获/会话 · B AI 精修 · C 笔记列表 · D 挂体系/元数据），修复提交：
24+
25+
1. **`e59c413`（B 批）**：流式 [DONE] 收尾校验（断流=失败回退非流式，禁止静默截断当成功）；流式拍去除 response_format（与 NDJSON 多值/stream 并存冲突）；整包 JSON 零成本回退兑现（compact/pretty 数组均可解析，免重发）；预算最坏档余量 16k→18k；授权文案按画面理解生效态条件化（不再误称"图像永不出本机"）
26+
2. **`fa1647a`（A 批）**：主路径 tick 对称处理 Resume（清 auto_paused——修"手动暂停被误当自动暂停并自动解除"）；暂停期 watchdog 探针（防 WGC 失活致永久卡自动暂停）；OCR 暂停边沿去重守卫（pause 已置时不重复记账/emit）；误停阈值 SUSPECT_AFTER_TICKS 1→2（静音静止 2~4s 不再误停，真机标定前保守）；live:resumed 清除媒体徽标
27+
3. **`7569871`（C 批）**：note_orders 孤儿行清理钩子（delete/move 命令 purge）+ scope 从属校验（save 前整体校验拒绝陈旧序）；折叠组行剔除区间/划选可见序；跨组行落点"先归组后落位+无锁防互覆"；平铺态（搜索/标签/非默认排序）禁排序拖拽守卫；划选监听泄漏修复（rAF 节流+pointercancel/blur/松开清理）；anchor 语义（普通单击清选集并设锚/无锚 Shift=单选设锚）；INTEGER 参数类型化直绑
28+
4. **`553e95a`（D 批）**：模型轻建 disciplines 改 JSON 数组字符串（原裸串必败）；Enter=有命中选首项/零命中新建 + IME isComposing 守卫；轻建与切体系代际守卫（防旧代覆盖）
29+
5. **`f15320d8`（元数据纠偏）**：requirements-pool REQ-281/282/285 状态收口"已实施 v0.19.6"；v0.19.6 版本文档范围表状态同步；豁免登记行数纠偏（ai_refine_protocol 撤登 340→295≤300；NoteListView 525→524；NoteLinkToSystem 314→325）
30+
31+
## 技术债修复登记（2026-09-05 二轮，用户指令"技术债修复"）
32+
33+
- **TD-2026-09-05-A closed（6b8f365）**：空体系引导「去体系页创建（向导）」——App 增 createSystemSignal 递增信号 + KnowledgePage 消费开向导 + NotesPage/NoteLinkToSystem 链路贯通；空体系测试补引导按钮断言
34+
- **TD-2026-09-05-B closed（14e3988）**：模型 disciplines 三形态统一——KnowledgeModelDialog/KnowledgeDetailPanel 均改 JSON.stringify（Rust String=JSON 数组字符串契约）；挂体系轻建路径此前已按同范式修正
35+
- **观察 2026-09-05-2 closed 核心项（b9571ccc）**：SSE 读取内核 read_sse_lines 收敛 + ndjson_feed 行缓冲纯函数（feed/flush）与 3 单测，adapter 闭包改调纯函数
36+
- **观察 2026-09-05-1/3 closed（bb24e84）**：暂停期声通道边界如实化文档；轨迹 system 注释如实化
37+
- **观察 2026-09-05-6 部分（bb24e84）**：recent_session_titles 加 LIMIT 200；其余整理项随后续批
38+
- **观察 2026-09-05-4/5 carried**：审计/预估 vision 维度、批量移动串行与双 IPC——未实施，随后续性能与审计批评估
39+
40+
## 审查观察项（登记不立债）
41+
42+
| ID | 摘要 | 处置 |
43+
|----|------|------|
44+
| 观察 2026-09-05-1（A-F2） | 暂停期 audio_loopback 端点停采 → media_sound 槽冻结，auto 轮询的“声画任一恢复”实际只剩画面通道 | 已处理（bb24e84 边界如实化入 media_state 文档）；低占空采样仍为后续候选 |
45+
| 观察 2026-09-05-2（B-B10） | 流式行缓冲无单测；SSE 循环双实现 | 核心项已处理（b9571ccc：read_sse_lines 内核 + ndjson_feed 3 单测）；stream_chat 切换共用内核价值低——余项接受 |
46+
| 观察 2026-09-05-3（B-B7） | 轨迹 AiTurn.system 记基座（缺动态段）；response 为重组 JSON | 已处理（bb24e84 注释如实化） |
47+
| 观察 2026-09-05-4（B-B12） | 任务审计/AiRefineResult 无 vision 覆写标记；ai_refine_estimate 不含 vision 维度（开关切换预估费用不变） | 登记后续：审计补 vision 标记、预估随 effectiveVision 重算 |
48+
| 观察 2026-09-05-5（C-L10） | 批量移动串行 await N 次 invoke 无进度；每次 saveOrder 全量重拉 | 登记后续：并行/进度与局部刷新（量级小暂缓） |
49+
| 观察 2026-09-05-6（A-F6/提示） | live:frame-heartbeat 无前端消费（保留=诊断）；recent_session_titles 无 LIMIT；title_rules TITLE_MAX_CHARS=40 与 commands.rs 同名值 100；import 标题未 normalize 与实时入口不一致 | 部分处理（bb24e84：recent_session_titles LIMIT 200）；heartbeat 前端无消费=诊断保留、TITLE_MAX_CHARS 同名异值、import normalize 对齐——仍待整理批 |
50+
| 观察（继承 09-04B） | 事件名跨语言契约无机器校验 / kb_chunk 超窗尾段不入向量 / 本地写+总线双刷 / dock 无组件测试 / 播放中真检测 / 设置页技术串与模型下载进度 | 延续 |
51+
52+
## 验证记录
53+
54+
- Rust：`cargo check --all-targets` 干净；clippy 终检 exit 0（受限会话无法启动 Rust 测试二进制——单测随文件入库，常规终端/CI 补跑，口径同 v0.19.6 文档）
55+
- 前端：vitest 全量绿（修复后复跑）；`tsc --noEmit` 零错误
56+
- 提交：审查即修四批 + 元数据纠偏（见上表）
57+
58+
## 关联
59+
60+
- 版本与需求：[v0.19.6 版本文档](../../versions/v0.19.6.md) · [v0.19.7 版本文档](../../versions/v0.19.7.md)（REQ-281~291 交付记录与真机验收待办）· [v0.20 版本文档](../../versions/v0.20.md)（v0.20.0/0.20.1 已交付；v0.20.2~4 待实施）
61+
- 活跃设计：[v0.19 反馈批设计](../../superpowers/specs/2026-09-05-v0.19-feedback-batch-design.md)（v0.19.8 余项仍活跃）· [目标执行智能体设计](../../superpowers/specs/2026-09-05-goal-execution-agent-design.md)（v0.21 未实施）
62+
- 归档快照：[2026-09-05 README](./README.md)（同日快照位于 [2026-09-05](../2026-09-05/README.md)）
63+
64+
## 2026-09-06 节（v0.20.0/0.20.1 交付后六维审查）
65+
66+
- **未偿表滚动**：10 笔逐条核验——closed 3 笔（TD-2026-08-30-B/2026-09-05-A/B，哈希不变）、carried 7 笔（无偿还条件发生）；**无新增债**（审查问题全部即修，不立债）
67+
- **审查即修（152cf56）**：CER 超长护栏（>20k 字 → None 诚实不可比，O(n×m) 时间成本防线）；SRT 跨块同号文本误并修复（块内累积一次性推入）；asr_eval 进度输出换行；豁免登记 bin/asr_eval.rs 386 行（300-600 档，见 v0.20.md 交付记录）
68+
- **观察（不立债）**：并行工作区 WIP（asr_pass2/v0.20.2 线，未入库）致全量回归暂含其失败用例——归并行线，非本批回归；harness 流式档无重打分（近似口径已文档化，慢速档回放待真机集成验证）
69+
- **验证记录**：目标测试全绿（eval_ 28/28、cer 11/11）；`cargo build --bin asr_eval` 通过；clippy 本批零新增告警；全量回归待并行 WIP 入库后终跑（口径：v0.20.0/0.20.1 已交付时点 2159 绿）

‎docs/archive/README.md‎

Lines changed: 2 additions & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -1,4 +1,4 @@
1-
# 文档归档机制
1+
# 文档归档机制
22

33
> 唯一权威入口：归档判定标准、日收工 SOP、技术债滚动规则、只读约束。
44
> 关联：[文档编写规范](../standards/documentation.md)、[技术债务管理](../standards/tech-debt.md)、[归档模板](../templates/archive-template.md)。
@@ -109,3 +109,4 @@ docs/archive/
109109
| 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 项 |
110110
| 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 项 |
111111
| 2026-09-04（二轮） | v0.19.4/5 全量实施 16 提交（REQ-274~279 + REQ-259/262，见 [versions/v0.19.4](../../versions/v0.19.4.md)·[v0.19.5](../../versions/v0.19.5.md)）+ 四区并行审查（无高）即修 30+ 项：Rust 批 653e8b3（采纳守卫前置×3/组结算与写端补广播/reindex 清 embedding meta 三键/回填分批 512/下载幂等·长度校验/语义合流降级防击穿/纯语义空词法路径/陈旧注释与 ndarray 直依清理）＋FE 批 8a4a104（15 项：采纳详情回写/dock 任务事件实时/loadSeq 竞态/中性占位/targetKind 分流/毕业档案总线/懒加载时效/unmount rAF 清理/裸号两处与 500 上限/引擎段拆分+契约归位/下载后状态刷新）＋锁净化 56aa05b；Rust 2083/2 预存（TD-30-B）+ clippy 0 + vitest 551/551 + tsc 0；无文档入夹（versions/ 不归档类；v0.19 检索规格已于 09-03 归档）；观察 2026-09-04B-1~6 登记 | 晨档 8 笔 carried 不变（二轮滚动段并入当日 tech-debt），共 8 笔 |
112+
| 2026-09-06 | v0.20.0/0.20.1 ASR 批交付收口（REQ-263~267：harness 全链路 + DTW 生产接线 + 参数档案化与 rule3=12s 首轮标定 + 热词/标题注入 + 排空补测；全量 2159 绿时点）+ 新增代码六维审查即修 4 项（152cf56：CER 超长护栏/SRT 跨块合并/进度换行/断言同步——[审查报告](./2026-09-06/asr-v020-review.md) 入夹）+ 技术债滚动（[2026-09-06 清单](./2026-09-06/tech-debt.md)：closed 3 哈希不变 / carried 7 / 无新增债）+ 回归修复批（TD-2026-08-30-B closed 3f6413e 等，9 例既有失败清零）；无活跃文档入夹（versions/Foresight 按机制常驻或仍活跃） | TD-040 + TD-19-D/24-A/30-A/31-A/B/C + 30-B/09-05-A/B（closed）——carried 7 + closed 3，无新增 |

0 commit comments

Comments
 (0)