|
diff --git a/src/api.ts b/src/api.ts
index bf7d612..dc2eb9f 100644
--- a/src/api.ts
+++ b/src/api.ts
@@ -10,9 +10,10 @@ import type {
Paginated,
TrendGranularity,
TrendPoint,
+ UsageLogRecord,
UserBreakdownItem,
} from './types'
-import { TZ } from './format'
+import { shanghaiDateOf, TZ } from './format'
const API_BASE = (import.meta.env.VITE_API_BASE || '/api/v1').replace(/\/$/, '')
const ADMIN_KEY = import.meta.env.VITE_ADMIN_API_KEY || ''
@@ -80,6 +81,51 @@ export function getUsageTrend(
)
}
+/**
+ * 单个用户在某日期区间内的精准首末活跃时刻（秒级，来自逐请求日志 /admin/usage）。
+ *
+ * 实测契约（决定下面的取法，改动前先复核）：
+ * - 只有带 user_id 过滤时 start_date/end_date 与 total 才可靠；
+ * 不带 user_id 时日期被忽略、total 随页码虚增，禁止全站聚合式调用。
+ * - 结果固定按 created_at 倒序（sort/order 等参数实测全部无效）：
+ * 第 1 页第 1 条 = 末次活跃；页码 = total 的末页那 1 条 = 首次活跃。
+ * - 每条记录嵌套 user/api_key/group 全量对象（约 4KB/条），
+ * 所以 page_size 固定为 1，只探边界，不拉数据。
+ * - 两次调用间新进来的请求会让 total 微增，末页可能偏移一两条，
+ * 对「周期内首次使用」影响可忽略；末页为空则放弃精准值。
+ * - 后端日期截断的时区未经确证（工作时段数据无法区分上海日/UTC 日），
+ * 取回后按上海日历日校验，越界即视为不可信、返回 null 由调用方回退近似值。
+ */
+const LOG_PROBE_PAGE_SIZE = 1
+/** 翻页取末页的 OFFSET 上限，超过则不查首次活跃（交给图表近似值兜底） */
+const LOG_LAST_PAGE_MAX = 20000
+
+export async function getUsageActiveBounds(
+ userId: number,
+ start: string,
+ end: string,
+): Promise<{ first: string | null; last: string | null }> {
+ const withinRange = (rec: string | null | undefined): string | null => {
+ const day = shanghaiDateOf(rec || '')
+ return day && day >= start && day <= end ? (rec as string) : null
+ }
+ const base = {
+ user_id: userId,
+ start_date: start,
+ end_date: end,
+ page_size: LOG_PROBE_PAGE_SIZE,
+ }
+ const head = await request>('/admin/usage', { ...base, page: 1 })
+ const last = withinRange(head.items?.[0]?.created_at)
+ if (!last) return { first: null, last: null }
+ const total = Number(head.total || 0)
+ if (total <= 1 || total > LOG_LAST_PAGE_MAX) {
+ return { first: total <= 1 ? last : null, last }
+ }
+ const tail = await request>('/admin/usage', { ...base, page: total })
+ return { first: withinRange(tail.items?.[0]?.created_at), last }
+}
+
export function getModels(
start: string,
end: string,
diff --git a/src/format.ts b/src/format.ts
index 9677caf..670fb07 100644
--- a/src/format.ts
+++ b/src/format.ts
@@ -197,6 +197,51 @@ export function formatActiveAt(key: string | null | undefined): string {
return key.slice(0, 4) === todayYear ? key.slice(5) : key
}
+/** 日志时间戳（ISO，含时区）→ 上海日历日 YYYY-MM-DD，解析失败返回空串 */
+export function shanghaiDateOf(iso: string): string {
+ const date = new Date(iso)
+ if (Number.isNaN(date.getTime())) return ''
+ const parts = new Intl.DateTimeFormat('en-CA', {
+ timeZone: TZ,
+ year: 'numeric',
+ month: '2-digit',
+ day: '2-digit',
+ }).formatToParts(date)
+ const get = (type: string) => parts.find((p) => p.type === type)?.value || ''
+ return `${get('year')}-${get('month')}-${get('day')}`
+}
+
+/**
+ * 精准活跃时间短文案（来自 /admin/usage 日志的 created_at，ISO 字符串）。
+ * 统一渲染为上海时区，同年省略年份：「MM-DD HH:MM」；
+ * 传 seconds=true 显示到秒（用于悬浮提示）。
+ */
+export function formatActiveExact(
+ iso: string | null | undefined,
+ options?: { seconds?: boolean; now?: Date },
+): string {
+ if (!iso) return ''
+ const date = new Date(iso)
+ if (Number.isNaN(date.getTime())) return ''
+ const now = options?.now || new Date()
+ const parts = new Intl.DateTimeFormat('en-CA', {
+ timeZone: TZ,
+ year: 'numeric',
+ month: '2-digit',
+ day: '2-digit',
+ hour: '2-digit',
+ minute: '2-digit',
+ ...(options?.seconds ? { second: '2-digit' } : {}),
+ hourCycle: 'h23',
+ }).formatToParts(date)
+ const get = (type: string) => parts.find((p) => p.type === type)?.value || ''
+ const ymd = `${get('year')}-${get('month')}-${get('day')}`
+ const hm = options?.seconds
+ ? `${get('hour')}:${get('minute')}:${get('second')}`
+ : `${get('hour')}:${get('minute')}`
+ return ymd.slice(0, 4) === todayISO(now).slice(0, 4) ? `${ymd.slice(5)} ${hm}` : `${ymd} ${hm}`
+}
+
export function formatQuotaRecovery(value: string | null | undefined, now = new Date()): string {
if (!value) return ''
const date = new Date(value)
diff --git a/src/style.css b/src/style.css
index 6b07437..2fb24b3 100644
--- a/src/style.css
+++ b/src/style.css
@@ -322,7 +322,7 @@ table.rank .col-rank {
}
table.rank .col-user {
- width: 140px;
+ width: 80px;
}
table.rank .col-num {
@@ -489,9 +489,15 @@ table.rank > tbody > tr.user-row > td.share-col {
justify-content: flex-start;
}
-/* 请求列收窄（避免与其它 auto 列平分后过宽） */
+/* 请求列与 Token / 输入输出同为数值列，交给 auto 平分剩余空间，
+ 避免固定宽度截断大数（近30天请求数可达百万级千分位） */
table.rank .col-requests {
- width: 84px;
+ width: auto;
+}
+
+/* 时间列定宽：精准时间形如「MM-DD HH:MM」（10 字符），不需要很大 */
+table.rank .col-time {
+ width: 112px;
}
/* 时间列左对齐（覆盖主表 .right 的右对齐） */
diff --git a/src/types.ts b/src/types.ts
index e330f52..4c79637 100644
--- a/src/types.ts
+++ b/src/types.ts
@@ -6,6 +6,8 @@ export type SortKey =
| 'output_tokens'
| 'cache_tokens'
| 'actual_cost'
+ | 'first_active'
+ | 'last_active'
export interface DateRange {
start: string
@@ -81,10 +83,20 @@ export interface RankedUser extends UserBreakdownItem {
trendGranularity: TrendGranularity
trendLoaded: boolean
trendError: string | null
- /** 本周期内首次有用量（请求/Token）的时间点 key，无则为 null */
+ /** 本周期内首次有用量（请求/Token）的时间点 key（趋势图粒度，近似），无则为 null */
firstActive: string | null
- /** 本周期内末次有用量（请求/Token）的时间点 key，无则为 null */
+ /** 本周期内末次有用量（请求/Token）的时间点 key（趋势图粒度，近似），无则为 null */
lastActive: string | null
+ /** 本周期内首条请求日志的 created_at（ISO，秒级精准），接口不可用时为 null */
+ firstActiveExact: string | null
+ /** 本周期内末条请求日志的 created_at（ISO，秒级精准），接口不可用时为 null */
+ lastActiveExact: string | null
+}
+
+/** Sub2API /admin/usage 请求日志单条记录中本前端用到的字段 */
+export interface UsageLogRecord {
+ user_id: number
+ created_at: string
}
export interface AdminGroup {
|