import type { BladeClient } from "../blade-client"; /** 全站访问统计快照。每个数字都来自真实请求,没有基数、系数或回填。 */ export interface SiteVisitsSummary { /** 统计日期,按北京时间切日(`YYYY-MM-DD`)。 */ date: string; /** 统计时区,固定为 `Asia/Shanghai`。 */ timezone: string; /** 当天出现过的匿名访客数:按天去重,不是实时在线人数。 */ today_uv: number; /** 当天的页面访问次数。 */ today_pv: number; /** 功能上线以来累计的页面访问次数。 */ total_pv: number; /** 快照生成时间(RFC3339 UTC)。并发响应可能倒序到达,用它丢弃旧快照。 */ as_of: string; } /** * 全站访问统计(内置 Web 的匿名计数)。 * * 这两个操作刻意走独立传输:不带 bearer、不触发 401 登录刷新,也不读登录 * Cookie——计数只依赖匿名访客 Cookie,因此登录态失效时统计依然可用。它们 * 只在同源的内置 Web 里使用,不是给第三方宿主页面用的。 */ export declare class SiteVisitsResource { private readonly client; constructor(client: BladeClient); /** 上报一次页面访问,返回当前快照;不承诺本次已计入或已落盘。 */ record(): Promise; /** 只读快照:不设置访客 Cookie,也不增加任何计数。 */ summary(): Promise; private request; }