mslxdff 0.1.170 → 0.1.172

package/src/daemon.js

@@ -1,112 +1,112 @@
-import { spawn, spawnSync } from "node:child_process";
-import { appendFileSync, existsSync, mkdirSync, openSync, readFileSync, writeFileSync, unlinkSync } from "node:fs";
-import { join, dirname } from "node:path";
-import os from "node:os";
-import { fileURLToPath } from "node:url";
-import { writeExitMarker } from "./runtime/lifecycle-forensics.js";
-
-export function daemonDir() {
-  return process.env.MSLXDFF_DAEMON_DIR || join(os.homedir(), ".config", "mslxdff");
-}
-
-export function pidFile() {
-  return join(daemonDir(), "daemon.pid");
-}
-
-export function logFile() {
-  return join(daemonDir(), "daemon.log");
-}
-
-// 当前代码所在的 CLI 入口（bin/mslxdff.js 绝对路径）：startDaemon 与
-// auto-update 的 -restart 委托共用（后者从 daemon 进程 spawn 时必须指向同一份代码）。
-export function daemonEntry() {
-  const here = fileURLToPath(import.meta.url);
-  return here.endsWith("bin/mslxdff.js")
-    ? here
-    : join(dirname(here), "..", "bin", "mslxdff.js");
-}
-
-export function startDaemon(args = []) {
-  const entry = daemonEntry();
-  const dir = daemonDir();
-  mkdirSync(dir, { recursive: true });
-  const logFd = openSync(logFile(), "a", 0o600);
-  const env = { ...process.env, MSLXDFF_DAEMON: "1" };
-  // a -debug foreground session wouldn't pass MSLXDFF_DEBUG to the
-  // background daemon it restores (that flag means "print events to stdout")
-  delete env.MSLXDFF_DEBUG;
-  const child = spawn(process.execPath, [entry, ...args, "--daemon"], {
-    detached: true,
-    stdio: ["ignore", logFd, logFd],
-    env,
-  });
-  child.unref();
-  return child.pid;
-}
-
-export function writePid(pid, version) {
-  const dir = daemonDir();
-  mkdirSync(dir, { recursive: true });
-  writeFileSync(pidFile(), version ? `${pid}\n${version}` : String(pid), { mode: 0o600 });
-}
-
-export function readPid() {
-  if (!existsSync(pidFile())) return null;
-  const raw = readFileSync(pidFile(), "utf8").trim();
-  const n = Number(raw.split("\n")[0]);
-  return Number.isInteger(n) && n > 0 ? n : null;
-}
-
-export function readPidVersion() {
-  if (!existsSync(pidFile())) return null;
-  const raw = readFileSync(pidFile(), "utf8");
-  const lines = raw.split("\n");
-  return lines.length > 1 && lines[1].trim() ? lines[1].trim() : null;
-}
-
-// Best-effort liveness check (signal 0); ESRCH means the process is gone.
-export function isPidAlive(pid) {
-  try {
-    process.kill(pid, 0);
-    return true;
-  } catch (err) {
-    return err.code !== "ESRCH";
-  }
-}
-
-export function stopDaemon({ reason = "stop" } = {}) {
-  const pid = readPid();
-  if (!pid) return { stopped: false, reason: "no pid file" };
-  // 杀者牌（验尸官的另一半证据）：动手前写、自带死者身份。只给在世者留牌——给尸体留牌
-  // 会让下次验尸把"早已静默死亡"误判成"被本次杀死"。
-  const victimAlive = isPidAlive(pid);
-  // 杀者留痕（写 daemon.log）：Windows 的 SIGTERM 是 TerminateProcess 强杀，被杀的 daemon
-  // 在 JS 层收不到任何事件（无法自记），故由"杀者"记录调用方 pid——
-  // 没有这行 = 非我方所杀（外部 taskkill/任务管理器/崩溃），配合最后一条 heartbeat 定位死亡时刻。
-  try {
-    appendFileSync(logFile(), `[lifecycle] stopDaemon called by pid=${process.pid} — killing daemon pid=${pid}\n`);
-  } catch {}
-  if (victimAlive) { try { writeExitMarker(daemonDir(), { reason, prevPid: pid, prevVersion: readPidVersion(), byPid: process.pid }); } catch {} }
-  let killFailed = false;
-  try {
-    process.kill(pid, "SIGTERM");
-  } catch (err) {
-    if (err.code === "ESRCH") {
-      // process already gone — nothing to do
-    } else if (err.code === "EPERM" && process.platform === "win32") {
-      // Windows: process.kill uses TerminateProcess which requires matching elevation.
-      // Fall back to taskkill /F which can terminate processes we don't own a handle to.
-      const r = spawnSync("taskkill", ["/PID", String(pid), "/F"], { windowsHide: true });
-      if (r.error || r.status !== 0) killFailed = true;
-    } else {
-      throw err;
-    }
-  }
-  try {
-    unlinkSync(pidFile());
-  } catch {
-    // already gone
-  }
-  if (killFailed) return { stopped: false, pid, reason: "EPERM — process kill denied (try running terminal as Administrator, or use restart-daemon.bat)" };
-  return { stopped: true, pid, stale: !victimAlive };
-}
+import { spawn, spawnSync } from "node:child_process";
+import { appendFileSync, existsSync, mkdirSync, openSync, readFileSync, writeFileSync, unlinkSync } from "node:fs";
+import { join, dirname } from "node:path";
+import os from "node:os";
+import { fileURLToPath } from "node:url";
+import { writeExitMarker } from "./runtime/lifecycle-forensics.js";
+
+export function daemonDir() {
+  return process.env.MSLXDFF_DAEMON_DIR || join(os.homedir(), ".config", "mslxdff");
+}
+
+export function pidFile() {
+  return join(daemonDir(), "daemon.pid");
+}
+
+export function logFile() {
+  return join(daemonDir(), "daemon.log");
+}
+
+// 当前代码所在的 CLI 入口（bin/mslxdff.js 绝对路径）：startDaemon 与
+// auto-update 的 -restart 委托共用（后者从 daemon 进程 spawn 时必须指向同一份代码）。
+export function daemonEntry() {
+  const here = fileURLToPath(import.meta.url);
+  return here.endsWith("bin/mslxdff.js")
+    ? here
+    : join(dirname(here), "..", "bin", "mslxdff.js");
+}
+
+export function startDaemon(args = []) {
+  const entry = daemonEntry();
+  const dir = daemonDir();
+  mkdirSync(dir, { recursive: true });
+  const logFd = openSync(logFile(), "a", 0o600);
+  const env = { ...process.env, MSLXDFF_DAEMON: "1" };
+  // a -debug foreground session wouldn't pass MSLXDFF_DEBUG to the
+  // background daemon it restores (that flag means "print events to stdout")
+  delete env.MSLXDFF_DEBUG;
+  const child = spawn(process.execPath, [entry, ...args, "--daemon"], {
+    detached: true,
+    stdio: ["ignore", logFd, logFd],
+    env,
+  });
+  child.unref();
+  return child.pid;
+}
+
+export function writePid(pid, version) {
+  const dir = daemonDir();
+  mkdirSync(dir, { recursive: true });
+  writeFileSync(pidFile(), version ? `${pid}\n${version}` : String(pid), { mode: 0o600 });
+}
+
+export function readPid() {
+  if (!existsSync(pidFile())) return null;
+  const raw = readFileSync(pidFile(), "utf8").trim();
+  const n = Number(raw.split("\n")[0]);
+  return Number.isInteger(n) && n > 0 ? n : null;
+}
+
+export function readPidVersion() {
+  if (!existsSync(pidFile())) return null;
+  const raw = readFileSync(pidFile(), "utf8");
+  const lines = raw.split("\n");
+  return lines.length > 1 && lines[1].trim() ? lines[1].trim() : null;
+}
+
+// Best-effort liveness check (signal 0); ESRCH means the process is gone.
+export function isPidAlive(pid) {
+  try {
+    process.kill(pid, 0);
+    return true;
+  } catch (err) {
+    return err.code !== "ESRCH";
+  }
+}
+
+export function stopDaemon({ reason = "stop" } = {}) {
+  const pid = readPid();
+  if (!pid) return { stopped: false, reason: "no pid file" };
+  // 杀者牌（验尸官的另一半证据）：动手前写、自带死者身份。只给在世者留牌——给尸体留牌
+  // 会让下次验尸把"早已静默死亡"误判成"被本次杀死"。
+  const victimAlive = isPidAlive(pid);
+  // 杀者留痕（写 daemon.log）：Windows 的 SIGTERM 是 TerminateProcess 强杀，被杀的 daemon
+  // 在 JS 层收不到任何事件（无法自记），故由"杀者"记录调用方 pid——
+  // 没有这行 = 非我方所杀（外部 taskkill/任务管理器/崩溃），配合最后一条 heartbeat 定位死亡时刻。
+  try {
+    appendFileSync(logFile(), `[lifecycle] stopDaemon called by pid=${process.pid} — killing daemon pid=${pid}\n`);
+  } catch {}
+  if (victimAlive) { try { writeExitMarker(daemonDir(), { reason, prevPid: pid, prevVersion: readPidVersion(), byPid: process.pid }); } catch {} }
+  let killFailed = false;
+  try {
+    process.kill(pid, "SIGTERM");
+  } catch (err) {
+    if (err.code === "ESRCH") {
+      // process already gone — nothing to do
+    } else if (err.code === "EPERM" && process.platform === "win32") {
+      // Windows: process.kill uses TerminateProcess which requires matching elevation.
+      // Fall back to taskkill /F which can terminate processes we don't own a handle to.
+      const r = spawnSync("taskkill", ["/PID", String(pid), "/F"], { windowsHide: true });
+      if (r.error || r.status !== 0) killFailed = true;
+    } else {
+      throw err;
+    }
+  }
+  try {
+    unlinkSync(pidFile());
+  } catch {
+    // already gone
+  }
+  if (killFailed) return { stopped: false, pid, reason: "EPERM — process kill denied (try running terminal as Administrator, or use restart-daemon.bat)" };
+  return { stopped: true, pid, stale: !victimAlive };
+}

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/enrich.js

@@ -1,86 +1,86 @@
-// -setto opencode 条目能力注入（ADR-0016 联动）：把 models.dev 能力写进 opencode.json
-// 的 per-model 条目（opencode Model 形状，实测 debug config 原样保留并生效），
-// 并产出一行人话摘要供 CLI 展示。查不到能力（未收录 provider/模型）时原样返回不硬造。
-import { globalCapabilities } from "./index.js";
-
-// "bai/glm-5.3-flash" → { provider: "bai", raw: "glm-5.3-flash" }；裸 id 归 opencode
-function splitProvider(modelId) {
-  const s = String(modelId || "").trim();
-  const i = s.indexOf("/");
-  if (i > 0) return { provider: s.slice(0, i).toLowerCase(), raw: s.slice(i + 1) };
-  return { provider: "opencode", raw: s };
-}
-
-// caps → opencode Model 形状增量（只含能力字段，name 等原有键不动）
-// variants：config 条目显式档位（provider.ts config 路径 mergeDeep(config.variants) 优先于启发式，
-// 绕过 transform.ts 黑名单——glm/kimi/deepseek-v3/minimax/qwen/big-pickle 启发式恒 return {}）。
-// 参数形状 reasoningEffort 对齐 @ai-sdk/openai-compatible（muse-spark 启发式同款）。
-// toggle/budget_tokens 型不注入（OpenAI 兼容协议无标准开关参数，留启发式判断）。
-function capsToEntryFields(caps) {
-  if (!caps) return null;
-  const fields = {
-    reasoning: Boolean(caps.reasoning),
-    tool_call: Boolean(caps.toolCall),
-    attachment: Boolean(caps.attachment),
-    temperature: Boolean(caps.temperature),
-    modalities: { input: caps.inputModalities || ["text"], output: caps.outputModalities || ["text"] },
-    limit: { context: Number(caps.context) || 0, output: Number(caps.maxOutput) || 0 },
-  };
-  if (caps.effortType === "effort" && Array.isArray(caps.effortValues) && caps.effortValues.length) {
-    fields.variants = Object.fromEntries(caps.effortValues.map((v) => [String(v), { reasoningEffort: String(v) }]));
-  }
-  if (caps.releaseDate) fields.release_date = caps.releaseDate;
-  if (caps.costIn != null || caps.costOut != null) {
-    fields.cost = { input: Number(caps.costIn) || 0, output: Number(caps.costOut) || 0 };
-  }
-  return fields;
-}
-
-// entry: 现有条目（含 name 等）；modelId: 内部 canonical id；capsSvc: 可注入（默认全局单例）
-// wbSource: workbuddy 动态源接缝（测试注入；生产 = workbuddyAllModels 上游原生字段）
-// 返回 { entry: 增强后条目, caps: caps|null }；服务异常静默降级（同步命令不能因目录拉取失败而挂）
-export async function enrichOpencodeEntry(entry, modelId, capsSvc, wbSource) {
-  const base = entry && typeof entry === "object" && !Array.isArray(entry) ? entry : {};
-  const svc = capsSvc === undefined ? globalCapabilities() : capsSvc;
-  if (!svc) return { entry: base, caps: null };
-  const { provider, raw } = splitProvider(modelId);
-  let caps = null;
-  try {
-    await svc.ready();
-    caps = svc.get(provider, raw) || null;
-    // 降级匹配：mslxdff 自建目录的 -free/-search-free/-expert-free 后缀在 models.dev 无后缀
-    if (!caps && /-free$/.test(raw)) caps = svc.get(provider, raw.replace(/-free$/, "")) || null;
-    // workbuddy 不在 models.dev 目录 → 上游原生字段兜底（maxInputTokens/supportsImages/... first-party 最准）
-    if (!caps && provider === "workbuddy") {
-      const { workbuddyCapsFromModels, workbuddyAllModels } = await import("./index.js");
-      const map = await workbuddyCapsFromModels(wbSource || workbuddyAllModels)();
-      caps = map[raw] || null;
-    }
-  } catch {
-    caps = null; // 目录不可用：降级为无能力条目（staleness 兜底在服务内已做）
-  }
-  const fields = capsToEntryFields(caps);
-  if (!fields) return { entry: base, caps: null };
-  return { entry: { ...base, ...fields }, caps };
-}
-
-// caps → 一行人话摘要（无有效信息返回 ""，调用方按空跳过不噪音）
-export function capsSummary(caps) {
-  if (!caps) return "";
-  const parts = [];
-  if (caps.effortType === "effort" && Array.isArray(caps.effortValues) && caps.effortValues.length) {
-    parts.push(`推理档 ${caps.effortValues.join("/")}`);
-  } else if (caps.effortType === "toggle") {
-    parts.push("推理 开关型");
-  } else if (caps.effortType === "budget_tokens") {
-    parts.push("推理 budget_tokens");
-  } else if (caps.reasoning) {
-    parts.push(caps.defaultEffort ? `推理（默认 ${caps.defaultEffort}）` : "推理模型");
-  }
-  if (caps.imageInput) parts.push("📷读图");
-  if (caps.context) parts.push(`上下文 ${caps.context >= 1000 ? `${Math.round(caps.context / 1000)}k` : caps.context}`);
-  if (caps.costIn != null || caps.costOut != null) {
-    parts.push(`$${caps.costIn ?? 0}/${caps.costOut ?? 0} 每M`);
-  }
-  return parts.join(" · ");
-}
+// -setto opencode 条目能力注入（ADR-0016 联动）：把 models.dev 能力写进 opencode.json
+// 的 per-model 条目（opencode Model 形状，实测 debug config 原样保留并生效），
+// 并产出一行人话摘要供 CLI 展示。查不到能力（未收录 provider/模型）时原样返回不硬造。
+import { globalCapabilities } from "./index.js";
+
+// "bai/glm-5.3-flash" → { provider: "bai", raw: "glm-5.3-flash" }；裸 id 归 opencode
+function splitProvider(modelId) {
+  const s = String(modelId || "").trim();
+  const i = s.indexOf("/");
+  if (i > 0) return { provider: s.slice(0, i).toLowerCase(), raw: s.slice(i + 1) };
+  return { provider: "opencode", raw: s };
+}
+
+// caps → opencode Model 形状增量（只含能力字段，name 等原有键不动）
+// variants：config 条目显式档位（provider.ts config 路径 mergeDeep(config.variants) 优先于启发式，
+// 绕过 transform.ts 黑名单——glm/kimi/deepseek-v3/minimax/qwen/big-pickle 启发式恒 return {}）。
+// 参数形状 reasoningEffort 对齐 @ai-sdk/openai-compatible（muse-spark 启发式同款）。
+// toggle/budget_tokens 型不注入（OpenAI 兼容协议无标准开关参数，留启发式判断）。
+function capsToEntryFields(caps) {
+  if (!caps) return null;
+  const fields = {
+    reasoning: Boolean(caps.reasoning),
+    tool_call: Boolean(caps.toolCall),
+    attachment: Boolean(caps.attachment),
+    temperature: Boolean(caps.temperature),
+    modalities: { input: caps.inputModalities || ["text"], output: caps.outputModalities || ["text"] },
+    limit: { context: Number(caps.context) || 0, output: Number(caps.maxOutput) || 0 },
+  };
+  if (caps.effortType === "effort" && Array.isArray(caps.effortValues) && caps.effortValues.length) {
+    fields.variants = Object.fromEntries(caps.effortValues.map((v) => [String(v), { reasoningEffort: String(v) }]));
+  }
+  if (caps.releaseDate) fields.release_date = caps.releaseDate;
+  if (caps.costIn != null || caps.costOut != null) {
+    fields.cost = { input: Number(caps.costIn) || 0, output: Number(caps.costOut) || 0 };
+  }
+  return fields;
+}
+
+// entry: 现有条目（含 name 等）；modelId: 内部 canonical id；capsSvc: 可注入（默认全局单例）
+// wbSource: workbuddy 动态源接缝（测试注入；生产 = workbuddyAllModels 上游原生字段）
+// 返回 { entry: 增强后条目, caps: caps|null }；服务异常静默降级（同步命令不能因目录拉取失败而挂）
+export async function enrichOpencodeEntry(entry, modelId, capsSvc, wbSource) {
+  const base = entry && typeof entry === "object" && !Array.isArray(entry) ? entry : {};
+  const svc = capsSvc === undefined ? globalCapabilities() : capsSvc;
+  if (!svc) return { entry: base, caps: null };
+  const { provider, raw } = splitProvider(modelId);
+  let caps = null;
+  try {
+    await svc.ready();
+    caps = svc.get(provider, raw) || null;
+    // 降级匹配：mslxdff 自建目录的 -free/-search-free/-expert-free 后缀在 models.dev 无后缀
+    if (!caps && /-free$/.test(raw)) caps = svc.get(provider, raw.replace(/-free$/, "")) || null;
+    // workbuddy 不在 models.dev 目录 → 上游原生字段兜底（maxInputTokens/supportsImages/... first-party 最准）
+    if (!caps && provider === "workbuddy") {
+      const { workbuddyCapsFromModels, workbuddyAllModels } = await import("./index.js");
+      const map = await workbuddyCapsFromModels(wbSource || workbuddyAllModels)();
+      caps = map[raw] || null;
+    }
+  } catch {
+    caps = null; // 目录不可用：降级为无能力条目（staleness 兜底在服务内已做）
+  }
+  const fields = capsToEntryFields(caps);
+  if (!fields) return { entry: base, caps: null };
+  return { entry: { ...base, ...fields }, caps };
+}
+
+// caps → 一行人话摘要（无有效信息返回 ""，调用方按空跳过不噪音）
+export function capsSummary(caps) {
+  if (!caps) return "";
+  const parts = [];
+  if (caps.effortType === "effort" && Array.isArray(caps.effortValues) && caps.effortValues.length) {
+    parts.push(`推理档 ${caps.effortValues.join("/")}`);
+  } else if (caps.effortType === "toggle") {
+    parts.push("推理 开关型");
+  } else if (caps.effortType === "budget_tokens") {
+    parts.push("推理 budget_tokens");
+  } else if (caps.reasoning) {
+    parts.push(caps.defaultEffort ? `推理（默认 ${caps.defaultEffort}）` : "推理模型");
+  }
+  if (caps.imageInput) parts.push("📷读图");
+  if (caps.context) parts.push(`上下文 ${caps.context >= 1000 ? `${Math.round(caps.context / 1000)}k` : caps.context}`);
+  if (caps.costIn != null || caps.costOut != null) {
+    parts.push(`$${caps.costIn ?? 0}/${caps.costOut ?? 0} 每M`);
+  }
+  return parts.join(" · ");
+}