@xixka/dsh-hub 0.2.3 → 0.2.4

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
@@ -1940,6 +1940,59 @@ function registerJetHubEndpoints(ctx, pool, auths, modelAdapters) {
1940
1940
  await healExpiredAccountBeforeBalance(entry, now);
1941
1941
  }
1942
1942
  };
1943
+ /**
1944
+ * ★ 签到/领取成功后,把「被领到积分的账号」的共享余额读数**失效**(2026-11-04)。
1945
+ *
1946
+ * ## 它是「签到成功,余额不刷新」修法的**第二条腿**
1947
+ *
1948
+ * 签到是写操作:`credits.claimAll` 成功的那一刻上游余额已经变了,而共享缓存里
1949
+ * 还留着**签到前**的读数(TTL 120 秒)。同一个症状需要**两条互补的腿**:
1950
+ *
1951
+ * | 路径 | 腿 |
1952
+ * |---|---|
1953
+ * | 用户手点的「刷新余额」按钮 / 签到后的**强制重读**(徽标 `read.current()`、面板 `loadCredits(true)`) | **force 穿透到底**(`usage.badge → collectBalances → credits.balances → readStale`,见 `usage-badge.ts` 的接线)—— 本次直接回源拿新值。用户 2026-11-04 的要求原话:「所有刷新余额按钮,都能穿透缓存」。 |
1954
+ * | **没有**强制重读的路径(页头「一键签到」后的面板挂载 `loadCredits()`、每日自动签到、徽标 30s 轮询) | **本函数**:写操作后失效被领账号的共享读数 ⇒ 下一次**普通读**经缓存层回源出新值(对齐既有铁律「任何让积分增加的写操作都必须让下游失效」—— 该铁律的另一半是 `clearExpiryCache`)。 |
1955
+ *
1956
+ * 只做第一条腿的话,「页头一键签到 → 切进某渠道面板」仍会吃旧条目最多 2 分钟;
1957
+ * 只做第二条腿的话,用户点「刷新」还要等一次上游往返之外再被 TTL 卡住 ——
1958
+ * 两条腿各管各的入口,缺一就复现报障的某一半。
1959
+ *
1960
+ * ## 为什么放在 case 内部、而不是 RPC 请求入口的 `clearExpiryCache` 那处
1961
+ *
1962
+ * 「每日首次启动自动签到」(`createAutoCheckin` 的 `claim` 回调)**直接调
1963
+ * `handleMethod`**、绕过 RPC 请求入口的清理 ⇒ 放在 case 内**一处**,就同时
1964
+ * 覆盖徽标签到 / 页头一键签到 / 面板一键领取 / 自动签到全部四个入口
1965
+ * (`clearExpiryCache` 正因为绕过问题才需要在两处各清一次,本失效不需要)。
1966
+ *
1967
+ * ## 为什么只失效 `kind === 'claimed'`
1968
+ *
1969
+ * `already-claimed` / `inactive` / `failed` 都**不改变**余额:失效它们只会让
1970
+ * 下一次读多打一轮上游(逐账号串行是防风控纪律,别白烧)。`claimed` 里
1971
+ * autoclaw / codely 的 `delayedMessage`(「上游不返回积分数量,请查看刷新后
1972
+ * 的余额」)正是把「看刷新后的余额」写进文案的那两家 —— 本失效就是那句
1973
+ * 文案承诺的后半句。
1974
+ *
1975
+ * ## ⚠️ 成长任务(`growth`)不需要重复失效
1976
+ *
1977
+ * 成长会改余额,但它的唯一入口(面板「一键领取积分」传 `runTasks: true`)
1978
+ * 收尾时**必然** `loadCredits(true)`(force 回源并经 `writeBalance` 回写
1979
+ * 共享缓存)⇒ 该路径已被第一条腿收敛;徽标 / 自动签到不传 `runTasks`,
1980
+ * 到不了成长。给它重复失效只是白打上游。
1981
+ *
1982
+ * ⚠️ 与 `clearExpiryCache`(折算缓存清理)是**两条并行的下游失效**、不能互相
1983
+ * 替代:折算缓存管「候选可用性」(`UNUSABLE` 会锁 60 秒),共享读数管
1984
+ * 「余额数字本体」。
1985
+ */
1986
+ const invalidateClaimedBalanceReadings = (provider, results) => {
1987
+ const cache = balanceCacheOf();
1988
+ if (cache === undefined)
1989
+ return;
1990
+ for (const item of results) {
1991
+ if (item?.outcome?.kind !== 'claimed')
1992
+ continue;
1993
+ cache.invalidate(provider, item.accountId);
1994
+ }
1995
+ };
1943
1996
  /**
1944
1997
  * Loomy 短信登录的中间状态(账号 id → { phone, msgid })。
1945
1998
  *
@@ -2970,9 +3023,15 @@ function registerJetHubEndpoints(ctx, pool, auths, modelAdapters) {
2970
3023
  // ⚠️ **省略时不得传 `undefined` 之外的键**:端点以「键存在与否」区分
2971
3024
  // 「查全部」与「查空集」—— `accountIds: undefined` 会被 JSON 丢掉,
2972
3025
  // 故两种写法在这里等价(但显式展开更安全,见下面那行)。
2973
- collectBalances: (provider, accountIds) => handleMethod('credits.balances', {
3026
+ collectBalances: (provider, accountIds, options) => handleMethod('credits.balances', {
2974
3027
  provider,
2975
3028
  ...accountIds === undefined ? {} : { accountIds: [...accountIds] },
3029
+ // ★ force 透传(用户 2026-11-04:「所有刷新余额按钮,都能穿透缓存」):
3030
+ // 徽标「刷新」/ 签到后的强制重读只绕过徽标本层 45s 响应缓存还不够 ——
3031
+ // 底层 credits.balances 还有一层共享读数缓存(TTL 120 秒),不传时
3032
+ // 强制重读拿回的是签到前的旧数字(真实报障「签到成功,余额不刷新」)。
3033
+ // ⚠️ 只在为真时追加键:普通轮询的载荷形状与旧版逐字节一致。
3034
+ ...(options?.force === true ? { force: true } : {}),
2976
3035
  }),
2977
3036
  collectQuota: (provider) => provider === CLINE.id
2978
3037
  ? handleMethod('cline.quota', { provider })
@@ -5991,6 +6050,11 @@ function registerJetHubEndpoints(ctx, pool, auths, modelAdapters) {
5991
6050
  precheckStatus: false,
5992
6051
  warn: (msg) => ctx.logger?.warn?.(msg),
5993
6052
  });
6053
+ // ★ 签到成功 ⇒ 失效被领账号的共享余额读数(判据见
6054
+ // `invalidateClaimedBalanceReadings`)。qoder 面板余额是特例直连、
6055
+ // 不吃共享缓存,但**折算侧**(`provider-expiry.ts` 的 cachedBalance
6056
+ // 透传)吃 —— 故这里同样要失效。
6057
+ invalidateClaimedBalanceReadings(req.provider, value.results);
5994
6058
  return { ok: true, value: value };
5995
6059
  }
5996
6060
  if (req.provider === ZCODE.id) {
@@ -6039,6 +6103,9 @@ function registerJetHubEndpoints(ctx, pool, auths, modelAdapters) {
6039
6103
  outcomes.push(outcome);
6040
6104
  }
6041
6105
  }
6106
+ // ★ 同上:zcode 的余额走查表分派(吃共享缓存),签到成功后必须失效,
6107
+ // 否则「+500.00MToken」的提示与旧额度并列。
6108
+ invalidateClaimedBalanceReadings(req.provider, results);
6042
6109
  return {
6043
6110
  ok: true,
6044
6111
  value: { results, summary: computeClaimSummary(outcomes) },
@@ -6131,6 +6198,10 @@ function registerJetHubEndpoints(ctx, pool, auths, modelAdapters) {
6131
6198
  },
6132
6199
  warn: (msg) => ctx.logger?.warn?.(msg),
6133
6200
  });
6201
+ // ★ 签到成功 ⇒ 失效被领账号的共享余额读数(理由与判据见
6202
+ // `invalidateClaimedBalanceReadings` 的注释;放 case 内一处的理由
6203
+ // 也在那里 —— 自动签到直接调 `handleMethod`、绕过 RPC 入口)。
6204
+ invalidateClaimedBalanceReadings(req.provider, value.results);
6134
6205
  return { ok: true, value: value };
6135
6206
  }
6136
6207
  // 积分余额(Credits Balance):逐账号顺序查询。
@@ -8411,7 +8482,10 @@ function registerJetHubEndpoints(ctx, pool, auths, modelAdapters) {
8411
8482
  * 已有查表分派与 `unsupported provider` 的统一文案),本分支**原样透传**,
8412
8483
  * 不另立一份 provider 名单 —— 两份名单必然漂移。
8413
8484
  *
8414
- * ⚠️ `force: true` = 绕过缓存(手动刷新、签到之后)。
8485
+ * ⚠️ `force: true` = 绕过缓存(手动刷新、签到之后)—— 且是**两层**:徽标本层
8486
+ * 的 45s 响应缓存,与底层共享读数缓存(`usage-badge.ts` 的 `forcedLoads` 槽
8487
+ * 会把 force 继续传给 `collectBalances`;用户 2026-11-04:「所有刷新余额
8488
+ * 按钮,都能穿透缓存」)。
8415
8489
  */
8416
8490
  case 'usage.badge': {
8417
8491
  const req = payload;