Repository navigation
feat(retrieval): 固定 SAG1/SAG2 知识库算法,支持原生入库、混合检索与问答对比 - #253
Draft
luoshuai990529 wants to merge 5 commits into
Draft
luoshuai990529 wants to merge 5 commits into
luoshuai990529 wants to merge 5 commits into
Conversation
luoshuai990529
force-pushed
the
feat/sag2-retrieval-strategy
branch
2 times, most recently
from
October 24, 2026 17:06
92d6022 to
524ec57
Compare
依赖与打包 - 新增 `zleap-sag2==0.1.0`(PyPI 正式版);中文分词由 `jieba-py` 改为 `jieba==0.42.1`,与 zleap-sag2 共用;桌面打包收集 `zleap-sag2`、`jieba` 元数据与 `pyuca` 排序词典 后端 - 新增 `sag/sag2_engine.py`:只读 zleap-sag2 引擎直接在 SAG 的 SQLite / PostgreSQL 关系库上检索(BM25 召回后由 JEV 服务多轮评分),一次请求覆盖 全部目标信源;按配置指纹惰性重建,内置并发上限、范围段落上限、整次超时 与异常翻译;引擎工作运行在专用线程的事件循环,不阻塞 API 循环 - 新增门面策略 `sag2`:保留引擎顺序与原始 JEV 分数,失败不回退 vector; 能力依赖 `jev` 与 `sag2_relational`(首期仅 SQLite / PostgreSQL) - JEV 为付费服务:`jev` 能力要求同时保存地址与 API Key(`jev_api_key_missing`), `multi_jev` 同步受约束;设置保存、Agent 人格、显式请求、连接测试均在缺 Key 时拒绝;改地址或 Key 导致连接不完整而默认策略仍为 JEV 模式时拒绝保存 - `sag2` 与 `multi_jev` 共用 JEV 错误文案与错误码;以 `JEV_SCORED_STRATEGIES` 统一各入口的 JEV 模式判断;新增 `SAG_SAG2_*` 调优参数 前端 - 检索模式列表新增 `sag2`,JEV 评分模式带付费标识;旧后端未声明支持时按 不可用处理;灰置项因缺配置或 Key 时提供「去设置」入口 - 知识库设置中 API Key 改为选择 JEV 模式时必填;检索状态栏显示 SAG2 的 本次 JEV 评分用量 文档 - README / README-CN 检索模式表新增 `sag2`,说明存储要求、PostgreSQL 辅助表 权限与付费 Key 要求;CHANGELOG Unreleased 记录
后端 - `Source` 新增 `default_search_strategy`(可空,跟随全局默认),创建 / 更新 接口接受并返回;取值须为当前部署可用的模式,JEV 付费模式还需已保存 API Key,拒绝时沿用能力原因码 - 新增 `resolve_search_strategy`:显式请求 → Agent 人格 → 范围内信源的共同 默认 → 全局默认;检索服务、搜索接口、Agent 工具统一走该解析,结果 `stats.strategy_origin` 标明来源 前端 - 创建 / 编辑信源对话框新增「默认检索模式」选择器:首项「跟随全局默认」, 各模式附通俗说明、适用场景与付费标识;不可用的模式灰置并说明原因 - 选择 JEV 模式但缺少服务或 Key 时就地展开 JEV 配置(预设服务商、Key、 测试连接),保存后再创建或更新;缺 Key 时无法提交 - 信源卡片与详情头部显示默认模式标签;搜索页在范围内信源默认一致且用户 未手动选择时自动采用并标注「信源默认」
luoshuai990529
force-pushed
the
feat/sag2-retrieval-strategy
branch
3 times, most recently
from
November 1, 2026 10:27
683ef31 to
c155710
Compare
后端 - `AskRequest` 新增可选 `strategy`,经 `AskPlan` 与工具上下文传入 `search_context`,优先于 Agent 人格与信源默认 - `/ask` 在开始流式生成前校验该模式可用,付费 JEV 模式缺 Key 时返回 400, 不落库用户消息;工具结果 `retrieval_stats.strategy_origin` 标明来源 前端 - 输入框工具栏在「联网」旁加入与探索页一致的模式控件,默认显示将实际 使用的模式并标注来源(人格默认 / 信源默认),生成中禁用 - 用户选择后仅对本面板后续轮次生效;模式不可用被拒绝时在输入框上方 内联提示并提供设置入口;活动时间线显示本轮模式来源
- 搜索栏「对比」开关:开启后以 2–3 个模式芯片替代单模式控件,同一问题 并发对比;可选 LLM 评审,范围沿用 @ 选择 - 分栏结果显示耗时、召回数、SAG2 的 JEV 用量与降级状态,跨列共同命中的 片段加标记,失败列内联显示原因;下方列出两两评审结论 - 任一列可「按此模式检索」,固定该模式并回到普通搜索;关闭对比保留上次 普通结果 - 对比列、片段行与评审列表抽为共享组件,信源页检索测试对话框改为复用
luoshuai990529
force-pushed
the
feat/sag2-retrieval-strategy
branch
from
November 1, 2026 10:47
c155710 to
9eccdec
Compare
This branch has not been deployed
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Sign up for free
to join this conversation on GitHub.
Already have an account?
Sign in to comment
Add this suggestion to a batch that can be applied as a single commit.This suggestion is invalid because no changes were made to the code.Suggestions cannot be applied while the pull request is closed.Suggestions cannot be applied while viewing a subset of changes.Only one suggestion per line can be applied in a batch.Add this suggestion to a batch that can be applied as a single commit.Applying suggestions on deleted lines is not supported.You must change the existing code in this line in order to create a valid suggestion.Outdated suggestions cannot be applied.This suggestion has been applied or marked resolved.Suggestions cannot be applied from pending reviews.Suggestions cannot be applied on multi-line comments.Suggestions cannot be applied while the pull request is queued to merge.Suggestion cannot be applied right now. Please check back later.
功能变化
default_search_strategy=sag2不会被误迁为 SAG2 入库算法。sag2.db;PostgreSQL 使用同库独立sag2schema,每个不可变输入独立命名空间。zleap-sag2==0.1.0、jieba==0.42.1,保留桌面词典收集配置。验证结果
最终功能提交
86c6c0ab:NATIVE-253,SAG2 引用可打开原文。API 重启后混合检索、显式算法限定再次通过。output/pr253-engine-binding-acceptance-20261101/report.html,不提交运行产物。本次应用与 PostgreSQL 验收服务已关闭。提交与数据边界
保留原有 4 个功能提交,本次固定算法及完整双引擎链路归入 1 个完整功能提交;审查修复并入此提交,不增加零散修补提交。未提交本地计划、无关 Markdown、API Key、数据库、上传文件、日志或截图;Markdown 仅对应功能的 README.md、README-CN.md、CHANGELOG.md。已将本地已保存凭证与完整待提交 diff 比对,无匹配。