mslxdff 0.1.187 → 0.1.188

package/src/runtime/bootstrap.js

@@ -1,67 +1,67 @@
-import { appendCall, appendError, appendEvent, appendTimeline } from "../logs.js";
-import { setupProviders } from "./providers-setup.js";
-import { startServerLifecycle } from "./server-lifecycle.js";
-import { appendModelTrace } from "../model-trace.js";
-import { startGroupSync } from "./group-sync.js";
-import { startBroadband } from "./broadband.js";
-import { installLogStamp } from "./log-stamp.js";
-
-const logs = { appendCall, appendError, appendEvent, appendTimeline, appendModelTrace };
-
-/**
- * daemon 启动门面 — 仅编排：组装世界 → 服务生命周期 → 群组同步 → 宽带中继 → 自更新。
- * 重活下沉 providers-setup / server-lifecycle / group-sync / broadband(-stream)。
- */
-export async function startDaemonMain(VERSION) {
-  // 每行带 [时间 pid]：一份 daemon.log 被多进程/多版本写过时，这是唯一能回答「谁写的、哪一轮」的东西
-  if (process.env.MSLXDFF_DAEMON === "1") installLogStamp();
-  const { installLifecycleLog } = await import("./lifecycle-log.js");
-  installLifecycleLog({ version: VERSION, logs });
-  // 接管：内存里若还有旧的 mslxdff daemon，先请它退出。它不在 daemon.pid 里（-restart 结构性碰不到它），
-  // 两个 daemon 会互抢 warp-pool 的端口（真机 2026-10-17：旧 daemon 活了一整天，日志只显示「起一条死一条」）。
-  // 必须早于 setupProviders —— 那一步才建池抢端口。debug 前台有自己的收口逻辑，不在这里抢。
-  if (process.env.MSLXDFF_DAEMON === "1" && process.env.MSLXDFF_DEBUG !== "1") {
-    try {
-      const { takeoverOlderDaemons } = await import("../daemon.js");
-      const r = await takeoverOlderDaemons({ log: (m) => console.log(m) });
-      if (!r.killed.length && !r.skipped.length && !r.remaining.length) {
-        console.log("[daemon] 内存里没有别的 mslxdff daemon（扫过一遍 /proc）—— 本进程独占出口池端口");
-      }
-    } catch (e) {
-      console.log(`[daemon] 接管旧 daemon 失败（不阻断启动）：${String(e?.message || e)}`);
-    }
-  }
-  const ctx = await setupProviders();
-  const { srv, bus } = await startServerLifecycle({ VERSION, ...ctx, logs });
-  void srv;
-  startGroupSync({ peers: ctx.peers, groups: ctx.groups });
-  startBroadband({ token: ctx.token, upstream: ctx.upstream });
-
-  const { setupAutoUpdate } = await import("./auto-update.js");
-  setupAutoUpdate({ VERSION, bus, logs });
-
-  const { setupWorkbuddyCheckin } = await import("./workbuddy-checkin.js");
-  void setupWorkbuddyCheckin({ bus, logs }).catch((e) => {
-    try { logs.appendEvent({ ts: Date.now(), type: "workbuddy-checkin-setup-failed", error: String(e?.message || e).slice(0, 200) }); } catch {}
-  });
-
-  const { setupTraeworkCheckin } = await import("./traework-checkin.js");
-  void setupTraeworkCheckin({ bus, logs }).catch((e) => {
-    try { logs.appendEvent({ ts: Date.now(), type: "traework-checkin-setup-failed", error: String(e?.message || e).slice(0, 200) }); } catch {}
-  });
-
-  const { setupQoderCheckin } = await import("./qoder-checkin.js");
-  void setupQoderCheckin({ bus, logs }).catch((e) => {
-    try { logs.appendEvent({ ts: Date.now(), type: "qoder-checkin-setup-failed", error: String(e?.message || e).slice(0, 200) }); } catch {}
-  });
-
-  const { setupRaccoonCheckin } = await import("./raccoon-checkin.js");
-  void setupRaccoonCheckin({ bus, logs }).catch((e) => {
-    try { logs.appendEvent({ ts: Date.now(), type: "raccoon-checkin-setup-failed", error: String(e?.message || e).slice(0, 200) }); } catch {}
-  });
-
-  const { setupWorkbuddyGrowth } = await import("./workbuddy-growth.js");
-  void setupWorkbuddyGrowth({ bus, logs }).catch((e) => {
-    try { logs.appendEvent({ ts: Date.now(), type: "workbuddy-growth-setup-failed", error: String(e?.message || e).slice(0, 200) }); } catch {}
-  });
-}
+import { appendCall, appendError, appendEvent, appendTimeline } from "../logs.js";
+import { setupProviders } from "./providers-setup.js";
+import { startServerLifecycle } from "./server-lifecycle.js";
+import { appendModelTrace } from "../model-trace.js";
+import { startGroupSync } from "./group-sync.js";
+import { startBroadband } from "./broadband.js";
+import { installLogStamp } from "./log-stamp.js";
+
+const logs = { appendCall, appendError, appendEvent, appendTimeline, appendModelTrace };
+
+/**
+ * daemon 启动门面 — 仅编排：组装世界 → 服务生命周期 → 群组同步 → 宽带中继 → 自更新。
+ * 重活下沉 providers-setup / server-lifecycle / group-sync / broadband(-stream)。
+ */
+export async function startDaemonMain(VERSION) {
+  // 每行带 [时间 pid]：一份 daemon.log 被多进程/多版本写过时，这是唯一能回答「谁写的、哪一轮」的东西
+  if (process.env.MSLXDFF_DAEMON === "1") installLogStamp();
+  const { installLifecycleLog } = await import("./lifecycle-log.js");
+  installLifecycleLog({ version: VERSION, logs });
+  // 接管：内存里若还有旧的 mslxdff daemon，先请它退出。它不在 daemon.pid 里（-restart 结构性碰不到它），
+  // 两个 daemon 会互抢 warp-pool 的端口（真机 2026-10-17：旧 daemon 活了一整天，日志只显示「起一条死一条」）。
+  // 必须早于 setupProviders —— 那一步才建池抢端口。debug 前台有自己的收口逻辑，不在这里抢。
+  if (process.env.MSLXDFF_DAEMON === "1" && process.env.MSLXDFF_DEBUG !== "1") {
+    try {
+      const { takeoverOlderDaemons } = await import("../daemon.js");
+      const r = await takeoverOlderDaemons({ log: (m) => console.log(m) });
+      if (!r.killed.length && !r.skipped.length && !r.remaining.length) {
+        console.log("[daemon] 内存里没有别的 mslxdff daemon（扫过一遍 /proc）—— 本进程独占出口池端口");
+      }
+    } catch (e) {
+      console.log(`[daemon] 接管旧 daemon 失败（不阻断启动）：${String(e?.message || e)}`);
+    }
+  }
+  const ctx = await setupProviders();
+  const { srv, bus } = await startServerLifecycle({ VERSION, ...ctx, logs });
+  void srv;
+  startGroupSync({ peers: ctx.peers, groups: ctx.groups, logs });
+  startBroadband({ token: ctx.token, upstream: ctx.upstream });
+
+  const { setupAutoUpdate } = await import("./auto-update.js");
+  setupAutoUpdate({ VERSION, bus, logs });
+
+  const { setupWorkbuddyCheckin } = await import("./workbuddy-checkin.js");
+  void setupWorkbuddyCheckin({ bus, logs }).catch((e) => {
+    try { logs.appendEvent({ ts: Date.now(), type: "workbuddy-checkin-setup-failed", error: String(e?.message || e).slice(0, 200) }); } catch {}
+  });
+
+  const { setupTraeworkCheckin } = await import("./traework-checkin.js");
+  void setupTraeworkCheckin({ bus, logs }).catch((e) => {
+    try { logs.appendEvent({ ts: Date.now(), type: "traework-checkin-setup-failed", error: String(e?.message || e).slice(0, 200) }); } catch {}
+  });
+
+  const { setupQoderCheckin } = await import("./qoder-checkin.js");
+  void setupQoderCheckin({ bus, logs }).catch((e) => {
+    try { logs.appendEvent({ ts: Date.now(), type: "qoder-checkin-setup-failed", error: String(e?.message || e).slice(0, 200) }); } catch {}
+  });
+
+  const { setupRaccoonCheckin } = await import("./raccoon-checkin.js");
+  void setupRaccoonCheckin({ bus, logs }).catch((e) => {
+    try { logs.appendEvent({ ts: Date.now(), type: "raccoon-checkin-setup-failed", error: String(e?.message || e).slice(0, 200) }); } catch {}
+  });
+
+  const { setupWorkbuddyGrowth } = await import("./workbuddy-growth.js");
+  void setupWorkbuddyGrowth({ bus, logs }).catch((e) => {
+    try { logs.appendEvent({ ts: Date.now(), type: "workbuddy-growth-setup-failed", error: String(e?.message || e).slice(0, 200) }); } catch {}
+  });
+}

package/src/runtime/group-sync.js

@@ -1,28 +1,81 @@
 import { groupSyncIntervalMs } from "../cli/policy.js";
 import { errMsg } from "../cli/util.js";
 
+// 连续失败升级阈值（BUG-23）。单次失败是常态——现网实测 1.2%（349 次里 288 次是 15s 同步超时
+// aborted、61 次 fetch failed），每次都喊只会把 errors.log 也刷成噪声（BUG-5 的教训）。
+// 但连续失败意味着 `peers` 静默停在上一次成功的结果——"组员列表变旧"而用户侧零信号，
+// 这才是要报的。连续 ≥N 次升一条 errors.log，恢复时再补一条收尾。
+// 0/off = 关闭升级（只留 console.log）。
+const DEFAULT_FAIL_ALERT_STREAK = 3;
+function failAlertStreak() {
+  const raw = process.env.MSLXDFF_GROUP_SYNC_FAIL_ALERT;
+  if (raw === undefined || raw === null || raw === "") return DEFAULT_FAIL_ALERT_STREAK;
+  const s = String(raw).trim().toLowerCase();
+  if (s === "0" || s === "off" || s === "false" || s === "no") return 0;
+  const n = Number(s);
+  return Number.isInteger(n) && n >= 0 ? n : DEFAULT_FAIL_ALERT_STREAK;
+}
+
+/**
+ * 造一个带「连续失败去抖」的结果上报器（纯函数，便于单测——不碰定时器）。
+ *
+ * 同一段连续失败**只喊一次**：阈值到的第一条写 errors.log，之后每分钟只走 console.log
+ * （轨迹仍在，但不再往 errors.log 灌重复行）；恢复时补一条「已恢复」，闭合事件。
+ * @param {object} opts
+ * @param {{appendError?: Function}} [opts.logs] 日志设施（errors.log 写入口）
+ * @param {number} [opts.alertAt] 连续失败阈值，0=不升级
+ * @param {(s: string) => void} [opts.log] 行日志出口（默认 console.log，经 log-stamp 带前缀）
+ * @returns {(results: Array<{name: string, error?: string, total?: number, added?: number}>, opts?: {verbose?: boolean}) => void}
+ */
+export function createGroupSyncReporter({ logs, alertAt = failAlertStreak(), log = console.log } = {}) {
+  const streaks = new Map(); // name -> { fails, alerted }
+  const appendError = (entry) => { try { logs?.appendError?.(entry); } catch { /* 日志失败不该拖垮同步 */ } };
+  return (results, { verbose = false } = {}) => {
+    for (const r of results || []) {
+      const st = streaks.get(r.name) || { fails: 0, alerted: false };
+      if (r.error) {
+        st.fails += 1;
+        const hit = alertAt > 0 && st.fails >= alertAt && !st.alerted;
+        if (hit) {
+          st.alerted = true;
+          log(`group sync ${r.name}: failed — ${r.error}（已连续 ${st.fails} 次，成员列表停在上一次成功的结果）`);
+          appendError({
+            api: "group-sync", status: 0, group: r.name, fails: st.fails,
+            message: `group sync ${r.name} 连续 ${st.fails} 次失败，成员列表已停留在上一次成功的结果：${r.error}`,
+          });
+        } else {
+          log(`group sync ${r.name}: failed — ${r.error}`);
+        }
+      } else {
+        if (st.alerted) {
+          log(`group sync ${r.name}: 已恢复（此前连续失败 ${st.fails} 次），${r.total} member(s), ${r.added} peer(s)`);
+          appendError({
+            api: "group-sync", status: 200, group: r.name, fails: st.fails,
+            message: `group sync ${r.name} 已恢复：此前连续失败 ${st.fails} 次`,
+          });
+        } else if (verbose || r.added) {
+          log(`group sync ${r.name}: ${r.total} member(s), ${r.added} peer(s)`);
+        }
+        st.fails = 0;
+        st.alerted = false;
+      }
+      streaks.set(r.name, st);
+    }
+  };
+}
+
 /**
  * 群组成员同步 — 首拉 + 定时器（fire-and-forget，原语义）。
+ * 失败的去抖告警见 createGroupSyncReporter。
  */
-export async function startGroupSync({ peers, groups }) {
+export async function startGroupSync({ peers, groups, logs }) {
   const { syncAllJoinedGroups } = await import("../cli/group-helpers.js");
-  syncAllJoinedGroups({ peers, groups })
-    .then((results) => {
-      for (const r of results) {
-        if (r.error) console.log(`group sync ${r.name}: failed — ${r.error}`);
-        else console.log(`group sync ${r.name}: ${r.total} member(s), ${r.added} peer(s)`);
-      }
-    })
-    .catch((err) => console.log(`group sync: ${errMsg(err)}`));
+  const report = createGroupSyncReporter({ logs });
+  // 整个同步抛错（读 state、令牌等基建问题）没有组名，归一成一个伪结果走同一套去抖
+  const reportThrow = (err) => report([{ name: "(all)", error: errMsg(err) }], { verbose: true });
+  syncAllJoinedGroups({ peers, groups }).then((results) => report(results, { verbose: true })).catch(reportThrow);
   const groupSyncTimer = setInterval(() => {
-    syncAllJoinedGroups({ peers, groups })
-      .then((results) => {
-        for (const r of results) {
-          if (r.error) console.log(`group sync ${r.name}: failed — ${r.error}`);
-          else if (r.added) console.log(`group sync ${r.name}: ${r.total} member(s), ${r.added} peer(s)`);
-        }
-      })
-      .catch((err) => console.log(`group sync: ${errMsg(err)}`));
+    syncAllJoinedGroups({ peers, groups }).then((results) => report(results)).catch(reportThrow);
   }, groupSyncIntervalMs());
   groupSyncTimer.unref();
 }

package/src/runtime/provider-gate.js

@@ -1,36 +1,36 @@
-// 定制 provider 启用门禁（纯函数 + auth 号型名单），从 providers-setup.js 拆出以守住 ≤10KB 体积门。
-// 背景：门禁曾要求 `baseUrl && keys` 两者皆有，导致 qoder（keys 有、baseUrl 空）被静默跳过 ——
-// 表现为 /v1/models 无该供应商模型、`-models` 挑不到、网关报 `Model qoder/x is not supported`。
-// Note: auth 号型不要求 baseUrl 是硬约束（旧门禁 baseUrl&&keys 曾静默跳过整家 qoder）— 见 .agents/notes/implemented/bug-fix/2026-09-21-auth-doc-provider-gate.md
-
-/** 凭证在 auth 目录、无需 baseUrl 的「auth 号型」定制供应商（端点由各自 constants 决定）。 */
-export const AUTH_DOC_PROVIDER_IDS = ["workbuddy", "traework", "qoder", "qwenwork", "globalqwenwork", "raccoon"];
-
-/**
- * - auth 号型：keys 或 auths 或 auth 目录有号 → 启用（baseUrl 可空）
- * - 其他定制（cline/codearts/插件注册）：有 keys → 启用（baseUrl 可空，端点由工厂决定）
- */
-export function shouldEnableCustomProvider(gid, { keys = [], auths = [], hasAuthDocs = false } = {}) {
-  if (AUTH_DOC_PROVIDER_IDS.includes(gid)) return keys.length > 0 || auths.length > 0 || hasAuthDocs;
-  return keys.length > 0;
-}
-
-/** 按 gid 载入各自 account-store 并列出落盘账号（失败/无目录 → 空数组，不抛）。 */
-export async function loadAuthDocs(gid) {
-  try {
-    const store = gid === "workbuddy"
-      ? await import("../providers/workbuddy/account-store.js")
-      : gid === "traework"
-        ? await import("../providers/traework/account-store.js")
-        : gid === "qwenwork"
-          ? await import("../providers/qwenwork/account-store.js")
-          : gid === "globalqwenwork"
-            ? await import("../providers/globalqwenwork/account-store.js")
-            : gid === "raccoon"
-              ? await import("../providers/raccoon/account-store.js")
-            : await import("../providers/qoder/account-store.js");
-    return store.listAccountDocs();
-  } catch {
-    return [];
-  }
-}
+// 定制 provider 启用门禁（纯函数 + auth 号型名单），从 providers-setup.js 拆出以守住 ≤10KB 体积门。
+// 背景：门禁曾要求 `baseUrl && keys` 两者皆有，导致 qoder（keys 有、baseUrl 空）被静默跳过 ——
+// 表现为 /v1/models 无该供应商模型、`-models` 挑不到、网关报 `Model qoder/x is not supported`。
+// Note: auth 号型不要求 baseUrl 是硬约束（旧门禁 baseUrl&&keys 曾静默跳过整家 qoder）— 见 .agents/notes/implemented/bug-fix/2026-09-21-auth-doc-provider-gate.md
+
+/** 凭证在 auth 目录、无需 baseUrl 的「auth 号型」定制供应商（端点由各自 constants 决定）。 */
+export const AUTH_DOC_PROVIDER_IDS = ["workbuddy", "traework", "qoder", "qwenwork", "globalqwenwork", "raccoon"];
+
+/**
+ * - auth 号型：keys 或 auths 或 auth 目录有号 → 启用（baseUrl 可空）
+ * - 其他定制（cline/codearts/插件注册）：有 keys → 启用（baseUrl 可空，端点由工厂决定）
+ */
+export function shouldEnableCustomProvider(gid, { keys = [], auths = [], hasAuthDocs = false } = {}) {
+  if (AUTH_DOC_PROVIDER_IDS.includes(gid)) return keys.length > 0 || auths.length > 0 || hasAuthDocs;
+  return keys.length > 0;
+}
+
+/** 按 gid 载入各自 account-store 并列出落盘账号（失败/无目录 → 空数组，不抛）。 */
+export async function loadAuthDocs(gid) {
+  try {
+    const store = gid === "workbuddy"
+      ? await import("../providers/workbuddy/account-store.js")
+      : gid === "traework"
+        ? await import("../providers/traework/account-store.js")
+        : gid === "qwenwork"
+          ? await import("../providers/qwenwork/account-store.js")
+          : gid === "globalqwenwork"
+            ? await import("../providers/globalqwenwork/account-store.js")
+            : gid === "raccoon"
+              ? await import("../providers/raccoon/account-store.js")
+            : await import("../providers/qoder/account-store.js");
+    return store.listAccountDocs();
+  } catch {
+    return [];
+  }
+}