运维与日志
适用角色：管理员
前置条件：已登录管理员账号
本篇覆盖三块：使用情况概览（花多少）、系统日志（谁做了什么）、扩展设置（挂子应用）。
一、使用情况概览
1.1 核心指标
| 指标 | 口径 |
|---|---|
| Token 总数 | 平台累计消耗的 Token 数 |
| 对话总数 | 累计会话数量 |
| 用户总数 | 平台注册用户数 |
1.2 用量分布
| 区域 | 说明 |
|---|---|
| 今日用量 TOP3 模型 | 按 Token 消耗排序的前三个模型 |
| 每月用量趋势（TOP3 模型） | 按月展示趋势，Y 轴为 Token 数 |
| 用户使用情况列表 | 分页展示每名用户的分组、Token 总数、对话总数 |
提示 · 统计维度是 Token 数而非请求数。一次长上下文对话的 Token 数会显著高于短对话，看排行时要结合对话总数一起看。
1.3 用量异常排查
| 现象 | 排查方向 |
|---|---|
| 某用户 Token 数异常高 | 看该用户的会话列表，是否有失控的长对话或循环任务 |
| 某模型 Token 占比过高 | 确认默认模型是否设成了高价位模型 |
| 某月用量突增 | 对照是否有新用户批量接入 |
二、系统日志
平台对每一次关键操作完整留痕。
| 记录字段 | 说明 |
|---|---|
| 用户 | 操作者 |
| 用户分组 | 操作者当时的分组 |
| IP | 客户端地址 |
| 地域 | 解析的地区 |
| 分类 | 操作类别 |
| 详情 | JSON 结构化的操作内容 |
| 状态 | 成功／失败 |
| 错误信息 | 失败时的原因 |
| 时间 | 精确到秒 |
2.1 多维筛选
可按以下维度组合筛选：
| 维度 | 说明 |
|---|---|
| 用户 | 按操作者 |
| 分类 | 按操作类别 |
| 状态 | 成功／失败 |
| IP | 按客户端地址 |
| 地域 | 按地区 |
| 时间范围 | 按起止时间 |
提示 · 排查问题时，先按「状态 = 失败」筛一遍，再按时间和用户收窄，通常一两步就能定位。
三、扩展设置
扩展是以 iframe 嵌入平台的第三方子应用。注册后会在左侧导航条中部显示一个图标。
扩展列表的每一行对应一个已注册的扩展：
| 字段 | 说明 |
|---|---|
| 图标 | 导航条上显示的图标 |
| 名称 | 扩展标识 |
| 显示标题 | 导航条上显示的名称与 hover 提示 |
| 位置 | 图标在导航条中的分组位置 |
| URL | 子应用的完整地址，必须是绝对地址 |
| 排序 | 导航条上的显示顺序，数值小的靠前 |
| 状态 | 启用／停用 |
3.1 新增扩展
| 字段 | 必填 | 说明 |
|---|---|---|
| 名称 | ✅ | 唯一标识，建议用英文小写 |
| 图标 | ✅ | 图标标识 |
| 标题 | ✅ | 显示名称 |
| URL | ✅ | 子应用地址，必须是绝对地址 |
注意 · URL 必须是绝对地址（带
http://或https://），否则扩展页会空白。
3.2 启用、停用、编辑与删除
| 操作 | 效果 |
|---|---|
| 启用 | 导航条出现图标，全员可见 |
| 停用 | 图标消失，已打开的页面不再可用 |
| 编辑 | 修改名称、图标、标题、URL 后保存生效 |
| 删除 | 从列表移除。不会删除扩展容器本身，只是取消注册 |
提示 · 扩展是部署级配置，不同环境注册的应用各不相同，具体清单由部署方维护。用户侧的使用方法见扩展应用。
四、常见问题
| 现象 | 原因 | 处理 |
|---|---|---|
| 用量概览没数据 | 尚未产生对话 | 正常使用后才有 |
| 某用户排行异常高 | 长对话或循环任务 | 结合对话数一起看 |
| 日志查不到某次操作 | 该操作未纳入审计范围 | 参考「分类」列表 |
| 扩展页空白 | URL 不是绝对地址，或子应用服务不可达 | 编辑扩展 |
| 导航条看不到扩展 | 未启用 | 启用扩展 |
| 扩展图标不刷新 | 前端缓存 | 刷新页面；扩展列表变更会主动触发重载 |
五、相关页面
| 页面 | 内容 |
|---|---|
| 扩展应用 | 用户侧使用内嵌的第三方子应用 |
| 用户与权限 | 分组与用户操作审计 |