creditdaddy 1.1.1 → 1.2.0

package/src/zcodeAutoClaim.js

@@ -1,97 +1,97 @@
-/**
- * ZCode 活动自动领取 — 签到调度器每轮调用。
- *
- * 策略（对齐用户手动路径，逐级尝试）：
- *   1. billing/preview 查可领活动；为空 → 无事可做（返回 null，不留痕迹）
- *   2. 先直接 claim（不带验证码：服务端未风控时可直接成功）
- *   3. 返回 3007/3001（需要验证码 / 参数被拒）且有验证码提供者 → 拉 captcha 配置，
- *      让提供者（桌面版的隐藏窗口跑阿里云验证码 SDK 静默验证）拿 captchaVerifyParam 后重试
- *   4. 没有提供者（NAS / 纯 CLI）或验证码需要人工 → 标记「需手动领取」，卡片上提示
- *   - 1003（已领取过）按成功口径处理并记忆
- * 结果写入账号 lastResult（签到日历记忆用的是 status checked-in/already，第二天照常重查 preview）
- */
-
-import { logger } from './logger.js';
-import { fetchClaimPlans, claimPlan, fetchCaptchaConfig } from './zcodeClient.js';
-
-// 桌面版（Electron 主进程）注册的隐藏窗口验证码实现；NAS / CLI 为 null（走「需手动领取」分支）
-let captchaProvider = null;
-export function setZcodeCaptchaProvider(fn) { captchaProvider = typeof fn === 'function' ? fn : null; }
-export function hasZcodeCaptchaProvider() { return Boolean(captchaProvider); }
-export function getZcodeCaptchaProvider() { return captchaProvider; }
-
-const grantsText = (plan) => (plan.grants && plan.grants.length ? plan.grants.join('；') : '');
-
-/**
- * 为单个 ZCode 账号执行一次自动领取。
- * @returns {null | { status, message, claims: Array }} null = preview 为空或查询失败（已记日志，不上卡片）
- */
-export async function zcodeAutoClaim(account) {
-  const label = account.name || account.uid || account.id;
-  let plans;
-  try {
-    plans = (await fetchClaimPlans(account)).plans;
-  } catch (e) {
-    logger.debug('ZCODE-CLAIM', `${label} 活动查询失败：${e.message}`);
-    return null;
-  }
-  if (!plans.length) return null;
-
-  const claims = [];
-  let anySuccess = false;
-  let needManual = false;
-
-  for (const plan of plans) {
-    const planName = plan.name || plan.planId;
-    // 第 2 步：先试不带验证码
-    try {
-      const r = await claimPlan(account, plan.planId, {});
-      claims.push({ plan: planName, via: 'direct', ok: true });
-      anySuccess = true;
-      logger.info('ZCODE-CLAIM', `${label} 已领取「${planName}」（免验证码）${grantsText(plan) ? '：' + grantsText(plan) : ''}`);
-      continue;
-    } catch (e) {
-      if (e.code === 1003) {
-        claims.push({ plan: planName, ok: true, already: true });
-        logger.info('ZCODE-CLAIM', `${label}「${planName}」已领取过`);
-        continue;
-      }
-      if (e.code !== 3007 && e.code !== 3001) {
-        claims.push({ plan: planName, ok: false, message: e.message });
-        logger.warn('ZCODE-CLAIM', `${label} 领取「${planName}」失败：${e.message}`);
-        continue;
-      }
-    }
-    // 第 3 步：需要验证码
-    if (!captchaProvider) {
-      needManual = true;
-      claims.push({ plan: planName, ok: false, needManual: true });
-      logger.info('ZCODE-CLAIM', `${label}「${planName}」需要验证码，本环境无法自动通过，请在面板手动领取`);
-      continue;
-    }
-    try {
-      const cfg = await fetchCaptchaConfig();
-      if (!cfg.enabled || !cfg.sceneId) throw new Error('验证码配置不可用');
-      const { captchaParam, region } = await captchaProvider(cfg);
-      await claimPlan(account, plan.planId, { captchaParam, region });
-      claims.push({ plan: planName, via: 'captcha', ok: true });
-      anySuccess = true;
-      logger.info('ZCODE-CLAIM', `${label} 已领取「${planName}」（静默验证码）${grantsText(plan) ? '：' + grantsText(plan) : ''}`);
-    } catch (e2) {
-      needManual = true;
-      claims.push({ plan: planName, ok: false, needManual: true, message: e2.message });
-      logger.warn('ZCODE-CLAIM', `${label}「${planName}」验证码未完成：${e2.message}（可在面板手动领取）`);
-    }
-  }
-
-  const names = claims.filter((c) => c.ok && !c.already).map((c) => c.plan);
-  const status = names.length ? 'checked-in'
-    : claims.every((c) => c.already) ? 'already'
-    : 'failed';
-  const message = status === 'checked-in'
-    ? `已领取：${names.join('、')}${claims.some((c) => c.via === 'captcha') ? '（静默验证码）' : ''}`
-    : status === 'already' ? '活动均已领取过'
-    : needManual ? `有 ${claims.filter((c) => c.needManual).length} 个活动需要验证码，请在面板手动领取`
-    : `领取失败：${claims.filter((c) => !c.ok).map((c) => c.message).filter(Boolean)[0] || '未知错误'}`;
-  return { status, message, claims };
-}
+/**
+ * ZCode 活动自动领取 — 签到调度器每轮调用。
+ *
+ * 策略（对齐用户手动路径，逐级尝试）：
+ *   1. billing/preview 查可领活动；为空 → 无事可做（返回 null，不留痕迹）
+ *   2. 先直接 claim（不带验证码：服务端未风控时可直接成功）
+ *   3. 返回 3007/3001（需要验证码 / 参数被拒）且有验证码提供者 → 拉 captcha 配置，
+ *      让提供者（桌面版的隐藏窗口跑阿里云验证码 SDK 静默验证）拿 captchaVerifyParam 后重试
+ *   4. 没有提供者（NAS / 纯 CLI）或验证码需要人工 → 标记「需手动领取」，卡片上提示
+ *   - 1003（已领取过）按成功口径处理并记忆
+ * 结果写入账号 lastResult（签到日历记忆用的是 status checked-in/already，第二天照常重查 preview）
+ */
+
+import { logger } from './logger.js';
+import { fetchClaimPlans, claimPlan, fetchCaptchaConfig } from './zcodeClient.js';
+
+// 桌面版（Electron 主进程）注册的隐藏窗口验证码实现；NAS / CLI 为 null（走「需手动领取」分支）
+let captchaProvider = null;
+export function setZcodeCaptchaProvider(fn) { captchaProvider = typeof fn === 'function' ? fn : null; }
+export function hasZcodeCaptchaProvider() { return Boolean(captchaProvider); }
+export function getZcodeCaptchaProvider() { return captchaProvider; }
+
+const grantsText = (plan) => (plan.grants && plan.grants.length ? plan.grants.join('；') : '');
+
+/**
+ * 为单个 ZCode 账号执行一次自动领取。
+ * @returns {null | { status, message, claims: Array }} null = preview 为空或查询失败（已记日志，不上卡片）
+ */
+export async function zcodeAutoClaim(account) {
+  const label = account.name || account.uid || account.id;
+  let plans;
+  try {
+    plans = (await fetchClaimPlans(account)).plans;
+  } catch (e) {
+    logger.debug('ZCODE-CLAIM', `${label} 活动查询失败：${e.message}`);
+    return null;
+  }
+  if (!plans.length) return null;
+
+  const claims = [];
+  let anySuccess = false;
+  let needManual = false;
+
+  for (const plan of plans) {
+    const planName = plan.name || plan.planId;
+    // 第 2 步：先试不带验证码
+    try {
+      const r = await claimPlan(account, plan.planId, {});
+      claims.push({ plan: planName, via: 'direct', ok: true });
+      anySuccess = true;
+      logger.info('ZCODE-CLAIM', `${label} 已领取「${planName}」（免验证码）${grantsText(plan) ? '：' + grantsText(plan) : ''}`);
+      continue;
+    } catch (e) {
+      if (e.code === 1003) {
+        claims.push({ plan: planName, ok: true, already: true });
+        logger.info('ZCODE-CLAIM', `${label}「${planName}」已领取过`);
+        continue;
+      }
+      if (e.code !== 3007 && e.code !== 3001) {
+        claims.push({ plan: planName, ok: false, message: e.message });
+        logger.warn('ZCODE-CLAIM', `${label} 领取「${planName}」失败：${e.message}`);
+        continue;
+      }
+    }
+    // 第 3 步：需要验证码
+    if (!captchaProvider) {
+      needManual = true;
+      claims.push({ plan: planName, ok: false, needManual: true });
+      logger.info('ZCODE-CLAIM', `${label}「${planName}」需要验证码，本环境无法自动通过，请在面板手动领取`);
+      continue;
+    }
+    try {
+      const cfg = await fetchCaptchaConfig();
+      if (!cfg.enabled || !cfg.sceneId) throw new Error('验证码配置不可用');
+      const { captchaParam, region } = await captchaProvider(cfg);
+      await claimPlan(account, plan.planId, { captchaParam, region });
+      claims.push({ plan: planName, via: 'captcha', ok: true });
+      anySuccess = true;
+      logger.info('ZCODE-CLAIM', `${label} 已领取「${planName}」（静默验证码）${grantsText(plan) ? '：' + grantsText(plan) : ''}`);
+    } catch (e2) {
+      needManual = true;
+      claims.push({ plan: planName, ok: false, needManual: true, message: e2.message });
+      logger.warn('ZCODE-CLAIM', `${label}「${planName}」验证码未完成：${e2.message}（可在面板手动领取）`);
+    }
+  }
+
+  const names = claims.filter((c) => c.ok && !c.already).map((c) => c.plan);
+  const status = names.length ? 'checked-in'
+    : claims.every((c) => c.already) ? 'already'
+    : 'failed';
+  const message = status === 'checked-in'
+    ? `已领取：${names.join('、')}${claims.some((c) => c.via === 'captcha') ? '（静默验证码）' : ''}`
+    : status === 'already' ? '活动均已领取过'
+    : needManual ? `有 ${claims.filter((c) => c.needManual).length} 个活动需要验证码，请在面板手动领取`
+    : `领取失败：${claims.filter((c) => !c.ok).map((c) => c.message).filter(Boolean)[0] || '未知错误'}`;
+  return { status, message, claims };
+}

package/src/zcodeClient.js

@@ -97,14 +97,16 @@ function netPref() {
       proxyUrl: typeof j.proxyUrl === 'string' && j.proxyUrl.trim() ? j.proxyUrl.trim() : null,
       autoClaim: j.autoClaim === true,
       autoClaimUntil: Number.isFinite(j.autoClaimUntil) ? j.autoClaimUntil : null,
+      claimIntervalMin: Number.isFinite(j.claimIntervalMin) ? Number(j.claimIntervalMin) : null,
+      claimWindowMin: Number.isFinite(j.claimWindowMin) ? Number(j.claimWindowMin) : null,
     };
-  } catch { netPrefCache = { proxyFirst: false, proxyUrl: null, autoClaim: false, autoClaimUntil: null }; }
+  } catch { netPrefCache = { proxyFirst: false, proxyUrl: null, autoClaim: false, autoClaimUntil: null, claimIntervalMin: null, claimWindowMin: null }; }
   return netPrefCache;
 }
 function writeNetPref(p) {
   netPrefCache = p;
   fs.mkdirSync(codeHome(), { recursive: true, mode: 0o700 });
-  fs.writeFileSync(NET_PREFS_FILE(), JSON.stringify({ proxyFirst: p.proxyFirst, proxyUrl: p.proxyUrl, autoClaim: p.autoClaim, autoClaimUntil: p.autoClaimUntil || null }, null, 2), { mode: 0o600 });
+  fs.writeFileSync(NET_PREFS_FILE(), JSON.stringify({ proxyFirst: p.proxyFirst, proxyUrl: p.proxyUrl, autoClaim: p.autoClaim, autoClaimUntil: p.autoClaimUntil || null, claimIntervalMin: p.claimIntervalMin ?? null, claimWindowMin: p.claimWindowMin ?? null }, null, 2), { mode: 0o600 });
 }
 export function proxyFirst() { return netPref().proxyFirst; }
 export function proxyUrl() { return netPref().proxyUrl; }
@@ -126,6 +128,35 @@ export function enableAutoClaimFor(durationMs) {
   if (!Number.isFinite(duration) || duration <= 0) throw new Error('自动领取时长无效');
   writeNetPref({ ...netPref(), autoClaim: true, autoClaimUntil: Date.now() + duration });
 }
+
+// ── 自动领取计划：轮询周期 / 单次运行时长（用户可在面板弹窗里改，落 zcode-net.json） ──
+
+/** 轮询周期（分钟）。默认 2，可配 1–720 */
+export function claimIntervalMin() {
+  const raw = netPref().claimIntervalMin;
+  if (raw === null || raw === undefined) return 2;
+  const n = Math.round(Number(raw));
+  return Number.isFinite(n) && n >= 1 && n <= 720 ? n : 2;
+}
+export function setClaimIntervalMin(v) {
+  const n = Math.round(Number(v));
+  if (!Number.isFinite(n) || n < 1 || n > 720) throw new Error('轮询周期需在 1–720 分钟之间');
+  writeNetPref({ ...netPref(), claimIntervalMin: n });
+}
+
+/** 单次运行时长（分钟）。默认 60；0 = 一直运行直到手动关闭 */
+export function claimWindowMin() {
+  const raw = netPref().claimWindowMin;
+  if (raw === null || raw === undefined) return 60;
+  const n = Math.round(Number(raw));
+  if (n === 0) return 0;
+  return n >= 5 && n <= 1440 ? n : 60;
+}
+export function setClaimWindowMin(v) {
+  const n = Math.round(Number(v));
+  if (!Number.isFinite(n) || n < 0 || n > 1440 || (n > 0 && n < 5)) throw new Error('运行时长需为 0（一直运行）或 5–1440 分钟');
+  writeNetPref({ ...netPref(), claimWindowMin: n });
+}
 export function setProxyFirst(v) { writeNetPref({ ...netPref(), proxyFirst: v === true }); }
 export function setProxyUrl(u) {
   const t = typeof u === 'string' ? u.trim() : '';

package/src/zcodeGateway.js

@@ -28,7 +28,7 @@ let PLAN_SHAPE = null;
 try { PLAN_SHAPE = JSON.parse(readFileSync(path.join(__dirname, 'zcodePlanShape.json'), 'utf8')); } catch {}
 
 import { getZcodeCaptchaProvider } from './zcodeAutoClaim.js';
-import { gatewayKey as tenrouterGatewayKey } from './tenrouter.js';
+import { gatewayHostSuggestion } from './tenrouter.js';
 
 // 整链补全提供者（桌面版注册）：隐藏窗口内「真 Chromium 求解验证码 + 同源发起补全」，
 // 规避 Node fetch 的 TLS 指纹风控。签名 ({ captchaCfg, jwt, rawBody }) → { status, contentType, body }。
@@ -308,23 +308,29 @@ const LOOPBACK_RE = /^(::1|::ffff:127\.0\.0\.1|127\.0\.0\.1)$/;
 function isLoopbackRemote(remote) {
   return !remote || LOOPBACK_RE.test(String(remote));
 }
-function bearerOf(authHeader) {
-  const v = String(authHeader || '');
-  return v.startsWith('Bearer ') ? v.slice(7) : '';
+
+/** 规范化远端地址（剥 IPv4-mapped IPv6 前缀），与白名单条目比对 */
+export function remoteHost(remote) {
+  return String(remote || '').replace(/^::ffff:/i, '').trim();
 }
-function fixedTimeEquals(a, b) {
-  const ab = Buffer.from(String(a), 'utf8');
-  const bb = Buffer.from(String(b), 'utf8');
-  if (ab.length !== bb.length) {
-    // 比较仍执行一次以保持恒定时间轮廓，然后返回 false
-    crypto.timingSafeEqual(ab, ab);
-    return false;
-  }
-  return crypto.timingSafeEqual(ab, bb);
+
+/** 白名单匹配：精确 IP / 主机名，或 `*` 结尾的前缀通配（如 192.168.31.*） */
+export function remoteAllowed(remote, allowList) {
+  const host = remoteHost(remote);
+  if (!host) return false;
+  return (Array.isArray(allowList) ? allowList : []).some((entry) => {
+    const e = String(entry || '').trim();
+    if (!e) return false;
+    if (e.endsWith('*')) return host.toLowerCase().startsWith(e.slice(0, -1).toLowerCase());
+    return host.toLowerCase() === e.toLowerCase();
+  });
 }
 
 /**
  * 网关数据面入口。返回 true 表示响应已写出（含失败结论）。
+ *
+ * 访问控制：本机回环始终放行；开局域网后仅 IP 白名单内的机器可访问——
+ * zcode-free 本就是 10Router 侧免授权供应商，10Router 所在机器加白即可，不再保留虚拟 key 鉴权。
  */
 export async function handleGateway(req, res) {
   if (req.method !== 'POST') {
@@ -338,27 +344,17 @@ export async function handleGateway(req, res) {
   // 首发不带验证码（客户端真实流量多数直过），所以纯 daemon / NAS 也能用；
   // 只有当上游索要验证码且本环境没有求解提供者时才失败（见 attempts 汇总）。
 
-  // 鉴权：本机回环免密；局域网/远程访问必须携带与设置一致的密钥
-  // （推荐直接复用 10r 的 LLM key：在 10r 面板复制，填进网关密钥与节点连接各一次）
+  // 鉴权：本机回环免密；开局域网后仅白名单内 IP 免密直连（如 10Router 所在机器——zcode-free 本就是免授权供应商）
   const remote = (req.socket && req.socket.remoteAddress) || '';
   if (!isLoopbackRemote(remote)) {
     const settings = await loadSettings();
     if (settings.zcodeGatewayLan !== true) {
       res.writeHead(403, { 'Content-Type': 'application/json' });
-      return res.end(JSON.stringify({ error: '网关未允许局域网访问（面板 → ZCode → 局域网开关）' }));
-    }
-    // 访问密钥 = 10Router 连接设置里保存的虚拟 key（sk-…）——用户从有鉴权的
-    // 10Router 面板复制，同一把 key 也配在 10Router 的 zcode-free 连接里
-    const expected = tenrouterGatewayKey();
-    if (expected.length === 0) {
-      res.writeHead(401, { 'Content-Type': 'application/json' });
-      return res.end(JSON.stringify({ error: '网关已对局域网开放但未配置 10Router 虚拟 key（10Router 连接设置）' }));
+      return res.end(JSON.stringify({ error: '网关未允许局域网访问（面板 → ZCode → 接口设置）' }));
     }
-    const h = req.headers || {};
-    const given = String(h['x-api-key'] || bearerOf(h.authorization) || '').trim();
-    if (!given || !fixedTimeEquals(given, expected)) {
-      res.writeHead(401, { 'Content-Type': 'application/json' });
-      return res.end(JSON.stringify({ error: '网关密钥不匹配' }));
+    if (!remoteAllowed(remote, settings.zcodeGatewayAllow)) {
+      res.writeHead(403, { 'Content-Type': 'application/json' });
+      return res.end(JSON.stringify({ error: `来源 ${remoteHost(remote) || '未知'} 不在网关 IP 白名单内（面板 → ZCode → 接口设置里添加）` }));
     }
   }
 
@@ -550,12 +546,12 @@ export async function gatewayStatus() {
   for (const a of all) { try { claimToken(a); withJwt++; } catch { /* 无 plan JWT */ } }
   const now = Date.now();
   const settings = await loadSettings();
-  const key = tenrouterGatewayKey();
   return {
     enabled,
     hasCaptcha,
     lan: settings.zcodeGatewayLan === true,
-    hasKey: key.length > 0,
+    allow: Array.isArray(settings.zcodeGatewayAllow) ? settings.zcodeGatewayAllow : [],
+    suggestAllow: gatewayHostSuggestion(),
     stats: {
       lastCallAt: stats.lastCallAt,
       calls: stats.calls,