# CHANGELOG ## 2026-10-23 · 调用日志列表加「内容」列(2.9.0 → 2.9.1) 老板:「列表的模型后面加一个字段,显示请求体的 content 内容」。 - 新增 `prompt_preview()`:从请求体 JSON 里抽出**用户实际说的话**(不是整包 JSON)—— 兼容 OpenAI chat / responses(`messages[-1].content`、`input` 字符串或数组)与 Anthropic messages(`content` 字符串或多段 text parts);非 JSON 时退回原文。 - `GET /logs/calls` 现在每行都返回 `prompt_text`(单行、压空白、截 240 字), **列表不再吐原文 `prompt`**(几千字整包会拖慢列表);`content=1` 时仍给完整原文。 - `GET /logs/calls/{id}` 也带 `prompt_text`,详情弹窗第一屏就能看到用户说了什么。 - 前端:模型列后面新增「内容」列(超长省略 + 悬停看全文);详情弹窗增加「内容」块。 ## 2026-10-23 · 指标改由数据库提供(重启不再清零)+ 月度用量导出(2.8.0 → 2.9.0) 老板:「全做」—— 指上一条列出的两项:① Dashboard 统计改从数据库读;② 按账号月度用量导出。 ### ① 指标数据源:内存 → SQLite - 新增 `_usage_snapshot()`:**调用数 / 供应商分布 / token / 耗时(含 p50/p95)** 全部改为从 `api_calls` 聚合(保留期内 90 天),**进程重启不再清零**;**运行时长 / 在途请求 / 熔断状态** 仍是进程内实时值。库不可用时自动回落到内存态(行为与之前一致)。 - 影响端点:`GET /metrics`、`GET /metrics/prometheus`、`GET /health` 的 `models` 字段。 - **口径变化(重要)**:Dashboard / 指标页看到的数字从「本次进程启动以来」变成「最近 90 天累计」, 所以数字会一次变大。要"本次启动以来"的口径需要另加参数,目前没有。 - 成员视角不变:仍只聚合自己的账号(`account` 过滤)。 ### ② token 也落库了 此前 `api_calls` 没存 token(方案里列了但首版没实现),导致指标切库后 token 只能是 0。 本轮补齐: - 表加 4 列 `tok_prompt / tok_completion / tok_cached / tok_reasoning`,**老库自动 ALTER 迁移**。 - 用 **rid contextvar + token 侧信道** 把两处接起来:`_record_usage_metrics()` 只知道 token、 不知道 rid;中间件只知道 rid、不知道 token。现在中间件 `RID.set(rid)`, 记账时 `calllog.note_tokens(RID.get(), …)`,落库时按 rid 取走并清空。 - 直传流式(`_UsageScanner`)那条路径也补了。 ### ③ 月度用量导出 - `GET /logs/usage/monthly?month=YYYY-MM`:按账号聚合调用数 / 成功 / 失败 / 平均耗时 / 涉及模型数(仅管理员)。 - `GET /logs/usage/monthly/export?month=YYYY-MM`:CSV(UTF-8 BOM,Excel 直接打开,含失败率)。 - 前端:调用日志页加「月份选择 + 月度用量」按钮 → 弹窗显示按账号的表格 + 导出 CSV。 ### ④ 顺手修 - 模型统计排除「无模型行」(匿名 401 的早失败补记)—— 否则 Dashboard 上会出现一个 `?` 模型。 ## 2026-10-23 · 调用日志落地(SQLite / 90 天 / 仅管理员可查全部)(2.7.3 → 2.8.0) 老板:「ai网关项目,现在我想把调用日志落地,有什么方案」→ 方案确认后:「1,要记 / 2,90天 / 3,要前端查询界面,然后这个查询界面集成在日志菜单里,只有管理员有这个权限查看全部人的日志」。 ### 后端:`app/calllog.py`(SQLite,零新依赖) - 表 `api_calls` **21 列**:时间、rid、账号、Key 前 8 位、类型、方法、路径、模型、实际模型、 供应商、是否流式、成功、状态码、耗时、IP、UA、**提示词**、**回复**、网关版本。 - **异步批量写**:`AccessLog.add()` → 内存队列 → 后台 task 每 1 秒或攒满 200 条 `executemany` 提交; 队列满(默认 1 万条)即丢弃并计数,**绝不反压请求**;进程退出前 flush。 - **双向握手**(本轮最关键的设计):一条日志的两半来自不同位置 —— 访问日志条目(`AccessLog.add`) 和响应元数据(中间件收尾,含状态码/耗时/IP/UA)。两半先后顺序不确定: 非流式是「条目先、元数据后」,**流式是「元数据先、条目后」**(SSE 真正发完才 add)。 所以两边都先暂存,谁后到谁拼成一行落库。 - **早失败也记**:未知模型 400、鉴权 401/403、限流 429 这类请求走不到 `AccessLog.add`, 中间件用请求体补一条(含模型名与提示词),否则日志里只剩一行"400、无模型",排查时没有信息量。 - **失败也记 Key 前缀**:401 时 `request.state.credential` 是空的,但恰恰这时最需要知道 客户端拿的是哪把 Key —— 记前 8 位即可对账(2026-10-23 的真实工单就是靠这个抓到 「客户端在发 `wjd-5Da_…`,而库里他的有效 Key 是 `wjd-15zs…`」)。 - 保留 **90 天**:启动时清理 + 每 6 小时清理一次;`CALLLOG_RETENTION_DAYS` 可调。 - 隐私:**API Key 只存前 8 位**;提示词/回复按 `CALLLOG_CONTENT_MAX`(默认 8000 字)截断; 库文件权限 600。IP 存完整地址(仅管理员可见,便于与 WAF/防火墙日志对账)。 ### 接口(新增 4 个,全部**仅管理员**) | 端点 | 用途 | |---|---| | `GET /logs/calls` | 分页 + 筛选(时间段/账号/模型/成功失败/状态码/类型/关键词),`content=1` 时带内容 | | `GET /logs/calls/stats` | 按天、按模型、按账号、按状态码聚合 + 库大小/写入/丢弃计数 | | `GET /logs/calls/{id}` | 单条详情(含完整提示词与回复)| | `GET /logs/calls/export` | CSV 导出(最多 5 万条,UTF-8 BOM,Excel 直接打开)| 成员访问以上端点一律 **403**(`_require_admin_logs`)。 ### 前端:集成在「日志」菜单 - 日志页顶部新增两个页签:**实时**(原有内存环形缓冲)/ **调用日志**(仅管理员可见)。 - 新组件 `CallLogs.vue`:日期范围、账号、模型、仅成功/仅失败、关键词(内容/rid/IP/UA)筛选; 列表显示时间/账号/模型/耗时/状态/流式/UA;点击行弹出详情看**完整提示词与回复**;CSV 导出。 ### 2026-10-23 补丁:翻译键位置 + 内容上限 - **修**:`calllogs.*` 的 i18n 段首次插入时被放进了 `upload` 段内部(嵌套层级错), 导致新面板全部显示原始键名(`calllogs.title` 之类)。已移为**顶层键**(`logs` 之后), 并复核 zh/en 两份文件的顶层键数量与层级一致。 - **提上限**:请求体摘要 `raw[:2000]` → `8000`,回复文本 `_logsafe(..., 2000)` → `8000`(5 处)。 实测 6000 字的提示词已能完整落库(此前会被截在 2000)。 ### 现状说明 - `/metrics` 仍是内存态(重启清零),本次没动它;**调用日志是持久化的**, 需要历史统计时可以基于 `api_calls` 做(二期可把 Dashboard 数据源切过来)。 ## 2026-10-22 · 成员只看自己的用量 + AI 接口不再被 WAF 误杀(2.7.2 → 2.7.3) 老板:「改,替换重启,更新文档,推送 gitea」;随后补充「成员在首页是要看到自己调用的次数统计」。 起因是一个真实工单:成员 `chenghongchang` 反馈「拿 apikey 请求 403」。排查结论是**两层问题**: ### 1. `/health` 把全站用量给了成员(安全) `/health` 只要带**任意有效 Bearer**(含 member 的 API Key)就返回 **全局 `tokens` 总量、各模型的全局调用量/失败率(`models`)、供应商熔断状态(`circuit` / `media_circuit`)**。 - 现在按角色分流:非 admin 只返回**运行态** —— `status` / `version` / `uptime_seconds` / `in_flight` / `in_flight_peak` / `providers`(仅 `name`、`api_key_set`、`models` 数量)。 - **全员** token 总量、模型级全局统计、熔断状态**仅管理员**可见。 - 前端没有用到被收敛的字段(Dashboard 只用 `version` / `uptime_seconds` / `in_flight` / `in_flight_peak` / `providers`), 所以**前端零改动、无需重新构建**。 ### 2. `/metrics` 明确保留按账号聚合(老板口径) - 成员首页的「我今天调了多少次」来自 `/metrics`,因此**不收成仅管理员**; 按账号聚合的逻辑保持原样(`_metrics.snapshot(request.state.account)`)。 - 实测:成员连调 2 次后自己看到 `deepseek-v4.1-flash: ok=2`,管理员看到全局 `ok=3`。 ### 3. 运维侧:1Panel WAF 放行 `/v1/` 成员那台 403 的真正来源是 **1Panel WAF 检查请求体**:AI 编程客户端(WorkBuddy 等) 发出的提示词里带 `