Skip to content

Commit 5aabc39

Browse files
committed
docs(archive): archive 2026-08-21
1 parent a1cbd1c commit 5aabc39

3 files changed

Lines changed: 48 additions & 0 deletions

File tree

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

Lines changed: 18 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -79,3 +79,21 @@
7979
- **新登记 open 0 笔**:审查发现 L2(区域构成信号暂缺)/L3(OCR 面积固定近似) 登记为观察项(M4 迭代),不登记正式债务
8080
- **未偿 5 笔保持**(TD-040 / TD-2026-08-19-D/F/G):本次未涉及 Rust 核心引擎/存储/UI,逐笔核验保持 carried
8181

82+
## 本批补充(第五轮:v0.10.1 编辑机制修复 + 笔记图片功能,2026-08-21)
83+
84+
**归档判定**:本批无文档归档——`docs/versions/v0.10.1.md` 为活跃版本规划(实施中);`docs/product/note-design-philosophy.md` / `product-design-philosophy.md` 为活跃产品理念文档(持续引用非实施文档);本次无已实施完成、不再活跃维护的新方案文档。
85+
86+
**工作摘要**:
87+
88+
- **0.10.1 规划定稿**(三轮探讨:编辑机制复杂度 / 浏览态价值 / 图片技术选型)→ `docs/versions/v0.10.1.md`
89+
- **编辑机制修复 F1~F5**:串写(切笔记退出编辑 + key 重建 + 卸载 dirty 自动保存)、`create_version` 参数接通(自动保存不建版本,恢复 v0.10.0 状态一致性规范)、版本内容去重、完成按钮改名 + ESC 退出、Ctrl+E handler ref 稳定化
90+
- **笔记图片功能**:`resolve_note_image`/`import_note_image`/`app_data_dir` 三命令(前缀白名单 + 归属校验 + 穿越防护 + 扩展名/大小限制)+ NoteImage 组件 + NotePreviewView 拼接修复(`session-images/` 前缀重复路径 v0.7.3 遗留疑点)+ 点击放大预览
91+
- 验证:新增 8 单测全绿;cargo test 1359 passed / 12 failed(既有断言过时 → TD-2026-08-21-B);clippy 新代码零警告;前端 tsc/build 通过
92+
93+
## 技术债摘录(本批滚动)
94+
95+
- **审查即修 3 项**:P0-1(NotePreviewView 图片 src 未转义 XSS 注入面 → escapeHtml 兜底)/ P2-1(async 按钮 void 包装)/ P2-2(indent 死代码),提交随 0.10.1 交付批次
96+
- **新登记 open 1 笔**:TD-2026-08-21-B(v0.10.0 时间戳锚点断言过时 12 项)
97+
- **未偿保持 4 笔**(TD-040 / TD-2026-08-19-D/F/G);TD-2026-08-21-A 保持已偿(四轮 close)
98+
- **观察项 +1**:卸载自动保存与在飞保存乱序(低概率,保持跟踪)
99+

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

Lines changed: 29 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -59,3 +59,32 @@
5959
|----|------|----------|
6060
| 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 闆惰鍛婃牳楠岄€氳繃 |
6161

62+
63+
## 五轮补充(v0.10.1 编辑机制修复 + 笔记图片功能建设,2026-08-21)
64+
> 来源:v0.10.1 规划文档(docs/versions/v0.10.1.md,三轮探讨定稿)+ 代码建设
65+
> 验证:cargo test 1359 passed / 12 failed(既有断言过时,见 TD-B)+ 新增 8 单测全绿 + clippy 新代码零警告 + 前端 tsc/build 通过
66+
67+
### 今日已偿(本批核验 + 审查即修)
68+
69+
| ID | 摘要 | 偿还方式 |
70+
|----|------|----------|
71+
| (审查 P0-1) | NotePreviewView 图片 src 未转义——http 直出分支把 markdown 内容拼进属性值(\\" onerror=\"\ 存储型 XSS 注入面,内容来自视频字幕不可信输入) | escapeHtml(src) 统一兜底(本次即修,提交随 0.10.1 交付批次) |
72+
| (审查 P2-1) | NoteEditView 工具栏 async 调用未 void 包装(eslint no-misused-promises 提交拦截风险) | 全部按钮统一 void 包装(本次即修) |
73+
| (审查 P2-2) | NoteEditView 拆分段 indent 变量两分支同值(死代码,v0.10.0 遗留) | 删除冗余变量(本次即修) |
74+
75+
### 新登记(open)
76+
77+
| ID | 摘要 | 类型 |
78+
|----|------|------|
79+
| TD-2026-08-21-B | v0.10.0 时间戳回链([[ts:...]] 锚点格式)引入后 concat/note_filter/structure_note 共 12 项断言未同步更新(cargo test 12 failed)——v0.10.0 交付遗留,建议随 v0.10.0 收尾更新断言 | 无意 |
80+
81+
### 观察项(登记不立债)
82+
83+
| ID | 摘要 | 处置 |
84+
|----|------|------|
85+
| (观察 0.10.1-1) | NoteEditView 卸载自动保存为 fire-and-forget invoke,可能与 30s 自动保存在飞的 invoke 乱序(同 id 两次保存后发先至 → 旧覆盖新) | 30s timer 卸载时已清理,碰撞窗口极小;SQLite 串行执行;保持跟踪 |
86+
87+
### 未偿核验(保持 carried)
88+
89+
TD-040(deliberate ffmpeg 体积权衡)· TD-2026-08-19-D/F/G(4 笔):本次未涉及,保持。
90+
TD-2026-08-21-A:四轮已 close(clippy 9 个清偿),本次核验保持已偿。

‎docs/archive/README.md‎

Lines changed: 1 addition & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -81,3 +81,4 @@ docs/archive/
8181
| 2026-08-20 | v0.7.2 课堂助手深化批次(REQ-148~154 四深化:三连体验/信息面板/合集联动/断句自适应/说话人分离弱化版,9097e8f~5159bee,1016 单测全绿)+ 新增代码七维审查五处即修(751b9c6:平台表单一来源/中文数字判定去重/暂停后语速基准重置/拆行标点过滤/讲者分析异步化+暂停态探测);本日无文档归档(Foresight 两份部分立项活跃、versions/使用说明/需求池均活跃);累计已偿 101 笔 | TD-040(carried)+ TD-2026-08-19-D~G(carried 4 笔),共 5 笔 |
8282
| 2026-08-20(二轮) | v0.7.5 净化批次(REQ-162~176,停止残留根治/净化链 12 项,0834b38~f2efab9)+ v0.7.6 纯本地结构渲染(REQ-177~181,974343b+4edb5db,1131 单测全绿):章节标题 + 词汇表入笔记 + 配置化 + 元数据 + v0.7.7 规划登记(REQ-182~187,843bfce);新增代码七维审查即修(4dbafdf+84c867f+fb40c1e:H1 AI 复核补结构渲染/H2 commands_session >600 硬拆/H2b 豁免登记同步/M1 词汇表 0 上限语义/M2 零回归补测/L1 死代码清理,1133 单测全绿);本日无新归档文档(v0.7.5/v0.7.6 规划实施均在 versions/ 持续活跃、v0.7.7 头脑风暴规划中);累计已偿 107 笔 | TD-040(carried)+ TD-D~G(carried 4 笔)+ TD-2026-08-20-A~C(open 3 笔),共 8 笔 |
8383
| 2026-08-21 | v0.8.0 M1~M4 代码建设(7818e90/12c5a13/fcd09c4/b4e7e79/4c44297,1264 单测全绿):AI 使能层/精修/知识补充/版本管理+成本完整;新增代码七维审查即修 6 项(354dd3d:URL 丢失 /v1 404 高优先级/C2 轮询泄漏/C3 双跑分析/C4 过期豁免/C5 trim_tasks/C6 动态 import,1265 单测全绿);本日无文档归档(ADR-016 当前生效、v0.8.0.md 开发中、Foresight 清单未跟踪排除);累计已偿 107 笔 | TD-040(carried)+ TD-D~G(carried 4 笔)+ TD-2026-08-21-A(open 1 笔:存量 clippy 告警 9 个),共 6 笔 |
84+
| 2026-08-21(五轮) | 0.10.1 编辑机制修复 + 笔记图片功能(规划 docs/versions/v0.10.1.md 定稿):串写修复/create_version 接通+版本去重/完成改名+ESC;resolve_note_image/import_note_image/app_data_dir 三命令 + NoteImage 组件 + 预览拼接修复;审查即修 P0 XSS(src 转义)/P2×2(void/死代码);新增 8 单测全绿,cargo test 1359/12(既有断言过时登 TD-B);本批无文档归档(v0.10.1.md 活跃、设计哲学活跃);累计已偿 110 笔 | TD-040 + TD-D~G(carried 4 笔)+ TD-2026-08-21-B(open 1 笔:v0.10.0 锚点断言过时 12 项),共 6 笔 |

0 commit comments

Comments
 (0)