Consider it done. The open-source AI agent that works out of the box · 想到,就能做到。开源、开箱即用的 AI Agent。
TypeScript agentai-agentai-assistantandroidclaude-codecodexelectroniosllmmacosreact-nativetypescriptwindows
fix(maker-shared): arm the codex stale timer at the transition instant
Eapp1e07ecaa46655b
diff --git a/packages/maker-shared/src/__tests__/sessionControls.test.ts b/packages/maker-shared/src/__tests__/sessionControls.test.tsindex 50e83fadaa..e428caec10 100644--- a/packages/maker-shared/src/__tests__/sessionControls.test.ts+++ b/packages/maker-shared/src/__tests__/sessionControls.test.ts@@ -1,5 +1,6 @@import { describe, expect, it, vi } from 'vitest';import {+ isCodexBucketStale,nextCodexBucketStaleAtMs,resolveCodexBucketTable,selectCodexUsageForModel,@@ -317,6 +318,34 @@ describe('generic bucket alias priority', () => {expect(nextCodexBucketStaleAtMs(null, NOW)).toBeNull();expect(nextCodexBucketStaleAtMs({}, NOW)).toBeNull();});++ it('keeps the transition armed at the exact stale instant', () => {+ const resetsAt = Math.floor(NOW / 1000);+ const staleAt = resetsAt * 1000 + 24 * 60 * 60 * 1000;+ const promo = {+ limitId: 'codex_bengalfox',+ limitName: 'GPT-5.3-Codex-Spark',+ primary: { usedPercent: 100, resetsAt },+ };+ // 陈旧判据是严格 `<`: staleAt 这一毫秒仍有效, staleAt + 1 才陈旧。+ expect(isCodexBucketStale(promo, staleAt)).toBe(false);+ expect(isCodexBucketStale(promo, staleAt + 1)).toBe(true);+ // 定时器正是在返回的那一刻回调, 因此这里仍须给出 staleAt, 否则面板不再重选。+ expect(nextCodexBucketStaleAtMs({ codex_bengalfox: promo }, staleAt)).toBe(staleAt);+ expect(nextCodexBucketStaleAtMs({ codex_bengalfox: promo }, staleAt + 1)).toBeNull();+ // 选桶同理: staleAt 这一毫秒仍能选中 promo, 再下一毫秒才被排除 —— 否则这条断言+ // 只是因为桶表匹配不到模型而恒为 null, 证明不了过期桶被排除。+ expect(selectCodexUsageForModel({+ byLimitId: { codex_bengalfox: promo },+ modelId: 'gpt-5.3-codex-spark',+ nowMs: staleAt,+ })).toBe(promo);+ expect(selectCodexUsageForModel({+ byLimitId: { codex_bengalfox: promo },+ modelId: 'gpt-5.3-codex-spark',+ nowMs: staleAt + 1,+ })).toBeNull();+ });});describe('overlapping bucket names', () => {@@ -381,3 +410,4 @@ describe('resolveCodexBucketTable (selector / timer must agree)', () => {expect(resolveCodexBucketTable({ byLimitId: [], appServerBuckets: 'nope' })).toBeNull();});});+diff --git a/packages/maker-shared/src/codexUsageBuckets.ts b/packages/maker-shared/src/codexUsageBuckets.tsindex 5f2b120883..ba542aa8a5 100644--- a/packages/maker-shared/src/codexUsageBuckets.ts+++ b/packages/maker-shared/src/codexUsageBuckets.ts@@ -1,223 +1,227 @@-/**- * codexUsageBuckets — Codex 账号限额「桶」的共享语义(main 与 renderer 共用一份)。- *- * 账号可能同时存在多个限额桶: 主配额桶与模型专属促销桶(如 codex_bengalfox /- * GPT-5.3-Codex-Spark)。app-server 的 account/rateLimits/updated 每次只推**一个**- * 桶(带 limitId), 因此存储必须按 limitId 隔离, 展示必须按当前会话模型选桶。- *- * 这里放各端必须**同口径**的判定与常量 —— 多份实现会漂移(review 实例: 陈旧- * 宽限一侧 1h 一侧 24h, 导致 main 仍保留而 renderer 已隐藏)。- * desktop(main / renderer)与 mobile 会话用量详情共用本模块。- */--/** 桶表的缺省键: 快照没带 limitId 时用它(单桶账号 / 老 app-server)。 */-export const CODEX_DEFAULT_LIMIT_BUCKET = '__default__';--/** 用作对象键会污染原型链的保留名 —— 一律回退缺省桶 / 丢弃。 */-export const UNSAFE_BUCKET_KEYS: ReadonlySet<string> = new Set([- '__proto__',- 'constructor',- 'prototype',-]);--/**- * 通用(非模型专属)桶的稳定标识 —— 只认桶键, 不看易在部分通知里丢失的 limitName。- * **按优先级排列**: 显式 'codex' 优先于缺省桶别名 —— 旧快照没带 limitId 时会- * 落到 '__default__', 之后真正的 'codex' 通知会新建第二个通用桶; 按插入序查找- * 会一直命中旧的缺省桶并显示陈旧百分比(review 反馈)。- */-export const GENERIC_BUCKET_KEYS_BY_PRIORITY: readonly string[] = [- 'codex',- CODEX_DEFAULT_LIMIT_BUCKET,-];--/** 集合形式(成员判定用);优先级查找请用 GENERIC_BUCKET_KEYS_BY_PRIORITY。 */-export const GENERIC_BUCKET_KEYS: ReadonlySet<string> = new Set(GENERIC_BUCKET_KEYS_BY_PRIORITY);--/**- * 陈旧桶宽限: 窗口全部过点超过它, 视为服务端已停推该 limitId(促销结束等)。- * main(记录时剪枝)与 renderer(选桶时跳过)必须用同一个值, 否则会出现- * 「main 保留但 renderer 隐藏」的空窗。- */-export const STALE_BUCKET_GRACE_MS = 24 * 60 * 60 * 1000;--/**- * 判定所需的最小窗口 / 快照形状 —— main 与 renderer 各自更宽的 RateLimitSnapshot- * 结构兼容(结构子类型), 这里只声明本模块真正读的字段。- */-export interface BucketWindowLike {- usedPercent?: number;- windowMinutes?: number | null;- resetsAt?: number | null;-}--export interface BucketSnapshotLike {- limitId?: string | null;- limitName?: string | null;- primary?: BucketWindowLike | null;- secondary?: BucketWindowLike | null;-}--/** 快照 → 桶键。limitId 缺失 / 为危险保留名时归缺省桶。 */-export function codexLimitBucketKey(snapshot: BucketSnapshotLike | null | undefined): string {- const limitId = snapshot?.limitId;- if (typeof limitId !== 'string' || limitId.length === 0) return CODEX_DEFAULT_LIMIT_BUCKET;- return UNSAFE_BUCKET_KEYS.has(limitId) ? CODEX_DEFAULT_LIMIT_BUCKET : limitId;-}--/**- * 陈旧桶 = **所有**窗口都带有效 resetsAt 且全部过点超宽限。- *- * 只要有一个窗口缺 resetsAt 就不判陈旧 —— 该字段是可选的, 拿「有时间戳的那些- * 都过期了」当全体过期的证据, 会在周窗口没给时间戳时误删仍然有效的桶- * (review 反馈)。无窗口同样不判陈旧(信息不足, 交给上层兜底)。- */-export function isCodexBucketStale(- bucket: BucketSnapshotLike | null | undefined,- nowMs: number,-): boolean {- if (!bucket) return true;- const windows = [bucket.primary, bucket.secondary].filter(- (window): window is BucketWindowLike => Boolean(window),- );- if (windows.length === 0) return false;- const resets = windows- .map((window) => window.resetsAt)- .filter((value): value is number => typeof value === 'number'- && Number.isFinite(value)- && value > 0);- // 有窗口没给 resetsAt → 信息不足, 保守视为未过期。- if (resets.length !== windows.length) return false;- return Math.max(...resets) * 1000 + STALE_BUCKET_GRACE_MS < nowMs;-}--/** 模型 id / 桶名 → 可比较 token(小写, 去非字母数字)。 */-function normalizeModelToken(value: string | null | undefined): string {- return typeof value === 'string' ? value.toLowerCase().replace(/[^a-z0-9]/g, '') : '';-}--/**- * 按**当前会话模型**选桶(desktop chip 与 mobile 用量详情共用)。- *- * 不能用 account_usage 事件判会话归属: 该 notification 是账号级的, host 把同一条- * fan-out 给所有 subscriber 再各自包上 sessionId(app-server host.routeNotification),- * 拿它当会话事实等于把任意会话触发的桶串给所有会话。- *- * 规则(按序):- * 1. 桶的 limitName 命中当前模型(如 'GPT-5.3-Codex-Spark' ↔ gpt-5.3-codex-spark);- * 精确匹配优先, 其次取最长匹配(重叠桶名下 'GPT-5.3-Codex' 不得抢走 Spark 会话);- * 2. 通用桶 —— 由**稳定桶键**(limitId 'codex' / 缺省桶)识别, 不能靠「没有- * limitName」判断: limitName 可选, 同桶 merge 遇到省略该字段的部分通知会把它- * 抹成 undefined, 模型专属桶会伪装成通用桶;- * 3. 都没有 → null。**绝不**退而求其次选一个已知属于别的模型的桶。- * 陈旧桶(窗口全部过期超宽限, 如促销结束后服务端停推)不参与匹配。- */-export function matchCodexBucketForModel<T extends BucketSnapshotLike>(- buckets: Record<string, T> | null | undefined,- modelId: string | null | undefined,- nowMs: number = Date.now(),-): T | null {- const entries = Object.entries(buckets ?? {}).filter(- ([, bucket]) => !isCodexBucketStale(bucket, nowMs),- );- if (entries.length === 0) return null;- const model = normalizeModelToken(modelId);- if (model) {- // 精确匹配优先; 否则取**最长**的 substring 匹配 —— 桶顺序反映更新 / 持久化- // 顺序, 按首个匹配返回会让 'GPT-5.3-Codex' 抢走本属于 'GPT-5.3-Codex-Spark'- // 的会话, 通用名 'Codex' 更会命中所有 codex/* 模型(review 反馈)。- let longest: { bucket: T; length: number } | null = null;- for (const [, bucket] of entries) {- const name = normalizeModelToken(bucket.limitName);- if (!name) continue;- if (name === model) return bucket;- if (model.includes(name) && (longest === null || name.length > longest.length)) {- longest = { bucket, length: name.length };- }- }- if (longest) return longest.bucket;- }- // 按优先级取通用桶(不能靠 entries 的插入序, 见 GENERIC_BUCKET_KEYS_BY_PRIORITY)。- for (const key of GENERIC_BUCKET_KEYS_BY_PRIORITY) {- const hit = entries.find(([entryKey]) => entryKey === key);- if (hit) return hit[1];- }- return null;-}--/**- * 防御式选桶入口(unknown 进 / unknown 出)—— 供 mobile 会话用量详情直接串在- * summarizeAccountRateLimits 之前使用: 两端拿到的 payload 形状都不保证。- *- * 桶来源优先级: 权威 rateLimitsByLimitId > 组合 payload 的 appServerBuckets;- * 两者都没有(旧被控端 / 尚无数据)→ 原样返回 fallback 顶层快照, 保持旧行为。- * 有桶表时以选桶结果为准, 匹配不到返回 null(不渲染限额区), 绝不显示别的模型的桶。- */-export function selectCodexUsageForModel(input: {- fallback?: unknown;- byLimitId?: unknown;- appServerBuckets?: unknown;- modelId?: string | null;- nowMs?: number;-}): unknown {- const nowMs = input.nowMs ?? Date.now();- const buckets = resolveCodexBucketTable(input);- if (!buckets) return input.fallback ?? null;- return matchCodexBucketForModel(buckets, input.modelId, nowMs);-}--/**- * 解析出**实际生效**的桶表: 权威 rateLimitsByLimitId 优先, 空表 / 畸形则回退- * appServerBuckets, 都不可用 → null。- *- * 选桶与「到点重选」定时器必须共用它 —— 用 `a ?? b` 只挡 null/undefined,- * 空对象 `{}` 会被当成有效表, 于是选桶回退到了 appServerBuckets 而定时器却按- * 空表算出「无需定时」, 面板跨过失效时刻不会重选(review 反馈)。- */-export function resolveCodexBucketTable(input: {- byLimitId?: unknown;- appServerBuckets?: unknown;-}): Record<string, BucketSnapshotLike> | null {- return readBucketTable(input.byLimitId) ?? readBucketTable(input.appServerBuckets);-}--/**- * 桶表中最近一个「由有效转为陈旧」的时刻(ms);没有可预期的转变 → null。- * 陈旧判定只在选桶时求值, 界面常驻时不会自己重算 —— desktop chip 与 mobile- * 用量面板都用它安排一次到点重选, 否则过期促销桶会一直挂着(review 反馈)。- */-export function nextCodexBucketStaleAtMs(buckets: unknown, nowMs: number): number | null {- const table = readBucketTable(buckets);- if (!table) return null;- let soonest: number | null = null;- for (const bucket of Object.values(table)) {- if (isCodexBucketStale(bucket, nowMs)) continue;- const windows = [bucket.primary, bucket.secondary].filter(- (window): window is BucketWindowLike => Boolean(window),- );- if (windows.length === 0) continue;- const resets = windows- .map((window) => window.resetsAt)- .filter((value): value is number => typeof value === 'number'- && Number.isFinite(value)- && value > 0);- // 与 isCodexBucketStale 同口径: 有窗口缺时间戳就永不进入陈旧, 无需定时。- if (resets.length !== windows.length) continue;- const staleAt = Math.max(...resets) * 1000 + STALE_BUCKET_GRACE_MS;- if (staleAt > nowMs && (soonest === null || staleAt < soonest)) soonest = staleAt;- }- return soonest;-}--/** unknown → 桶表(丢弃非对象条目与危险键);不是可用桶表 → null。 */-function readBucketTable(value: unknown): Record<string, BucketSnapshotLike> | null {- if (!value || typeof value !== 'object' || Array.isArray(value)) return null;- const out: Record<string, BucketSnapshotLike> = {};- for (const [key, entry] of Object.entries(value as Record<string, unknown>)) {- if (UNSAFE_BUCKET_KEYS.has(key)) continue;- if (entry && typeof entry === 'object' && !Array.isArray(entry)) {- out[key] = entry as BucketSnapshotLike;- }- }- return Object.keys(out).length > 0 ? out : null;-}+/**+ * codexUsageBuckets — Codex 账号限额「桶」的共享语义(main 与 renderer 共用一份)。+ *+ * 账号可能同时存在多个限额桶: 主配额桶与模型专属促销桶(如 codex_bengalfox /+ * GPT-5.3-Codex-Spark)。app-server 的 account/rateLimits/updated 每次只推**一个**+ * 桶(带 limitId), 因此存储必须按 limitId 隔离, 展示必须按当前会话模型选桶。+ *+ * 这里放各端必须**同口径**的判定与常量 —— 多份实现会漂移(review 实例: 陈旧+ * 宽限一侧 1h 一侧 24h, 导致 main 仍保留而 renderer 已隐藏)。+ * desktop(main / renderer)与 mobile 会话用量详情共用本模块。+ */++/** 桶表的缺省键: 快照没带 limitId 时用它(单桶账号 / 老 app-server)。 */+export const CODEX_DEFAULT_LIMIT_BUCKET = '__default__';++/** 用作对象键会污染原型链的保留名 —— 一律回退缺省桶 / 丢弃。 */+export const UNSAFE_BUCKET_KEYS: ReadonlySet<string> = new Set([+ '__proto__',+ 'constructor',+ 'prototype',+]);++/**+ * 通用(非模型专属)桶的稳定标识 —— 只认桶键, 不看易在部分通知里丢失的 limitName。+ * **按优先级排列**: 显式 'codex' 优先于缺省桶别名 —— 旧快照没带 limitId 时会+ * 落到 '__default__', 之后真正的 'codex' 通知会新建第二个通用桶; 按插入序查找+ * 会一直命中旧的缺省桶并显示陈旧百分比(review 反馈)。+ */+export const GENERIC_BUCKET_KEYS_BY_PRIORITY: readonly string[] = [+ 'codex',+ CODEX_DEFAULT_LIMIT_BUCKET,+];++/** 集合形式(成员判定用);优先级查找请用 GENERIC_BUCKET_KEYS_BY_PRIORITY。 */+export const GENERIC_BUCKET_KEYS: ReadonlySet<string> = new Set(GENERIC_BUCKET_KEYS_BY_PRIORITY);++/**+ * 陈旧桶宽限: 窗口全部过点超过它, 视为服务端已停推该 limitId(促销结束等)。+ * main(记录时剪枝)与 renderer(选桶时跳过)必须用同一个值, 否则会出现+ * 「main 保留但 renderer 隐藏」的空窗。+ */+export const STALE_BUCKET_GRACE_MS = 24 * 60 * 60 * 1000;++/**+ * 判定所需的最小窗口 / 快照形状 —— main 与 renderer 各自更宽的 RateLimitSnapshot+ * 结构兼容(结构子类型), 这里只声明本模块真正读的字段。+ */+export interface BucketWindowLike {+ usedPercent?: number;+ windowMinutes?: number | null;+ resetsAt?: number | null;+}++export interface BucketSnapshotLike {+ limitId?: string | null;+ limitName?: string | null;+ primary?: BucketWindowLike | null;+ secondary?: BucketWindowLike | null;+}++/** 快照 → 桶键。limitId 缺失 / 为危险保留名时归缺省桶。 */+export function codexLimitBucketKey(snapshot: BucketSnapshotLike | null | undefined): string {+ const limitId = snapshot?.limitId;+ if (typeof limitId !== 'string' || limitId.length === 0) return CODEX_DEFAULT_LIMIT_BUCKET;+ return UNSAFE_BUCKET_KEYS.has(limitId) ? CODEX_DEFAULT_LIMIT_BUCKET : limitId;+}++/**+ * 陈旧桶 = **所有**窗口都带有效 resetsAt 且全部过点超宽限。+ *+ * 只要有一个窗口缺 resetsAt 就不判陈旧 —— 该字段是可选的, 拿「有时间戳的那些+ * 都过期了」当全体过期的证据, 会在周窗口没给时间戳时误删仍然有效的桶+ * (review 反馈)。无窗口同样不判陈旧(信息不足, 交给上层兜底)。+ */+export function isCodexBucketStale(+ bucket: BucketSnapshotLike | null | undefined,+ nowMs: number,+): boolean {+ if (!bucket) return true;+ const windows = [bucket.primary, bucket.secondary].filter(+ (window): window is BucketWindowLike => Boolean(window),+ );+ if (windows.length === 0) return false;+ const resets = windows+ .map((window) => window.resetsAt)+ .filter((value): value is number => typeof value === 'number'+ && Number.isFinite(value)+ && value > 0);+ // 有窗口没给 resetsAt → 信息不足, 保守视为未过期。+ if (resets.length !== windows.length) return false;+ return Math.max(...resets) * 1000 + STALE_BUCKET_GRACE_MS < nowMs;+}++/** 模型 id / 桶名 → 可比较 token(小写, 去非字母数字)。 */+function normalizeModelToken(value: string | null | undefined): string {+ return typeof value === 'string' ? value.toLowerCase().replace(/[^a-z0-9]/g, '') : '';+}++/**+ * 按**当前会话模型**选桶(desktop chip 与 mobile 用量详情共用)。+ *+ * 不能用 account_usage 事件判会话归属: 该 notification 是账号级的, host 把同一条+ * fan-out 给所有 subscriber 再各自包上 sessionId(app-server host.routeNotification),+ * 拿它当会话事实等于把任意会话触发的桶串给所有会话。+ *+ * 规则(按序):+ * 1. 桶的 limitName 命中当前模型(如 'GPT-5.3-Codex-Spark' ↔ gpt-5.3-codex-spark);+ * 精确匹配优先, 其次取最长匹配(重叠桶名下 'GPT-5.3-Codex' 不得抢走 Spark 会话);+ * 2. 通用桶 —— 由**稳定桶键**(limitId 'codex' / 缺省桶)识别, 不能靠「没有+ * limitName」判断: limitName 可选, 同桶 merge 遇到省略该字段的部分通知会把它+ * 抹成 undefined, 模型专属桶会伪装成通用桶;+ * 3. 都没有 → null。**绝不**退而求其次选一个已知属于别的模型的桶。+ * 陈旧桶(窗口全部过期超宽限, 如促销结束后服务端停推)不参与匹配。+ */+export function matchCodexBucketForModel<T extends BucketSnapshotLike>(+ buckets: Record<string, T> | null | undefined,+ modelId: string | null | undefined,+ nowMs: number = Date.now(),+): T | null {+ const entries = Object.entries(buckets ?? {}).filter(+ ([, bucket]) => !isCodexBucketStale(bucket, nowMs),+ );+ if (entries.length === 0) return null;+ const model = normalizeModelToken(modelId);+ if (model) {+ // 精确匹配优先; 否则取**最长**的 substring 匹配 —— 桶顺序反映更新 / 持久化+ // 顺序, 按首个匹配返回会让 'GPT-5.3-Codex' 抢走本属于 'GPT-5.3-Codex-Spark'+ // 的会话, 通用名 'Codex' 更会命中所有 codex/* 模型(review 反馈)。+ let longest: { bucket: T; length: number } | null = null;+ for (const [, bucket] of entries) {+ const name = normalizeModelToken(bucket.limitName);+ if (!name) continue;+ if (name === model) return bucket;+ if (model.includes(name) && (longest === null || name.length > longest.length)) {+ longest = { bucket, length: name.length };+ }+ }+ if (longest) return longest.bucket;+ }+ // 按优先级取通用桶(不能靠 entries 的插入序, 见 GENERIC_BUCKET_KEYS_BY_PRIORITY)。+ for (const key of GENERIC_BUCKET_KEYS_BY_PRIORITY) {+ const hit = entries.find(([entryKey]) => entryKey === key);+ if (hit) return hit[1];+ }+ return null;+}++/**+ * 防御式选桶入口(unknown 进 / unknown 出)—— 供 mobile 会话用量详情直接串在+ * summarizeAccountRateLimits 之前使用: 两端拿到的 payload 形状都不保证。+ *+ * 桶来源优先级: 权威 rateLimitsByLimitId > 组合 payload 的 appServerBuckets;+ * 两者都没有(旧被控端 / 尚无数据)→ 原样返回 fallback 顶层快照, 保持旧行为。+ * 有桶表时以选桶结果为准, 匹配不到返回 null(不渲染限额区), 绝不显示别的模型的桶。+ */+export function selectCodexUsageForModel(input: {+ fallback?: unknown;+ byLimitId?: unknown;+ appServerBuckets?: unknown;+ modelId?: string | null;+ nowMs?: number;+}): unknown {+ const nowMs = input.nowMs ?? Date.now();+ const buckets = resolveCodexBucketTable(input);+ if (!buckets) return input.fallback ?? null;+ return matchCodexBucketForModel(buckets, input.modelId, nowMs);+}++/**+ * 解析出**实际生效**的桶表: 权威 rateLimitsByLimitId 优先, 空表 / 畸形则回退+ * appServerBuckets, 都不可用 → null。+ *+ * 选桶与「到点重选」定时器必须共用它 —— 用 `a ?? b` 只挡 null/undefined,+ * 空对象 `{}` 会被当成有效表, 于是选桶回退到了 appServerBuckets 而定时器却按+ * 空表算出「无需定时」, 面板跨过失效时刻不会重选(review 反馈)。+ */+export function resolveCodexBucketTable(input: {+ byLimitId?: unknown;+ appServerBuckets?: unknown;+}): Record<string, BucketSnapshotLike> | null {+ return readBucketTable(input.byLimitId) ?? readBucketTable(input.appServerBuckets);+}++/**+ * 桶表中最近一个「由有效转为陈旧」的时刻(ms);没有可预期的转变 → null。+ * 陈旧判定只在选桶时求值, 界面常驻时不会自己重算 —— desktop chip 与 mobile+ * 用量面板都用它安排一次到点重选, 否则过期促销桶会一直挂着(review 反馈)。+ */+export function nextCodexBucketStaleAtMs(buckets: unknown, nowMs: number): number | null {+ const table = readBucketTable(buckets);+ if (!table) return null;+ let soonest: number | null = null;+ for (const bucket of Object.values(table)) {+ if (isCodexBucketStale(bucket, nowMs)) continue;+ const windows = [bucket.primary, bucket.secondary].filter(+ (window): window is BucketWindowLike => Boolean(window),+ );+ if (windows.length === 0) continue;+ const resets = windows+ .map((window) => window.resetsAt)+ .filter((value): value is number => typeof value === 'number'+ && Number.isFinite(value)+ && value > 0);+ // 与 isCodexBucketStale 同口径: 有窗口缺时间戳就永不进入陈旧, 无需定时。+ if (resets.length !== windows.length) continue;+ const staleAt = Math.max(...resets) * 1000 + STALE_BUCKET_GRACE_MS;+ // isCodexBucketStale 用严格 `<` 判定: 到 staleAt 这一毫秒尚未陈旧, 下一毫秒才陈旧。+ // 这里若用 `>` 过滤, 恰好在 staleAt 回调时会返回 null, 面板就不再安排重选,+ // 正是 docstring 要避免的「过期促销桶一直挂着」。+ if (staleAt >= nowMs && (soonest === null || staleAt < soonest)) soonest = staleAt;+ }+ return soonest;+}++/** unknown → 桶表(丢弃非对象条目与危险键);不是可用桶表 → null。 */+function readBucketTable(value: unknown): Record<string, BucketSnapshotLike> | null {+ if (!value || typeof value !== 'object' || Array.isArray(value)) return null;+ const out: Record<string, BucketSnapshotLike> = {};+ for (const [key, entry] of Object.entries(value as Record<string, unknown>)) {+ if (UNSAFE_BUCKET_KEYS.has(key)) continue;+ if (entry && typeof entry === 'object' && !Array.isArray(entry)) {+ out[key] = entry as BucketSnapshotLike;+ }+ }+ return Object.keys(out).length > 0 ? out : null;+}+