Skip to content

Commit d6bfb57

Browse files
committed
docs(ai): v0.19.4 版本文档与需求登记(REQ-274~280,REQ-259 顺延 v0.19.5)
1 parent a4752f2 commit d6bfb57

3 files changed

Lines changed: 139 additions & 3 deletions

File tree

‎docs/product/requirements-pool.md‎

Lines changed: 18 additions & 3 deletions
Original file line numberDiff line numberDiff line change
@@ -457,15 +457,15 @@
457457

458458
> 依据:用户 2026-09-03 方向裁决「方案三:派生索引+双读路径+人工裁决闭环」(加一层能力 + 换引擎良性内核;整体重定位/引擎替换否决);检索欠账核实(FTS5 未实装、/goal L3 为标题占位)后立项;
459459
> 设计:[2026-09-03-v0.19-rag-retrieval-discovery-design.md([ ] 已归档)](../archive/2026-09-03/2026-09-03-v0.19-rag-retrieval-discovery-design.md) + [ADR-029](../adr/ADR-029-rag-retrieval-discovery-layer.md)(已接受);
460-
> 排期:M0 spike → v0.19.0(索引基建)→ v0.19.1(学习库问答)→ v0.19.2(采集体验小版本——用户实测插队,见下段)→ v0.19.3(检索建议)→ v0.19.4(语义增强,spike 定案后)。
460+
> 排期:M0 spike → v0.19.0(索引基建)→ v0.19.1(学习库问答)→ v0.19.2(采集体验小版本——用户实测插队,见下段)→ v0.19.3(检索建议)→ v0.19.4(AI 任务体验与标识治理批——2026-09-04 用户反馈批插队,见下段)→ v0.19.5(语义增强,spike 定案后)。
461461
462462
| REQ | 需求 | 优先级 | 状态 | 目标版本 | 备注 |
463463
|----|------|--------|------|---------|------|
464464
| REQ-258 | 检索与索引基建:kb_chunks/kb_meta/FTS5 影子表(节级切块 ≤800 字符硬切、多态源双可空 FK)+ 生命周期(保存收口钩子重索引/删除事务内显式清理/全量重建 reindex_all + kb_index_stats 角标)+ kb_search 混合检索(FTS5 BM25 ∪ 向量余弦 → RRF 融合;LIKE 旧链保留) | P1 | 已实施 | v0.19.0 | FTS-only 可发布;影子表写入收敛 kb_index 同事务双写(不依赖触发器);**代码已交付(2026-09-03:三表 DDL + 切块/查询纯函数 + 生命周期钩子 + reindex_all/stats + kb_search;切词校准定案=trigram+2 字 LIKE 补充;RRF 函数 TDD 先行待 v0.19.3 合流)** |
465-
| REQ-259 | 本地 embedding 引擎:EmbeddingEngine trait(Noop/Onnx/Ollama 实现)+ M0 spike 定选型(内嵌 ONNX bge-small-zh-v1.5 vs Ollama /api/embeddings;中文小评测集 ~30 查询;ORT 共存必测)+ 模型分发复用 model_registry + 混合检索开启 | P1 | 已立项 | v0.19.4(spike 定案后) | 无模型 = FTS-only 降级,不阻塞 v0.19.0~2;模型文件不入库;**2026-09-03 顺延:v0.19.2 采集体验小版本用户实测插队(原 v0.19.3)** |
465+
| REQ-259 | 本地 embedding 引擎:EmbeddingEngine trait(Noop/Onnx/Ollama 实现)+ M0 spike 定选型(内嵌 ONNX bge-small-zh-v1.5 vs Ollama /api/embeddings;中文小评测集 ~30 查询;ORT 共存必测)+ 模型分发复用 model_registry + 混合检索开启 | P1 | 已立项 | v0.19.5(spike 定案后) | 无模型 = FTS-only 降级,不阻塞 v0.19.0~2;模型文件不入库;**2026-09-03 顺延:v0.19.2 采集体验小版本用户实测插队(原 v0.19.3)**;**2026-09-04 再顺延:v0.19.4 用户反馈批(AI 任务体验与标识治理)插队(原 v0.19.4)** |
466466
| REQ-260 | 学习库问答「问我的学习库」:chat_sessions.retrieval 列 + chat_send 检索分支(命中列表恒可用·本地;生成经 content_gate + kb_qa_enabled 默认关)+ pack_fragments 转正 + 预算档位/成本/审计(ai_usage + meta_json 引用)+ 引用 chips 跳笔记高亮命中词 | P1 | 已实施 | v0.19.1 | 兑现 REQ-024/REQ-231 检索欠账(口径修订见设计 §十二.1);断网回退命中列表;**代码已交付(2026-09-03:retrieval/meta_json 补列 + kb 双闸门编排 + KbHits 事件 + CitationChips + 笔记内命中词搜索高亮 + 设置「学习库」段)** |
467467
| REQ-261 | 检索建议(发现路径):概念/节点详情「相关素材建议」候选(混合检索 top-K ≤10,排除已链接)→ 人工勾选确认 → 既有 link_knowledge_target 落库(白名单零迁移)+ 跨体系相似概念提示(提示型不自动合并) | P2 | 已实施 | v0.19.3 | kb_discovery 默认关(交叉点默认关延续);建议不落库零双写;**代码已交付(2026-09-03:kb_discovery.rs 排除已链接 + feature flag + DiscoverySuggestSection 勾选确认流 + 相似提示,dd5f9b2 之后 v0.19.3 提交)**;v0.19.2 采集体验插队顺延一档 |
468-
| REQ-262 | 治理与设置:SettingsPage「学习库」段(引擎状态/模型下载/索引统计与重建/发现开关)+ FTS5 使能核查 + 中文 BM25 切词校准 | P2 | 部分落地(v0.19.0~3) | v0.19 系列随批 | 复用 speaker/OCR 模型下载 UI 范式;**已交付(2026-09-03):FTS5 使能核查 + 切词校准定案(trigram)+ 设置「学习库」段(引擎状态/问答开关与档位/统计/重建/**相关素材建议开关 v0.19.3**);模型下载随 v0.19.4** |
468+
| REQ-262 | 治理与设置:SettingsPage「学习库」段(引擎状态/模型下载/索引统计与重建/发现开关)+ FTS5 使能核查 + 中文 BM25 切词校准 | P2 | 部分落地(v0.19.0~3) | v0.19 系列随批 | 复用 speaker/OCR 模型下载 UI 范式;**已交付(2026-09-03):FTS5 使能核查 + 切词校准定案(trigram)+ 设置「学习库」段(引擎状态/问答开关与档位/统计/重建/**相关素材建议开关 v0.19.3**);模型下载随 v0.19.5(2026-09-04 随 REQ-259 顺延)** |
469469

470470
### v0.19.2 · 采集体验小版本(2026-09-03 用户实测插队立项)
471471

@@ -478,6 +478,21 @@
478478
| REQ-272 | 站点/播放器可达性与活跃置顶:评分表补抖音/快手/B站客户端(标题+进程)+ CaptureWindow.zOrder(EnumWindows 序号)推荐区同级按 z 序——活跃窗口自然靠前 | P1 | 已实施 | v0.19.2 | 真"播放中"检测(OCR/音频轮询)成本高,z 序为零成本近似——观察项;**代码已交付(2026-09-03,dd5f9b2)** |
479479
| REQ-273 | 开始即录就绪门控:start 有界等待 5s→15s(CUDA 冷载);超时取消+会话行回滚+明确报错(不再双引擎重载);前端启动过渡态——recording 事件(引擎真就绪、AV 同刻)前不显示暂停/浮窗等采集中控件 | P1 | 已实施 | v0.19.2 | 双击防抖(starting 闸);wasEngineReady 分流防内联提前置活动态;**代码已交付(2026-09-03,dd5f9b2)** |
480480

481+
### v0.19.4 · AI 任务体验与标识治理批(2026-09-04 用户反馈批插队立项)
482+
483+
> 依据:用户 2026-09-04 反馈 6 点逐项讨论裁决,设计详见 [v0.19.4 版本文档](../versions/v0.19.4.md)(含丙案全局面板交互规格/裸号清单 6 处/uid 基建/事件总线域设计);
484+
> 排期注:**本批抢位 v0.19.4;REQ-259(本地 embedding)顺延 v0.19.5**(REQ-262 模型下载余项随动)。
485+
486+
| REQ | 需求 | 优先级 | 状态 | 目标版本 | 备注 |
487+
|----|------|--------|------|---------|------|
488+
| REQ-274 | AI 任务对话化·全局 AI 对话面板(丙案):应用级右停靠、按需唤起+内容保活(隐藏不销毁/后台任务照跑/完成 toast)、面板线程=chat_sessions 真实会话(AI 对话页可查可继续)、全站入口统一「以对话处理」(笔记编辑态/会话精修/补充/任务中心/选中文本)、完成操作条按来源渲染(采纳到工作台/查看来源回跳/追问)+ 补充采纳断点补齐(ChatPage enrich 无就地采纳、完成卡无查看笔记) | P0 | 已立项 | v0.19.4 | 2026-09-04 用户三选裁决定稿丙案+保活模型;复用 ChatMessageList/ChatComposer/TaskThreadCard 与既有 ai_refine_*/chat 协议**零新 IPC**;ChatPage 收敛面板全屏态后续再说 |
489+
| REQ-275 | AI 响应速度治理:链路耗时拆解(首 token 延迟/流式帧节奏与前端节流/任务发起前置 estimate 链)→ 针对性优化 | P1 | 已立项 | v0.19.4 | 先建基线报告再动刀;排除:换 Provider/改云端协议/content_gate 与预算语义 |
490+
| REQ-276 | 笔记页「挂体系」浮层/弹层边距残缺修复:右缘钳制/按可视区重定位与翻转 + 边距统一;同类阅读头悬浮弹层群(色板/归组)统查 | P1 | 已立项 | v0.19.4 | 2026-09-04 用户定位选 A(挂体系浮层/弹层);补窄窗与贴边场景验收 |
491+
| REQ-277 | ID 治理:6 处裸数字上屏语义化(ChatSidebar/ChatPage 兜底「会话 #N」、TaskConversationView「来源会话 #N」、AiTaskPanel「任务 #N 结果」、NotePreviewView「笔记 #N」、ClassroomRightPane「#N」→ 标题/日期/「已删除」文案)+ notes/sessions 加不可变 uid(`n|s-YYYYMMDD-6随机`,唯一索引;幂等加列+存量回填,零表重建) | P1 | 已立项 | v0.19.4 | 数字主键不动(35 表重建+无迁移框架成本核算否决);v0.12.7 治理延续至 AI 任务域;前端契约仅增可选 uid;消费端(导出/深链/合并判重)后续铺开 |
492+
| REQ-278 | 通用变更事件总线:Rust `data:*` 六域广播(notes/sessions/note-groups/goals/knowledge/ai-tasks)挂载零广播写命令模块 + 前端 useDomainRefresh(防抖 300ms+路由活跃门控)订阅刷新 | P1 | 已立项 | v0.19.4 | 既有领域事件(ai:task-update/knowledge:links-changed/live:*)保留不重复造轮子;根治「AI 任务完成需切页才见详情」 |
493+
| REQ-279 | 精修程度「自定义」档(自由文本随提示词+实时预览同路径)+ 标准恒纯净:换档替换语义清残留(不再并集合并)/记忆仅显式非默认调整生效/意图基准偏好派生修复/后端 preset=standard 恒空策略不叠加 | P1 | 已立项 | v0.19.4 | 2026-09-04 用户裁决两者都做;污染三通道盘点证据见 v0.19.4 文档 §6 |
494+
| REQ-280 | 笔记联合整理(相似内容汇总整理,维护笔记有序性)——远期登记 | P3 | 待评估 | 后续再议 | 2026-09-04 思考结论:相似判定依赖 v0.19.5 本地嵌入;建议制确认+版本链回滚复用既有模式;**本批不实施**,四子问题存档于 v0.19.4 文档 §7 |
495+
481496
### v0.20 · ASR 质量增强(2026-09-03 用户裁决立项 C:P0~P2)
482497

483498
> 依据:repowiki+代码互证盘点(阈值经验化/实时缺全量精修/无混淆画像/三处文档落差)+ 用户裁决(① 验证必须代码自验证 ② 立项范围 C);

‎docs/versions/README.md‎

Lines changed: 1 addition & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -53,6 +53,7 @@
5353
| v0.19.1 | [v0.19.1.md](./v0.19.1.md) — 读路径 A 学习库问答「问我的学习库」:📚 会话模式 + 命中恒可用 + 双闸门生成(pack_fragments 转正/预算/审计)+ 引用 chips 跳笔记高亮命中词 + 设置「学习库」段(REQ-260/262 部分) | 版本文档(已实施 2026-09-03,真机验收待执行) |
5454
| v0.19.2 | [v0.19.2.md](./v0.19.2.md) — 采集体验小版本:窗口选择增强(抖音/快手/B站客户端评分表 + z 序置顶 + 系统窗口过滤开关找回)+ 开始即录门控(15s 就绪等待自动开录/等待期无采集中控件/AV 同刻,REQ-271~273;REQ-261/259 顺延 v0.19.3/v0.19.4) | 版本文档(已实施 2026-09-03,真机验收待执行) |
5555
| v0.19.3 | [v0.19.3.md](./v0.19.3.md) — 读路径 B 检索建议(发现路径):概念「相关素材建议」候选(排除已链接)+ 勾选确认经引用通道落库(建议零双写)+ 跨体系相似概念提示(不自动合并)+ kb_discovery 默认关(REQ-261/262 余项) | 版本文档(已实施 2026-09-03,真机验收待执行) |
56+
| v0.19.4 | [v0.19.4.md](./v0.19.4.md) — AI 任务体验与标识治理批(2026-09-04 用户反馈批):全局 AI 对话面板(丙案·按需唤起+内容保活)+ 响应速度链路拆解治理 + 挂体系浮层残缺修复 + 裸号显示治理 6 处与 notes/sessions uid 基建 + 通用变更事件总线(data:* 六域)+ 精修程度「自定义」+标准恒纯净 + 联合整理远期登记(REQ-274~280;REQ-259 顺延 v0.19.5) | 版本文档(2026-09-04 规划定稿,待实施) |
5657
| v0.20 | [v0.20.md](./v0.20.md) — ASR 质量增强系列(自验证路线):v0.20.0 asr_eval harness + 首轮报告(REQ-263)→ v0.20.1 DTW 接线/参数定案族/热词加固/积压验证(REQ-264~267)→ v0.20.2 全量精修/混淆画像闭环/LLM 校对(REQ-268~270) | 系列文档(2026-09-03 立项 C,待实施;ADR-030) |
5758

5859
## 沉淀规则

0 commit comments

Comments
 (0)