Skip to content

armgit / cindy

Public Imported from GitHub
0

Consider it done. The open-source AI agent that works out of the box · 想到,就能做到。开源、开箱即用的 AI Agent。

8.1 KB
Raw Blame
/**
 * subscriptionUsage — 订阅账号余量快照的跨端契约与必须同口径的纯判定。
 *
 * 这些快照由被控端 desktop 读取(`maker:usage:claude-subscription` /
 * `maker:usage:xai-subscription`),desktop renderer 与 mobile 任务菜单都要按同一套规则
 * 选窗口、判新鲜度 —— 两份实现必然漂移(见 codexUsageBuckets 的同类教训)。
 * 来源解析(端点 / headers 归一化)仍在 desktop shared,只在被控端执行。
 */

// ── Claude 订阅 ──────────────────────────────────────────────────────────────

/** 单个用量窗口(5h / 周 / 分模型周)。utilization 一律 0-100 已用百分比。 */
export interface ClaudeUsageWindow {
  utilization: number;
  /** Unix epoch 秒;缺失 = 未知。 */
  resetsAt?: number | null;
  /** 服务端判定的告警级别(端点 limits[].severity,如 'normal';headers 源无此字段)。 */
  severity?: string | null;
}

/** 分模型周窗口(端点 limits[] 里 kind=weekly_scoped 的条目)。 */
export interface ClaudeScopedUsageWindow extends ClaudeUsageWindow {
  /** scope.model.display_name,如 'Fable' / 'Opus' / 'Sonnet'。 */
  modelDisplayName: string;
  /** scope.model.id(端点常为 null)。 */
  modelId?: string | null;
}

/** extra usage(usage credits)状态 —— 套餐打满后的按量付费通道。 */
export interface ClaudeExtraUsageSnapshot {
  isEnabled: boolean;
  /** 0-100;仅启用且服务端给值时有。 */
  utilization?: number | null;
  /**
   * 已用 credits(服务端原值)。单位未文档化,不要当货币金额展示;
   * 仅保留原始值,等拿到 extra-usage 账号实样后再定展示口径。
   */
  usedCredits?: number | null;
  /** 月度上限原值;0 = 不限。单位未文档化,不要当货币金额展示。 */
  monthlyLimit?: number | null;
}

export interface ClaudeSubscriptionUsageSnapshot {
  /** 5 小时滚动窗口。 */
  fiveHour?: ClaudeUsageWindow | null;
  /** 总周限窗口。 */
  sevenDay?: ClaudeUsageWindow | null;
  /** 分模型周窗口(仅 oauth-endpoint 源有)。 */
  scoped?: ClaudeScopedUsageWindow[];
  /** 订阅套餐(凭证 blob 的 subscriptionType: pro / max 等,记录时由 main 一并写入)。 */
  subscriptionType?: string | null;
  /** headers 源的整体状态:allowed / allowed_warning / rejected。 */
  rateLimitStatus?: string | null;
  /** headers 源:当前代表性(最紧)窗口名,如 'five_hour' / 'seven_day'。 */
  representativeClaim?: string | null;
  extraUsage?: ClaudeExtraUsageSnapshot | null;
  source?: 'oauth-endpoint' | 'unified-headers' | string | null;
  /** 快照生成时间(ms epoch)。 */
  updatedAt?: number | null;
  /**
   * 归属账号的 OAuth token 指纹(sha256 截断, main 记录时附加, 不含 token 原文)。
   * 同机换号时 reader 据此判定持久化快照已过期, 避免 chip 闪上一个账号的余量。
   * 缺失(旧快照 / 仅 headers 源)时按未知归属处理, 不据此清除。
   */
  accountFingerprint?: string | null;
}

// ── 方案 B:当前模型 → scoped 窗口匹配 ───────────────────────────────────────

/**
 * 去掉末尾的 `[...]` 后缀(如 `[1m]`),等价于 `/\[[^\]]*\]\s*$/`。不用正则:
 * model id 来自远端数据,该正则在大量 `[` 的输入上是多项式回溯(CodeQL)。
 */
function stripTrailingBracketSuffix(value: string): string {
  const close = value.trimEnd().length - 1;
  if (close < 0 || value[close] !== ']') return value;
  const open = value.indexOf('[', value.lastIndexOf(']', close - 1) + 1);
  return open >= 0 && open < close ? value.slice(0, open) : value;
}

/**
 * 从 model id 提取模型家族名(与端点 scope.model.display_name 对齐的小写词)。
 *   'claude-fable-5[1m]' → 'fable';'claude-opus-4-8' → 'opus';'sonnet' → 'sonnet'
 * 未识别 → null(调用方回退总周限)。
 */
export function claudeModelFamily(modelId: string | null | undefined): string | null {
  const normalized = stripTrailingBracketSuffix((modelId ?? '').trim().toLowerCase());
  if (!normalized) return null;
  // 顺序无关 —— 家族名互斥地出现在 Anthropic model id 里。
  for (const family of ['fable', 'mythos', 'opus', 'sonnet', 'haiku']) {
    if (normalized.includes(family)) return family;
  }
  return null;
}

/**
 * 判断一个分模型周窗口是否属于指定家族。
 *
 * 优先用窗口自带的 `modelId` 经 `claudeModelFamily` 归类(权威、精确);`modelId`
 * 缺失或无法归类(端点常为 null,或 id 形态不在识别表里)时,回退用 `modelDisplayName`
 * 的变体包含匹配——端点对 display_name 的口径历史上有 "Fable" / "Claude Fable" /
 * "Fable 5" 等形态,精确等于会漏掉变体(issue #3244)。家族名互斥,不会跨家族误命中。
 *
 * matcher(`matchScopedWindowForModel`)与 legacy 兜底去重共用这一份口径,避免两份
 * includes 规则漂移。
 */
export function scopedWindowBelongsToFamily(
  window: ClaudeScopedUsageWindow,
  family: string,
): boolean {
  const fromId = claudeModelFamily(window.modelId);
  if (fromId) return fromId === family;
  return window.modelDisplayName.trim().toLowerCase().includes(family);
}

/**
 * 找当前会话模型对应的分模型周窗口(chip 方案 B:第二栏跟随当前模型)。
 * 找不到 → null,调用方回退 sevenDay 总周限(绝不臆造)。家族归属口径见
 * scopedWindowBelongsToFamily。
 */
export function matchScopedWindowForModel(
  scoped: ClaudeScopedUsageWindow[] | null | undefined,
  modelId: string | null | undefined,
): ClaudeScopedUsageWindow | null {
  if (!scoped || scoped.length === 0) return null;
  const family = claudeModelFamily(modelId);
  if (!family) return null;
  return scoped.find((w) => scopedWindowBelongsToFamily(w, family)) ?? null;
}

// ── xAI(SuperGrok)订阅 ───────────────────────────────────────────────────────

/** 分产品周用量(页面「Grok Build 2%」)。 */
export interface XaiProductUsage {
  /** 上游 product id,如 GrokBuild。 */
  product: string;
  /** 0-100 已用百分比。 */
  usagePercent: number;
}

export interface XaiSubscriptionUsageSnapshot {
  /** 套餐展示名,如 SuperGrok Heavy。 */
  planLabel?: string | null;
  /** 0-100 本周已用百分比(页面「2% 已使用」)。 */
  creditUsagePercent?: number | null;
  /** Unix epoch 秒;周窗口重置时刻。 */
  resetsAt?: number | null;
  /** 分产品已用百分比。 */
  productUsage?: XaiProductUsage[];
  /**
   * 额外使用点数余额。单位按 grok.com 页面为美元;0 / 缺失不要当「免费额度」展示。
   */
  prepaidBalance?: number | null;
  source?: 'cli-billing' | string | null;
  updatedAt?: number | null;
  /**
   * 稳定账号指纹(OIDC sub 的不可逆哈希)。换 SuperGrok 号时用来丢掉旧快照。
   * 不是 access token 哈希 —— token 刷新会轮换。
   */
  accountFingerprint?: string | null;
}

/** 超过这个时间没刷新到新快照,就不再当「当前额度」展示。 */
export const XAI_USAGE_STALE_MS = 30 * 60 * 1000;

/**
 * 周窗口数字是否还能当当前额度:过了 TTL,或已经过了 resetsAt 却还没新快照,
 * 都不当当前值(避免无限显示旧百分比 / 卡在「重置中」)。套餐名仍可单独展示。
 */
export function isXaiWeeklyUsageCurrent(
  snapshot: XaiSubscriptionUsageSnapshot | null | undefined,
  nowMs: number,
): boolean {
  if (!snapshot) return false;
  if (
    typeof snapshot.creditUsagePercent !== 'number'
    || !Number.isFinite(snapshot.creditUsagePercent)
  ) {
    return false;
  }
  if (typeof snapshot.updatedAt !== 'number' || !Number.isFinite(snapshot.updatedAt) || snapshot.updatedAt <= 0) {
    return false;
  }
  if (nowMs - snapshot.updatedAt > XAI_USAGE_STALE_MS) return false;
  if (typeof snapshot.resetsAt === 'number' && Number.isFinite(snapshot.resetsAt) && snapshot.resetsAt > 0) {
    if (nowMs >= snapshot.resetsAt * 1000) return false;
  }
  return true;
}