web-search-deepseek 丢弃 usage：联网搜索的模型 turn 被计费，却不计入任何 token 统计

[Echot111111]

现象

dsh-web-search-deepseek 的每次联网搜索都是一次真实的模型调用（Anthropic 兼容 Messages 端点 https://api.deepseek.com/anthropic/v1 + 原生 web_search 工具，复用同一个 DEEPSEEK_API_KEY，会被计费），但响应只经 mapAnthropicResponse() 取搜索结果、usage 被丢弃，会话里仅 session.append("web/deepseek-search-llm-request", request) —— 只记请求，不记用量。

后果

token-meter 的 tokenUsage 投影、usage_report.mjs、会话台账系统性漏算搜索开销；报表只把它列为「旁路调用不计入上表：…联网搜索 N 个会话」，只有会话数、没有 token，容易被读成"没有成本"。

实测对账（2026-09-19，单 key，DSH 0.1.5-rc.1，Windows）

全天	平台计费 CSV	会话日志	差
request_count	2,098	1,288	+810
input_cache_miss_tokens	13,105,799	2,065,331	+11.0 M
input_cache_hit_tokens	200,271,744	214,926,080	≈持平（导出延迟）
output_tokens	1,657,037	984,006	+0.67 M
实扣金额	23.74 元	日志口径 ≈10 元	2.4 倍

当天 web_search 共 352 次，折算每次约 31.4k 未命中输入 + 1.9k 输出，正好填平差额。命中列持平是关键判据：搜索结果是全新内容，不产生缓存命中，所以只有未命中/输出/请求数在涨。（dsh-web-fetch-http 无模型调用，本地抓取，不计费。）按官方空闲时段单价（命中 0.02 / 未命中 1 / 输出 4 元每百万）换算：搜索占当天账单 58%（13.7 / 23.74 元）。

建议

1. 在 dsh-web-search-deepseek 中读取并记录响应的 usage（例如追加 web/deepseek-search-llm-usage 事件），再由 token-meter 折叠进 tokenUsage；
2. 或在报表里明确标注「本表不含联网搜索的模型用量，实际成本请以平台账单为准」。

复现

用平台按 key 导出的 amount/cost CSV，对比本地日志中 usage 之和：request_count、input_cache_miss_tokens、output_tokens 三项均高于日志，而 input_cache_hit_tokens 基本持平；差值与该天 web_search 调用次数高度相关。

相关但不同的已有讨论

#2554 讨论的是 pi-ai 按 OpenAI 语义读取 cached_tokens 导致的缓存命中/未命中映射分类问题；本贴是搜索 provider 丢弃响应 usage，两者不是同一个 bug。

[PerryLink]

结论：你的判断成立，而且比「丢弃」更彻底 —— 它从来没有被读进来过，同时 token-meter 也接不住它，所以这不是一个字段漏传的问题。

1. 这条路径根本不在 LLM 接缝上

packages/web/web-search-deepseek/src/provider.ts:5 的模块注释就明说了：

* The wire format and native `fetch` client are provider-private and do not use `ctx.llm`.

packages/web/web-search-deepseek/src/provider.ts:224 是裸的 response = await fetch(endpoint, { ... })。而 usage 是在 LLM 接缝里记录的（packages/llm/llm/src/types.ts:432 有 | { type: 'usage'; usage: TokenUsage }，由 packages/llm/llm/src/assembler.ts:85-86 组装）—— 搜索这条路从不进入那个接缝，所以不存在「读了但没记」。

2. 响应类型里根本没有放 usage 的地方

packages/web/web-search-deepseek/src/types.ts:41-43：

export interface AnthropicResponse {
  content?: ContentBlock[]
}

packages/web/web-search-deepseek/src/provider.ts:270 走 mapAnthropicResponse(payload)，packages/web/web-search-deepseek/src/provider.ts:172 返回 { sources, truncated: false } —— 只取结果。

3. 唯一落盘的是「请求」，而且上游自己把它标成 log-only

packages/web/web-search-deepseek/src/index.ts:115-120：

recordRequest: (request) => {
  ctx.get('agents')?.currentInitiator()?.session.append('web/deepseek-search-llm-request', request)
},

事件形态见 packages/web/web-search-deepseek/src/provider.ts:55-77 = endpoint / apiVersion / body，没有 usage。docs/persistence-catalog.md:1235 对它的小标题就是 — log-only。

4. 决定性的一条：git grep -in "usage" HEAD -- packages/web → exit 1，零命中。整个 packages/web 树里没有出现过 "usage" 这个词。

5. 就算发了事件，统计层也不会认：packages/llm/token-meter/src/usage-projection.ts:82-86

function usageOf(event: SessionEvent): TokenUsage | undefined {
  if (event.type === 'assistant/message' && event.data.usage !== undefined) return event.data.usage
  if (event.type !== 'assistant/message' && event.type !== 'assistant/attempt') return undefined
  return lastAssistantStreamChunk(event.data.stream, 'usage')?.usage
}

只认 assistant/message 与 assistant/attempt。web/* 事件不可能被折进去。

⇒ 最小修复（三处小改）：① packages/web/web-search-deepseek/src/types.ts:41-43 给 AnthropicResponse 加 usage?；② 在 packages/web/web-search-deepseek/src/index.ts 加一个独立的 recordUsage 回调追加 web/deepseek-search-llm-usage 事件 —— 注意 recordRequest 在 packages/web/web-search-deepseek/src/provider.ts:216-220 是派发之前触发的，它拿不到响应，不能复用；③ 扩 usageOf() 并把新事件加进 packages/web/web-search-deepseek/src/provider.ts:79-84 的 SessionEventMap（declare module '@deepseek-ai/dsh-session/types'）（会连带重新生成 docs/persistence-catalog.md）。

⚠️ 一个应当在落地前讨论的设计问题：搜索调用不属于会话上下文，把它折进同一个 tokenUsage 会改变那个投影的语义。若不想改语义，替代方案是单独一个桶；而你提到的「至少在报告里标注不含联网搜索用量」是零代码改动就能做的兜底。

诚实边界：我没有核对你的账单 CSV 对账数字（2,098 vs 1,288 次请求、13.7/23.74 元、352 次搜索）—— 本机没有平台 CSV 也没有那段会话日志；你引用的 usage_report.mjs 不在本仓，我在本工作区递归也没搜到，所以那条无法复核。

[Echot111111]

感谢确认，五条我都在本机 0.1.5-rc.1 的构建产物上独立复现了（lib/index.js:125 的 recordRequest 确实在 :133 的 fetch 之前，你方案②——新加一个独立 recordUsage 回调——必须新加，没法复用 recordRequest）。

先补上你说无法核对的那半块——本地有平台按 key 导出的 amount/cost CSV，9-19 全天（deepseek-flash）逐项可复算：request_count 2098、miss 13,105,799、output 1,657,037、hit 200,271,744；按 CSV 自带单价实扣 23.7393 元，其中搜索侧 ≈ 13.73 元（57.8%）。报告里的数字都对得上。

关于你提的设计问题，我倾向不要折进同一个 tokenUsage：那个投影不只是用量账，它的 view 同时暴露 contextWindow / pressureTokens / projectedTokens，而 compaction 的触发阈值正是读这个量。搜索调用不占会话表面，并进去会让 projectedTokens 虚高，压缩会提前触发，报表口径也一起失真。更稳的是单独一个桶（独立事件 + 独立投影），并在报表里显式标注"不含联网搜索用量"——后者零代码改动就能先落地。

另外按这个思路，你补丁第③条里的 usageOf() 其实不用扩——SessionEventMap 加新事件、再挂一个独立投影就够了，改动比原方案还小。

个人侧补充：我已把 searchProvider 切到 dsh-web-search-free（纯检索通道），默认通道对本机账单不再生效；但本地统计与平台账单差 2.4 倍这个事实本身，说明上游仍值得修。

一点边界：你引的是仓库 main 的源码行号，我只能拿本机 npm 包的构建产物验证语义、没法逐行对齐；docs/persistence-catalog.md 里的 log-only 标注本机没有该文件，未核；352 次搜索那个数字来自我的会话日志，也没重新统计。