Repository navigation
Commit 60620ea
committed
feat(standalone): 维度探针改存在性判据,降级原因收口成单一枚举(#508 二轮评审)
CodeRabbit 在 #508 首轮之后提了四条,逐条落实:
1(Major)探针判据从「读一行的维度」换成**存在性**。原判据 LIMIT 1 拿
任意一条向量代表全库,在混合维度库里两个方向都错:抽到与查询不符的那条
→ 明明有可比的向量却误报 degraded;首条恰好解析失败 → 其余有效向量都不
匹配时又漏报成 full。现在问的是「有没有一条活跃向量的维度等于查询维度」,
行集与 searchVector 同源(WHERE 谓词逐条相同)。
返回值扩成五态:match / mismatch / none / unreadable / invalid。
unreadable 与 none 分开——「还没有内容」与「内容在那儿却读不出来」是两种
空,后者判不出来,按 fail-closed 落 unknown,绝不因为读不到就宣称 full。
invalid 收查询维度非正整数的情形,同样不落到 full 上。
成本模型如实写进注释:一次无 LIMIT 的全 id 扫描 + 按匹配短路。全库同维度
(常态)循环第一行就返回,只解析 1 个向量;只有一条都不匹配时才走完整个
循环,而那正是要报 degraded 的情形,值得。解析复用 getParsedEmbedding 的
缓存;缓存热不热取决于 injectCandidates 是否真走了 vectorIndex 分支,
这点也写明了,没有假装它永远热。
2(Minor)降级原因收口成 src/api-standalone.js 导出的 frozen 常量
CONTEXT_DEGRADE_REASONS(六值)。此前「没装配 embedder」这条路不写
diag.reason,靠日志行的兜底表达式临时拼一个 no-embedder,而那个值不在
文档声明的枚举里;同一表达式里还躺着第二个越界字面量 embed-failed,且
它那个 embed-error 分支在 embedder 存在时一次都走不到,却会把未来任何
新增的未记账失败一律谎报成「接口抛错」。现在默认值只有决策点一个来源,
日志行不再兜底,越界或漏记账都露出 (undefined)——看得见的缺陷信号,
不是一个编出来的因。
no-embedder 保留为独立第六值、不并进 embed-unavailable:两者共用「语义路
没通」的结果,但一个是适配器坏了(异常)、一个是语义路没开(设计内常态),
并过去会让按 embed-unavailable 告警的面板对每个轻量模式安装报警。用词与
宿主面 /api/dsh-mneme/semantic 的 reason 对齐;那边是另一套同名枚举、
另一个消费者,注释里写明不要顺手统一。
3(Minor)探针自身抛异常(库被锁 / 半开 / 旧装配没这方法)不再掉进最终
.catch() 把已算好的 items 变成 500。隔离在调用侧:store 与 service 透传
都保持抛出口,不把异常吞成某个 state;api 侧判不出来就留 unknown。sentinel
不用 null/undefined——那正是「库里没有向量」的合法读数,混起来会把一次
真实的探针故障谎报成 full。
另加一层:unknown 有三个生产者(空 q / 探针没跑成 / 有行却一条都读不出),
响应体只有 tier 一个键分不出它们,而调用方对 unknown 的策略常常是「不告
警」——所以判不出来的情形另打一行 `tier left unknown: <what>`。它不是六值
的一员,运维程序不要按原因枚举解析它。
4 顺带:每处 logger 调用各自包 try/catch。logger 来自宿主,stdout 管道断裂
时 warn 自身抛错是真实可发生的,而 logger?.warn?.() 只防 logger 缺失。
测试:新增 11 条,含
- 三侧枚举契约(代码导出 / README / docs/DAEMON.md 同集合,漏改一边就红)
- 六条降级路径逐个抓 warn 行断言 reason ∈ 枚举
- Major 两个场景(混合维度有可比向量→full;首条损坏其余不匹配→degraded)
- 探针抛错 → unknown 且 items 不丢、绝不 500
- 探针方法缺失 / 返回垃圾 / 异步漂移 → 一律 unknown
- logger 自身抛错仍 200
- 五态状态机
均已验红→绿(把探针退回 rows[0] 判据,4 条转红,含两个 Major 场景)。
本地全量 2319 passed / 0 failed,npm run sync 后 lib 与 src 一致。
Refs #5081 parent 9a1efce commit 60620ea
9 files changed
Lines changed: 691 additions & 112 deletions
File tree
- dsh-mneme
- docs
- lib
- src
- test
| Original file line number | Diff line number | Diff line change | |
|---|---|---|---|
| |||
547 | 547 | | |
548 | 548 | | |
549 | 549 | | |
550 | | - | |
| 550 | + | |
551 | 551 | | |
552 | | - | |
| 552 | + | |
553 | 553 | | |
554 | | - | |
| 554 | + | |
555 | 555 | | |
556 | | - | |
| 556 | + | |
| 557 | + | |
| 558 | + | |
557 | 559 | | |
558 | 560 | | |
559 | 561 | | |
| |||
| Original file line number | Diff line number | Diff line change | |
|---|---|---|---|
| |||
15 | 15 | | |
16 | 16 | | |
17 | 17 | | |
18 | | - | |
| 18 | + | |
19 | 19 | | |
20 | 20 | | |
21 | 21 | | |
| |||
0 commit comments