docs(memory): 请求上界按条数维+字符维两维算准(review-m61 P2-1)

embedding.Embed 同时受条数界(8)与字符界(480 字)约束 ⇒ 一次 embedOnce(B 条)
会发 C 个请求(C 由正文长度决定,1..B),因此:

  正常批            C
  含一条坏正文      ≤ C + B(短正文 9;均长 75 汉字的现实批 10;病理上限 2B=16)
  服务整体挂死      首个 chunk 即失败 + 逐条 B ⇒ 1 + B = 9(与字符维无关)

修正 embed_isolation.go 文件头的上界表、approxRequests 的「两者一致」表述、
embedReuseStats.Sent 的注释,以及 embed_resilience_test.go 的上界注释与日志文案。
零行为改动:判据、实现、请求数都未动,测试全绿。
This commit is contained in:
AskaEth committed 2026-10-30 09:04:14 +08:00
1 parent 8f7017fc0b
commit 058fa141bf
3 files changed
+40 -17

No files matched your search

+21 -9
View File
@@ -19,11 +19,11 @@ import (
//
// ## 为什么是「逐条」而不是递归二分
//
// 二分定位一条坏文本要 1+2+2+2 = 7 个请求(比逐条的 9 少 2 个),但它需要一套
// 失败预算的簿记(哪一层还允许拆、拆到多深收手),而那套簿记本身就是「韧性变成
// 放大」的风险点:预算给紧了会把好正文一起丢掉,给松了会在服务挂死时把请求数
// 放大成 2^深度。逐条隔离的代价**恒定且可算**:一批最多 1+B 个请求(B=8 ⇒ 9),
// 定位精度与二分相同(精确到单条),没有任何深度参数。
// 二分定位一条坏文本在短正文下要 1+2+2+2 = 7 个请求(比逐条的 9 少 2 个),但它
// 需要一套失败预算的簿记(哪一层还允许拆、拆到多深收手),而那套簿记本身就是
// 「韧性变成放大」的风险点:预算给紧了会把好正文一起丢掉,给松了会在服务挂死时
// 把请求数放大成 2^深度。逐条隔离的代价**恒定且可算**:`embedOnce` 调用 ≤ 1+B
// (B = 批上限),定位精度与二分相同(精确到单条),没有任何深度参数。
//
// ## 三条必须同时成立的约束
//
@@ -32,11 +32,23 @@ import (
// 只损失坏的那几条 —— 绝不把「算不出来」说成「没有相似」;
// 3. **预算**:父 ctx 已到期时不再逐条重试(预算花完了,重试只会把 worker 拖住)。
//
// 请求数的上界(B = 批上限,生产 = 8):
// ## HTTP 请求数的上界(必须按**两维**切片算,B = 批上限 = 8)
//
// 正常批 1
// 含一条坏正文 1 + B = 9(定位到它自己)
// 服务整体挂死 1 + B = 9(一次之后 embedMissing 立刻停手,不再发后续批)
// `embedding.Embed` 不是「一批一个请求」:它按 budget.go 的**条数界**
// (DefaultBatchLimit=8)**与字符界**(DefaultBatchChars=480)同时切片
// (chunkTexts),因此一次 `embedOnce(B 条)` 会发出 C 个请求,C 由正文长度决定:
// 全批 ≤480 字 ⇒ C=1;均长 75 汉字(budget.go 的实测口径)时 8×75=600 > 480 ⇒ C=2;
// 每条自己就超过 480 字 ⇒ 每条独占一片 ⇒ C=B(病理上限)。
// 单条重试**永不切分**(它自己就是一片)⇒ 每条恰好 1 个请求。于是:
//
// 正常批 C(短正文 C=1;长正文 2 起)
// 含一条坏正文 首次失败发生在第 1~C 个 chunk 之一,随后逐条 B 次
// ⇒ ≤ C + B(短正文 9;现实长正文 10;病理上限 2B=16)
// 服务整体挂死 首个 chunk 即失败 + 逐条 B 次 ⇒ **1 + B = 9**(与字符维无关)
//
// 口径与 budget.go 同源:那里的「建模上界 ≠ 延迟保证」是同一类提醒 —— 这里的
// 「≤1+B」是**embedOnce 调用次数**的上界,HTTP 请求数必须再按字符维的 chunk 数算
// (正常批 C、含坏正文 ≤C+B);只有「服务整体挂死 = 1+B」这一条与字符维无关。
// ErrEmbedUnavailable 在「一条向量都没拿到」时返回:调用方据此走既有的词项余弦
// 降级(记忆一条不丢、判定规则一字不改),而不是把「算不出来」当成「没有相似」。