Appearance
AIHub 网关 Web 端需求文档（终端用户）
版本: v1.0 日期: 2026-02-05 负责人: AIHub 产品
一、问题陈述
1.1 核心问题
AIHub 网关是 Beacon 的算力中台与支付基础设施，但终端用户侧缺少一个清晰、可控、可对比的用量入口，导致以下直接损失：
- 成本不可见：用户无法快速判断自己的算力消耗、信用点消耗和趋势变化，容易误判预算。
- 价值不可感：用户看不到自己与“高使用人群”的差距，无法形成使用目标与粘性。
- 配置不可控：用户无法基于用量与榜单反馈调整模型偏好、预算策略与代理授权。
1.2 战略定位约束
- 网关定位为Beacon 的算力中台，对内成本中心、对外可选开放能力。
- 终端用户入口不做直接 AI 使用，仅做用量、榜单、账单、预算的管理与对比。
- 关键指标以“词元消耗”为主（文本计量单位）。
1.3 线上核对说明
当前线上产品结构需以实际界面为准。本 PRD 基于两份战略文档与现有竞品表现进行定义，最终上线前必须由运营与设计补齐线上字段核对。
二、用户场景与界面流程
2.1 核心用户
- 终端用户（主入口）：关心自己的算力消耗、信用点消耗、趋势和排名。
- 开发者（次入口）：关心密钥、接口使用与报表导出。
- 运营/工程（次入口）：关心供应商路由、成本与异常告警。
2.2 终端用户关键流程
进入“用量与排行榜”首页
- 默认时间范围：本周
- 默认榜单：词元消耗榜
- 同屏展示：用量概览卡片 + 用量趋势 + 模型榜 + 用户榜
查看用量明细
- 按来源筛选（网页端、代理、接口）
- 展示字段：时间、来源、模型、词元消耗（输入/输出/缓存）、信用点消耗、耗时
查看榜单与自我对比
- 模型榜：比较模型热度与消耗规模
- 用户榜：查看自身名次、差距与趋势
跳转预算与充值（弱引导）
- 顶部展示余额、预算剩余
- 明确“预算不足”风险提示
2.3 次要入口（不做深功能）
- 开发者入口：仅展示密钥入口与接口用量入口
- 运营入口：仅展示供应商健康与成本趋势入口
三、成功指标
- 入口触达率：终端用户进入“用量与排行榜”页面占比 ≥ 35%
- 榜单互动率：模型榜/用户榜切换与筛选操作率 ≥ 20%
- 用量透明度：用户自报“看得懂自己消耗”的比例 ≥ 70%
- 充值转化：预算不足提示触发后的充值转化率 ≥ 8%
四、验收条件
- 默认入口为终端用户视图，且默认榜单为“词元消耗榜（本周）”。
- 用量概览至少包含：词元消耗、信用点消耗、调用次数、平均耗时。
- 用量趋势图支持本周/本月切换，趋势数据与概览数值口径一致。
- 用量明细表必须包含以下字段：时间、来源、模型、输入词元、输出词元、缓存命中词元、信用点消耗、耗时。
- 模型榜必须展示：模型名称、提供方、词元消耗、环比变化。
- 用户榜必须展示：用户匿名标识、词元消耗、信用点消耗、环比变化。
- 角色切换必须可见：终端用户、开发者、运营三类入口；非终端入口只展示最小信息占位。
- 预算提醒在余额低于设定阈值时触发明显提示。
五、边界条件
- 无用量数据：显示空状态与数据口径说明，不允许出现零除或空白图表。
- 模型下线：历史用量仍显示模型名称，榜单标记“下线”。
- 缓存命中为 0：输入/输出仍需展示，缓存列显示 0。
- 跨时区：时间统一按用户本地时区展示。
- 大额异常：单日词元消耗突增时需要显著标记。
六、排除范围
- 直接 AI 对话与策略生成入口
- 复杂的代理配置与模型路由策略编辑
- 真实支付链路与 x402 结算细节
- 第三方市场公开榜单或外部导流
文档版本: v1.0 | 最后更新: 2026-02-05