Skip to content

feat(search): 探索页多模式对比与 SAG2 专用事件循环 - #256

Closed
luoshuai990529 wants to merge 3 commits into
feat/sag2-chat-strategyfrom
feat/sag2-search-compare
Closed

luoshuai990529 wants to merge 3 commits into
feat/sag2-chat-strategyfrom
feat/sag2-search-compare

Conversation

@luoshuai990529

Copy link
Copy Markdown
Collaborator

改动范围

后端(apps/api)

  • sag_api/sag/sag2_engine.py:新增 _EngineLoop,zleap-sag2 只读引擎的创建、范围扫描、检索与关闭全部在专用线程的事件循环执行;API 循环只保留并发闸门、整次超时与取消。超时会同步取消专用循环中的协程;aclose 等待在途检索后关闭引擎并停掉线程。对比端点 eval-compare 本已并发执行、单策略失败隔离并透传 stats,未改动。
  • 测试:tests/test_sag2_retrieval.py 新增「阻塞式引擎不影响 API 循环心跳」「超时取消到达引擎协程」,跨线程并发上限在线调整改用线程安全信号;tests/test_sag2_engine_integration.py 在新执行模型下通过。

前端(apps/web)

  • 探索页搜索栏新增「对比」开关(search-panel.tsx):开启后单模式控件替换为多选模式芯片(仅列出当前部署可用的模式,JEV 模式带付费标识,强制 2–3 个),下方为「LLM 评审」开关(仅在已配置 LLM 时显示)与范围芯片;回车或搜索按钮调用现有 POST /search/eval-compare,范围与普通搜索一致。
  • 新增 search/search-compare-results.tsx:2–3 列响应式并排,列头含模式图标、标签、付费标识与指标条(耗时、召回数、SAG2 的 JEV 用量),发生降级或实际模式不同时显示检索状态条;跨列共同命中的片段标「共同命中」;失败列内联显示原因并禁用采用;加载骨架、整次失败可重试;下方为两两评审结论或未评审原因。
  • 每列「按此模式检索」:固定该模式、关闭对比并用同一问题执行普通搜索;关闭对比时保留上次普通结果,对比结果缓存至查询被清空。
  • 新增 search/use-search-compare.ts(本地状态、默认芯片选择、取消);对比列、片段行、指标条与评审列表抽到 retrieval-compare-parts.tsx,信源页「检索测试」对话框改为复用,行为不变。
  • 新增 19 条 Search 文案(中英);新增 vitest:对比钩子、对比结果、搜索面板对比交互、检索测试对话框回归。

文档

  • README / README-CN 补充探索页对比;CHANGELOG Unreleased 记录对比功能与专用事件循环。

影响功能范围

  • 探索页:新增对比模式,普通搜索流程不变。
  • SAG2 检索:大范围扫描不再阻塞其他请求;行为、超时与并发上限语义不变。SAG_SAG2_* 配置不变。

测试覆盖情况

  • 通过:pytest -q(apps/api,串行),1773 passed / 6 skipped;全量中 test_source_default_strategy.py 一次 teardown 出现 database is locked,根因是该用例收尾删除信源与应用关闭争抢 SQLite 锁,已在 feat(retrieval): 信源默认检索模式、问答按轮选择与探索页多模式对比 #254 追加修复提交并重跑三次通过。
  • 通过:ruff check sag_api tests scripts(apps/api)。
  • 通过:npm run typecheck、npx vitest run(109 files / 912 tests)、npm run lint、npm run i18n:check(apps/web)。
  • 未执行:浏览器内的人工走查;真实 JEV 服务;≥1 万段落范围下的专用循环实测。
  • CI:待远程 CI 执行。

🤖 Generated with Claude Code

luoshuai990529 and others added 3 commits October 24, 2026 23:52
- zleap-sag2 构建内存语料时在事件循环线程同步分词、建倒排表,范围大时会
  阻塞 API 循环;`Sag2EngineHolder` 新增 `_EngineLoop`,引擎的创建、范围
  扫描、检索与关闭全部在专用线程的事件循环执行
- API 循环只保留并发闸门、整次超时与取消:超时会同步取消专用循环中的协程,
  `aclose` 等待在途检索后关闭引擎并停掉线程
- 测试:阻塞式引擎不影响 API 循环心跳;超时取消到达引擎协程;跨线程并发
  上限在线调整;真实 zleap-sag2 直读集成测试在新执行模型下通过

Co-Authored-By: Claude Fable 5.1 <noreply@anthropic.com>
Co-Authored-By: Claude Fable 5.1 <noreply@anthropic.com>
- 搜索栏「对比」开关:开启后以 2–3 个模式芯片替代单模式控件,同一问题
  并发对比;可选 LLM 评审,范围沿用 @ 选择
- 分栏结果:各列显示耗时、召回数、SAG2 的 JEV 用量与降级状态,跨列共同
  命中的片段加标记,失败列内联显示原因;下方列出两两评审结论
- 任一列可「按此模式检索」,固定该模式并回到普通搜索;关闭对比保留上次
  普通结果
- 对比列、片段行与评审列表抽为共享组件,信源页检索测试对话框改为复用;
  补充中英文案与 vitest 用例

Co-Authored-By: Claude Fable 5.1 <noreply@anthropic.com>
@luoshuai990529

Copy link
Copy Markdown
Collaborator Author

已整合进 #254,此 PR 关闭。

@luoshuai990529
luoshuai990529 deleted the feat/sag2-search-compare branch October 24, 2026 16:06
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant