dsh-connect-trae 2.0.3 → 2.0.4

package/CHANGELOG.md

@@ -1,5 +1,15 @@
 # Changelog
 
+## 2.0.4 (2026-09-16)
+
+### Fixes
+
+- **修复「某个区域没有实时模型目录时，该区域的 provider 整个加载失败」**（issue #8：未安装国际版的用户看到 `Trae Global 加载失败：adapter returned invalid context metadata for provider "trae-global" model "gemini-3.1-pro"`）：
+  - **根因**：两个区域的内置兜底目录里，每个模型都缺少 `contextWindow`。DSH 要求它必须是正整数（`INVALID_MODEL_CONTEXT`），而 `dsh-llm-pi-ai` 的回退链是 `entry.contextWindow → 已安装 catalog → request.defaultContextWindow`——本插件既没传 `defaultContextWindow`，兜底模型也不在已安装 catalog 里，三条全空，于是校验失败。
+  - **失败粒度是 provider 级**：不是丢单个模型，而是**整个区域不可用**。触发场景包括未安装该区客户端、未登录、目录拉取失败（该端点有已知的间歇性 401）、以及首次安装尚未刷新过目录。因此这不是「没装国际版拖累国内版」，而是**两个区域各自独立地有这个缺陷**。
+  - **修复**：(1) 兜底目录补上实测 `contextWindow`——国际版依据 2026-09-15 实测目录（`gemini-3.1-pro`/`gemini-3-flash-solo`/`minimax-m3`/`minimax-m2.7`/`kimi-k2.5` = 200000，`gpt-5.4`/`gpt-5.2` = 272000），国内版依据 SOLO 通道实测（200000）；(2) adapter 传 `defaultContextWindow` 作为最终防线，将来任何来源的条目不慎缺字段时降级为「一个保守尺寸的模型」而非「整区不可用」。
+  - 新增不变量测试：**两个区域的兜底行都必须带正整数 `contextWindow`**。原先有一条测试断言「兜底条目没有 `contextWindow`」——它固化的正是这个 bug，已改正。
+
 ## 2.0.3 (2026-09-16)
 
 ### Fixes

package/lib/index.d.ts

@@ -126,6 +126,14 @@ interface TraeModelInfo {
  * `DeepSeek-V4-Pro-Official` carry the `-Official` suffix, and there is no
  * `auto` config_name — an `auto` row was previously served here and would have
  * failed on selection.
+ *
+ * Every row MUST also carry a positive-integer `contextWindow`. DSH rejects an
+ * adapter whose model has no usable context (`INVALID_MODEL_CONTEXT`), and that
+ * failure is per-provider — one bad row takes the whole region offline. These
+ * rows are exactly the ones served when no live directory is available (no
+ * install for that region, signed out, or a failed refresh), which is precisely
+ * when the fallback is doing its job, so a missing field here is fatal rather
+ * than cosmetic. See docs/ISSUE8_DIAGNOSIS.md.
  */
 declare const FALLBACK_TRAE_MODELS: readonly TraeModelInfo[];
 /**
@@ -135,6 +143,10 @@ declare const FALLBACK_TRAE_MODELS: readonly TraeModelInfo[];
  * has no Gemini/GPT/MiniMax entries), so an international account must never
  * be seeded with the CN list. Like the CN fallback it is replaced by the live
  * refresh; image input stays the user's explicit opt-in (`imageModelIds`).
+ *
+ * The `contextWindow` values are the measured ones from that same capture
+ * (`docs/INTL_SG_EVIDENCE.md` §3) and are required for the same reason as the
+ * CN fallback: without them the whole `trae-global` provider fails to load.
  */
 declare const FALLBACK_TRAE_MODELS_AI: readonly TraeModelInfo[];
 /**

package/lib/index.js

@@ -29,23 +29,35 @@ import { promisify } from "node:util";
 * `DeepSeek-V4-Pro-Official` carry the `-Official` suffix, and there is no
 * `auto` config_name — an `auto` row was previously served here and would have
 * failed on selection.
+*
+* Every row MUST also carry a positive-integer `contextWindow`. DSH rejects an
+* adapter whose model has no usable context (`INVALID_MODEL_CONTEXT`), and that
+* failure is per-provider — one bad row takes the whole region offline. These
+* rows are exactly the ones served when no live directory is available (no
+* install for that region, signed out, or a failed refresh), which is precisely
+* when the fallback is doing its job, so a missing field here is fatal rather
+* than cosmetic. See docs/ISSUE8_DIAGNOSIS.md.
 */
 const FALLBACK_TRAE_MODELS = [
 	{
 		id: "DeepSeek-V4-Flash-Official",
-		name: "DeepSeek-V4-Flash"
+		name: "DeepSeek-V4-Flash",
+		contextWindow: 2e5
 	},
 	{
 		id: "DeepSeek-V4-Pro-Official",
-		name: "DeepSeek-V4-Pro"
+		name: "DeepSeek-V4-Pro",
+		contextWindow: 2e5
 	},
 	{
 		id: "glm-5.2",
-		name: "GLM-5.2"
+		name: "GLM-5.2",
+		contextWindow: 2e5
 	},
 	{
 		id: "kimi-k2.6",
-		name: "Kimi-K2.6"
+		name: "Kimi-K2.6",
+		contextWindow: 2e5
 	}
 ];
 /**
@@ -55,35 +67,46 @@ const FALLBACK_TRAE_MODELS = [
 * has no Gemini/GPT/MiniMax entries), so an international account must never
 * be seeded with the CN list. Like the CN fallback it is replaced by the live
 * refresh; image input stays the user's explicit opt-in (`imageModelIds`).
+*
+* The `contextWindow` values are the measured ones from that same capture
+* (`docs/INTL_SG_EVIDENCE.md` §3) and are required for the same reason as the
+* CN fallback: without them the whole `trae-global` provider fails to load.
 */
 const FALLBACK_TRAE_MODELS_AI = [
 	{
 		id: "gemini-3.1-pro",
-		name: "Gemini-3.1-Pro-Preview"
+		name: "Gemini-3.1-Pro-Preview",
+		contextWindow: 2e5
 	},
 	{
 		id: "gemini-3-flash-solo",
-		name: "Gemini-3-Flash-Preview"
+		name: "Gemini-3-Flash-Preview",
+		contextWindow: 2e5
 	},
 	{
 		id: "minimax-m3",
-		name: "MiniMax-M3"
+		name: "MiniMax-M3",
+		contextWindow: 2e5
 	},
 	{
 		id: "minimax-m2.7",
-		name: "MiniMax-M2.7"
+		name: "MiniMax-M2.7",
+		contextWindow: 2e5
 	},
 	{
 		id: "kimi-k2.5",
-		name: "Kimi-K2.5"
+		name: "Kimi-K2.5",
+		contextWindow: 2e5
 	},
 	{
 		id: "gpt-5.4",
-		name: "GPT-5.4"
+		name: "GPT-5.4",
+		contextWindow: 272e3
 	},
 	{
 		id: "gpt-5.2",
-		name: "GPT-5.2"
+		name: "GPT-5.2",
+		contextWindow: 272e3
 	}
 ];
 /**
@@ -292,6 +315,13 @@ const REQUEST_IMAGE_BUDGETS = {
 	requestImagePixelBudget: 4194304,
 	requestImageMaxBytes: 1048576
 };
+/**
+* Conservative context capacity used only when a served model row carries no
+* window of its own. Every fallback row and every live Trae row is expected to
+* state its real window; this is the backstop that keeps one unsized row from
+* failing the entire provider route (`INVALID_MODEL_CONTEXT`).
+*/
+const FALLBACK_CONTEXT_WINDOW = 2e5;
 function toPiModel(info, baseUrl, providerId) {
 	return {
 		id: info.id,
@@ -351,6 +381,7 @@ function createTraeAdapter(options) {
 		retryPolicy: resolveRetryPolicy(void 0, "dsh-connect-trae retryPolicy"),
 		configuredMaxTokens: /* @__PURE__ */ new Map(),
 		modelErrors: /* @__PURE__ */ new Map(),
+		defaultContextWindow: FALLBACK_CONTEXT_WINDOW,
 		...REQUEST_IMAGE_BUDGETS,
 		piProvider: provider
 	};

package/package.json

@@ -2,7 +2,7 @@
   "name": "dsh-connect-trae",
   "displayName": "DSH Connect Trae",
   "description": "Connect locally signed-in Trae models to DeepSeek Harness, plus a read-only usage/credits summary.",
-  "version": "2.0.3",
+  "version": "2.0.4",
   "author": "dingminhua",
   "copyright": "Copyright (c) 2026 LaoDing",
   "license": "MIT",