mslxdff 0.1.90 → 0.1.92

package/package.json

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

package/src/cli/commands/provider/bench-via.js

@@ -25,9 +25,37 @@ export function buildHeadersForProvider(providerId, apiKey, auth) {
   return h;
 }
 
-export async function handleVia({ providerId, opts, fetchImpl, loadConfigs, loadKeys, loadAllowed, loadBaseUrl }) {
+// bench 取数口径：只测（allowlist ∩ 全局 picks）交集。
+// 两套勾选会分叉（allowlist 管上游放行，picks 是用户 curated 集），直接测 allowlist 会打到未勾选模型、漏掉已勾选模型。
+// picks 为空时原样通过（兼容纯 allowlist 用户）。
+export function filterBenchModels({ providerId, allowed, picks, allowAny = false } = {}) {
+  const pid = String(providerId ?? "");
+  const isOpen = pid.toLowerCase() === "opencode";
+  let list = [...new Set((Array.isArray(allowed) ? allowed : []).map((m) => String(m ?? "").trim()).filter(Boolean))];
+  const all = [...new Set((Array.isArray(picks) ? picks : []).map((p) => String(p ?? "").trim()).filter(Boolean))];
+  // opencode 默认 allowAny 且 allowlist 常空：候选即裸 picks
+  if (!list.length && allowAny && isOpen && all.length) {
+    list = [];
+    for (const p of all) {
+      if (!p.includes("/")) list.push(p);
+      else if (p.toLowerCase().startsWith("opencode/")) list.push(p.slice(9));
+    }
+    list = [...new Set(list.map((m) => m.trim()).filter(Boolean))];
+  }
+  if (!all.length) return { models: list, skippedUnpicked: 0, pickedBlocked: [] };
+  const hit = (m) => all.includes(`${pid}/${m}`) || (isOpen && (all.includes(m) || all.includes(`opencode/${m}`)));
+  const models = list.filter(hit);
+  const inAllowed = new Set(list);
+  const pickedBlocked = all.filter((p) => {
+    if (isOpen) return !p.includes("/") && !inAllowed.has(p);
+    return p.startsWith(`${pid}/`) && !inAllowed.has(p.slice(pid.length + 1));
+  });
+  return { models, skippedUnpicked: list.length - models.length, pickedBlocked };
+}
+
+export async function handleVia({ providerId, opts, fetchImpl, loadConfigs, loadKeys, loadAllowed, loadBaseUrl, loadAllowAny, loadModelPicks, getOnlinePeersFn }) {
   const { getOnlinePeers, orchestrateVia, resolveIncludeOpencode } = await import("../../../bench/via.js");
-  const peers = await getOnlinePeers();
+  const peers = await (typeof getOnlinePeersFn === "function" ? getOnlinePeersFn() : getOnlinePeers());
   if (!peers.length) {
     const msg = "未加入组或无在线 peer，--via 无意义。先 mslxdff -group list / -addtogroup";
     if (opts.json) console.log(JSON.stringify({ meta: { at: new Date().toISOString(), samples: opts.samples, timeout: opts.timeoutMs, includeOpencode: false, peers: [], opencodeSkipped: true }, results: [], advice: msg }, null, 2));
@@ -47,9 +75,23 @@ export async function handleVia({ providerId, opts, fetchImpl, loadConfigs, load
     const log = (s) => (opts.json ? console.error(s) : console.log(s));
     includeOpencode = await resolveIncludeOpencode({ includeOpencode, isTTY, confirmFn, log });
   }
-  const { loadToken } = await import("../../../state.js");
+  const stateMod = await import("../../../state.js");
+  const { loadToken } = stateMod;
   let token = "";
   try { token = (await loadToken()).token || ""; } catch {}
+  let picks = [];
+  try {
+    picks = typeof loadModelPicks === "function"
+      ? (loadModelPicks() || [])
+      : (typeof stateMod.loadModelPicks === "function" ? stateMod.loadModelPicks() || [] : []);
+  } catch { picks = []; }
+  const allowAnyOf = (pid) => {
+    try {
+      if (typeof loadAllowAny === "function") return loadAllowAny(pid);
+      if (typeof stateMod.loadProviderAllowAnyModels === "function") return stateMod.loadProviderAllowAnyModels(pid);
+    } catch {}
+    return String(pid || "").toLowerCase() === "opencode";
+  };
   let targetIds = [];
   const isAll = providerId === "bench" || providerId === "all";
   if (isAll) {
@@ -68,6 +110,10 @@ export async function handleVia({ providerId, opts, fetchImpl, loadConfigs, load
       for (const k of Object.keys(raw.providerKeys || {})) if (!targetIds.includes(k) && (loadAllowed(k) || []).length) targetIds.push(k);
     } catch {}
     if (!targetIds.length) targetIds = ["openrouter", "workbuddy", "clinebot"].filter((p) => (loadAllowed(p) || []).length);
+    // opencode 默认 allowAny 但 allowlist 常空：有裸 picks 且确认包含 opencode 时纳入
+    if (includeOpencode && !targetIds.includes("opencode") && picks.some((p) => !String(p).includes("/") || String(p).toLowerCase().startsWith("opencode/"))) {
+      targetIds.push("opencode");
+    }
   } else {
     targetIds = [providerId];
   }
@@ -80,13 +126,20 @@ export async function handleVia({ providerId, opts, fetchImpl, loadConfigs, load
     const keys = loadKeys(pid) || [];
     const allowed = loadAllowed(pid) || [];
     const baseUrl = (loadBaseUrl(pid) || cfg.baseUrl || "").trim();
-    if (!allowed.length) { viaLog(`provider ${pid}: 无勾选模型，跳过`); continue; }
+    const picked = filterBenchModels({ providerId: pid, allowed, picks, allowAny: allowAnyOf(pid) });
+    if (!picked.models.length) {
+      if (!allowed.length && !(pid === "opencode" && allowAnyOf(pid))) viaLog(`provider ${pid}: 无勾选模型，跳过`);
+      else viaLog(`provider ${pid}: allowlist ${allowed.length} 个模型都不在全局 picks 中，跳过（如需测请 -model pick）`);
+      if (picked.pickedBlocked.length) viaLog(`  已勾选但未进 allowlist（先 allowlist set）：${picked.pickedBlocked.join(" ")}`);
+      continue;
+    }
+    if (picked.skippedUnpicked) viaLog(`provider ${pid}: 跳过 ${picked.skippedUnpicked} 个未勾选模型，只测 ${picked.models.length} 个已勾选`);
     if (!baseUrl && pid !== "opencode") { viaLog(`provider ${pid}: missing baseUrl 跳过`); continue; }
     if (!keys.length && pid !== "opencode") { viaLog(`provider ${pid}: 未配置 Key 跳过`); continue; }
     const chatPath = cfg.chatPath || defaultChatPath(pid);
     let auths = [];
     try { const m = await import("../../../state.js"); auths = m.loadProviderAuths ? m.loadProviderAuths(pid) : []; } catch {}
-    const models = allowed.map((id) => ({ provider: pid, model: String(id), id: String(id) }));
+    const models = picked.models.map((id) => ({ provider: pid, model: String(id), id: String(id) }));
     const directRunner = async ({ provider, model }) => {
       const p = provider || pid;
       const idx = models.findIndex((x) => x.model === model);

package/src/cli/commands/provider/bench.js

@@ -6,7 +6,7 @@ import { isRefreshToken } from "../../../providers/cline/headers.js";
 import { refreshTokenForBase } from "../../../providers/cline/auth.js";
 import { clineBenchOne } from "../../../bench/cline-bench.js";
 import { workbuddyBenchOne } from "../../../bench/workbuddy-bench.js";
-import { buildHeadersForProvider, handleVia } from "./bench-via.js";
+import { buildHeadersForProvider, filterBenchModels, handleVia } from "./bench-via.js";
 
 function parseBenchArgs(rest) {
   const opts = { json: false, prompt: "hi", maxTokens: 32, timeoutMs: 30000, via: false, includeOpencode: false, samples: 1, apply: false };
@@ -36,13 +36,14 @@ export async function handleProviderBench(id, sub, rest, args, deps = {}) {
   if (!isBench) return false;
   const opts = parseBenchArgs(_restArr);
   if (opts.via) {
-    const loadConfigs = deps.loadProviderConfigs || (await import("../../../state.js")).loadProviderConfigs;
-    const loadKeys = deps.loadProviderKeys || (await import("../../../state.js")).loadProviderKeys;
-    const loadAllowed = deps.loadProviderAllowedModels || (await import("../../../state.js")).loadProviderAllowedModels;
-    const loadBaseUrl = deps.loadProviderBaseUrl || (await import("../../../state.js")).loadProviderBaseUrl;
+    const stateMod = await import("../../../state.js");
+    const loadConfigs = deps.loadProviderConfigs || stateMod.loadProviderConfigs;
+    const loadKeys = deps.loadProviderKeys || stateMod.loadProviderKeys;
+    const loadAllowed = deps.loadProviderAllowedModels || stateMod.loadProviderAllowedModels;
+    const loadBaseUrl = deps.loadProviderBaseUrl || stateMod.loadProviderBaseUrl;
     const viaPid = _isBenchViaAll ? "bench" : String(id || "").trim();
     if (!viaPid) { console.error("usage: mslxdff -provider <id> bench --via [--json] [--include-opencode]"); process.exit(1); }
-    await handleVia({ providerId: viaPid, opts, fetchImpl: deps.fetchImpl || globalThis.fetch, loadConfigs, loadKeys, loadAllowed, loadBaseUrl });
+    await handleVia({ providerId: viaPid, opts, fetchImpl: deps.fetchImpl || globalThis.fetch, loadConfigs, loadKeys, loadAllowed, loadBaseUrl, loadAllowAny: deps.loadProviderAllowAnyModels || stateMod.loadProviderAllowAnyModels, loadModelPicks: deps.loadModelPicks, getOnlinePeersFn: deps.getOnlinePeers });
     return true;
   }
   const fetchImpl = deps.fetchImpl || globalThis.fetch;
@@ -58,6 +59,12 @@ export async function handleProviderBench(id, sub, rest, args, deps = {}) {
   const keys = loadKeys(providerId) || [];
   const allowed = loadAllowed(providerId) || [];
   const allowAny = loadAllowAny(providerId);
+  let picks = [];
+  try {
+    const m = await import("../../../state.js");
+    picks = typeof deps.loadModelPicks === "function" ? (deps.loadModelPicks() || []) : (typeof m.loadModelPicks === "function" ? m.loadModelPicks() || [] : []);
+  } catch { picks = []; }
+  const picked = filterBenchModels({ providerId, allowed, picks, allowAny });
   const baseUrl = (loadBaseUrl(providerId) || cfg.baseUrl || "").trim();
   let auths = [];
   try { const m = await import("../../../state.js"); auths = m.loadProviderAuths ? m.loadProviderAuths(providerId) : []; } catch {}
@@ -81,18 +88,26 @@ export async function handleProviderBench(id, sub, rest, args, deps = {}) {
     if (opts.json) console.log(JSON.stringify({ ok: true, data: list, hint: `pick then bench` }, null, 2));
     process.exit(0);
   }
+  if (picks.length && !picked.models.length) {
+    console.log(`provider ${providerId}: allowlist ${allowed.length} 个模型都不在全局 picks 中，不测速（只测勾选）。`);
+    if (picked.pickedBlocked.length) console.log(`已勾选但未进 allowlist：${picked.pickedBlocked.join(" ")} → mslxdff -provider ${providerId} allowlist set <model>`);
+    else console.log(`先勾选：mslxdff -model pick ${providerId}/<model>`);
+    process.exit(0);
+  }
   const log = (s) => (opts.json ? console.error(s) : console.log(s));
-  log(`bench ${providerId}: 共 ${allowed.length} 个已勾选模型，逐个测速（串行，${opts.timeoutMs}ms 超时）...`);
+  log(`bench ${providerId}: 共 ${picked.models.length} 个已勾选模型，逐个测速（串行，${opts.timeoutMs}ms 超时）...`);
+  if (picked.skippedUnpicked) log(`跳过 ${picked.skippedUnpicked} 个未勾选模型`);
   if (!opts.json) console.log(`prompt="${opts.prompt}" maxTokens=${opts.maxTokens}\n`);
   const chatPath = cfg.chatPath || defaultChatPath(providerId);
   const rtKeys = keys.filter((k) => isRefreshToken(k, providerId));
   const normBase = String(baseUrl).replace(/\/+$/, "");
   const clineChatBase = normBase.endsWith("/api/v1") ? normBase.slice(0, -7) : normBase;
   const results = [];
-  for (let i = 0; i < allowed.length; i++) {
-    const raw = allowed[i];
+  const benchModels = picked.models;
+  for (let i = 0; i < benchModels.length; i++) {
+    const raw = benchModels[i];
     const model = String(raw || "").trim();
-    if (!opts.json) process.stdout.write(`  [${i + 1}/${allowed.length}] ${model} ... `);
+    if (!opts.json) process.stdout.write(`  [${i + 1}/${benchModels.length}] ${model} ... `);
     const kIdx = i % (keys.length || 1);
     const aIdx = Math.min(kIdx, Math.max(auths.length - 1, 0));
     const key = keys[kIdx];

package/src/cli/commands/provider/cline-login.js

@@ -7,17 +7,48 @@ export async function handleClineLogin(id, sub) {
   const WORKOS_AUTH = "https://api.workos.com/user_management/authenticate";
   const CLINE_REGISTER = "https://api.cline.bot/api/v1/auth/register";
 
+  // 网络层：支持代理（读环境变量）+ 超时 + 人话报错。
+  // 直连 api.workos.com 在部分网络下 TCP 会被墙（DNS 通但 443 超时），此时必须走代理。
+  const PROXY_URL = (process.env.HTTPS_PROXY || process.env.https_proxy || process.env.HTTP_PROXY || process.env.http_proxy || "").trim();
+  let dispatcher = null;
+  if (PROXY_URL) {
+    try {
+      const { ProxyAgent } = await import("undici");
+      dispatcher = new ProxyAgent(PROXY_URL);
+    } catch (e) {
+      console.error(`⚠️ 代理变量 ${PROXY_URL} 不可用（${e.message}），回退直连`);
+    }
+  }
+  function netHint(e, url) {
+    const host = (() => { try { return new URL(url).host; } catch { return url; } })();
+    const cause = e?.cause || e;
+    const code = cause?.code || cause?.name || "";
+    if (code === "ENOTFOUND" || code === "EAI_AGAIN") return `DNS 解析失败（${host}），检查 DNS/网络`;
+    if (code === "ECONNREFUSED") return `连接被拒（${host}），检查代理是否开启`;
+    if (code === "ETIMEDOUT" || code === "UND_ERR_CONNECT_TIMEOUT" || e?.name === "TimeoutError") return `连接 ${host} 超时（直连可能被墙），请开代理后重试：set HTTPS_PROXY=http://127.0.0.1:7890 再跑 login`;
+    if (!PROXY_URL && /workos\.com|cline\.bot/.test(host)) return `直连 ${host} 失败（${code || e.message}），疑似被墙，请开代理后重试`;
+    return `${code || e.message}`;
+  }
+  // 注意：dispatcher 为 null 时不能显式传给 fetch（undici 会断言失败），有代理才带。
+  const extraOpts = dispatcher ? { dispatcher } : {};
   async function postForm(url, form) {
     const body = new URLSearchParams(form).toString();
-    const res = await fetch(url, { method: "POST", headers: { "Content-Type": "application/x-www-form-urlencoded" }, body });
+    let res;
+    try {
+      res = await fetch(url, { method: "POST", headers: { "Content-Type": "application/x-www-form-urlencoded" }, body, ...extraOpts, signal: AbortSignal.timeout(20000) });
+    } catch (e) { throw new Error(`连不上 WorkOS：${netHint(e, url)}`); }
     const txt = await res.text();
     try { return JSON.parse(txt); } catch { throw new Error(`WorkOS 返回非 JSON: ${txt.slice(0, 200)}`); }
   }
   async function postJson(url, obj) {
-    const res = await fetch(url, { method: "POST", headers: { "Content-Type": "application/json" }, body: JSON.stringify(obj) });
+    let res;
+    try {
+      res = await fetch(url, { method: "POST", headers: { "Content-Type": "application/json" }, body: JSON.stringify(obj), ...extraOpts, signal: AbortSignal.timeout(20000) });
+    } catch (e) { throw new Error(`连不上 Cline：${netHint(e, url)}`); }
     const txt = await res.text();
     try { return JSON.parse(txt); } catch { throw new Error(`Cline 返回非 JSON: ${txt.slice(0, 200)}`); }
   }
+  if (PROXY_URL && dispatcher) console.log(`🌐 检测到代理：${PROXY_URL}\n`);
 
   console.log("🚀 启动 Cline WorkOS 设备授权流程...\n");
   let device;

package/src/providers/cline/chat.js

@@ -4,6 +4,16 @@ import { createTransport } from "../../transport/index.js";
 
 function genSessionId() { return `sess_${Date.now()}_${Math.random().toString(36).slice(2, 8)}`; }
 
+// stripProviderPrefix 去掉本地供应商前缀，发上游用裸模型 id。
+// 上游（对标 cline2api-workers MODELS）只认裸 id："deepseek/deepseek-v4-flash"、
+// "poolside/laguna-s-2.1:free"；本地 "clinebot/deepseek/..." 需取后两段。
+// 两段及以内视为已是裸 id，原样透传。
+function stripProviderPrefix(id) {
+  const parts = String(id || "").split("/").filter(Boolean);
+  if (parts.length > 2) return parts.slice(1).join("/");
+  return String(id || "");
+}
+
 function unwrapData(obj) {
   if (obj && obj.data && typeof obj.data === "object") {
     const d = obj.data;
@@ -144,7 +154,7 @@ export function createChatService({
     const model = body?.model || "deepseek/deepseek-v4-flash";
     const sessionId = genSessionId();
     const isStream = body?.stream === true;
-    const upstreamModel = String(model).split("/").pop().includes(":") ? model : model;
+    const upstreamModel = stripProviderPrefix(model);
     const upstreamBody = {
       model: upstreamModel,
       max_tokens: body?.max_tokens || body?.max_completion_tokens || 4096,
@@ -171,7 +181,10 @@ export function createChatService({
           return new Response(JSON.stringify(ret.data), { status: 200, headers: hdrs });
         }
         const raw = await resp.json().catch(() => null);
-        if (!raw) return resp;
+        if (!raw || typeof raw !== "object") {
+          if (!raw) return resp;
+          return new Response(JSON.stringify({ error: { message: "upstream returned non-JSON body", type: "api_error" } }), { status: 502, headers: { "Content-Type": "application/json" } });
+        }
         const normalized = unwrapData(raw);
         normalized.model = model;
         return new Response(JSON.stringify(normalized), { status: 200, headers: { "Content-Type": "application/json" } });

package/src/providers/workbuddy/checkin.js

@@ -0,0 +1,74 @@
+// WorkBuddy 每日签到 core：纯逻辑 + fetch 注入，被 daemon scheduler 与 CLI 共用。
+// 接口：双域 POST /v2/billing/meter/daily-checkin，code 0=新签成功，10001=已签（幂等成功）。
+
+export const CHECKIN_ENDPOINTS = [
+  "https://www.codebuddy.cn/v2/billing/meter/daily-checkin",
+  "https://copilot.tencent.com/v2/billing/meter/daily-checkin",
+];
+
+function checkinHeaders({ at, uid, domain, enterpriseId }) {
+  return {
+    Authorization: `Bearer ${at}`,
+    "Content-Type": "application/json",
+    Accept: "application/json",
+    "X-User-Id": uid,
+    "X-Domain": domain || "www.codebuddy.cn",
+    "X-Product": "SaaS",
+    "User-Agent": "CLI/2.115.0 WorkBuddy/2.115.0",
+    Origin: "https://www.codebuddy.cn",
+    Referer: "https://www.codebuddy.cn/",
+    ...(enterpriseId ? { "X-Enterprise-Id": enterpriseId } : {}),
+  };
+}
+
+export async function checkinOne({ uid, at, domain, enterpriseId, fetchImpl = globalThis.fetch, timeoutMs = 15000 } = {}) {
+  const headers = checkinHeaders({ at, uid, domain, enterpriseId });
+  let last = null;
+  for (const url of CHECKIN_ENDPOINTS) {
+    try {
+      const res = await fetchImpl(url, {
+        method: "POST",
+        headers,
+        body: "{}",
+        signal: AbortSignal.timeout(timeoutMs),
+      });
+      const text = await res.text();
+      let j;
+      try { j = JSON.parse(text); } catch { j = { code: res.status, msg: text.slice(0, 200) }; }
+      last = { url, status: res.status, body: j };
+      if (j.code === 0 || j.code === 10001 || String(j.msg || "").includes("已签到")) {
+        return { ok: true, already: j.code === 10001, ...last };
+      }
+      // 401/403 = token 过期：标记给上层 refresh，不浪费第二域
+      if (res.status === 401 || res.status === 403) return { ok: false, needRefresh: true, ...last };
+    } catch (e) {
+      last = { url, error: String(e?.message || e).slice(0, 200) };
+    }
+  }
+  return { ok: false, ...last };
+}
+
+// 多账号签到：逐个独立，失败不挡别人；返回按 uid 排序的 rows。
+export async function checkinAll({ accounts = [], fetchImpl = globalThis.fetch, concurrency = 3, onAccount } = {}) {
+  const list = (Array.isArray(accounts) ? accounts : []).filter((a) => a && a.uid && a.at);
+  const results = new Array(list.length);
+  let idx = 0;
+  async function worker() {
+    while (idx < list.length) {
+      const i = idx++;
+      const a = list[i];
+      let row;
+      try {
+        const r = await checkinOne({ uid: a.uid, at: a.at, domain: a.domain, enterpriseId: a.enterpriseId, fetchImpl });
+        row = { uid: a.uid, ok: r.ok, already: !!r.already, needRefresh: !!r.needRefresh, code: r.body?.code, msg: r.body?.msg || r.error || "", url: r.url };
+      } catch (e) {
+        row = { uid: a.uid, ok: false, msg: String(e?.message || e).slice(0, 200) };
+      }
+      if (typeof onAccount === "function") { try { await onAccount(row, a); } catch {} }
+      results[i] = row;
+    }
+  }
+  await Promise.all(Array.from({ length: Math.min(Math.max(concurrency, 1), Math.max(list.length, 1)) }, () => worker()));
+  results.sort((a, b) => String(a.uid).localeCompare(String(b.uid)));
+  return results;
+}

package/src/runtime/bootstrap.js

@@ -19,4 +19,9 @@ export async function startDaemonMain(VERSION) {
 
   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 {}
+  });
 }

package/src/runtime/workbuddy-checkin.js

@@ -0,0 +1,119 @@
+// daemon 内置 WorkBuddy 每日自动签到（A 方案）：多账号全签 + 启动补签 + 每日定时。
+// 开关：MSLXDFF_WORKBUDDY_CHECKIN=0 关闭（默认开）；时间：MSLXDFF_WORKBUDDY_CHECKIN_HOUR（默认 9 点本地时）。
+// 幂等：上游 code 10001（今天已签）视为成功；落盘 workbuddyCheckin {date} 防重复。
+
+export function isCheckinEnabled(env = process.env) {
+  const v = String(env.MSLXDFF_WORKBUDDY_CHECKIN ?? "1").trim().toLowerCase();
+  return !["0", "false", "off", "no"].includes(v);
+}
+
+export function getCheckinHour(env = process.env) {
+  const h = Number(env.MSLXDFF_WORKBUDDY_CHECKIN_HOUR);
+  return Number.isInteger(h) && h >= 0 && h <= 23 ? h : 9;
+}
+
+export function todayKey(d = new Date()) {
+  const m = String(d.getMonth() + 1).padStart(2, "0");
+  const day = String(d.getDate()).padStart(2, "0");
+  return `${d.getFullYear()}-${m}-${day}`;
+}
+
+// 到下一次计划点的毫秒数（今天未到点→今天，已过→明天同时）。
+export function nextRunDelayMs(now = new Date(), hour = 9) {
+  const next = new Date(now);
+  next.setHours(hour, 0, 0, 0);
+  if (next.getTime() <= now.getTime()) next.setDate(next.getDate() + 1);
+  return next.getTime() - now.getTime();
+}
+
+// 启动补签：已过今日计划点、且（从没签过 或 上次不是今天）。
+export function shouldCatchUp({ lastDate, now = new Date(), hour = 9 } = {}) {
+  const point = new Date(now);
+  point.setHours(hour, 0, 0, 0);
+  if (now.getTime() < point.getTime()) return false;
+  return !lastDate || lastDate !== todayKey(now);
+}
+
+export async function setupWorkbuddyCheckin({ bus, logs } = {}) {
+  function emit(type, data = {}) {
+    const entry = { ts: Date.now(), type, ...data };
+    try { bus?.emit(entry); } catch {}
+    try { logs?.appendEvent?.(entry); } catch {}
+    console.log(`[workbuddy-checkin] ${type} ${JSON.stringify(data)}`.slice(0, 500));
+  }
+  if (!isCheckinEnabled()) {
+    console.log("[workbuddy-checkin] disabled (set MSLXDFF_WORKBUDDY_CHECKIN=1 to enable)");
+    emit("workbuddy-checkin-disabled");
+    return { enabled: false };
+  }
+  const hour = getCheckinHour();
+  console.log(`[workbuddy-checkin] enabled: daily ${String(hour).padStart(2, "0")}:00 local, multi-account`);
+  emit("workbuddy-checkin-enabled", { hour });
+
+  const stateMod = await import("../state.js");
+  const { checkinAll } = await import("../providers/workbuddy/checkin.js");
+  const { createAuthService, decodeJwtExp } = await import("../providers/workbuddy/auth.js");
+
+  let running = false;
+  async function runOnce(reason) {
+    if (running) return { skipped: "already-running" };
+    running = true;
+    try {
+      const cfg = stateMod.loadProviderConfigs().workbuddy || {};
+      const keys = [...(Array.isArray(cfg.keys) ? cfg.keys : [])];
+      const authList = [...(Array.isArray(cfg.auths) ? cfg.auths : [])];
+      if (!keys.length) {
+        emit("workbuddy-checkin-no-accounts", { reason });
+        return { ok: false, reason: "no-accounts" };
+      }
+      // 先给过期 token 续期（复用 chat 同款 refresh，落盘回 state）
+      const authService = createAuthService({
+        fetchImpl: globalThis.fetch,
+        store: { keys, authList },
+      });
+      await Promise.all(authList.map(async (auth, i) => {
+        try {
+          const exp = typeof decodeJwtExp === "function" ? decodeJwtExp(keys[i]) : null;
+          if (exp && exp - Date.now() / 1000 < 3600) await authService.refreshTokenFor(keys[i], auth);
+        } catch {}
+      }));
+      const accounts = authList.map((a, i) => ({ uid: a.uid, at: keys[i], domain: a.domain, enterpriseId: a.enterpriseId })).filter((a) => a.uid && a.at);
+      const rows = await checkinAll({ accounts, concurrency: 3 });
+      const okCount = rows.filter((r) => r.ok).length;
+      const date = todayKey();
+      try {
+        stateMod.writeStateImmediate(stateMod.defaultStateFile(), {
+          workbuddyCheckin: { date, at: Date.now(), ok: okCount, total: rows.length, accounts: rows.map((r) => ({ uid: r.uid, ok: r.ok, already: r.already })) },
+        });
+      } catch {}
+      for (const r of rows) {
+        emit("workbuddy-checkin-account", { uid: String(r.uid).slice(0, 8), ok: r.ok, already: !!r.already, msg: String(r.msg || "").slice(0, 120), reason });
+      }
+      emit("workbuddy-checkin-done", { date, ok: okCount, total: rows.length, reason });
+      return { ok: okCount > 0, okCount, total: rows.length, rows };
+    } catch (e) {
+      emit("workbuddy-checkin-failed", { error: String(e?.message || e).slice(0, 200), reason });
+      return { ok: false, error: String(e?.message || e).slice(0, 200) };
+    } finally {
+      running = false;
+    }
+  }
+
+  // 启动补签：昨天没签且已过今天计划点，60s 后跑（等网络/上游就绪）
+  try {
+    const lastDate = stateMod.readState(stateMod.defaultStateFile())?.workbuddyCheckin?.date || "";
+    if (shouldCatchUp({ lastDate, hour })) {
+      setTimeout(() => { runOnce("catch-up").catch(() => {}); }, 60_000).unref?.();
+      console.log(`[workbuddy-checkin] catch-up scheduled (last=${lastDate || "never"})`);
+    }
+  } catch {}
+  // 每日定时：对齐到下一个计划点，跑完再约 24h 后
+  function arm() {
+    const delay = nextRunDelayMs(new Date(), hour);
+    setTimeout(() => {
+      runOnce("daily").catch(() => {}).finally(arm);
+    }, delay).unref?.();
+  }
+  arm();
+  return { enabled: true, hour, runOnce };
+}