diff --git a/readme.md b/readme.md index e9ef942..7e59afc 100755 --- a/readme.md +++ b/readme.md @@ -1136,7 +1136,7 @@ GET /apix/search?q=nginx Authorization: Bearer sk_<本网关签 `admin.css` + `upstreams.js` 渲染路径做无头浏览器断言(比例条成比例、条块数、悬停日期、无溢出)。 - 专章:`docs/llm/MULTI_ACCOUNT_ROUTING.md`(数据模型 / 路由 / 冷却数学 / shm 布局 / 负载统计)。 -- **2026-09-14(续17)「上次落盘」记录移入共享内存(`ipass-1.0.19`)** +- **2026-09-14(续17)「上次落盘」记录移入共享内存(`ipass-1.0.19`,已发版)** - **起因**:1.0.18 首次线上验证时发现 —— `error.log` 里明明有 10 次 `[stats] 落盘` (来自 `6#0` / `18#0` / `23#0` 多个 worker),`/api/admin/stats/persist` 却报 「上次落盘:(本进程还没落过)」。 @@ -1152,6 +1152,19 @@ GET /apix/search?q=nginx Authorization: Bearer sk_<本网关签 - 已知问题(另案):审计容量巡检的 `LAST_PURGE_AT` / `PURGING` 同样是每 worker 静态量, 启动时每个 worker 都会 `purge(true)`,理论上可能多删最旧审计目录;影响面仅「留档比上限更少」, 修它需要跨 worker 互斥原语。见 `docs/llm/STATS_PERSISTENCE.md` §十。 + - 发版:commit `1bc316e` → `ipass-1.0.19` + (digest `sha256:8f8a4444…e5ba`,job `20260914-201252-3d17`,7 步全过)。 + **线上复验**:`bash deploy/agent.sh stats-persist` 由「(本进程还没落过)」变为真实时刻, + 连查 5 次均一致;`stats-dump` 后时刻更新且任意 worker 立刻可见(读写两向跨 worker 一致)。 + 本次 1.0.18→1.0.19 也是一次**真实发版验证**:重启后 `restored_keys = 14/14`, + 发起版前的统计快照完成恢复,**没有清零**。 + - ⚠️ 两个发版副发现(既有问题,未修): + ① **宿主上的控制面 `ipass-agent.py` 仍是旧版** —— job 日志里还在走「备份到 `~/ipass-data-backup-*.tar.gz`」 + 与「旧镜像留 rollback 标签」,而这两步 1.0.17 已改掉(控制面跑在宿主、不在镜像里,需单独部署)。 + ② **容器 TZ = UTC**,状态页/审计的时间显示比北京慢 8 小时,且 `util::day_id`(`localtime_r`) + 让趋势日桶按 **UTC 日界**(北京 08:00 换日)—— 而冷却窗口用 `RESET_DAY_OFFSET_SEC=28800` + 按北京日。两处口径不一致。要改必须**同时**处理:设 `TZ=Asia/Shanghai` 就必须把 + `RESET_DAY_OFFSET_SEC` 归 0,否则双重偏移(改一处必改另一处)。 - **2026-09-14(续16)统计落盘/恢复 + 审计口径收口(`ipass-1.0.18`,已发版)** - **起因**:发版后管理台「用量」与「趋势」从 0 重新长起来。根因是这两类数据 @@ -1187,6 +1200,30 @@ GET /apix/search?q=nginx Authorization: Bearer sk_<本网关签 - 新文档:`docs/llm/STATS_PERSISTENCE.md`(含 runbook)、`docs/llm/AUDIT_LOG.md` (两者此前被代码注释与 `Dockerfile` 引用但文件并不存在)。 +- **2026-09-14(续15.5)控制面备份路径 + 审计目录权限 + 去掉本地 rollback 标签(`ipass-1.0.17`,commit `6b8d694`)** + - **备份路径**:`~/ipass-data-backup-<时间>.tar.gz` → `~/ipass/backup/ipass-data-<时间>.tar.gz` + (`ls ~` 不再被一堆备份文件名刷屏)。 + - **审计目录权限**:宿主侧首建 `audit/` 后显式 `chmod 777`。agent 以 root 跑,`os.makedirs` + 建的目录属主是 root,而容器内 worker 是 `nobody` → 写不动,日志刷 + `[audit] 建日期目录失败 Permission denied`、**审计整个废掉**(实测踩过)。 + 用 777 而非按 uid chown:宿主 uid 与容器内 `nobody(65534)` 不一定一致, + 且 audit 是 append-only 元数据、无防篡改语义。 + - **去掉「旧镜像在本地打 rollback tag」**:镜像动辄 100 MB+,本地磁盘越积越多; + 阿里云私仓永远保留所有 tag,回滚 `docker pull` 即可。更新从 7 步变 6 步, + `op_rollback` 不再自动选本地 rollback-tag,**必须显式传 tag**(否则报错指引去阿里云拉)。 + - ⚠️ 控制面 `deploy/ipass-agent.py` **跑在宿主、不在镜像里**,改动需单独部署到 .11 —— + 否则线上仍是旧逻辑(1.0.19 发版的 job 日志里就是这么暴露的,见下一条)。 + +- **2026-09-14(续15.4)`/api/v1/me` = 能力目录扩展点(`ipass-1.0.16`,commit `dfbfe5c`)** + - **拍板**:给同事/文档/SDK 展示能力(域名 / LLM 上游 / API 代理)时**往 `CoreExt::decorate_me` + 里塞,不要另开 `/api/v1/catalog` 这类聚合端点**(不破坏既有 3 个 v1 端点与老客户端脚本; + 一把 key 一个请求拿全身份 + 域名 + 上游 + API 代理 + 用量 + 策略)。 + - `decorate_me` 签名改为 `(&User, port, &mut Value)`:传 `&User` 让装饰**零额外 shm 查询** + 就完成权限收敛(`upstreams` 按 `allowed_models` 过滤);`port` 从 Host 头取(**不写死**, + 88 要带端口、443 反代不能带)。 + - 仅文档同步,不动代码:`CLAUDE.md`(核心机制补第 6 条)+ `docs/plugin/PLUGIN_ARCHITECTURE.md` + (§2.3 子段、§6 纪律第 7 条、§7 已拍板)。 + - **2026-09-14(续15)auth 规范化 + 排障子命令(`ipass-1.0.15`)** - **根因**:表单 placeholder 写 `sk-...`,用户照着填了**裸 key**(无 `Bearer `), 转发时原样发 → 上游回 1004。`agent.sh upstreams` 一打就看出来:deepseek 掩码是