From adbd2dee616d7e54d560150621158b03438b7790 Mon Sep 17 00:00:00 2001 From: admin Date: Sat, 12 Sep 2026 18:02:34 +0800 Subject: [PATCH] =?UTF-8?q?docs(readme):=20=C2=A712.5=20=E6=8E=A7=E5=88=B6?= =?UTF-8?q?=E9=9D=A2=E8=87=AA=E6=9B=B4=E6=96=B0=E8=84=9A=E6=9C=AC=20/=20?= =?UTF-8?q?=C2=A712.6=20tag=20=E8=A1=A8=E8=A1=A5=20ipass-1.0.7=20/=20?= =?UTF-8?q?=C2=A716=20=E7=BB=AD5=20=E5=8F=98=E6=9B=B4=E6=97=A5=E5=BF=97?= MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit --- readme.md | 16 ++++++++++++++++ 1 file changed, 16 insertions(+) diff --git a/readme.md b/readme.md index 2a45660..88ed782 100755 --- a/readme.md +++ b/readme.md @@ -721,6 +721,7 @@ DRY_RUN=1 bash deploy/release.sh 1.0.3 # 只构建不推送 | `ipass-1.0.4` | **LLM 出站请求头改为「默认不放行」**(`proxy_pass_request_headers off` + 凭据头抹空 + 显式放行清单),堵住网关自己的 Key 经 `x-api-key` 泄漏给上游厂商。详见 `docs/llm/UPSTREAM_PROTOCOL_AND_AUTH.md`。 | | `ipass-1.0.5` | **上游健康自动标记 + 管理台连通性测试 + 可复制 API 地址**。健康数据来自真实流量(log 阶段写 `uh:`,4xx=活、5xx/502/504=失效、下次成功自愈);「测试」按钮内部重定向复用 LLM 转发链路真探测;上游列表 OpenAI/Anthropic 复制按钮与 `anthropic_base_url`;统计挪进独立「数据总览」tab。 | | `ipass-1.0.6` | **子域名规则固化为 `i`+8 位随机数+`dm`**(规则真源在 `config.rs`,经 `subdomain_rule` 下发给面板;API 不传 `subdomain` 即自动生成、撞车重试)+ **域名列表点完整域名即复制**(带端口,跟随调用方)+ **管理台布局改为自适应**(去掉 1180px 居中锁;表单另限宽 1100px)。digest `96c0e952…`,commit `12f20dd`。 | +| `ipass-1.0.7` | **LLM token 级计量 + 对话审计日志**:body filter 旁路(FFI 全局符号注册,单 .so 无需额外 C 模块)解析 SSE 尾部 `usage` → `utt:`/`utms:` 键,用量接口增加 tokens 维度;log 阶段请求体归档到 `audit/`(data 兄弟目录,**10 GiB 容量阈值**触发式清理);LLM location 去掉 `proxy_request_buffering off`(与 body 落盘互斥,SSE 由 `proxy_buffering off` 保障)。控制面更新后自动挂审计卷。digest `5cd68ec4…`,commit `401f9be`。**注意:需先更新控制面(§12.5 自更新脚本)再 update,否则新容器缺审计挂载。** | --- @@ -949,6 +950,21 @@ curl -s -H "X-API-Key: $KEY" "$API/api/v1/usage" ## 16. 变更记录 +- **2026-09-12(续5)LLM token 计量 + 对话审计日志(`ipass-1.0.7`)** + - **关键发现**:`ngx_http_top_body_filter` 是 extern 全局符号(`ngx_http.c:74`),动态模块可直接 + FFI 引用注册 body filter —— 推翻"必须写额外 C 模块"的调研结论,token 计量收敛进现有单 .so。 + - **token 计量**(`llm_usage.rs`):body filter 透传 SSE 的同时旁路累积尾部 chunk,`last_buf` 时 + 解析 `usage`(OpenAI `stream_options.include_usage` 尾块 / Anthropic `message_delta`), + log 阶段经 `stats::add_tokens` 写 `utt:`/`utms:` 键;用量接口(admin/自查)增加 tokens 维度。 + - **对话审计**(`llm_audit.rs`):log 阶段把请求体临时文件复制进 `audit/`(data 兄弟目录)+ + `meta.jsonl`(user/slot/status/token);**10 GiB 容量阈值**触发式清理,按日期目录从最旧删起。 + - **踩坑**:SSE 三件套里的 `proxy_request_buffering off` 管的是**请求体**方向,与 SSE 无关, + 且与 `client_body_in_file_only` 互斥(nginx `ngx_http_request_body.c:1334` 直接短路不落盘) + —— LLM location 删掉它后审计才恢复,SSE 流式不受影响(由 `proxy_buffering off` 保障)。 + - **发版顺序**:控制面挂载逻辑在宿主 `ipass-agent.py` 里 → **先在 .11 跑自更新脚本 + (§12.5 `update-agent-face.sh`)再 `agent.sh update ipass-1.0.7`**,否则新容器缺审计挂载。 + - 测试 207 全绿(LLM 117 + 网关 90;靶机 usage 块用 `"usage_probe"` 标记门控不破坏 CHUNKS=3 契约)。 + - 落地:`ipass-1.0.7`(digest `5cd68ec4…`,commit `401f9be`)。 - **2026-09-12(续4)管理台布局自适应 + 控制面收敛到 `deploy/agent.sh`(`ipass-1.0.6`)** - **布局自适应**:`.wrap` 去掉 `max-width:1180px` 居中锁与 `margin:0 auto`——大屏上原版面只占 中间一小块、右侧大片留白且表格被压窄。改为铺满视口;配套给 `.grid-form` 限宽 `1100px`,