交互设计 · 调用日志
管理面的模型请求日志查询页——GET /api/admin/logs 的界面落点。回答「这段时间谁、哪把 key、哪个模型、花了多少」；与 Key 管理、成员管理、全员总览构成筛选跳转闭环。只读事实，无改写。
| 项目 |
内容 |
| 状态 |
定稿（2026-10-08；2026-10-13 补模型筛选与汇总条、来源徽章支付弹窗） |
| 关联 |
《实现方案-日志模型筛选与汇总条》·《API契约-管理面》§6（过滤与 DTO）·《交互设计-总览与共性》（时间范围、数值呈现、状态模式）·《交互设计-key管理》《交互设计-成员管理》《交互设计-全员总览》（双向跳转）· usage_logs表字段设计.md |
| 数据 |
usage_logs 明细（分页；默认全类型，可筛 type / model_name）+ 当前筛选汇总（条数 + 消费用量） |
1. 页面定位
- 侧边栏项「调用日志」（排在「支付记录」之后：对象链之后的事实查询）
- 纯查询页：无登记、无启停、无删除；排查与核对入口
- 与成员视图的日志表列语义同构，但范围是全池且可筛错误行
2. 筛选区（自上而下一行或两行）
| 筛选 |
形态 |
对应 API |
| 时间范围 |
共性组件，默认最近 30 天 |
from / to（必填） |
| 成员 |
Select，含「未归属」 |
member_id |
| Key |
Select（依赖已选成员可收窄；或全量） |
api_key_id |
| 模型 |
Select，可搜可清空；选项 = 时间窗 + 主体筛选下去重 model_name |
model_name |
| 计费来源 |
全部 / 订阅 / 充值 / 未关联 |
billing_source |
| 订阅 ID |
数字（可空） |
subscription_id |
| 类型 |
全部 / 消费 / 错误 |
type（2 / 非 2） |
- 切换任一筛选 → 回第 1 页
- URL 查询同步：
from/to 可选省略（用默认区间）；member_id、api_key_id、model_name、billing_source、subscription_id、type、page——便于总览/管理页深链
2.5 汇总条（筛选条与表格之间）
低高度单行读数条（约 32–36px），只回答「这批条件加起来多少」：
| 段 |
内容 |
口径 |
| 请求次数 |
当前筛选条数；错误数 > 0 时附注「消费 X / 错误 Y」 |
跟全部筛选（含 type） |
| 消费用量 |
quota + $（QuotaText） |
恒 type = 2 + 其余筛选 |
- 类型筛「错误」时：请求次数 = 错误条数；消费用量仍为同期消费口径（标签保持「消费用量」，不叫「花费」）
- 查询中数字骨架/淡化，不闪上一轮；空结果汇总条保留、数字归零
- 成员端同构（见《交互设计-成员视图》§4）
3. 日志表（页面主体）
| 列 |
内容 |
备注 |
| 时间 |
到秒（北京时间） |
倒序由后端返回 |
| Key |
token_name |
可点 → Key 管理定位该 key |
| 归属 |
成员名 / 未归属 |
可点 → 成员管理；未归属不跳 |
| 模型 |
model_name |
|
| 类型 |
消费 / 错误徽章 |
错误行 type ≠ 2 |
| 来源 |
订阅 #N / 充值 / 未关联徽章 |
与成员视图同构 |
| 用量 |
quota + $ 双单位 |
错误行可显示 — 或 0 |
| Tokens |
prompt / completion |
|
| 操作 |
「详情」按钮 |
开详情弹窗 |
- 分页：默认 50，档位 20 / 50 / 100 / 200（无界列表）
- 来源徽章：
订阅 #N（蓝）可点 → 支付参数弹窗（期间 / 额度 / 金额 / 备注；无登记显示「该订阅无登记信息」）；底栏「在支付记录中查看」→ 支付记录页并带 subscription_id 深链。充值 / 未关联 为纯标识，不可点（与成员端同构）
- 「详情」弹窗（操作列，居中定高内滚，宽约 720）：时间 / Key·归属 / 模型·类型 / 用量 / Tokens / 耗时流式 / 来源 / 内容（错误详情），以及原始数据（落库行 JSON，内滚）；不承载支付参数（支付参数走来源徽章弹窗，核对/补录走支付记录页）
- 空态：「该时段内无调用日志」
- 窄屏：表格横向滚动（共性 §3.5）
4. 交互链路（与其它页）
| 从 |
到 |
携带 |
| 全员总览 · 按 key 行 / 成员行 |
本页 |
api_key_id 或 member_id + 当前时间范围 |
| Key 管理 · 行操作「查调用」 |
本页 |
api_key_id |
| 成员管理 · 行操作「查调用」 |
本页 |
member_id |
| 本页 · Key 列 |
Key 管理 |
key_id（定位/高亮） |
| 本页 · 归属列 |
成员管理 |
member_id（筛选） |
| 本页 · 来源徽章弹窗「在支付记录中查看」 |
支付记录 |
tab=subs + subscription_id |
| 健康带失败数（总览） |
仍去 Key 管理失败筛选 |
不变 |
5. 状态与边界
- 加载：表 loading；错误：顶部错误条 + 重试（共性 §3.4）
- 401 → 管理面登录（既有分流）
- 不展示
request_id / ip / channel 等表字段（契约 §6 暂不 API）；将来需要时列可扩
6. 与既有文档的衔接
- 《API契约-管理面》§6「界面落点待补」→ 本篇即落点；「跳 Key 管理详情」改为「跳本页带筛选 + Key 管理定位」并行
- 侧边栏六项 → 七项（《交互设计-总览与共性》§2 同步修订）
