dsh-connect-trae 4.6.3 → 4.6.4

package/CHANGELOG.md

@@ -1,5 +1,51 @@
 # Changelog
 
+## 4.6.4 (2026-10-28)
+
+> **缓存命中恒为 0% 不是插件丢了数字，是上游没有分配缓存池。** Trae 的
+> `metadata` 事件里 `prompt_cache_pool_record` 非空才代表这次请求挂了前缀
+> 缓存池；实测 CN/AI 双区、4 个账号、7 个模型、4 种 function，该字段
+> **100% 为 `null`**。没有池，`cache_read_input_tokens` 只能是 0 —— 0% 是
+> 正确读数。本版把这个事实变成可观测的，用户不必再怀疑插件吞了数据。
+
+### 修复
+
+- **上游的缓存池事实与管线名不再被丢弃**（#67）。
+  - **现象**：无论简单还是复杂提问，缓存命中恒为 0%，十个会话一致；
+    同时 tps 在 60–80 之间浮动。
+  - **根因**：不是插件。issue #10 的转发修复仍在（`lib/index.js` 含
+    `cached_tokens`，同版本下 `workbuddy`/`dsh-opencode-go` 命中显示正常），
+    是上游 `llm_utils_chat` 改由 `llm_raw_chat_v2` 管线、火山方舟 `ep-…`
+    端点承载后，不再为这些请求分配前缀缓存池。当初产出 5248/9216 的
+    `scripts/probe-cache-convention.mjs` 原样重跑，现在三轮全是 0。
+  - **修法**：`sse.ts` 新增 `diagnostic` 事件类型，解码 `metadata`
+    （`prompt_cache_pool_record`）与 `timing_cost`（`name` 管线名、
+    `provider_model_name`）；`solo-bridge.ts` 通过可选 `log` 上报
+    `promptCachePoolRecord` / `pipeline` / `providerModelName`；
+    `index.ts` 四个 `TraeSoloBridge` 构造点接入 `ctx.logger.warn`。
+    诊断事件不进答案文本、不改 usage 映射，**对外行为不变**。
+  - **为什么区分 `null` 与「字段不存在」**：`null` 是上游明确表示「没挂池」，
+    字段缺失只是没这条信息；两者混为一谈就又回到「看不出是谁的问题」。
+
+### 修复（顺带守住一个回归）
+
+- **`metadata` 不能被 peek 当成「上游已应答」**。它现在是被认识的事件类型，
+  若据此停止 peek，紧跟其后的拒绝（如 `1005` 未订阅）会退化成截断的 200 流
+  —— 正是 issue #19 的故障形态。`openTraeSource` 显式把 `diagnostic` 排除在
+  「已应答」之外。
+
+### 测试
+
+- `tests/sse.spec.ts`：`metadata` / `timing_cost` 解码为 `diagnostic`，
+  保留 `prompt_cache_pool_record: null`，且区分字段缺失。
+- `tests/solo-bridge.spec.ts`：诊断事实上报（含 `null` 原样保留、事件不泄漏进
+  答案）；`metadata` 之后紧跟的 `1005` 仍转成 402 `hard_credit`。
+
+### 说明
+
+- 诊断细节与完整证据链见 `docs/ISSUE67_DIAGNOSIS.md`（不随 npm 包发布）。
+- 上游若开始分配缓存池，`cached_tokens` 会自动恢复显示，插件侧无需再改。
+
 ## 4.6.3 (2026-10-27)
 
 > **国际版美国区账号不会再被当成新加坡区。** 它的凭据明明写着

package/lib/index.d.ts

@@ -3426,6 +3426,29 @@ type TraeStreamEvent = {
    */
   cacheReadTokens?: number;
   cacheWriteTokens?: number;
+} | {
+  /**
+   * The upstream's own account of how the request was served: `metadata`
+   * (acceptance, plus `prompt_cache_pool_record`) and `timing_cost` (the
+   * pipeline and the backing provider model).
+   *
+   * These events were previously folded into `unknown` and dropped. That
+   * mattered for issue #67: `prompt_cache_pool_record` is the ONLY upstream
+   * signal that says whether a prompt-cache pool was even attached to the
+   * request, so with it dropped a "0% cache" report could not be told apart
+   * from a plugin that lost the numbers. See docs/ISSUE67_DIAGNOSIS.md.
+   */
+  type: 'diagnostic';
+  /**
+   * `metadata.prompt_cache_pool_record`. `null` is a real, observed value
+   * (100% of measured requests on 2026-10-28) and means the upstream attached
+   * no cache pool; it is kept distinct from "the field was absent".
+   */
+  promptCachePoolRecord?: unknown;
+  /** `timing_cost.name`, e.g. `llm_raw_chat_v2`. */
+  pipeline?: string;
+  /** `timing_cost.provider_model_name` — the model that actually answered. */
+  providerModelName?: string;
 } | {
   type: 'done';
   finishReason: string;
@@ -3569,7 +3592,21 @@ declare class TraeSoloBridge implements TraeUpstreamClient {
   private readonly upstream;
   private readonly catalog?;
   private readonly wireResolver?;
-  constructor(upstream: TraeUpstreamClient, catalog?: Pick<TraeCatalog, "current"> | undefined, wireResolver?: TraeWireResolver | undefined);
+  /**
+   * Optional sink for the upstream's own diagnostics (`metadata` /
+   * `timing_cost`). Issue #67: without it, `prompt_cache_pool_record: null`
+   * was invisible, so "the upstream attached no cache pool" and "the plugin
+   * lost the numbers" looked identical to a user reading a 0% cache rate.
+   */
+  private readonly log?;
+  constructor(upstream: TraeUpstreamClient, catalog?: Pick<TraeCatalog, "current"> | undefined, wireResolver?: TraeWireResolver | undefined,
+  /**
+   * Optional sink for the upstream's own diagnostics (`metadata` /
+   * `timing_cost`). Issue #67: without it, `prompt_cache_pool_record: null`
+   * was invisible, so "the upstream attached no cache pool" and "the plugin
+   * lost the numbers" looked identical to a user reading a 0% cache rate.
+   */
+  log?: ((message: string, detail?: unknown) => void) | undefined);
   chatStream(bodyJson: string, signal?: AbortSignal): Promise<TraeChatResult>;
 }
 //#endregion

package/lib/index.js

@@ -5581,6 +5581,12 @@ function decodeTraeEvent(event) {
 		...typeof record["cache_read_input_tokens"] === "number" ? { cacheReadTokens: record["cache_read_input_tokens"] } : {},
 		...typeof record["cache_creation_input_tokens"] === "number" ? { cacheWriteTokens: record["cache_creation_input_tokens"] } : {}
 	};
+	if (event.event === "metadata" || event.event === "timing_cost") return {
+		type: "diagnostic",
+		...record["prompt_cache_pool_record"] === void 0 ? {} : { promptCachePoolRecord: record["prompt_cache_pool_record"] },
+		...typeof record["name"] === "string" ? { pipeline: record["name"] } : {},
+		...typeof record["provider_model_name"] === "string" ? { providerModelName: record["provider_model_name"] } : {}
+	};
 	if (event.event === "done" || typeof record["finish_reason"] === "string" && record["response"] === void 0) return {
 		type: "done",
 		finishReason: typeof record["finish_reason"] === "string" ? record["finish_reason"] : "stop"
@@ -5747,7 +5753,7 @@ function bridgeTraeSoloStream(response, model) {
 	return bridgeTraeSource(source, model);
 }
 /** {@link bridgeTraeSoloStream} over an already-opened byte stream. */
-function bridgeTraeSource(source, model) {
+function bridgeTraeSource(source, model, log) {
 	const id = `chatcmpl-${randomUUID().replaceAll("-", "").slice(0, 24)}`;
 	const created = Math.floor(Date.now() / 1e3);
 	const decoder = new TextDecoder();
@@ -5780,6 +5786,15 @@ function bridgeTraeSource(source, model) {
 					if (failure !== void 0) upstreamError = new Error(describeTraeFailure(failure));
 					return;
 				}
+				if (decoded.type === "diagnostic") {
+					if (decoded.promptCachePoolRecord !== void 0 || decoded.pipeline !== void 0) log?.("dsh-connect-trae: upstream request diagnostics", {
+						model,
+						promptCachePoolRecord: decoded.promptCachePoolRecord,
+						pipeline: decoded.pipeline,
+						providerModelName: decoded.providerModelName
+					});
+					return;
+				}
 				if (decoded.type === "delta") {
 					const delta = {};
 					if (decoded.text !== "") delta["content"] = decoded.text;
@@ -5932,7 +5947,7 @@ async function openTraeSource(response) {
 						message: describeTraeFailure(failure)
 					};
 				}
-				if (decoded.type !== "unknown") answered = true;
+				if (decoded.type !== "unknown" && decoded.type !== "diagnostic") answered = true;
 			}
 			if (answered) break;
 		}
@@ -5956,12 +5971,12 @@ async function openTraeSource(response) {
 * The sibling {@link bridgeTraeSoloStream} stays synchronous and always answers
 * 200; it is the primitive, and this is the policy the bridge class uses.
 */
-async function bridgeTraeSoloStreamOrFail(response, model) {
+async function bridgeTraeSoloStreamOrFail(response, model, log) {
 	const opened = await openTraeSource(response);
 	if (!opened.ok) return opened;
 	return {
 		ok: true,
-		response: bridgeTraeSource(opened.source, model)
+		response: bridgeTraeSource(opened.source, model, log)
 	};
 }
 /**
@@ -6002,10 +6017,12 @@ var TraeSoloBridge = class {
 	upstream;
 	catalog;
 	wireResolver;
-	constructor(upstream, catalog, wireResolver) {
+	log;
+	constructor(upstream, catalog, wireResolver, log) {
 		this.upstream = upstream;
 		this.catalog = catalog;
 		this.wireResolver = wireResolver;
+		this.log = log;
 	}
 	async chatStream(bodyJson, signal) {
 		let model = "glm-5.2";
@@ -6093,7 +6110,7 @@ var TraeSoloBridge = class {
 		}
 		const result = await this.upstream.chatStream(prepared, signal);
 		if (!result.ok) return result;
-		return await bridgeTraeSoloStreamOrFail(result.response, model);
+		return await bridgeTraeSoloStreamOrFail(result.response, model, this.log);
 	}
 };
 //#endregion
@@ -11189,7 +11206,7 @@ function apply(ctx, config) {
 				route,
 				log: (message, detail) => ctx.logger.warn(message, detail)
 			});
-			const delegating = new TraeDelegatingUpstreamClient(new TraeSoloBridge(client, catalog, wireResolver));
+			const delegating = new TraeDelegatingUpstreamClient(new TraeSoloBridge(client, catalog, wireResolver, (message, detail) => ctx.logger.warn(message, detail)));
 			routeClients[provider] = {
 				provider,
 				route,
@@ -11230,7 +11247,7 @@ function apply(ctx, config) {
 							runtime: resolved.runtime
 						}
 					}),
-					solo: new TraeSoloBridge(primary.client, catalog, wireResolver),
+					solo: new TraeSoloBridge(primary.client, catalog, wireResolver, (message, detail) => ctx.logger.warn(message, detail)),
 					endpoint: `${REGION_GATEWAYS.cn.chat}/api/ide/v2/llm_raw_chat`,
 					edition: resolved.identity.edition,
 					identity: {
@@ -11627,7 +11644,7 @@ function apply(ctx, config) {
 				identity: () => stack.identity(),
 				route: stack.routeOf(providerOfPanel(panel)),
 				log: (message, detail) => ctx.logger.warn(message, detail)
-			}), stack.catalog, stack.wireResolver)
+			}), stack.catalog, stack.wireResolver, (message, detail) => ctx.logger.warn(message, detail))
 		};
 	}
 	/**
@@ -11709,7 +11726,7 @@ function apply(ctx, config) {
 				identity: () => stack.identity(),
 				route: stack.routeOf(providerOfPanel(panel)),
 				log: (message, detail) => ctx.logger.warn(message, detail)
-			}), stack.catalog, stack.wireResolver);
+			}), stack.catalog, stack.wireResolver, (message, detail) => ctx.logger.warn(message, detail));
 			const chat = (body, signal) => bridge.chatStream(body, signal);
 			bridges.set(accountId, chat);
 			return chat;

package/package.json

@@ -2,7 +2,7 @@
   "name": "dsh-connect-trae",
   "displayName": "DSH Connect Trae",
   "description": "把本机登录的 Trae 模型接入 DeepSeek Harness：国内版与国际版双供应商并行，提供用量/积分概览与每日签到领取。",
-  "version": "4.6.3",
+  "version": "4.6.4",
   "author": "dingminhua",
   "copyright": "Copyright (c) 2026 LaoDing",
   "license": "MIT",