docs: 落 W15/W16 批次（重试复键的取舍、会话内搜索的形状）+ 六条契约口径登记

devdocs/02-前后端协同事项.md

@@ -1049,3 +1049,18 @@ POST /api/v1/chat      (221-byte body) → 200 OK
 **③ IM 侧能力边界（如果你们要测微信/QQ 发文件）**：bridge 侧的摄取**已接通**（文件类媒体 → 内容寻址存储 → 挂到该回合的用户消息 → 自动抽取/清单），**但现网适配器上报的文件媒体只带 URL/ID、不带字节** ⇒ 真机上她目前只会得到「**无法读取：渠道只给了远程引用**」的诚实提示（我们刻意不代取任意远程 URL —— 与 `F3` 的 SSRF 教训一致）。**让 IM 文件真能读需要各适配器入站时下载并内联字节**（IM-1，已等主人点头）。
 
 **④ 面板** 新增只读端点 `GET /api/v1/admin/system/storage`（SQLite 体积/WAL/页数 + 附件占用 + **PG 增强状态**）⇒ 契约将升 **v0.60**（ST1 在跑）。**纯新增，无破坏性**，你们按未知字段忽略即可。
+
+---
+
+## 登记（客户端会话，2026-10-05 凌晨 · 会话内搜索 D2 落地后的六条契约口径）
+
+**结论先说**：D2（**会话内搜索**）已落地 —— 顶栏入口 + 搜索面板 + 点结果定位。`q` / `before` / `limit` 的语义我们**逐条核过契约**、实现与之一致；下面是**契约没写透或需要你们确认**的六条（**都不阻塞我们**）。
+
+1. **`before` 是「含」还是「不含」游标，契约没写**：契约只对 `after` 明说过 `created_at > after`。我们沿用既有分页的游标语义，并加了两道防御（按 `id` 去重 + **「这一页没带来新条目就停止翻页」**，否则「还能翻 → 再请求 → 全是重复」会死循环）。**请明确 `before` 的边界语义**（`<` 还是 `<=`）——若是 `<=`，页边界那条会被重复返回，我们靠去重兜着，但那是白流量。
+2. **`q` 匹配的是原始 `content`（含标记），契约只说「内容搜索」、没说落点**：后果是搜 `action` / `narration` 这类词**会命中**（标记里就有），但**剥掉标记的纯文本里没有它** ⇒ 我们**只显示片段、不画高亮**（不假装命中）。**建议契约写清「标记本身可被搜到」**。
+3. **搜索没有结束信号**：只能靠「返回条数 < 请求条数」判断到底 ⇒ 最后一页之后会多打一次空请求。契约没有 total、也没有游标耗尽标记（这是既有分页口径，**不是本模块引入的**）。
+4. **`q` 与 `platform` 能否同传，契约没写**（没说互斥）。我们搜索**不带 `platform`**——那是多端来源过滤，与「会话内找话」正交。
+5. **空 `q` = 未传** ⇒ 我们把它**当陷阱处理**：空/纯空白关键词**一个请求都不发**（否则服务端退化成普通分页，会把整段历史当搜索结果回给用户）。
+6. **没有「命中总数」**：面板顶栏那个「N 条命中」是**已加载条数**、不是总数。措辞上我们写的就是实话；若你们以后加 total，我们改成总数即可。
+
+另：**W15（手动重试复用幂等键）是纯客户端改动**、无所求 —— 但它把 `duplicate` 两侧路径又读了一遍（WS `chat_duplicate` / REST `{duplicate:true}`），行为与我们理解**一致，无异议**。