docs(api): 契约 v0.91 —— recallMode 如实上报（新增 mixed/空态语义）

起因：M6 诊断发现旧实现把「向量路径实际失败、回退词项」静默报成 embedding，面板看不出降级。M9 改为上报实际选用的召回路径，取值域扩 mixed（部分分区降级）与 ""（无候选可比）。同步：版本行 + §6 v0.91 条目 + §4.12 的 recallMode 值表；并记录「客户端 5s 超时未改、改的是批上限推演」这条对客户端透明但重要的取舍。

Docs/api-client.md

@@ -1,6 +1,6 @@
 # Cyrene v2 客户端 API 契约
 
-> **契约版本：`v0.90`**（上一版 `v0.89`，其条目见 §6；`v0.88` / `v0.87` / `v0.86` / `v0.85` / `v0.84` / `v0.83` / `v0.82` / `v0.81` / `v0.80` / `v0.79` / `v0.78` / `v0.77` / `v0.76` / `v0.75` / `v0.74` / `v0.73` / `v0.72` / `v0.71` 及更早见本文件 §6，`v0.67` 及更早的基线已归档、只读：`Docs/archive/api-client.v0.65.md`）。
+> **契约版本：`v0.91`**（上一版 `v0.90`，其条目见 §6；`v0.89` / `v0.88` / `v0.87` / `v0.86` / `v0.85` / `v0.84` / `v0.83` / `v0.82` / `v0.81` / `v0.80` / `v0.79` / `v0.78` / `v0.77` / `v0.76` / `v0.75` / `v0.74` / `v0.73` / `v0.72` / `v0.71` 及更早见本文件 §6，`v0.67` 及更早的基线已归档、只读：`Docs/archive/api-client.v0.65.md`）。
 > **读者**：Web 前端 / 移动端原生客户端（含 Android）/ IM 桥接等**跨平台客户端开发者**。
 > **唯一真源 = 当前代码**（`internal/services/gateway/*` 等）。本文档由代码逐条核对得出；与代码不符时**以代码为准**，并回改本文档。
 > **旧的超详细版已归档、只读**：`Docs/archive/api-client.v0.65.md`（412 KB，含 v0.28→v0.65 全部历史条目）与 `Docs/archive/api-reference.v0.65.md`（170 KB，后端全量字段级文档）。归档的原因是**结构性臃肿 + 历史条目并列 + 长期漂移**；本文档**不复制**那段历史，需要考古时去归档。
@@ -1064,7 +1064,7 @@
 | 请求体 | **可为空**（端点不读 body）。没有参数：阈值/上限一律取**进程生效的既有配置**（`MEMORY_TIDY_RECALL_THRESHOLD` / `_SCAN_LIMIT` / `_CANDIDATE_LIMIT` / **`_COMPARE_LIMIT`（v0.77 新增）**），端点**自己不带任何旋钮** |
 | 响应体 | `{data:{dryRun,recallMode,durationMs,ruleVersion,partitions,scanned,compared,pairs,vetoed,vetoReasons,truncated,candidates[]}}` |
 | `dryRun` | 恒为 `true`。它是**结构化**判据：这份响应**没有**改动任何记忆（客户端不必只靠本地硬编码文案说明这件事） |
-| `recallMode` | `"embedding"`（语义向量召回）或 `"lexical"`（零依赖词项余弦，仅当进程没有接 embedder） |
+| `recallMode` | **如实上报本轮实际选用的召回路径**（不再是「配置态」）：`"embedding"`（语义向量召回）｜`"lexical"`（零依赖词项余弦）｜`"mixed"`（**部分分区降级**、其余走向量）｜`""`（**没有候选可比** ⇒ 本轮没做召回，不是降级、也不该显示成空）。⚠️ v0.91 起语义收紧：旧实现把「全量降级」静默报成 `embedding`，面板因此看不出降级 |
 | `durationMs` | 本次试算的墙钟耗时（毫秒） |
 | `ruleVersion` | 规则集版本（`internal/runtime/memory` 的 `TidyRuleVersion`，进候选幂等键；**改判定规则必须同时升它**） |
 | 观测口径 | `partitions`（含在册条目的分区数）/ `scanned`（扫描条数）/ `compared`（**真正参与两两比对**的条数，受 **`MEMORY_TIDY_COMPARE_LIMIT`** 与**时间预算**两道闸约束 —— 因此 `compared < scanned` 时要看 `truncated` 是不是指出了原因）/ `pairs`（相似度 ≥ 召回门的对数）/ `vetoed` 与 `vetoReasons`（否决数与原因分布，如 `scope`/`persona`/`project`/`source`/`temporal`/`numeric`/`conflict`/`low_confidence`） |
@@ -1496,7 +1496,17 @@ curl -s -X POST -H "X-API-Key: $KEY" \
 > 只保留最近若干版（**v0.60 起**）；更早的全部历史见归档 `Docs/archive/api-client.v0.65.md` §5（v0.28 → v0.59）。
 > 每版一句话 + 三档标注。**三档定义见 [§0.4](#04-三档标注惯例)。**
 
-### v0.90（当前契约版本）
+### v0.91（当前契约版本）
+
+**「召回来源如实上报」版 —— `recallMode` 取值域扩两个 + 语义收紧**（实现 `5967272`，切片 M9；起因 = M6 诊断发现旧实现把「全量降级」静默报成 `embedding`，见 `DevDocs/audit/去重失效诊断-2026-10-13.md`）
+
+- `recallMode` 现在**如实上报本轮实际选用的召回路径**，取值域：`"embedding"` ｜ `"lexical"` ｜ **`"mixed"`（部分分区降级、其余走向量 —— v0.91 新增）** ｜ **`""`（没有候选可比 ⇒ 本轮未做召回 —— v0.91 新增；它不是降级，也不该被显示成空标签）**。
+- 🔴 **行为变更（客户端须跟进）**：旧实现报的是**配置态**（进程接没接 embedder），因此「向量路径实际失败、回退到词项」会被显示成 `embedding` —— 面板**看不出降级**。现改为实际态。**试算端点（B14）与整理轮日志/审计同源**；整理轮另新增 `recall_degraded_partitions` 计数，用于回答「哪几个分区降级了」。
+- **兼容性**：按 `embedding|lexical` 二分读的老客户端需自行兜底新值（`mixed` → 「部分降级」；`""` → 「无候选可比」）。前端渲染由后续切片修正（`MemoryTidyDryRunCard`）。
+- **附带的稳定性修复（对客户端透明，无契约影响）**：embedding 批上限改为按「单次请求预算 = 客户端超时的一半」**推演**得出，并在 embedder 内部强制切片（任何调用方给多大的批都安全）；**客户端 5s 超时值本身一字未改**。它修的是「客户端先放弃、服务端继续算 ⇒ 队列堆积级联」这条真机制（M9 实测：空闲态单条 ~0.03s（ASCII）/ ~0.16s（40 汉字），饱和态可放大 70~90 倍）。
+- **计数不变**：无新端点 ⇒ §2.0 维持 `14 + 25 + 40 = 79`。字段级说明见 **§4.12** 的 `recallMode` 行。
+
+### v0.90
 
 **「渠道连接态三态」版 —— 管理面新增三个可选键，并把 `connected` 的语义从「动作被受理」纠正为「真的连上了」**（依据：2026-10-13 主人报「改了 QQ 适配器配置后点连接，卡片仍显示未连接，却提示已连接」；实现推库 `b4d55f4`。）