feat(knowledge): v2 Phase 3+4 向量混合检索与 AI Chat/Ask 双模式

[wynxing]

概述

知识库 v2 Phase 3（sqlite-vec 向量索引 + RRF 混合检索）与 Phase 4（AI Chat/Ask 双模式 + 三级上下文权限 + 引用审计）。在 PR #9（Phase 0-2）之上叠加向量层与 RAG 对话层，向 issue #7/#8 推进。

Phase 3 — sqlite-vec + RRF

• embedding adapter（packages/ai/src/embedding.ts）：OpenAI 兼容 /v1/embeddings batch，重试+超时，与 chat provider 解耦（DeepSeek 无 embedding 端点）
• db 层：loadVecExtension/toVecBuffer + vec0 延迟建表（首嵌发现维度）+ embedding_cache 内容哈希去重 + searchKnn(KNN) + getIndexStatus 三态(hybrid/indexing/fts-only)
  • 顺手修 Phase 2 bug：reindexTask 缺 FTS5 INSERT，task 无法被检索 → 已补
• service：drain 队列（单飞 mutex + cache 复用）+ searchHybrid(FTS5+vec) + rrf.ts 纯函数(k=60)
• routes：search 切 hybrid、index-status 真实 flags、新增 GET/PUT /api/knowledge/embedding-config（内存态，apiKey 不回显）
• 前端：api 层 + KnowledgeSection embedding baseUrl/apiKey 配置闭环

Phase 4 — Chat/Ask 双模式

• 会话持久化：ai_conversations/ai_messages 表 + createAiConversationStore（多轮 + sources_json）
• ContextBuilder（modules/ai/context.ts）：权重/greedy fill/gap fill 句子边界/三明治排序
• 引用审计（modules/ai/citation.ts）：injectSources(稳定 sN id) + parseAndAuditCitations(丢弃未注入 id 防幻觉) + buildSources(服务端生成，非模型自报)
• ai service：handleChat(全量上下文多轮) + handleAsk(RAG 一次性) + plainChat 降级
• 路由重构：/api/ai/chat 委托 service，请求体扩 mode/projectId/context/conversationId，ai:done 携带 {text, sources, retrievalMode}

降级路径

• vec 未加载 → mode='fts-only'，search 回退 FTS
• embedding 未配 → mode='fts-only'
• Ask 无命中 / Chat 无选中 → 退普通单轮 DeepSeek（保持现有行为不回归）

测试计划

• pnpm typecheck 全绿（shared/ai/db/tts/desktop/server-local）
• pnpm -r test 全绿：ai 8、db 9+4skip、server-local 41+5skip、desktop 28、tts 1
• 单测：embedding(8)、rrf(6)、context(7)、citation(5)
• CI：vec0 写入+KNN+embedding_cache 去重+searchHybrid（skipIf 本机跳过，CI 验证）；reindexTask FTS 修复回归
• 手动：配置 embedding provider → 语义查询命中；Chat/Ask 切换 + sources 跳转
• 前端 4.5 Chat/Ask 对话 UI（PR 后续补充，当前仅后端 + 配置 UI）

说明

• 本机无 better-sqlite3 原生 binding（Node 24.14），vec/sqlite 专属测试 skipIf，CI 为唯一验证（Phase 2 已验证此模式）
• sqlite-vec pre-v1，pin 版本；vec0 维度固定，模型换维度需 drop+recreate+全量重嵌
• embedding 配置走服务端内存端点（重启丢失，YAGNI，不引持久 settings store）
• better-sqlite3→node:sqlite 迁移仍延后（SEA 任务）

后续

• issue 知识检索 Phase 3：sqlite-vec 向量索引 + embedding adapter + RRF 混合检索 #7/知识检索 Phase 4：AI Chat/Ask 双模式 + 三级上下文权限 + 引用审计 #8 实现完成；前端 4.5 对话 UI 待补

[fennoai]

Important

Fenno AI is not enabled for this organization

Fenno AI is currently in internal testing and is not yet open for external organizations.

If you would like to request access, sign in to Fenno AI Console, choose Give Feedback in the lower-left corner, and tell us what you need. We will follow up promptly.