mslxdff 0.1.171 → 0.1.172

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "mslxdff",
-  "version": "0.1.171",
+  "version": "0.1.172",
   "description": "测试项目，请勿使用。",
   "type": "module",
   "bin": {

package/src/model-capabilities/context-lookup.js

@@ -0,0 +1,65 @@
+// 模型上下文窗口的四级解析（ADR-0054）：/v1/models 富化时唯一真相源。
+// 旧状：顶层 context_length（provider 自报）与 capabilities.context（models.dev）两套并行可能矛盾，
+// 且四层全空时什么都不报；本模块把优先级收死，并保证"双层同源同值"。
+// 纯函数 + env，无 IO 无网络（L1/L2/L4 不依赖目录，冷缓存/目录挂掉照常生效）。
+// L4 方向沿上游 workbuddy2api-hub："未知报 1M——高估比低估安全"（只作元数据，网关转发不读它）。
+
+export const DEFAULT_CONTEXT_FALLBACK = 1_000_000;
+
+/** L4 兜底值：`MSLXDFF_MODEL_CONTEXT_FALLBACK` 覆盖；0/负数 = 关闭兜底（回"未知不报"旧口径）；非法值按默认 1M。 */
+export function contextFallback() {
+  const raw = String(process.env.MSLXDFF_MODEL_CONTEXT_FALLBACK ?? "").trim();
+  if (raw === "") return DEFAULT_CONTEXT_FALLBACK;
+  const n = Number(raw);
+  if (!Number.isFinite(n)) return DEFAULT_CONTEXT_FALLBACK;
+  if (n <= 0) return 0;
+  const f = Math.floor(n);
+  return f > 0 ? f : DEFAULT_CONTEXT_FALLBACK; // (0,1) 被.floor 成 0 会静默变"关兜底"，按非法回默认
+}
+
+function positiveInt(v) {
+  if (typeof v !== "number" && typeof v !== "string") return null; // boolean/数组/对象 = 未自报，不猜
+  const n = Number(v);
+  return Number.isFinite(n) && n > 0 ? Math.floor(n) : null;
+}
+
+/** L1 条目自报（first-party 最准）。键序覆盖现网全部自报形状；非数字/0/负数 = 未自报，丢弃而非钳制。 */
+export function firstPartyContextOf(entry) {
+  if (!entry || typeof entry !== "object") return null;
+  for (const v of [entry.context_length, entry.maxInputTokens, entry.max_input_tokens]) {
+    const n = positiveInt(v);
+    if (n) return n;
+  }
+  const cw = entry.contextWindow;
+  return positiveInt(cw && typeof cw === "object" ? cw.defaultLength : cw);
+}
+
+// L2 内置知识表：给"provider 目录不自报窗口、且值有官方/上游文档出处"的模型补一手。
+// 准入红线（评审过：无据值不得进表——traework 硬编码 131072 正是反面教材，本次已删）：
+//   - key = **实际传入解析器的条目 id 小写**（现网含裸 id 与 `-free` 后缀形态；填表前必须按此对键，
+//     跨 provider 撞名靠带前缀的 id 天然区分），别照 ADR 初稿的 `prov/raw` canonical 形去猜；
+//   - 每条必须带 source 出处注释（文档/上游字段 + 核对日期），给不出出处就让它落 L4 兜底。
+// 首期为空是盘点结论：raccoon/qoder/codearts/workbuddy/globalworkbuddy/qwenwork 系的有据值全部已被 L1 覆盖，
+// 把 L1 复制进表只会制造第二个真相源。等出现"只回 id 的极简目录 provider"之类的真缺口再填。
+export const KNOWN_CONTEXT = Object.freeze({});
+
+/** L2 查表（按条目 id 小写）；未命中或值非法返回 null。`table` 为测试注入口（缺省用内置表）。 */
+export function knownContextOf(id, table = KNOWN_CONTEXT) {
+  const e = table[String(id || "").trim().toLowerCase()];
+  return e ? positiveInt(e.context) : null;
+}
+
+/**
+ * 四级解析：L1 自报 > L2 内置表 > L3 models.dev caps > L4 兜底。
+ * 返回正整数；env 关闭兜底且 L1–L3 全空时返回 null（调用方两层都不写）。
+ * `knownTable` 仅供测试注入假表锁 L2>L3 顺序，生产调用方不传。
+ */
+export function resolveContextLength({ entry, id, caps, knownTable } = {}) {
+  const fp = firstPartyContextOf(entry);
+  if (fp) return fp;
+  const known = knownContextOf(id, knownTable);
+  if (known) return known;
+  const c = positiveInt(caps?.context);
+  if (c) return c;
+  return contextFallback() || null;
+}

package/src/model-capabilities/merge.js

@@ -1,8 +1,10 @@
-// /v1/models 能力富化（ADR-0022）：把 models.dev 目录（+ workbuddy 原生字段兜底）
-// 的能力合并进 /v1/models 每条 data 条目的 `capabilities` 子对象，客户端与 CLI 一眼可读。
+// /v1/models 能力富化（ADR-0022 + ADR-0054）：把 models.dev 目录（+ workbuddy 原生字段兜底）
+// 的能力合并进每条 data 条目的 `capabilities` 子对象；上下文窗口由 context-lookup 四级解析
+// 统一裁决并双层同源写入（顶层 context_length 与 capabilities.context 恒同值）。
 // 逃生门：GET /v1/models?raw=1 保持 ADR-0016 的原始透传形状；codex 调用者恒原始 + 空 models:[]。
-// 全程 best-effort：目录不可用 → 原样返回，绝不让 /models 因富化失败挂掉。
+// 全程 best-effort：富化失败不阻塞 /models，context 一致化不依赖目录（冷缓存照常生效）。
 import { globalCapabilities } from "./index.js";
+import { resolveContextLength } from "./context-lookup.js";
 
 // "cline/deepseek/deepseek-v4-flash" → { provider: "cline", raw: "deepseek/deepseek-v4-flash" }；裸 id 归 opencode
 export function splitModelId(id) {
@@ -82,46 +84,59 @@ function lookupCapsDeep(svc, provider, raw) {
  * wbSource 显式 null 禁用 workbuddy 兜底（测试用）。
  */
 export async function mergeModelsList(data, { capsSvc, wbSource } = {}) {
-  const svc = capsSvc === undefined ? globalCapabilities() : capsSvc;
   const entries = Array.isArray(data?.data) ? data.data : [];
-  if (!svc || !entries.length) return data;
-  // 只用内存/磁盘缓存热身；冷缓存绝不阻塞请求（后台拉新，下次请求即富化）
-  try {
-    const warmed = svc.readyWarm ? await svc.readyWarm() : await svc.ready();
-    if (!warmed) return data;
-  } catch {
-    return data;
+  if (!entries.length) return data;
+  const svc = capsSvc === undefined ? globalCapabilities() : capsSvc;
+  // 目录冷缓存/抛错不阻塞：context 一致化（L1/L2/L4）不依赖目录，照常生效（ADR-0054）
+  let catalogReady = false;
+  if (svc) {
+    try {
+      catalogReady = svc.readyWarm ? await svc.readyWarm() : await svc.ready();
+    } catch {
+      catalogReady = false;
+    }
   }
-  // 第一遍：目录直查；workbuddy 未命中记下，第二遍走上游原生字段
+  // L3 目录直查（仅就绪时）；workbuddy 未命中第二遍走上游原生字段
   const resolved = new Map(); // index -> caps
-  const needWb = []; // [index, raw]
-  entries.forEach((entry, i) => {
-    const id = String(entry?.id || "");
-    if (!id) return;
-    const { provider, raw } = splitModelId(id);
-    const caps = lookupCapsDeep(svc, provider, raw);
-    if (caps) resolved.set(i, caps);
-    else if (provider === "workbuddy" && wbSource !== null) needWb.push([i, raw]);
-  });
-  if (needWb.length) {
-    try {
-      const { workbuddyCapsFromModels, workbuddyAllModels } = await import("./index.js");
-      const wbMap = await workbuddyCapsFromModels(wbSource || workbuddyAllModels)();
-      for (const [i, raw] of needWb) {
-        const caps = wbMap?.[raw] || null;
-        if (caps) resolved.set(i, caps);
+  if (catalogReady) {
+    const needWb = []; // [index, raw]
+    entries.forEach((entry, i) => {
+      const id = String(entry?.id || "");
+      if (!id) return;
+      const { provider, raw } = splitModelId(id);
+      const caps = lookupCapsDeep(svc, provider, raw);
+      if (caps) resolved.set(i, caps);
+      else if (provider === "workbuddy" && wbSource !== null) needWb.push([i, raw]);
+    });
+    if (needWb.length) {
+      try {
+        const { workbuddyCapsFromModels, workbuddyAllModels } = await import("./index.js");
+        const wbMap = await workbuddyCapsFromModels(wbSource || workbuddyAllModels)();
+        for (const [i, raw] of needWb) {
+          const caps = wbMap?.[raw] || null;
+          if (caps) resolved.set(i, caps);
+        }
+      } catch {
+        // workbuddy 源不可用：这些条目保持无能力，不拖垮整个列表
       }
-    } catch {
-      // workbuddy 源不可用：这些条目保持无能力，不拖垮整个列表
     }
   }
-  if (!resolved.size) return data;
+  // 产物：capabilities（caps 语义字段 + 解析出的 context）+ 顶层 context_length 同源同值（ADR-0054 决定 2：
+  // 两层要么同写要么同不写，绝不给客户端两种答案）；caps 未命中只补 { context }，不硬造能力声明（能力不知道就沉默）
   const next = entries.map((entry, i) => {
-    const caps = resolved.get(i);
-    if (!caps) return entry;
+    if (!entry || typeof entry !== "object") return entry; // 异形条目原样透传，不凭空造成员
+    const caps = resolved.get(i) || null;
+    const ctx = resolveContextLength({ entry, id: String(entry?.id || ""), caps });
+    if (!caps && !ctx) return entry; // env 关兜底 + 全未命中：回旧口径
     const { raw } = splitModelId(String(entry?.id || ""));
-    const payload = capsPayloadFor(caps, raw);
-    return payload ? { ...entry, capabilities: payload } : entry;
+    const capsPart = caps ? capsPayloadFor(caps, raw) : null;
+    const capabilities = capsPart
+      ? (ctx ? { ...capsPart, context: ctx } : capsPart)
+      : (ctx ? { context: ctx } : null);
+    if (!capabilities) return entry;
+    const out = ctx ? { ...entry, context_length: ctx } : { ...entry };
+    out.capabilities = capabilities;
+    return out;
   });
   return { ...data, data: next };
 }

package/src/providers/traework/models.js

@@ -3,7 +3,8 @@ import { AGENT_HOST, EP_MODELS, FUNCTION, DEFAULT_MODEL } from "./constants.js";
 import { soloHeaders } from "./headers.js";
 import { joinModelId } from "../model-id.js";
 
-const CTX = 131072;
+// 窗口自报已删（ADR-0054）：此前对所有模型硬编码 context_length=131072，无任何依据；
+// 现交由 /v1/models 富化的四级解析统一裁决——本 provider 不自报，未知落 1M 兜底。
 const CREATED = 1753600000;
 const OWNER = "trae-solo";
 
@@ -19,7 +20,7 @@ export const STATIC_MODEL_IDS = [
 ];
 
 export function staticModels(id = "traework") {
-  return STATIC_MODEL_IDS.map((m) => ({ id: joinModelId(id, m), object: "model", created: CREATED, owned_by: OWNER, context_length: CTX }));
+  return STATIC_MODEL_IDS.map((m) => ({ id: joinModelId(id, m), object: "model", created: CREATED, owned_by: OWNER }));
 }
 
 export function normalizeModelName(s) {
@@ -78,7 +79,7 @@ export function createModelsService({
     if (cache && now - fetchedAt < CACHE_TTL_MS) return cache;
     try {
       const dyn = await fetchDynamic();
-      cache = dyn.map((m) => ({ id: joinModelId(id, m.id), object: "model", created: CREATED, owned_by: OWNER, context_length: CTX, name: m.name }));
+      cache = dyn.map((m) => ({ id: joinModelId(id, m.id), object: "model", created: CREATED, owned_by: OWNER, name: m.name }));
       fetchedAt = now;
       return cache;
     } catch {