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。

13.2 KB
Raw Blame
/**
 * UsageTokenBars — 近 30 天每日 token 堆叠柱状图 (设置 → 用量历史)。
 *
 * 与首页的 UsageDailyBars 是姊妹组件, 但**不是它的 token 分支**: 那个组件的币种选取、
 * api / 订阅估算分段、金额 tooltip 都是围绕金额长出来的, 塞进 metric 分支等于让一个
 * 组件同时维护两套逻辑。本页只统计 token (issue #2785), 分段规则简化成"按天 × rank 求和"。
 *
 * 从 UsageDailyBars 照搬的两处视觉规则 (不搬会比首页看板简陋):
 *   - niceTicks(): max/4 取整到 1 / 2 / 2.5 / 5 / 10 档, 最多 3 条; Y 轴列固定 30px 宽,
 *     避免数字位数变化引起布局抖动
 *   - 柱高 max(3, round(ratio × H)); 零值日固定 2px, 保留"那天有格子但没用量"的视觉
 *
 * 日期推算一律以 main 返回的 todayKey 为锚, renderer 不自己取系统日期。
 * 悬停 / 聚焦时整张图共用一个 UsageBarsTooltip 浮层 (日期、总量、占比条、按模型明细),
 * 不再用原生 title —— 原生提示无法排版配色, 也不给每根柱子各挂一个 Radix 实例。
 */

import React, { useCallback, useEffect, useId, useMemo, useReducer, useRef, useState } from 'react';
import { useTranslation } from 'react-i18next';

import { formatCompactTokens } from '@/lib/usageFormat';
import type { UsageHistoryModelDay } from '@/hooks/useUsageHistory';
import { usageModelKey } from '@/components/new-chat/usagePalette';

import { usageHistoryModelColor } from './usageHistoryColors';
import { UsageBarsTooltip, type UsageBarsTooltipData } from './UsageBarsTooltip';

const WINDOW_DAYS = 30;
const CHART_HEIGHT_PX = 96;

interface DaySegment {
  rank: number;
  label: string;
  tokens: number;
}

interface DayBar {
  day: string;
  tokens: number;
  /** rank 升序 (rank 0 = 最大头模型, 渲染在柱子底部)。 */
  segments: DaySegment[];
}

function shiftDayKeyLocal(dayKey: string, deltaDays: number): string {
  const [y, m, d] = dayKey.split('-').map(Number);
  const date = new Date(y, (m ?? 1) - 1, (d ?? 1) + deltaDays);
  const mm = String(date.getMonth() + 1).padStart(2, '0');
  const dd = String(date.getDate()).padStart(2, '0');
  return `${date.getFullYear()}-${mm}-${dd}`;
}

function parseDayKeyLocal(dayKey: string): Date {
  const [year, month, day] = dayKey.split('-').map(Number);
  return new Date(year, (month ?? 1) - 1, day ?? 1);
}

/** 与 UsageDailyBars 同一套刻度算法, 保证两张图的刻度密度一致。 */
function niceTicks(max: number): number[] {
  if (!(max > 0)) return [];
  const rawStep = max / 4;
  const pow = Math.pow(10, Math.floor(Math.log10(rawStep)));
  const step = [1, 2, 2.5, 5, 10].map((m) => m * pow).find((s) => s >= rawStep) ?? 10 * pow;
  const ticks: number[] = [];
  for (let v = step; v <= max * 0.95 && ticks.length < 3; v += step) ticks.push(v);
  return ticks;
}

/** 柱图的一行来源数据:某天某个分段(模型、人或电脑)的 token;key 决定配色顺序与合并。 */
export interface UsageSeriesDay {
  day: string;
  key: string;
  tokens: number;
}

interface UsageBarsProps {
  todayKey: string;
  selectedDay?: string | null;
  /** Visual emphasis only; a multi-day range does not select individual buttons. */
  highlightRecentWeek?: boolean;
  onDayClick?: (day: string) => void;
}

export function UsageTokenBars({
  modelDaily,
  colorOrder,
  ...props
}: UsageBarsProps & {
  modelDaily: UsageHistoryModelDay[];
  /** 完整历史的模型 key(按 token 排序),决定分段与表格配色。 */
  colorOrder: string[];
}): React.JSX.Element {
  const daily = useMemo(
    () => modelDaily.map((row) => ({ day: row.day, key: usageModelKey(row.agentKind, row.model), tokens: row.tokens })),
    [modelDaily],
  );
  const labels = useMemo(
    () => new Map(modelDaily.map((row) => [usageModelKey(row.agentKind, row.model), row.model])),
    [modelDaily],
  );
  const labelOf = useCallback((key: string) => labels.get(key) ?? key, [labels]);
  return <UsageSeriesBars {...props} daily={daily} order={colorOrder} labelOf={labelOf} />;
}

/**
 * 按任意分段堆叠的近 30 天每日 token 柱图:设置 → 用量按模型;「远程与分享」页的用量还可按人、按电脑
 * (provider-groups.md §7)。几何、交互、浮层与配色规则与模型柱图完全相同(usage-history-charts.md)。
 */
export function UsageSeriesBars({
  daily,
  order,
  labelOf,
  todayKey,
  selectedDay,
  highlightRecentWeek = false,
  onDayClick,
}: UsageBarsProps & {
  daily: readonly UsageSeriesDay[];
  /** 分段 key 的固定顺序,决定堆叠次序与配色;不在里面的合并成「其它」。 */
  order: readonly string[];
  /** 分段在浮层与读屏文本里的名字。 */
  labelOf: (key: string) => string;
}): React.JSX.Element {
  const colorOrder = order;
  const { t, i18n } = useTranslation();
  const dateFormatter = useMemo(
    () =>
      new Intl.DateTimeFormat(i18n.language, {
        year: 'numeric',
        month: 'short',
        day: 'numeric',
      }),
    [i18n.language],
  );

  const bars = useMemo(() => {
    const ranks = new Map(colorOrder.map((key, rank) => [key, rank]));
    const segsByDay = new Map<string, Map<number, DaySegment>>();
    for (const row of daily) {
      if (row.tokens <= 0) continue;
      const rank = ranks.get(row.key) ?? colorOrder.length;
      let daySegs = segsByDay.get(row.day);
      if (!daySegs) {
        daySegs = new Map();
        segsByDay.set(row.day, daySegs);
      }
      const seg = daySegs.get(rank);
      if (seg) {
        seg.tokens += row.tokens;
        // 防御性兜底:调用方未登记的模型合并到尾部档 (rank === colorOrder.length),
        // 保留首个模型名会把合计错误地挂到它头上 —— 改标「其它」, 与图例同义。
        if (rank >= colorOrder.length) seg.label = t('usageDashboard.othersLegend');
      } else {
        daySegs.set(rank, {
          rank,
          label: rank >= colorOrder.length ? t('usageDashboard.othersLegend') : labelOf(row.key),
          tokens: row.tokens,
        });
      }
    }

    const list: DayBar[] = [];
    for (let i = WINDOW_DAYS - 1; i >= 0; i--) {
      const day = shiftDayKeyLocal(todayKey, -i);
      const segments = [...(segsByDay.get(day)?.values() ?? [])].sort((a, b) => a.rank - b.rank);
      list.push({
        day,
        tokens: segments.reduce((sum, s) => sum + s.tokens, 0),
        segments,
      });
    }
    return { list, max: Math.max(...list.map((b) => b.tokens), 0) };
  }, [daily, colorOrder, labelOf, todayKey, t]);

  const plotRef = useRef<HTMLDivElement>(null);
  const descriptionIdBase = useId();
  // 悬停与键盘聚焦是两个独立的触发源:任一仍有效就显示,悬停优先。只记「哪一天」,
  // 坐标由浮层在布局阶段按当前 DOM 测量 —— 数据刷新或重排后不会停在旧位置。
  const [hoverDay, setHoverDay] = useState<string | null>(null);
  const [focusDay, setFocusDay] = useState<string | null>(null);
  const activeDay = hoverDay ?? focusDay;
  // fixed 定位的浮层不随页面滚动:滚动或窗口尺寸变化时重新测量,跟随柱子。
  const [layoutTick, remeasure] = useReducer((tick: number) => tick + 1, 0);
  useEffect(() => {
    if (!activeDay) return;
    window.addEventListener('scroll', remeasure, true);
    window.addEventListener('resize', remeasure);
    return () => {
      window.removeEventListener('scroll', remeasure, true);
      window.removeEventListener('resize', remeasure);
    };
  }, [activeDay]);
  const activeBar = activeDay ? bars.list.find((b) => b.day === activeDay) : undefined;
  const tooltip: UsageBarsTooltipData | null = activeBar
    ? {
        day: activeBar.day,
        tokens: activeBar.tokens,
        segments: activeBar.segments.map((s) => ({
          key: s.rank,
          label: s.label,
          tokens: s.tokens,
          color: usageHistoryModelColor(s.rank, colorOrder.length),
        })),
        layoutTick,
        measureAnchor: () =>
          plotRef.current
            ?.querySelector<HTMLElement>(`[data-day="${activeBar.day}"]`)
            ?.getBoundingClientRect() ?? null,
        measurePlot: () => plotRef.current?.getBoundingClientRect() ?? null,
      }
    : null;

  const ticks = niceTicks(bars.max);
  const recentWeekStart = shiftDayKeyLocal(todayKey, -6);

  return (
    <div className="flex gap-1.5" style={{ height: CHART_HEIGHT_PX }}>
      {/* Y 轴 token 刻度 (有数据才显示; 宽度固定避免数字位数变化引起布局抖动) */}
      {ticks.length > 0 && (
        <div className="relative w-[4.5ch] shrink-0 text-11 tabular-nums">
          {ticks.map((v) => (
            <span
              key={v}
              className="absolute right-0 translate-y-1/2 text-11 leading-none tabular-nums text-[var(--text-tertiary)]"
              style={{ bottom: (v / bars.max) * CHART_HEIGHT_PX }}
            >
              {formatCompactTokens(v)}
            </span>
          ))}
        </div>
      )}
      <div className="relative min-w-0 flex-1">
        {/* 横向参考线 (柱子后面, 半透明) */}
        {ticks.map((v) => (
          <div
            key={v}
            className="absolute left-0 right-0 border-t border-[var(--border-default)] opacity-50"
            style={{ bottom: (v / bars.max) * CHART_HEIGHT_PX }}
          />
        ))}
        <div className="absolute inset-0">
          <div
            ref={plotRef}
            className="usage-token-plot flex h-full items-end gap-[3px]"
            onPointerLeave={() => setHoverDay(null)}
          >
            {bars.list.map((b) => {
              const ratio = bars.max > 0 ? b.tokens / bars.max : 0;
              const visualHeight =
                b.tokens > 0 ? Math.max(3, Math.round(ratio * CHART_HEIGHT_PX)) : 2;
              const hitHeight = Math.max(24, visualHeight);
              const usageSummary =
                b.tokens > 0
                  ? t('usageDashboard.tokensOnly', { tokens: formatCompactTokens(b.tokens) })
                  : t('usageHistory.heatmap.emptyCell');
              return (
                <button
                  key={b.day}
                  type="button"
                  data-day={b.day}
                  onPointerEnter={() => setHoverDay(b.day)}
                  onFocus={() => setFocusDay(b.day)}
                  onBlur={() => setFocusDay((day) => (day === b.day ? null : day))}
                  aria-label={`${dateFormatter.format(parseDayKeyLocal(b.day))} · ${usageSummary}`}
                  aria-describedby={
                    b.segments.length > 0 ? `${descriptionIdBase}-${b.day}` : undefined
                  }
                  aria-pressed={selectedDay === b.day}
                  data-highlighted={
                    selectedDay
                      ? selectedDay === b.day
                      : highlightRecentWeek && b.day >= recentWeekStart
                  }
                  onClick={() => onDayClick?.(b.day)}
                  disabled={!onDayClick}
                  // Hit height remains generous without forcing the visible bar width.
                  // Target sizing remains pending after cancellation of the added date entry.
                  className="usage-chart-target group relative flex min-w-0 flex-1 cursor-pointer items-end justify-center rounded-none border-0 bg-transparent p-0 outline-none"
                  style={{ height: hitHeight }}
                >
                  <span
                    aria-hidden="true"
                    data-usage-mark="usage-token-bar"
                    className="usage-chart-mark pointer-events-none flex shrink-0 flex-col overflow-hidden rounded-[2px]"
                    style={{
                      height: visualHeight,
                      width: 'calc(100% + var(--usage-mark-grow, 0px))',
                      backgroundColor: b.segments.length === 0 ? 'var(--surface-chip)' : undefined,
                    }}
                  >
                    {[...b.segments].reverse().map((s) => (
                      <span
                        key={s.rank}
                        style={{
                          height: `${(s.tokens / b.tokens) * 100}%`,
                          backgroundColor: usageHistoryModelColor(s.rank, colorOrder.length),
                        }}
                      />
                    ))}
                  </span>
                  <span
                    aria-hidden="true"
                    className="usage-chart-indicator pointer-events-none absolute inset-0 rounded-[2px]"
                  />
                </button>
              );
            })}
          </div>
        </div>
      </div>
      {/* 逐日模型明细的读屏文本:浮层 aria-hidden,原生 title 的这部分信息由它承接。 */}
      <div className="sr-only">
        {bars.list
          .filter((b) => b.segments.length > 0)
          .map((b) => (
            <span key={b.day} id={`${descriptionIdBase}-${b.day}`}>
              {[...b.segments]
                .sort((x, y) => y.tokens - x.tokens)
                .map(
                  (s) =>
                    `${s.label}: ${t('usageDashboard.tokensOnly', {
                      tokens: formatCompactTokens(s.tokens),
                    })}`,
                )
                .join('; ')}
            </span>
          ))}
      </div>
      <UsageBarsTooltip data={tooltip} />
    </div>
  );
}