Appearance
AIHub 网关用量与排行榜网页端需求文档（终端用户）
版本：v2.0 日期：2026-02-05 负责人：AIHub 产品
一、问题陈述
1.1 核心问题
AIHub 网关是 Beacon 的算力中台与支付基础设施，但终端用户缺少统一、可信的“加油站入口”与用量入口，导致：
- 成本不可见：无法快速判断词元消耗、信用点消耗和趋势变化，预算判断失真。
- 价值不可感：用户无法对比同类用户与高使用人群，使用目标与粘性不足。
- 行为不可控：缺少用量反馈与榜单信号，模型偏好、预算策略和代理授权难以优化。
- 身份不可感：链上钱包与 x402 通道缺少可视化入口，用户难以理解“为什么这是 Agent 加油站”。
1.2 目标与约束
- 目标是建立“加油站 + x402 通道 + 用量与排行榜”的单页入口，默认以终端用户视角呈现。
- 不提供直接 AI 使用入口，只展示加油、预算、通道、用量、趋势、榜单与账单提示。
- 核心口径以“词元消耗”为准，信用点消耗作为价值量化指标。
1.3 线上核对状态
当前无法使用浏览器子代理核对线上产品字段与逻辑，需由运营与设计在上线前补齐字段核对与口径校验。
二、用户场景
2.1 目标用户
- 终端用户：关心个人消耗、趋势、排名与预算。
- 开发者：只需看到密钥入口与接口用量入口占位。
- 运营/工程：只需看到供应商健康与成本趋势入口占位。
2.2 关键流程
- 进入“加油站”主页，默认时间范围为本周，默认榜单为词元消耗榜。
- 查看钱包身份与可用余额，确认加油入口与 Agent 预算授权状态。
- 查看 x402 支付通道流程与支持网络，理解链上结算路径。
- 查看用量概览卡片与趋势图，快速判断消耗走势与预算风险。
- 查看用量明细表，按来源筛选并支持模型搜索。
- 切换模型榜与用户榜，理解消耗结构与排名位置。
- 触发预算提醒时，引导充值或调整阈值。
三、成功指标
- 入口触达率：终端用户进入“用量与排行榜”页面占比 ≥ 35%。
- 榜单互动率：榜单切换与筛选操作率 ≥ 20%。
- 用量透明度：用户自报“看得懂自己的消耗”比例 ≥ 70%。
- 预算转化率：预算不足提示后的充值转化率 ≥ 8%。
四、验收条件
- 默认入口为终端用户视图，默认榜单为“词元消耗榜（本周）”。
- 用量概览至少包含：词元消耗、信用点消耗、调用次数、平均耗时。
- 用量趋势图支持本周/本月/本季度切换，口径与概览一致。
- 用量明细表必须包含：时间、来源、模型、输入词元、输出词元、缓存命中词元、信用点消耗、耗时。
- 明细表支持按来源筛选与模型搜索，筛选后数量实时更新。
- 模型榜至少展示：模型名称、提供方、词元消耗、环比变化、占比。
- 用户榜至少展示：用户匿名标识、词元消耗、信用点消耗、环比变化、用户标签。
- 用户榜需展示“我的名次与差距”，无名次时显示提示。
- 角色切换必须可见：终端用户、开发者、运营三类入口；非终端入口仅展示占位信息。
- 预算阈值低于设定值时展示明显风险提示，并提供充值入口。
- 加油站区域必须展示：钱包身份、可用余额、加油入口、Agent 预算授权入口。
- x402 通道区域必须展示：请求 → 402 → 签名 → 放行的流程示意，以及支持网络与结算资产。
- x402 通道必须支持分步控制交互，当前步骤可执行并产生状态变化。
五、边界条件
- 无用量数据：显示空状态与口径说明，不出现空白图表或零除错误。
- 并列排名：按词元消耗相同则并列显示，名次跳号。
- 模型下线：历史记录保留模型名称，榜单标记“已下线”。
- 缓存命中为 0：仍需展示输入与输出词元，缓存列显示 0。
- 跨时区：时间统一按用户本地时区展示。
- 异常突增：单日词元消耗异常上升需标记高亮并提示检查。
六、排除范围
- 直接 AI 对话、策略生成或模型试用入口。
- 复杂的模型路由配置与代理策略编辑。
- 实际支付链路与 x402 结算执行。
- 外部公开排行榜与第三方导流。