|
1 | | -# 技术债清单(权威:2026-08-21 二轮归档滚动——AI 精修全链路建设 F0~F3 + 新增代码审查批次后) |
| 1 | +# 鎶€鏈€烘竻鍗曪紙鏉冨▉锛?026-08-21 浜岃疆褰掓。婊氬姩鈥斺€擜I 绮句慨鍏ㄩ摼璺缓璁?F0~F3 + 鏂板浠g爜瀹℃煡鎵规鍚庯級 |
2 | 2 |
|
3 | | -> 本清单为当前唯一权威债务清单,归档日滚动更新;旧归档清单仅历史追溯。 |
4 | | -> 来源:2026-08-21 首轮清单滚动 + 本次会话 AI 精修全链路代码建设 |
5 | | -> (F0 契约修复 `1845462` · F1-A2 丢图 `897ee96` · F1-A3 成本 `ba9e618` · F1-A4/A5 审计配额 `b6ad051` |
6 | | -> · F2-B1/B2 任务中心 `f06fd7f` · F2-B3 面板 `6e72c5d` · F2-B4 并发 `afca35f` |
7 | | -> · F3-C 协议 v2 `7f575cd` · F3-D 硬拦截 `790f964` · F3-E golden `b75db82`,1294 单测全绿) |
8 | | -> + 新增代码七维审查即修批次(提交 `564dfc5`,1294 单测全绿 + 前端 tsc/build 通过)。 |
| 3 | +> 鏈竻鍗曚负褰撳墠鍞竴鏉冨▉鍊哄姟娓呭崟锛屽綊妗f棩婊氬姩鏇存柊锛涙棫褰掓。娓呭崟浠呭巻鍙茶拷婧€?> 鏉ユ簮锛?026-08-21 棣栬疆娓呭崟婊氬姩 + 鏈浼氳瘽 AI 绮句慨鍏ㄩ摼璺唬鐮佸缓璁?> 锛團0 濂戠害淇 `1845462` 路 F1-A2 涓㈠浘 `897ee96` 路 F1-A3 鎴愭湰 `ba9e618` 路 F1-A4/A5 瀹¤閰嶉 `b6ad051` |
| 4 | +> 路 F2-B1/B2 浠诲姟涓績 `f06fd7f` 路 F2-B3 闈㈡澘 `6e72c5d` 路 F2-B4 骞跺彂 `afca35f` |
| 5 | +> 路 F3-C 鍗忚 v2 `7f575cd` 路 F3-D 纭嫤鎴?`790f964` 路 F3-E golden `b75db82`锛?294 鍗曟祴鍏ㄧ豢锛?> + 鏂板浠g爜涓冪淮瀹℃煡鍗充慨鎵规锛堟彁浜?`564dfc5`锛?294 鍗曟祴鍏ㄧ豢 + 鍓嶇 tsc/build 閫氳繃锛夈€? |
| 6 | +## 鏈伩鍊哄姟锛堥€愮瑪鏍搁獙锛沜arried 浠呯暀 ID + 涓€琛屾憳瑕侊級 |
9 | 7 |
|
10 | | -## 未偿债务(逐笔核验;carried 仅留 ID + 一行摘要) |
11 | | - |
12 | | -| ID | 摘要 | |
| 8 | +| ID | 鎽樿 | |
13 | 9 | |----|------| |
14 | | -| TD-040 | bundle.resources 未含 ffmpeg(deliberate 有意不修:体积权衡,开发期脚本+PATH 覆盖);本次未涉及,保持 | |
15 | | -| TD-2026-08-19-D | image_stream_store 已交付未接线(REQ-110/123/088);本次未涉及,保持 | |
16 | | -| TD-2026-08-19-F | detect_pause_icon 暗底+中央亮内容可能误报暂停;本次未涉及,保持 | |
17 | | -| TD-2026-08-19-G | db_ocr_search 500 会话静默截断 + 图路径不校验存在性;本次未涉及,保持 | |
18 | | -| TD-2026-08-21-A | 存量 clippy 告警 9 个(live_session_persist ×8 + series_detect ×1)——本次未改动文件,环境版本漂移所致;本次新增代码 clippy 已清零(审查确认),保持 | |
19 | | - |
20 | | -## 今日已偿(本次新增代码七维审查即修,可经代码/提交验证;提交 `564dfc5`) |
21 | | - |
22 | | -| ID | 摘要 | 偿还方式 | |
| 10 | +| TD-040 | bundle.resources 鏈惈 ffmpeg锛坉eliberate 鏈夋剰涓嶄慨锛氫綋绉潈琛★紝寮€鍙戞湡鑴氭湰+PATH 瑕嗙洊锛夛紱鏈鏈秹鍙婏紝淇濇寔 | |
| 11 | +| TD-2026-08-19-D | image_stream_store 宸蹭氦浠樻湭鎺ョ嚎锛圧EQ-110/123/088锛夛紱鏈鏈秹鍙婏紝淇濇寔 | |
| 12 | +| TD-2026-08-19-F | detect_pause_icon 鏆楀簳+涓ぎ浜唴瀹瑰彲鑳借鎶ユ殏鍋滐紱鏈鏈秹鍙婏紝淇濇寔 | |
| 13 | +| TD-2026-08-19-G | db_ocr_search 500 浼氳瘽闈欓粯鎴柇 + 鍥捐矾寰勪笉鏍¢獙瀛樺湪鎬э紱鏈鏈秹鍙婏紝淇濇寔 | |
| 14 | +| TD-2026-08-21-A | 瀛橀噺 clippy 鍛婅 9 涓紙live_session_persist 脳8 + series_detect 脳1锛夆€斺€旀湰娆℃湭鏀瑰姩鏂囦欢锛岀幆澧冪増鏈紓绉绘墍鑷达紱鏈鏂板浠g爜 clippy 宸叉竻闆讹紙瀹℃煡纭锛夛紝淇濇寔 | |
| 15 | + |
| 16 | +## 浠婃棩宸插伩锛堟湰娆℃柊澧炰唬鐮佷竷缁村鏌ュ嵆淇紝鍙粡浠g爜/鎻愪氦楠岃瘉锛涙彁浜?`564dfc5`锛? |
| 17 | +| ID | 鎽樿 | 鍋胯繕鏂瑰紡 | |
23 | 18 | |----|------|----------| |
24 | | -| (审查 P0-1) | 任务去重粒度过粗:`tasks.values().any(进行中)` 全表检查——会话 A 精修中时会话 B 精修/任意笔记补充被误拒 | `AiTaskEntry` 增 `target_id`,去重按目标粒度(精修=session、补充=note);refine/enrich 同步 + 恢复路径补字段 | |
25 | | -| (审查 P0-2) | 成本拦截与配额消耗顺序错误:先扣配额后拦余额——余额不足被拒时配额已扣(浪费每日额度) | 顺序调整:先 `ensure_balance_for`(失败不扣配额),后消耗配额;enrich 同步 | |
26 | | -| (审查 P1-1) | 采纳无幂等:adopted 标记只在落库后写,异常/重复调用可绕过前端反复建笔记 | 服务端 `is_ai_task_adopted` 前置校验(refine/enrich apply)+ 前端 adopted 任务禁用查看/采纳 + DB 单测 | |
27 | | -| (审查 P1-2) | 落库成本失真残留:`usage_cost` 用旧默认单价(¥0),付费模型预估 ¥X 但落库记 ¥0 | 新增 `usage_cost_for_model`(模型感知单价与预估同口径),refine/enrich apply 改用 + 单测 | |
28 | | -| (审查 P1-3) | 补充任务无单片重试(精修有 SLICE_RETRY)——网络瞬态失败整任务失败浪费已成功片 | run_enrich_task 单片重试 1 次(与精修对齐) | |
29 | | -| (审查 P1-4) | 任务表运行期不裁剪:`trim_ai_tasks` 仅启动时跑,终态任务运行期无限累积 | 精修/补充任务终态落库后调用 `trim_ai_tasks`(保留策略生效) | |
30 | | -| (审查 P1-5) | AiTaskPanel 用 `any` 类型(违反强类型契约);AiRefineResult 前端类型缺 `failedSlices` | 改类型收窄(AiRefineResult/AiEnrichResult 分支);types.ts 补 failedSlices | |
31 | | -| (审查 P2-1) | App.tsx toast 计时器未清理(每事件新起 timer,卸载后残留空转) | toastTimer ref 持有 + 卸载/新事件清理 | |
32 | | -| (审查 P2-2) | 前端未展示部分成功(failedSlices > 0 无提示) | AiRefineCard done 状态显示「部分成功 x/y 片」 | |
33 | | - |
34 | | -## 今日新登记 open |
35 | | - |
36 | | -| ID | 摘要 | 类型 | |
| 19 | +| 锛堝鏌?P0-1锛?| 浠诲姟鍘婚噸绮掑害杩囩矖锛歚tasks.values().any(杩涜涓?` 鍏ㄨ〃妫€鏌モ€斺€斾細璇?A 绮句慨涓椂浼氳瘽 B 绮句慨/浠绘剰绗旇琛ュ厖琚鎷?| `AiTaskEntry` 澧?`target_id`锛屽幓閲嶆寜鐩爣绮掑害锛堢簿淇?session銆佽ˉ鍏?note锛夛紱refine/enrich 鍚屾 + 鎭㈠璺緞琛ュ瓧娈?| |
| 20 | +| 锛堝鏌?P0-2锛?| 鎴愭湰鎷︽埅涓庨厤棰濇秷鑰楅『搴忛敊璇細鍏堟墸閰嶉鍚庢嫤浣欓鈥斺€斾綑棰濅笉瓒宠鎷掓椂閰嶉宸叉墸锛堟氮璐规瘡鏃ラ搴︼級 | 椤哄簭璋冩暣锛氬厛 `ensure_balance_for`锛堝け璐ヤ笉鎵i厤棰濓級锛屽悗娑堣€楅厤棰濓紱enrich 鍚屾 | |
| 21 | +| 锛堝鏌?P1-1锛?| 閲囩撼鏃犲箓绛夛細adopted 鏍囪鍙湪钀藉簱鍚庡啓锛屽紓甯?閲嶅璋冪敤鍙粫杩囧墠绔弽澶嶅缓绗旇 | 鏈嶅姟绔?`is_ai_task_adopted` 鍓嶇疆鏍¢獙锛坮efine/enrich apply锛? 鍓嶇 adopted 浠诲姟绂佺敤鏌ョ湅/閲囩撼 + DB 鍗曟祴 | |
| 22 | +| 锛堝鏌?P1-2锛?| 钀藉簱鎴愭湰澶辩湡娈嬬暀锛歚usage_cost` 鐢ㄦ棫榛樿鍗曚环锛埪?锛夛紝浠樿垂妯″瀷棰勪及 楼X 浣嗚惤搴撹 楼0 | 鏂板 `usage_cost_for_model`锛堟ā鍨嬫劅鐭ュ崟浠蜂笌棰勪及鍚屽彛寰勶級锛宺efine/enrich apply 鏀圭敤 + 鍗曟祴 | |
| 23 | +| 锛堝鏌?P1-3锛?| 琛ュ厖浠诲姟鏃犲崟鐗囬噸璇曪紙绮句慨鏈?SLICE_RETRY锛夆€斺€旂綉缁滅灛鎬佸け璐ユ暣浠诲姟澶辫触娴垂宸叉垚鍔熺墖 | run_enrich_task 鍗曠墖閲嶈瘯 1 娆★紙涓庣簿淇榻愶級 | |
| 24 | +| 锛堝鏌?P1-4锛?| 浠诲姟琛ㄨ繍琛屾湡涓嶈鍓細`trim_ai_tasks` 浠呭惎鍔ㄦ椂璺戯紝缁堟€佷换鍔¤繍琛屾湡鏃犻檺绱Н | 绮句慨/琛ュ厖浠诲姟缁堟€佽惤搴撳悗璋冪敤 `trim_ai_tasks`锛堜繚鐣欑瓥鐣ョ敓鏁堬級 | |
| 25 | +| 锛堝鏌?P1-5锛?| AiTaskPanel 鐢?`any` 绫诲瀷锛堣繚鍙嶅己绫诲瀷濂戠害锛夛紱AiRefineResult 鍓嶇绫诲瀷缂?`failedSlices` | 鏀圭被鍨嬫敹绐勶紙AiRefineResult/AiEnrichResult 鍒嗘敮锛夛紱types.ts 琛?failedSlices | |
| 26 | +| 锛堝鏌?P2-1锛?| App.tsx toast 璁℃椂鍣ㄦ湭娓呯悊锛堟瘡浜嬩欢鏂拌捣 timer锛屽嵏杞藉悗娈嬬暀绌鸿浆锛?| toastTimer ref 鎸佹湁 + 鍗歌浇/鏂颁簨浠舵竻鐞?| |
| 27 | +| 锛堝鏌?P2-2锛?| 鍓嶇鏈睍绀洪儴鍒嗘垚鍔燂紙failedSlices > 0 鏃犳彁绀猴級 | AiRefineCard done 鐘舵€佹樉绀恒€岄儴鍒嗘垚鍔?x/y 鐗囥€?| |
| 28 | + |
| 29 | +## 浠婃棩鏂扮櫥璁?open |
| 30 | + |
| 31 | +| ID | 鎽樿 | 绫诲瀷 | |
37 | 32 | |----|------|------| |
38 | | -| (无) | 本次新增代码七维审查:接入性/逻辑性/牵连性/性能/冗余/规范/安全全部通过或即修;无遗留 open | — | |
39 | | - |
40 | | -## 观察项(登记不立债,保持跟踪) |
| 33 | +| 锛堟棤锛?| 鏈鏂板浠g爜涓冪淮瀹℃煡锛氭帴鍏ユ€?閫昏緫鎬?鐗佃繛鎬?鎬ц兘/鍐椾綑/瑙勮寖/瀹夊叏鍏ㄩ儴閫氳繃鎴栧嵆淇紱鏃犻仐鐣?open | 鈥?| |
41 | 34 |
|
42 | | -| ID | 摘要 | 处置 | |
| 35 | +## 瑙傚療椤癸紙鐧昏涓嶇珛鍊猴紝淇濇寔璺熻釜锛? |
| 36 | +| ID | 鎽樿 | 澶勭疆 | |
43 | 37 | |----|------|------| |
44 | | -| (观察 A1) | ai_enrich_protocol B6 无链接校验用宽松 contains_url——含 "www" 的普通文本会被误拒 | B6 语义=仅标题不输出链接,宽松匹配已够;保持跟踪 | |
45 | | -| (观察 A2) | AiRefineCard/EnrichPanel 事件监听 useEffect 依赖数组未含 handleState(eslint exhaustive-deps 会提示) | 运行时无碍(taskId 变化时监听与回调同步重建);保持跟踪 | |
46 | | -| (观察 A3) | ai_refine_apply 两步落库(建基线笔记 + versioned_save 精修版)——中途失败留下只有基线快照的笔记 | 单机应用可接受;M5 端到端验收时实测 | |
47 | | -| (观察 1~8 继承) | 2026-08-20 清单观察 8 条(clone 拷贝/结构渲染白算/前端统计卡/AGENTS.md Silero 表述/说话人卡片入口/首启下载/双版面/词级时间戳) | 保持跟踪 | |
| 38 | +| 锛堣瀵?A1锛?| ai_enrich_protocol B6 鏃犻摼鎺ユ牎楠岀敤瀹芥澗 contains_url鈥斺€斿惈 "www" 鐨勬櫘閫氭枃鏈細琚鎷?| B6 璇箟=浠呮爣棰樹笉杈撳嚭閾炬帴锛屽鏉惧尮閰嶅凡澶燂紱淇濇寔璺熻釜 | |
| 39 | +| 锛堣瀵?A2锛?| AiRefineCard/EnrichPanel 浜嬩欢鐩戝惉 useEffect 渚濊禆鏁扮粍鏈惈 handleState锛坋slint exhaustive-deps 浼氭彁绀猴級 | 杩愯鏃舵棤纰嶏紙taskId 鍙樺寲鏃剁洃鍚笌鍥炶皟鍚屾閲嶅缓锛夛紱淇濇寔璺熻釜 | |
| 40 | +| 锛堣瀵?A3锛?| ai_refine_apply 涓ゆ钀藉簱锛堝缓鍩虹嚎绗旇 + versioned_save 绮句慨鐗堬級鈥斺€斾腑閫斿け璐ョ暀涓嬪彧鏈夊熀绾垮揩鐓х殑绗旇 | 鍗曟満搴旂敤鍙帴鍙楋紱M5 绔埌绔獙鏀舵椂瀹炴祴 | |
| 41 | +| 锛堣瀵?1~8 缁ф壙锛?| 2026-08-20 娓呭崟瑙傚療 8 鏉★紙clone 鎷疯礉/缁撴瀯娓叉煋鐧界畻/鍓嶇缁熻鍗?AGENTS.md Silero 琛ㄨ堪/璇磋瘽浜哄崱鐗囧叆鍙?棣栧惎涓嬭浇/鍙岀増闈?璇嶇骇鏃堕棿鎴筹級 | 淇濇寔璺熻釜 | |
48 | 42 |
|
49 | | -## 本批滚动(2026-08-21 第三轮:设置页重构 + 任务 4 基建 + 框架 v2 定稿) |
| 43 | +## 鏈壒婊氬姩锛?026-08-21 绗笁杞細璁剧疆椤甸噸鏋?+ 浠诲姟 4 鍩哄缓 + 妗嗘灦 v2 瀹氱锛? |
| 44 | +- **鏈伩 5 绗斾繚鎸?carried**锛圱D-040 / TD-2026-08-19-D/F/G / TD-2026-08-21-A锛夛細鏈壒涓哄墠绔?UI 杩佺Щ锛堣缃〉锛屾彁浜?`6720bec`锛? 浠撳簱鍩哄缓閫傞厤锛堜换鍔?4锛夛紝鏈秹鍙?Rust 閫昏緫锛岄€愮瑪鏍搁獙鏃犲彉鍖?- **宸插伩 0 绗旀柊澧?* / **鏂扮櫥璁?open 0 绗?*锛氭棤 Rust 鏀瑰姩锛屾棤鏂板€哄姟 |
50 | 45 |
|
51 | | -- **未偿 5 笔保持 carried**(TD-040 / TD-2026-08-19-D/F/G / TD-2026-08-21-A):本批为前端 UI 迁移(设置页,提交 `6720bec`)+ 仓库基建适配(任务 4),未涉及 Rust 逻辑,逐笔核验无变化 |
52 | | -- **已偿 0 笔新增** / **新登记 open 0 笔**:无 Rust 改动,无新债务 |
| 46 | +## 鍏宠仈 |
53 | 47 |
|
54 | | -## 关联 |
| 48 | +- 鐗堟湰涓庨渶姹傦細[v0.8.0 鐗堟湰鏂囨。](../../versions/v0.8.0.md)锛圡1~M4 宸蹭氦浠?+ AI 绮句慨闈炲姛鑳芥墿灞?F0~F3 宸蹭氦浠橈紝M0/M5 寰呮帹杩涳級路 [闇€姹傛睜 REQ-138~147](../../product/requirements-pool.md) |
| 49 | +- 璁捐鏂囨。锛歔AI 绮句慨闈炲姛鑳芥墿灞曡璁★紙[ ] 宸插綊妗o紝鏈棩褰掓。锛塢(brainstorming-ai-refine-nonfunctional-rebuild.md) |
| 50 | +- 鍐崇瓥锛歔ADR-016锛圓I 瀵嗛挜 DPAPI 瀛樺偍锛塢(../../adr/ADR-016-ai-credentials-dpapi.md)锛堝綋鍓嶇敓鏁堬級 |
| 51 | +- 鎻愪氦閾撅細F0 `1845462` 路 F1 `897ee96`/`ba9e618`/`b6ad051` 路 F2 `f06fd7f`/`6e72c5d`/`afca35f` 路 F3 `7f575cd`/`790f964`/`b75db82` 路 瀹℃煡淇 `564dfc5` 路 璁剧疆椤?`6720bec` 路 浠诲姟 4 `158b3ff`~`d6af0af` |
| 52 | + |
| 53 | +## 鍥涜疆琛ュ厖锛坴0.9.0 鍥涚淮瑙h€︿唬鐮佸缓璁?M1~M5锛?026-08-21锛? |
| 54 | +> 鏉ユ簮锛歷0.9.0 浠g爜寤鸿锛圡1 鍥涚淮绫诲瀷/M2 鐢婚潰妫€娴?M3 棰嗗煙/M4 骞冲彴/M5 妫€娴嬪崱+鍙欎簨锛?> 鎻愪氦涓€瑙堬細video_profile_spec/commands_video/live_session_frame/artifact_templates/ProfileDetector 绛?30 涓枃浠跺彉鏇?> 楠岃瘉锛歝argo test 1352 鍏ㄧ豢 + clippy 闆惰鍛?+ 鍓嶇 tsc/build 閫氳繃 |
| 55 | +
|
| 56 | +### 浠婃棩宸插伩锛堟湰鎵规牳楠岋級 |
| 57 | + |
| 58 | +| ID | 鎽樿 | 鍋胯繕鏂瑰紡 | |
| 59 | +|----|------|----------| |
| 60 | +| TD-2026-08-21-A | 瀛橀噺 clippy 鍛婅 9 涓紙live_session_persist 脳8 + series_detect 脳1锛夆€斺€旂幆澧冪増鏈紓绉绘墍鑷?| v0.9.0 浠g爜寤鸿涓叏閮ㄦ竻鍋匡細live_session_persist 涓ゅ mut 鍐椾綑(鑷姩fix)+ series_detect EP 甯冨皵绠€鍖?manual fix)+ video_profile_domain 涓ゅ clone 浼樺寲(manual fix)锛沜lippy 闆惰鍛婃牳楠岄€氳繃 | |
55 | 61 |
|
56 | | -- 版本与需求:[v0.8.0 版本文档](../../versions/v0.8.0.md)(M1~M4 已交付 + AI 精修非功能扩展 F0~F3 已交付,M0/M5 待推进)· [需求池 REQ-138~147](../../product/requirements-pool.md) |
57 | | -- 设计文档:[AI 精修非功能扩展设计([ ] 已归档,本日归档)](brainstorming-ai-refine-nonfunctional-rebuild.md) |
58 | | -- 决策:[ADR-016(AI 密钥 DPAPI 存储)](../../adr/ADR-016-ai-credentials-dpapi.md)(当前生效) |
59 | | -- 提交链:F0 `1845462` · F1 `897ee96`/`ba9e618`/`b6ad051` · F2 `f06fd7f`/`6e72c5d`/`afca35f` · F3 `7f575cd`/`790f964`/`b75db82` · 审查修复 `564dfc5` · 设置页 `6720bec` · 任务 4 `158b3ff`~`d6af0af` |
|
0 commit comments