Commit Graph
86 Commits
Author SHA1 Message Date
admin fa3ca180a4 docs(readme): §12.6 补发版自动回滚与 live_check 验证口径 2026-09-17 08:43:41 +08:00
admin 42a316b964 docs(tests): README 同步目录驱动 + 三态口径 + 退出码语义 2026-09-17 08:42:59 +08:00
admin 762d308745 test+deploy: 探针改目录驱动 + 三态判定 + 发版失败自动回滚(镜像+数据)
两件事:

1) 验证脚本统一从 /api/v1/me 拉能力目录(新增 tests/me_catalog.py 共享模块)。
   之前 slot×模型、apix 条目写死在脚本里——配置是管理台动态的,改配置后探针
   要么漏验新上游、要么拿旧模型名误报。现在 test_models 按 upstreams×models
   全展开(both 双格式并发),apix_check 按目录逐条探;拉不到目录退出码 2
   (验证失效 ≠ 上游没问题,不许假绿)。
   三态口径:❌ 网关侧故障(错误体归属 + HTTP 码 + error.code 值三重判据——
   智谱 401 体也是 {"error":{code,message}} 形状,光看形态会把欠费误判成发版
   故障);⚠️ 上游/厂商侧(欠费 402、不可达 502/504、WAF、200 软错误)
   **如实汇总反馈但不染红发版**;网关 429 限流按 GW_WARN 处理。
   live_check.sh 退出码语义固定:0 过 / 1 网关侧故障 / 2 验证不可用。
   分类器 15 个边界场景离线单测全对(撞形状/码集合/软错误/不误伤正常 200)。

2) agent.sh release 改 4/4 步:验证失败不再停在原地——
   抓 PRE_IMG + update job 的备份路径 → live_check → rc=1 时自动
   POST /rollback {tag, restore_backup} 回滚镜像并恢复 data/audit,回滚后
   再跑 verify 自检;rc=2(验证不可用)**不回滚**(盲回滚比带病观察危险)。
   ipass-agent 1.0.2:rollback 本地无镜像自动 pull(自动路径不许卡「先手动拉」);
   新增 restore_data——先 stop 容器(防周期落盘把污染写回)、备份 tar 解包顶替
   data/audit、现目录改名 .broken-<ts> 留证、只认 ~/ipass/backup/ 下的 tar。
   restore_data 本地单测过(恢复/留证/staging 清理/越界拒绝)。
   release 开头加控制面版本闸门:<1.0.2 会静默忽略 restore_backup → 中止
   (IPASS_FORCE_RELEASE=1 可跳过),⚠️ 线上控制面还是 1.0.1,发版前先上 .11
   跑 §12.5 自更新。
   附带修 bash 老坑:`$VAR` 紧跟全角字符被吞进变量名(unbound variable,
   live_check A 路径实测炸出),统一 ${VAR}。

线上实测:live_check 三步全绿(LLM 10/10 目录全展开 + apix 3/3 + 验收)。
只动 tests/deploy,不进镜像;ipass-agent 属控制面(跑宿主),需单独自更新。
2026-09-17 08:41:48 +08:00
admin cde14e1f1b test: apix 纳入上线后验证(tests/apix_check.py + live_check.sh 三步)
apix 发版后最容易静默失效:location 没挂 / shm 没装载都不报错,只是 404,
而回归打假上游、agent.sh verify 又不发真实请求 —— 之前完全没有覆盖。

新增 tests/apix_check.py:
- 从 /api/v1/me(mdm host + X-API-Key 头)拉能力目录,逐个探 enabled 条目;
- vendor → GET /apix/<slug>?<p>=<占位>;passthrough → GET /apixp/<slug>/health;
- **无效 Key 预检**:证明 location 挂着 + 鉴权生效(与上游是否抽风无关);
- 判定按错误体归属:网关体({"error":{...}} / {"code":..,"msg":..})→ 失败;
  上游体({"detail":...} / WAF 页)→ 只告警,不染红发版验证。

实测踩到的三个坑(已写进 README):
1. urllib 默认 UA `Python-urllib/3.x` 被供应商边缘 Cloudflare 拦(403 error code:
   1010),看着像 IP 被封,换 curl UA 立刻 200;
2. passthrough tail 是 /apixp/<slug> 之后的全部(上游 /health → /apixp/ocr/health),
   usage_hint 里的 /<tail> 要换成 slug,照抄是上游 404;
3. vendor 参数要放白名单值:accel 给 example.com 是 400 target host not allowed
   (链路通,属告警),换 raw.githubusercontent 小文件即 200。

live_check.sh 改为三步(LLM 真实流量 / apix 探针 / 环境验收),加 --apix-only。
线上实测:LLM 8/8 + apix 3/3 + 验收全绿。
2026-09-17 07:56:25 +08:00
admin 81f83f6f50 test: 加 tests/live_check.sh —— 上线后验证(真实流量 + 环境验收)
回归(tests/run.sh)打的是假上游,deploy/agent.sh verify 又只验管理台不发真实
LLM 请求,两半都跑不到「新版在线上真能干活」。新脚本把两者合成一条命令:

- 真实流量:test_models.py 4 slot × OpenAI/Anthropic + /v1/models;
- 环境验收:deploy/agent.sh verify(登录 / 页面标记 / subdomain_rule / 趋势 / 账号 load)。
- --models-only / --verify-only 可只跑一半;key 文件默认 ~/ssw.txt。

顺带:
- test_models.py 补退出码(原来失败也退 0,包装脚本判不出失败);
- key 文件解析支持 `sk=<key>` 与 # 注释行(取整行会拿到 sk=sk_xxx → 全量 401);
- tests/README.md 断言数同步到 108 + 262 = 370,补两个脚本说明。

实测:8/8 通过 + 验收全绿;错 key / 缺 key 文件均退出 1。
2026-09-17 07:37:08 +08:00
admin 0a9047840d feat(llm): 上游账号冷却改指数退避 + 真实请求探测闭环 (1.0.44)
天锚定重置边界计算(resets)删掉:锚点算错过两次(1.0.14 / 1.0.24),
线上表现为「厂商 15:00 已重置、网关锁到 18:00」。resets 只存不路由。

新口径:uac: = <backoff>:<next_probe>:<hard_cap>
- 到期放一个「无绑定/绑定失效」的真实请求过去探测,2xx → clear_cool 回队;
- 仍耗尽 → 退避翻倍(首轮 ipass_probe_min,默认 60s,30min 硬顶无条件回队自愈);
- 绑定流量永不被劫持当探测(保 prompt 缓存亲和)。
- pick_account 必须纯决策:四个 $llm_* 变量各求值一次,副作用只在 log 阶段记一次。

fix: 探测窗口判定改严格小于 —— 秒级时钟下 >= 会让「标记于 45.95s、next_probe=46」
的账号在 46.05s 即被当探测目标,1s 退避实际只等 0.05s,冷却形同虚设(回归暴露)。

回归 370 条全绿(网关 108 + LLM 262,新增「探测恢复闭环」剧本)。
2026-09-17 07:19:35 +08:00
admin 515dcb3134 fix(llm): 探测通道注入最小 dummy 体,避开智谱 model=null NPE 误报 (1.0.43)
管理台「测试」按钮发的是空 body POST,智谱 4.x SDK 在 model 缺失时
NPE 兜底成 200 + body.error.code=500,被误读成「模型不存在」。
/_upstream_test location 加 proxy_set_body 注入最小探测体
(model=test/max_tokens=1/messages=hi),让上游真做一次最小生成,
费用与可观测性可控。tests 同步。

另收 tests/test_models.py:网关多模型 × OpenAI/Anthropic 双协议验证脚本。
2026-09-16 21:01:27 +08:00
admin 2c66197d2c fix(llm): upstream-test 改裸 /chat/completions,避开 join_target 剥 /v1 的副作用 (1.0.42)
1.0.41 join_target 在 base 自带路径段时剥掉客户端的 /v1,upstream-test
走 internal_redirect 固定拼 /v1/chat/completions,结果被剥成
…/v4/,智谱 SDK 抛 NPE 报 500 'model=null',管理台点测试时像
'模型不存在'。改为裸 /chat/completions 走 join_target,结果是
…/v4/chat/completions(智谱真端点),正常 200。
2026-09-16 18:51:03 +08:00
admin 9e0a1e53b9 fix(llm): join_target 剥 /v1 仅 OpenAI 协议生效,Anthropic 保留 /v1 (1.0.42)
1.0.41 把 Anthropic 协议的 /v1/messages 也剥了,漏版本段必 404。
修正为:join_target 接 anthropic 参数,仅 OpenAI + base 自带路径段时
剥客户端冗余 /v1;Anthropic 协议始终原样拼(版本段必保留)。
同步 e2e §4 期望(新设计:base 自带路径 → 客户端 /v1 必须被剥)。
2026-09-16 18:36:43 +08:00
admin 391ccfbd1a chore(deploy): agent.sh 加 upstream-save 子命令 + 修 upstream-test 抓真实状态码
- upstream-save <slot> <base> <base_anthropic>:直连网关改双协议地址,
  auth/models/enabled 保持原值(凭据只从 .env 读,走统一白名单入口)
- upstream-test 改用 -w '%{http_code}' 抓 internal_redirect 后的上游真实状态码
  (旧解析器把上游原始响应当 JSON 包装,拿不到状态码,glm/qwen 等验证失真)
2026-09-16 18:32:31 +08:00
admin 49a8b81647 fix(llm): join_target 剥掉 base 自带路径时客户端多余的 /v1 (1.0.41)
智谱(glm) OpenAI 基址 …/api/coding/paas/v4、阿里(qwen) …/compatible-mode/v1
已自带版本路径段,而真实客户端统一带 /v1(/openai/v1/chat/completions 约定),
旧逻辑只在 base_path==/v1 时去重,导致 glm 被拼成 …/v4/v1/chat/completions
被智谱严格 404、qwen 双 /v1(阿里容忍但脏)。

改为:base 自带路径段(非裸 host)时,剥掉客户端冗余的 /v1 再拼;
裸 host(deepseek/minimax 的 https://api.x.com)保留客户端 /v1。
覆盖 glm/qwen 双协议与 deepseek/minimax 裸 host 四种形态,单测 + e2e §9.5 锁回归。
2026-09-16 18:31:20 +08:00
admin 1e52eae468 feat(llm): 上游拆 OpenAI/Anthropic 双地址 (1.0.40)
每上游存 base(OpenAI) + base_anthropic(Anthropic) 两条完整真实 URL;
网关出口纯 /<slot> 与 /<slot>/anthropic,厂商协议路径段原样留在 base* 里,
由 join_target 拼到 SDK 余下路径前。解决智谱/阿里单 base 无法表达
不同 OpenAI 与 Anthropic 路径段导致 404 进冷却的问题。

- models.rs: Upstream 加 base_anthropic 字段
- upstreams.rs: derive_anthropic/effective_anthropic、shm payload 三字段、
  read_up 三元组、pick_account 按协议选 base、base_url/anthropic_base_url
  纯网关出口、upsert 支持 base_anthropic 保留语义、view 回显 base_anthropic
- llm.rs: is_anthropic 按 /anthropic 段分流、upstream_uri 剥标记段防重复拼
- api.rs/upstreams.js/me.js: 管理台双地址输入与回显
- tests: GLM 双协议夹具 + §9.5 路由断言,回归 245/0
2026-09-16 18:07:25 +08:00
admin d56dd52c3e fix(me): 24h 图表改滚动窗口(左 23h 前 → 右 现在)
之前 hour_24 数组按 hour-of-day 桶索引(h = (now_h - age_h + 24) % 24),
导致 11 点打开面板看到「今天 0-11 + 昨天 12-23」混在一起,x 轴
「0-23」语义跟时间顺序对不上,看着像「显示的是昨天的 24 小时」。

改 llm_audit.rs:
  * 索引语义换成「hours ago」:hour_24[0] = 23h 前,hour_24[23] = 现在
  * 24h 边界(age_h == 24)clamp 到 0 桶;老逻辑会把边界调用错归到
    当前小时桶,是同一个 bug 的另一种表现
  * 响应里加 hour_24h_labels 数组,前端不用再算时间

改 www/assets/me.js:
  * renderHourly 接收 server 返回的 labels,老 server 缺字段时降级到索引

改 www/me.html:
  * 描述文字「按本地自然小时分桶」→「滚动 24 小时(左 23h 前 → 右 现在)」
    ——避免后续用户再问

hourly.html 的热力图(slot × 24 小时)按 hour-of-day 是设计如此,
不动。
2026-09-16 12:07:47 +08:00
admin 354c58e721 fix(migrate-agent-home): 放宽 git 依赖,没 git 也能跑
脚本原硬要求 REPO_DIR 是 git repo,否则直接 exit。但 .11 上没装 git
的部署场景只 scp deploy/ 文件夹上来跑,git pull 那步根本不存在。

改成:
  * 必须有 $REPO_DIR/deploy/ipass-agent.py 文件(不强制 .git)
  * 如果 command -v git && [ -d .git ] 才尝试 pull,否则跳过
  * 缺文件时给 scp 提示(之前的错误信息只说"仓库不存在",新用户看不懂)
2026-09-16 11:43:47 +08:00
admin 4129d2449e refactor(agent): 路径统一到 ~/ipass/,加迁移脚本
agent 自身的三件套(py/log/pid + token)原本散在 $HOME 根目录,跟
~/ipass/{data,backup,audit} 不是一个根,运维一眼看不到。

ipass-agent.py:
  * 新增 INSTALL_DIR/TOKEN_FILE/PID_FILE/LOG_FILE 四个常量
  * load_token()/main() 用常量替代 hardcoded os.path.join(~, ...)
  * 文档注释同步路径

deploy/migrate-agent-home.sh (新):
  * 一次性迁移:停旧 agent → mv 文件到 ~/ipass/ → 启新 agent
  * 旧日志 gzip 归档到 ~/ipass/ipass-agent.log.old.gz
  * 旧位置残留检查,避免漏删
  * 仅做一次:commit 之后 git pull + restart 即可

deploy/update-agent-face.sh:
  * 注释里的 ~/.ipass-agent-token / ~/ipass-agent.log 同步新路径

deploy/release.sh:
  * §12.5 指引里的 ~/.ipass-agent-token 同步新路径

CLAUDE.md:
  * 控制面 §12.5 的 ipass-agent.py CLI 示例同步新路径
2026-09-16 11:40:06 +08:00
admin 184b052ec0 fix(backup): 备份含 audit 兄弟目录 + 路径对齐 ~/ipass/backup/
update-ipass.sh:
  * 备份路径 ~/ipass-data-backup-*.tar.gz → ~/ipass/backup/ipass-data-*.tar.gz
    (与 ipass-agent.py:470 同口径,CLAUDE.md 1.0.17 后的约定)
  * 同时打包 audit 兄弟目录(data 的父目录下 sibling audit,1.0.18+
    对话审计落这里);不存在则只打包 data
  * 复用 agent.py:656 已有的 audit_src = parent/audit 推导逻辑

ipass-agent.py backup_data():
  * tf.add(data_dir) 后追加 tf.add(parent/audit),与 update-ipass.sh
    对齐;同样 audit 不存在就跳过
  * 加 jlog 一行 + 审计目录 %s 让备份日志能看出 audit 进没进

CLAUDE.md:
  * 「生产更新」段补一条:两条入口走同一份逻辑 + audit 进归档 +
    audit 不存在则只打包 data

效果:旧备份只有 data/(5 KB 级),新备份含 data/ + audit/
(实测从 5 KB 跳到 354 KiB,把之前漏掉的对话审计元数据补回来)
2026-09-16 11:27:40 +08:00
admin ac40738c30 fix(upstreams): anthropic_base_url 不带 /v1(Anthropic SDK 自己拼) (1.0.38)
**Anthropic SDK 与 OpenAI SDK 行为不同**:
- OpenAI SDK:用 base_url 直接拼 /chat/completions,**不会自动加 /v1**
  → base_url 必须带 /v1
- Anthropic SDK:用 base_url 拼 /messages,**会自动拼 /v1**
  → base_url **不要带 /v1**,否则 SDK 拼出 /v1/v1/messages 404

1.0.37 把 anthropic_base_url 也加 /v1 是错的——Anthropic SDK 拿到后会
拼成 /v1/v1/messages 上游 404。同时 upstreams.js 的 apiUrls 函数
拿已经带 /v1 的 base_url 再拼 /anthropic,得到 `…/v1/anthropic` 错 URL
(现场复制)。

修:
- 后端 anthropic_base_url **不带 /v1**(让 SDK 拼)
- upstreams.js apiUrls 函数**不再拼**,直接用后端返回的 base_url /
  anthropic_base_url 字段(前端正则拼接是 1.0.37 之前的兜底,不再需要)
- e2e 断言同步改:anthropic_base_url 不含 /v1

回归全绿。
2026-09-15 20:53:41 +08:00
admin cc4406738c fix(upstreams): base_url 强制带 /v1(OpenAI SDK 需要) (1.0.37)
OpenAI Python SDK 用法:`client = OpenAI(base_url=...)` 内部拼
`/chat/completions`,**不会自动加 /v1**。

但网关 location 只接 `/<slot>/v1/...`(slot 拆完路径必须是
`/v1/chat/completions`,上游 base `https://api.deepseek.com` 也要求
带 /v1)。

旧 base_url 函数:上游 base 无路径时,输出
`https://lm.mayishangshu.cn:88/openai`(**无 /v1**)——SDK 拼出
`/openai/chat/completions` → 网关拆 slot 后路径是 /chat/completions →
转发到上游 → 404 且响应体为空。

修:
- base_url 出口保证末尾是 `/v1`(上游已有 /v1 时不加,避免 /v1/v1)
- anthropic_base_url 末尾保证 `/anthropic/v1`
- e2e 测试断言同步改:base_url 必须带 /v1 + anthropic_base_url 必须带 /v1

回归全绿。
2026-09-15 20:40:05 +08:00
admin a47e08b5ac fix(me): by_slot last_status 用 max_ts 取最新一次的状态 (1.0.36)
`user_recent` 的 by_slot_7d 计算里 `entry.last_status = status` 无
条件覆盖,导致**昨天末尾的 status 覆盖今天最新**——
`list_days()` 是**倒序**(今天 → 昨天),如果昨天的最后几行是
失败状态(minimax 9-14 末尾 9 行全是 429),会覆盖今天的最新值。

现场:wugui minimax 最近 5 分钟全是 200,但 me.html 显示 429。

修:track `max_ts`,**仅在 ts > max_ts 才更新 last_status**——
保证 last_status 反映 7d 窗口内**最大 ts 的那次调用**。

回归 238/0 全绿。
2026-09-15 20:19:55 +08:00
admin 704a332f3f feat(me): 上游按协议分组 + 复制即用 curl + 24h 折线高度压半 (1.0.34)
- **上游按协议分组**:每个 upstream 的 `base_url`(OpenAI 协议)与
  `anthropic_base_url`(Anthropic 协议)**各自渲染一份 curl 示例**——
  同一个上游支持两种客户端(OpenAI SDK / Anthropic SDK),
  各拿各的 URL 即可。
- **复制即用**:每份 curl 带「OpenAI」「Anthropic」协议标签 + 复制按钮
  (IP.copyText,非安全上下文 fallback prompt)。**Key 占位 `<YOUR_KEY>`**。
- **协议判定**:后端 view 已返回 `base_url` / `anthropic_base_url`
  两个字段(1.0.23 起),不再做 heuristics 猜测。
- **24h 折线高度**:180 → **90**(再压一半),整体更紧凑。

回归 238/0 全绿。
2026-09-15 19:59:23 +08:00
admin 18385949f6 fix(me): 24h 改折线 + 去掉右上退出按钮 (1.0.33)
- 「24h 调用分布」用 IP.chart.line 画**一条折线**(之前 bars 接口传 24
  行太占屏,每小时一行还把 max 推到 200,bar 长度一样难分辨)
- 去掉 me.html 顶部 panel 的「退出」按钮(只留「刷新」)
- 去掉 topbar 里的「退出」按钮(用户反复要求)

退出需求通过关页面清 sessionStorage 满足。

回归 238/0 全绿。
2026-09-15 18:30:17 +08:00
admin e02ad9e77b feat(stats): /api/v1/me 增量聚合 + 自上线以来累计 (1.0.32)
1. **/api/v1/me 增量聚合**:
   - 新增 shm 前缀 `usum:`(值 JSON),key = `usum:<username>`
   - 持久化 `{calls, tin, tout, by_slot, last_ts, last_slot, last_status}`
   - 每次 user_recent 只扫 audit delta (`ts > last_ts`),累加进 shm 后写回
   - 24h hour / 24h totals / 7d by_slot 是**滚动数据**,每次现算(持久化会过期)
   - dump 走 stats_persist 的 PREFIXES 白名单 → 自动落 llm-stats.json → 跨重启不丢
   - **冷启动**:`last_ts=0` → 第一次 user_recent 全量扫 audit 重建索引
   - 后续请求:`last_ts` 跟上 → 增量扫 audit → 写入持久化

2. **/api/admin/usage 自上线以来累计**:
   - 新增 `tokens.all_time` 字段(1.0.32),来自 audit meta.jsonl 全聚合
   - 真源聚合,不依赖 shm 日桶,**不受 stats 落盘/恢复影响**
   - audit 容量 1GB = 14 年历史,**自服务上线以来覆盖完整**
   - overview.html 新增 stat 卡片「累计 token (自上线)」+ since 日期

回归 238/0 全绿。
2026-09-15 18:12:29 +08:00
admin 57d0f19c9f fix(me): 24h 调用分布空白 —— IP.chart.bars 用法错 (1.0.31)
me.html 把 24 小时数据(hour_24h 数组)传给 IP.chart.bars 时,
写成了 `{name: "调用数", values: [...]}` —— 但 chart.js.bars
的 items 期望 `{label, value}` 单值(每行一根 bar)。

实际 hour_24h 是有数据的(wugui 24h 1276 次,分布 11 个小时槽非 0),
但前端渲染失败显示空白 —— 用户看不到自己的 24h 分布。

修:每 hour 一行 item,传 label="h时" / value=v。
顺便 hourly.js 检查过了——它自己写 SVG heatmap 不走 bars,不受影响。

回归 238/0 全绿。
2026-09-15 17:55:24 +08:00
admin faae6b95d4 feat(admin): 「我的用量」面板 me.html —— 用户自查询 (1.0.30)
基于 1.0.29 `/api/v1/me` 新增 recent 块,每个用户可以**自助**看自己的
用量,不必 admin 帮忙——也省得同事自己 curl 拼 JSON。

**面板能力**(来自 `/api/v1/me`):
- 6 张概览卡片:用户名 / 24h 调用 / 7d 调用 / 24h token / 上次调用
- 24h 调用分布:bar chart(来自 `recent.hour_24h`,按本地小时分桶)
- 近 7 天按 slot 拆分表格:calls_24h / calls_7d / tin / tout / last_status
- 我能调的 LLM 上游:白名单过滤后的完整 slot + base_url + models
- 我能调的 API 代理:enabled 列表 + 调用方式(`<code>GET /apix/...` 或
  `<code>POST /apixp/...`) + desc 截前 80 字
- 我的域名列表

**鉴权**:
- 用户首次进入 → 输入 sk_ → sessionStorage 存 → 调 `/me` → 渲染
- 不能复用 `IP.api`(那个走 cookie)—— 新加 `meApi` helper 走 `X-API-Key`
- Key 只在 sessionStorage,**关页面即清**,不会落盘不会上传
- 401 自动清 Key 跳回输 Key 卡片
- 顶部 nav 加「我的用量」入口:admin 也能用自己的 sk_ 查

**安全考虑**:
- 用户拿 sk_ 看自己:API key 天然按 username 隔离,**不能看别人** ✓
- 面板只读,没有任何写操作

回归 108/0 全绿(gateway 108,含 me.html 200 断言)。
2026-09-15 17:32:49 +08:00
admin fe7816450e feat(/me): recent 块 —— 一次拿全「我最近调用/消耗/主要 slot」 (1.0.29)
同事反馈:希望 `/api/v1/me` 直接带自己最近的调用/消耗数据,不再需要二次
调 `/api/v1/usage` + `/api/v1/upstreams`。

**1.0.29**:在 `/api/v1/me` 顶层加 `recent` 块,数据从 audit meta.jsonl 实时
聚合——**不依赖 stats 落盘周期**,log 阶段落盘即聚合,零延迟。

`recent` 字段:
- `calls_24h` / `calls_7d`:24h / 7 天总调用数(含被拒 401/404,**与 shm 日桶
  只统计成功转发不同**——审计全量)
- `tin_24h` / `tout_24h` / `tin_7d` / `tout_7d`:token 数
- `hour_24h`:24 长度的数组,索引 = 小时(按本地时区切分),值 = 该小时调用数
- `by_slot`:\[\{slot, calls_24h, calls_7d, tin_7d, tout_7d, last_status\}\]
  按 calls_7d 降序
- `last_at` / `last_slot`:最近一次调用的时间 / 哪个 slot

**实现要点**:
- `plugin_llm::llm_audit::user_recent(username, days)` 新增聚合 helper,复用
  已有 `read_day` 路径(不重新发明读 meta.jsonl 的轮子)
- gateway::decorate_me 装配根调它,往 `/api/v1/me` view 里塞 `recent` 字段
  —— 插件依赖方向依然 `plugin → core`,gateway 反向装配,不破坏插件边界
- 失败兜底:audit 无数据 / 权限 → 返回空统计(不阻塞 /me)

回归 238/0 全绿(§10 账号态端点新增 6 条 me.recent 断言)。
2026-09-15 17:22:42 +08:00
admin c785a7b7f0 feat(admin): 「24h 热力」页 hourly.html —— 直接读 meta.jsonl 聚合 (1.0.28)
1.0.27 加了 `/api/admin/audit/days` + `/api/admin/audit/day` 端点,
但**没有前端 UI**——「端点有什么用」不直观。

加 `hourly.html` + `hourly.js`:
- 选区间(最近 1/3/7 天)+ 选 slot(全部 / 单个)+ 选指标(请求数 / 入 / 出 token)
- fetch 多天 meta.jsonl → JS 按 (slot, 小时) 聚合 → 渲染 SVG heatmap
- 颜色:浅蓝 → 深蓝 渐变(吃现有 admin.css 颜色基调)
- Top 10 繁忙 (slot, 小时) 表格
- 概览:区间内请求/token/slot/账号 数 + 数据来源(meta.jsonl × N 天)

设计要点:
- **零外部依赖**:纯 SVG/HTML,复用 chart.js 的 fmtNum/niceMax,自己写 100 行 heatmap 渲染
- **实时反映所有请求**(含被拒 401/404)—— 不像 shm 日桶只统计成功转发
- **零延迟**:审计落盘即聚合,不依赖 stats 落盘周期
- 不破坏 usage.html(独立的 panel 入口)
- 顶部 nav 加 "24h 热力" tab

回归 339/0 全绿(gateway 107/0 + LLM 232/0,新增 hourly.html 200 断言)。
2026-09-15 16:38:43 +08:00
admin 67776334a5 feat(llm/audit): 智能 excerpt —— 长请求体优先摘 user content (1.0.27)
原 100 字节截前 N 字节的方式在大 body 上**全是噪声**:
- 165 KB / 238 KB 请求体(带 context_management / tools 数组 / 多轮 history),
  前 100 字节几乎全是 `{"context_management":{"edits":[...]}` 这种元数据
- 真正想问的 user content 完全看不到
- 之前 100 KB+ 请求复盘只能看出「这请求很大」「用了哪个模型」,看不出
  「用户问了啥」

**1.0.27 智能摘录**(按 body_bytes 长度分支):
- ≤ `AUDIT_EXCERPT_BYTES` (100B):保留原文(含 model + messages 完整结构,
  短 query 一眼能看出完整对话)
- > 100B:解析 JSON → 提取 `model` + 最后一个 role=user 的 message 的 `content`,
  按 `AUDIT_CONTENT_CHARS` (200 字) 截前 N 个字符 → 输出
  `{"model":"...","content":"<user 内容前 200 字>"}`
- 兼容 OpenAI(content 字符串)与 Anthropic(content 是 `[{type,text}]` 数组)
- 大 body 解析只读前 `AUDIT_JSON_PARSE_BYTES` (16KB),不把 165 KB 全读进内存

**保留字段不变**:body_bytes / body_hash 仍记录全文长度 + SHA256 前 16 hex;
excerpt 仍是 meta.jsonl 单行;不存 body 副本。

附带:管理台「小时级趋势」直接读取 meta.jsonl 的端点
`GET /api/admin/audit/days` + `GET /api/admin/audit/day?day=YYYY-MM-DD`
(admin 鉴权,剔除 excerpt / body_hash 省流量)。前端按 `ts / 3600` 自己聚合。

回归 232/0 全绿(§13 改造为智能摘录断言,新增 4 条原文/摘要/脱敏相关)。
2026-09-15 16:24:53 +08:00
admin 24ced30d41 fix(upstreams): accounts=None 保留顶层 accounts 字段(不再清空) (1.0.26)
`accounts = None` 走 legacy auth 路径时**写空 vec 覆盖**了 existing.accounts,
导致管理台 toggle「停用/启用」(只发 {slot, enabled})会把账号清单
全部清空——用户现场踩坑:minimax 2 个账号点停用变 0 个。

修:`accounts = None` 时保留 `existing.accounts`(含 note/resets),
与 base/models/note 字段的 None = 保留原值语义对齐。

回归 228/0 全绿。
2026-09-15 15:30:35 +08:00
admin bbe54f109b fix(upstreams): upsert base_raw 改 Option,空串保留原值 (1.0.25)
`upsert` 其他字段(models/auth/note)语义都是 None / Some("") = 保留原值,
Some(有效) = 校验覆盖。`base_raw` 是 `&str`,"" 被 `validate_base`
直接拦截报「缺少 base 参数」。

现场踩坑:用户改 minimax 槽位 resets 时点了「停用」按钮,前端只
发 `{slot: minimax, enabled: 0}`(其他字段没填),被 base 校验拦下。

修:`base_raw` 改 `Option<&String>`,与现有约定对齐。新建必填校验
移进闭包(existing.base 兜底),编辑「停用」/「改备注」/「改账号」
等不需要回填 base 的场景不再被拦。

回归 228/0 全绿。
2026-09-15 15:19:03 +08:00
admin 2c37a36d9f fix(time): 容器 TZ=Asia/Shanghai + RESET_DAY_OFFSET_SEC=0 (1.0.24)
容器默认 TZ=UTC 导致所有时间显示比北京慢 8h,'今日'配额/趋势日桶
在北京 08:00 切日(不是 00:00),反直觉。同时 `cool_until_until` 用
`RESET_DAY_OFFSET_SEC=28800` 手工补 8h 算'上海 0 点'——**两处口径不一致**,
趋势日界比冷却边界早 8h。

按 memory 红线要求同时动两处:
1. Dockerfile 加 `tzdata` + `ENV TZ=Asia/Shanghai`
   - `util::day_id`/`fmt_time` 走 localtime_r 自动按上海 0:00 切日
   - `day_id` 输出 = `tm_year*1000 + tm_yday`(Shanghai yday)
2. `RESET_DAY_OFFSET_SEC` 从 28800 改成 0
   - `(now - 0).div_euclid(DAY)` 直接 = 当前上海 0 点对应 epoch
   - 与 `day_id` 口径一致(都按上海 0:00 切)

**副作用**:线上 `uda:`/`uex:` 等冷却类键按 epoch 算(不走 day_id),
不受影响。**真正受影响的是 `ud:`/`udu:`/`uds:` 趋势日桶的 yday key**——
同一天 UTC 算 vs 上海算差 ±1(跨 UTC 16:00 / Shanghai 0:00 边界时),
因此发版后 14 天趋势按新 key 重算,旧 14 天逐步过期(滚动窗口允许丢)。

回归 228/0 全绿(网关上一轮已 106/0,本次 LLM 无新增)。
2026-09-15 15:09:16 +08:00
admin c28e9edb53 fix(nginx): 管理台静态资源 no-store + /admin/ 500 + 88 不再跳 18098 (1.0.23)
1. **管理台所有 HTML/CSS/JS 改 Cache-Control: no-store**(expires -1 + add_header)
   - 解决「代码上线了但用户浏览器一直用旧 JS」——管理员看不到新增字段
     的典型表现就是浏览器缓存命中。文件都不大(HTML<5KB / CSS<10KB /
     JS<15KB),无缓存的性能影响可忽略。
2. **/admin/ 带尾斜杠 500 修**
   - 根因:nginx 把请求 URI 拼到 alias 后打开文件/目录;(末尾斜杠、
     剩余空)+ alias 目录 + index 拼出 `overview.htmlindex.html` 报错
     「is not a directory」。改用 internal rewrite 落到 `/admin/overview.html`,
     重新走 location 匹配(命中 `= /admin` 那条 alias 文件)。
3. **路由器 88 不再被踢到 18098**
   - 根因:nginx 默认 `absolute_redirect on; port_in_redirect on;`,302
     Location 写绝对 URL + 实际 listen 端口(18098),把外部 88 用户踢出
     反代链。三条 server(lm / mdm / *.dm)都加 `absolute_redirect off;
     port_in_redirect off;`,Location 变成相对路径,浏览器留 88。
4. **e2e 加 3 条无缓存断言 + /admin/ 200 断言防回归**

回归 334 全绿(网关 106 + LLM 228)。
2026-09-15 13:11:28 +08:00
admin 3635b18797 docs(readme): 补 1.0.21/1.0.22 变更记录
- 1.0.21: passthrough 新建可空 Key(upsert 按 mode 放宽校验)
- 1.0.22: usage_hint 字段,/api/v1/me 把调用语法下发给用户 AI
2026-09-15 11:48:40 +08:00
admin 26a0f2f4f4 feat(apix): usage_hint 字段 —— /api/v1/me 帮用户 AI 自动发现调用语法 (1.0.22)
`desc` 是中文给运维看的,`params` 只对 vendor 有意义(passthrough 是空数组)。
`/api/v1/me` 把条目下发给用户 AI 后,AI 必须能自己拼出:
- 路径尾部是什么(/ocr /ocr/base64 /ocr/url)
- 每个端点的 Content-Type(multipart 还是 json)
- 上游字段名 / Swagger 在哪

加 `usage_hint` 字段:管理员按 OpenAPI 风格填写自由格式,由 /api/v1/me
原样透传给用户 AI。AI 直接解析,无需再读人工文档。

设计要点:
- 不进 shm(热路径只查 base/key/asset_id/mode,进 shm 占带宽)
- 截断到 1KB(够写 3-5 个端点说明,长 Swagger 截断而非拒绝)
- 默认空字符串,向后兼容旧数据
- passthrough 推荐填,vendor 可选填

改动:
- models.rs: ApiProxy 加 usage_hint 字段
- apix.rs: upsert 收 usage_hint_raw + 截断;view 回显
- api.rs: save 解析 usage_hint;响应回显
- www/apix.html: 描述加 usage_hint 解释
- www/assets/apix.js: 表单加 textarea + 提交带 usage_hint
- tests/llm/e2e.sh: §11.5 加 1 条 usage_hint 写入与回显断言
- 回归 227/0 全绿(修复断言 1 条)
2026-09-15 11:30:16 +08:00
admin d05ebfb5b0 fix(apix): passthrough 新建可空 Key —— upsert 按 mode 放宽校验 (1.0.21)
1.0.20 现场踩坑:upsert 统一要求「基址与密钥」,但 passthrough 设计是
Key 可空(内部服务免鉴权,handler 已经放空 Key 转发),管理台提交 passthrough
+ 空 Key 直接 400。

修:vendor 必须 base + key 都填;passthrough 仅 base 必填,key 可空。

补 2 条测试断言防回归(vendor 缺 Key → 400;passthrough 空 Key → 200)。
回归 227/0 全绿。
2026-09-15 11:12:07 +08:00
admin 31aaf58c30 docs(readme): 补 1.0.16-1.0.20 变更记录 + 1.0.20 发版与复验结论
- 1.0.16 me 能力目录 / 1.0.17 备份路径 / 1.0.18 落盘与审计 / 1.0.19 spr: 移 shm
  四条此前漏登记(commit 479024c / 6b8d694 / 16cf68d / 1bc316e)
- 1.0.20 记为已发版(commit 4533db8,digest ff34f7ef…),含 apix passthrough 真源指向
- 待补:本地 Gitea 192.168.1.18:13300 当前拒连(Connection refused),
  push 待 Gitea 恢复后由本地手工执行
2026-09-15 10:58:14 +08:00
admin 4533db8536 feat(apix): 透传模式 passthrough —— 通用内部 REST 出口 (1.0.20)
- 模型加 mode 字段(vendor 默认 / passthrough 新增),shm payload 扩为 4 字段
  base\nkey\nasset_id\nmode;旧数据零迁移(无 mode → vendor)
- 拆 location 而非按 mode 分支:/apixp/ 不施加 vendor 强约束
  (proxy_method POST + 强制 Content-Type + proxy_pass_request_headers off
  是 location 级指令,无法按请求级 shm 的 mode 动态切换)
- handler 校验路径前缀 vs mode 一致(vendor slug 走 /apixp/ → 404,反之亦然),
  避免 vendor 条目继承 passthrough 强制 Content-Type 致 415 之类静默故障
- passthrough:方法/请求体/Content-Type 原样透传(含 multipart),上游路径
  = base + /apixp/<slug> 之后的 URI 尾部(含 query 由模块拼,变量式 proxy_pass
  不自动追加);Key 可空(内部服务免鉴权,下发时 nginx 空串 = 不发该头)
- 探测按 mode 分流:vendor 走 POST 预估 / passthrough 走 GET 打上游根地址
- nginx:lm server 加 /apixp/,mdm server 加 /_apixp_probe/(internal)
- 测试 §11.6 新增 35 条断言(鉴权/路径转发/体透传/Key 下发/路径-mode 一致
  /管理台回显/探测);账号态 count 1→3 同步;回归 225/0 全绿
- 管理台:列表加 mode 标签、表单加 mode 下拉 + 透传说明 + 路径示例复制
- 文档:docs/apix/PASSTHROUGH_MODE.md 真源(决策/兼容/改动一览)

OCR 是第一条 passthrough 配置:/apixp/ocr/ocr、/apixp/ocr/ocr/base64、
/apixp/ocr/ocr/url?src=...
2026-09-15 10:51:29 +08:00
admin 2cd2ba43b9 docs(readme): 补 1.0.16/1.0.17 变更记录 + 1.0.19 发版与复验结论
- 1.0.16(me 承载能力目录)/ 1.0.17(备份路径 + 审计目录 777 + 去本地 rollback 标签)
  两条此前漏登记(commit dfbfe5c / 6b8d694)
- 1.0.19 记为已发版,附 commit/digest/job 与线上复验结论
- 记两个发版副发现:宿主控制面 ipass-agent.py 仍是旧版;
  容器 TZ=UTC 导致时间显示与趋势日界偏移(与 RESET_DAY_OFFSET_SEC 耦合,改一处必改另一处)
2026-09-14 20:16:30 +08:00
admin 1bc316e014 fix(stats): 「上次落盘」记录移入共享内存(1.0.19)
1.0.18 首次线上验证暴露:error.log 里有 10 次 [stats] 落盘(来自 6#0/18#0/23#0
多个 worker),GET /api/admin/stats/persist 却报「本进程还没落过」。

根因:LAST_DUMP_AT 是每 worker 的进程内静态量。maybe_dump() 挂在记账路径上,
而记账每 worker 各算各的 → 落盘时刻也就每 worker 一份;接口落到没落过盘的
worker 就报 0。与 1.0.18 已修过的 spr:last(上次恢复)是同一类错误。

修法:发布到共享内存 spd:last(publish_dump 取 max)。一次解决两件事:
* 上报一致 —— 所有 worker 报同一份;
* 节流收敛 —— maybe_dump 新增慢路径查它,把「8 个 worker 各写一遍同一个文件」
  收敛成「全局每间隔一次」。快路径仍是原子比较,热路径代价不变。

顺带:
- 新增回归断言「状态页报告的上次落盘时刻非空」(套件开 2 worker,能暴露该分歧)
- deploy/agent.sh 加 stats-persist / stats-dump 子命令(线上观测口)
- 统一文档里过期的断言条数(90/111/160/179/196/262/298 → 实际值)
- 记录审计容量巡检 LAST_PURGE_AT/PURGING 同为每 worker 静态量(另案)

回归:bash tests/run.sh all → 299 条全绿(网关 102 + LLM 197)。
2026-09-14 20:05:51 +08:00
admin 16cf68d132 feat(stats): 运行期统计落盘/恢复 + 审计口径收口 (1.0.18)
起因:发版后管理台「用量」与「趋势」从 0 重新长起来。根因是统计类键
(ust:/ums:/utt:/utms:/ud:/udu:/uds:/uda:/uex:/uh:)只活在共享内存,
进程退出即消失;而上游/账号/域名/用户都有 data/*.json 所以不丢。

统计落盘(新 stats_persist.rs):
- 快照 data/llm-stats.json(与 users.json 同级),原子写 <path>.tmp.<pid> + rename
- 两个落盘点互补:worker 退出钩子 exit_process(发版/docker stop,零丢失)
  + 记账后按间隔节流落盘(默认 60s,覆盖 SIGKILL/OOM/断电)
- 启动 init_process 恢复,put-if-absent → 多 worker 幂等、不覆盖新数据
- 白名单 10 个统计前缀;刻意排除配置类/ukb:/内核态(各有数据文件或重启清零更安全)
- 恢复结果发布 shm spr:last(不再放进程内静态量,否则接口落到哪个 worker 报哪个数)
- 接口 GET /api/admin/stats/persist + POST /api/admin/stats/dump
- 指令 ipass_stats_persist <秒>(0=只留退出钩子);生产 conf 刻意不写

fix(audit): excerpt 双重编码
- json_quote_bytes(手工转义+两侧引号)塞进 json!() 被二次转义,落盘成
  "excerpt":"\"{\\\"model\\\"…",解码后多一层引号,消费方全解析不到
- 改为 excerpt_text():只 from_utf8_lossy,转义交给 serde

docs: 新增 docs/llm/STATS_PERSISTENCE.md(含 runbook)、docs/llm/AUDIT_LOG.md
  (两者此前被代码注释与 Dockerfile 引用但文件并不存在)

tests:
- 新增【15】统计落盘/重启恢复 13 条(间隔压 1s → 快照产出与白名单 →
  nginx -s quit → 恢复键数 == 快照键数、用量不变、再打一笔 +1、趋势仍在)
- 【13】「不再生成 body 副本」改断言本轮增量 = 0(对历史残留免疫);
  选择器改 body_bytes>400 且取最后一条匹配(目录里有首版的双重编码行)
- run.sh 复位改用 mv(rename 不算删除)——本机 safe-delete 钩子在累计删除
  超 50 个文件后会静默拦掉后续删除,rm -rf 与 python rmtree 同样被拦
- 回归 298 全绿(网关 102 + LLM 196)
2026-09-14 19:32:17 +08:00
admin 6b8d694c54 deploy(agent): 备份改 ~/ipass/backup/ + 删 rollback-* 标签 (1.0.17)
3 处变更,都是苏苏 9-14 反馈:

1. **备份路径**:从 `~/ipass-data-backup-<时间>.tar.gz` 改成
   `~/ipass/backup/ipass-data-<时间>.tar.gz`。
   `ls ~` 不再被一堆 `ipass-data-backup-*.tar.gz` 文件刷屏。

2. **审计目录权限**:宿主侧首建 audit/ 目录后显式 `chmod 777`。
   agent 是 root 跑的,`os.makedirs` 创建的目录属主是 root,
   但容器内 worker 是 nobody,写不动 → 日志刷
   `[audit] 建日期目录失败 Permission denied`、整个审计废掉。
   用 777 而非按 uid chown:宿主 uid 与容器内 nobody uid 不一定一致
   (镜像内 nobody=65534,宿主 root mkdir 后 uid=0),按 uid 改
   要么拖数字要么拖 docker 进程解析;777 简单可读,
   且 audit 是「append-only JSON 元数据」、没有防篡改语义。

3. **去掉「旧镜像留 rollback tag」步骤**:镜像动辄 100 MB+,
   本地磁盘会越积越多;阿里云私仓永远保留所有 tag,需要时
   `docker pull` 即可。
   - 删除 §3(7 步变 6 步:2/6 备份 → 3/6 删容器 → 4/6 起新容器 →
     5/6 自检 → 6/6 探活)
   - 删 `ROLLBACK_PREFIX` 常量
   - `op_rollback` 不再自动选 local rollback-tag,**必须显式传 tag**,
     否则报错指引去阿里云拉
   - 同时清掉 .11 上积的 `ipass-gateway:rollback-20260912-104954` (144 MB)

CLAUDE.md 同步:发版/回滚段补三条 1.0.17 注意事项。
2026-09-14 18:01:27 +08:00
admin dfbfe5cf6c docs(me+plugin): 登记 /api/v1/me 能力目录扩展点(1.0.16)
CLAUDE.md
- 「核心机制」补第 6 条:/api/v1/me 是插件装饰扩展点,不是写死端点;
  加新字段往 decorate_me 里塞,不要另开 v1 端点(避免老客户端脚本被破坏,
  也避免能力目录被拆成 N 个调用)
- 提示协作者给同事/文档/SDK 展示能力时直接讲 me

docs/plugin/PLUGIN_ARCHITECTURE.md
- §2.3 更新 decorate_me 签名为 (User, port)(1.0.16 引入):传 &User 让
  装饰零额外 shm 查询就能做权限收敛(upstreams 按 allowed_models 过滤);
  port 从 Host 头取(不写死是已知坑)
- 新增「decorate_me = 能力目录的承载点」子段:拍板决策 + 当前塞入字段表
  (domains / llm_usage / policy / upstreams / apix)+ 新增字段的纪律
- §6 纪律补第 7 条:能力目录走 decorate_me,不要另开 /api/v1/catalog
- §7 已拍板补 1.0.16 一条 "me 承载能力目录"

不动代码,仅文档同步。
2026-09-14 17:25:10 +08:00
admin 479024c61e feat(api): /api/v1/me 聚合能力目录 (upstreams + apix) (1.0.16)
- plugin-apix: 新增 apix::enabled(),仅列 enabled=true 的代理
- ipass-core: CoreExt::decorate_me 签名加 &User 和 &port,让装饰零额外
  shm 查询就能做权限收敛(upstreams 按 allowed_models 过滤)
- gateway::GatewayExt: decorate_me 多塞 upstreams(白名单过滤)和 apix
  (仅 enabled)两个字段;port 从请求 Host 头取(适配 88 / 443 反代)

老 3 个端点 /api/v1/{upstreams,apix,domains} 保留不破坏。同事拿 key 一个
me 拿全能力目录,不再需要分别调三个端点。

回归 281 全绿(网关 102 + LLM 179)
2026-09-14 17:14:00 +08:00
admin f34ba3d198 fix(llm): auth 规范化兜住「只填裸 key」+ 排障子命令 (1.0.15)
线上 minimax 2 把 Key 点「测试」红字:1004 Please carry the API secret key
—— 根因是表单 placeholder 写 sk-...,用户照着填了**裸 key**(无 Bearer ),
而 accounts[].auth 语义是「完整 Authorization 头值」,转发时原样发就 1004。
agent.sh upstreams 一打就看出对照组:deepseek=Bearer s...d425(正常),
minimax=sk-cp-...(**无 Bearer **)——光看截图红字只会猜「额度用完」。

plugin-llm
- upstreams::normalize_auth:trim 后含空白→已完整;否则补「Bearer 」。
  **双处应用**:upsert 写入(下次保存自愈) + read_upa 读出(让线上坏数据
  立即可用,无需用户重填——存量 10 把 Key 根本不可能通知用户重填)。
- 兼容 Basic / 自定义 scheme / 前后空格 / 内部含空格共 6 个边界,
  干跑 + e2e 2 条新断言全过(裸 key 200 + 靶机实收 Bearer sk-NORM-NO-SCHEME)。

前端
- placeholder 改为「Bearer sk-…(... 留空=保留原值;只填裸 key 也会自动补 Bearer)」
  ——placeholder 写「前缀」会诱导漏填必要部分,写「字面值」才能正确引导。
- 多账号小节加说明文字(只填裸 key 也会自动补 Bearer)。

deploy/agent.sh
- 新增 upstreams(逐账号掩码/冷却/今日负载;掩码为空显式标 **空** —— 这条
  是发现「只填裸 key」类问题的关键指示器,旧镜像的回显脱敏后看不出问题)
- 新增 upstream-test <slot>(调测试接口并打印厂商真实 status_code + body),
  避免再靠「管理台截图 OCR」排障。

回归 281 全绿(网关 102 + LLM 179);专章 docs/llm/MULTI_ACCOUNT_ROUTING.md §10
记录现象/规则/兼容表/自检工具。
2026-09-14 14:21:48 +08:00
admin ab44853413 deploy(agent): verify 增加 .env 默认 tag 漂移告警
update 不带 tag 时用 .env 的 IPASS_IMAGE_TAG 做缺省值,它落后于线上会
**静默降级**回旧镜像(真踩过:1.0.14 发完,.env 仍停在 1.0.9)。
verify 是发版一条龙的最后一步,在那里固定自检一次最省事:
- 一致 → 「✓ 默认 tag 与线上一致」
- 落后 → 「! ... 会退回 xxx」提示(不判失败)
- 未设 → 「! 未设 IPASS_IMAGE_TAG」

已用 5 组输入干跑验证分流(含 registry 前缀 / 裸 tag / 前缀相同易误判)。
另记:.env 受沙箱写保护,只能人工改,所以文档明确要求把同步交回用户。
文档:readme §12.6 + CLAUDE.md 硬约定。
2026-09-14 12:16:01 +08:00
admin f4adb5685c deploy(agent): verify 增加「账号级负载字段」换新证据
1.0.14 起单 auth 的旧记录也会合成 accounts[],投影带 load;
旧镜像 items 里没有 accounts 键 —— 可干净区分新旧镜像。
三态判定(ok / noupstream / old)避免线上无上游时假失败。
已用 6 组输入干跑验证(含 data 为数组的兼容分支)。
2026-09-14 12:05:37 +08:00
admin 51c473bdd7 docs(llm): 补上游负载列示意图 + 沉淀 ipass-admin-ui-verify 技能
- docs/llm/MULTI_ACCOUNT_ROUTING.md §7.2 加界面示意图(含双 Key / 单 Key / 无账号三形态)
- 新增项目级技能 .workbuddy/skills/ipass-admin-ui-verify:管理台前端改动
  的无头渲染验证流程(桩全局 + 真实资源、playwright executablePath 版本坑、
  base href 陷阱、程序化断言清单、必须同步的后端/回归断言点)
2026-09-14 11:59:37 +08:00
admin bfa3cf8ff8 feat(llm): 上游多账号路由 + 账号级负载统计 (1.0.14)
一个 slot 挂多把上游账号 Key,解决厂商「单账号额度/并发受限」与
「同一用户缓存命中」两个矛盾诉求。

多账号路由 (plugin-llm)
- models: Upstream.accounts[] (auth/note/resets) + 上游级
  exhaust_status/exhaust_markers;顶层 auth 保留兼容(accounts 为空时合成单账号)
- upstreams::pick_account:粘性绑定 ukb:<key> 优先 → 无绑定时
  FNV-1a(下游 Key) % 可用数 冷分散 → 绑定账号冷却则重新分散 → 全冷却取最早恢复
  * 分散避开厂商单账号 agent 并发上限;落点固定保住 prompt/token 缓存
- cool_until_until 天锚定冷却:boundary = day0 + ceil(已过/窗口)*窗口,
  封顶次日 0 点(MiniMax 5h 窗口、24=5*4+4 → 末段 20:00-24:00 只有 4h 随天重置)
- 耗尽双检测 (log 阶段):$upstream_status 命中 exhaust_status,或
  usage_filter 流式扫到 marker → $llm_acct 定位本次账号 → 写冷却 uac:
- shm: up:/upa:/uac:/ukb:/upe: 五类前缀;$llm_acct 变量 (NOCACHEABLE)

账号级负载统计(问题发现与跟踪)
- 新增 uda:<slot>:<idx>:<day>(请求/token)与 uex:(耗尽次数) 日桶,
  复用内核 usage::bump_day —— 无数据库、无新进程(项目红线)
- 计数点只在 log 阶段一次;pick_account 会被 $llm_target/$llm_auth/$llm_acct
  三个变量各触发一次,放进那里会三倍计数
- view() 投影带每账号 load 与 account_trend + trend_labels(日期由后端算)
- 管理台「上游」页密钥列:各 Key 今日请求/token/耗尽 + 负载比例条 +
  14 天迷你趋势(自绘 SVG,零第三方依赖)+ 冷却/耗尽徽标 + 上游合计

测试与验证
- 回归 279 条全绿(网关 102 + LLM 177),新增 6 条多账号/负载断言
- 假上游新增 UPSTREAM_FAIL_AUTH 模拟账号额度耗尽;靶机验证 Key 真被替换
- 前端以真实 admin.css + upstreams.js 渲染路径做无头浏览器断言:
  比例条与负载成比例(412 vs 96 → 100%/23%)、每账号 14 条块、
  悬停峰值日期与数据逐位吻合、单账号/无账号兜底正常、无横向溢出、零 JS 错误

文档
- 新增 docs/llm/MULTI_ACCOUNT_ROUTING.md(数据模型/路由/冷却数学/shm 布局/负载统计)
- readme §11 数据模型 + §15 上游配置 + §15 用量统计 + §12.6 tag 表 + §16 变更记录
- 修正 docs/llm/*.md 中插件化前的过时路径(rust/src/* → crates/plugin-llm/src/*)
2026-09-14 11:57:08 +08:00
admin db99ce1521 docs: 文档与注释系统性对齐插件化现状 + 清理前身实现引用
- readme §16 补 1.0.10-1.0.13 四条变更记录;§12.6 tag 表补 1.0.9-1.0.13
- readme §5 架构图更新为插件化结构(PLUGINS 注册表/四开关/四表)
- readme §11 补 api-proxies.json 数据模型小节;§8 管理台表格补 API 代理行
- readme/CLAUDE.md 测试断言数对齐 262(102+160);三个 JSON 改四个
- CLAUDE.md LLM 落点表改 crates/plugin-llm 路径;发版补 git push 前置教训
- 清理全部前身实现引用(readme 三处、CLAUDE.md 性能章节、util.rs 注释)
- PLUGIN_ARCHITECTURE.md 增补 1.0.13 sso 合流记录
2026-09-13 18:27:28 +08:00
admin ee05b27a36 refactor(core): 采纳 sso 上游化 4 条 —— A1/A2/A3 + A1 配套
按 sso/docs/upstream-core-changes.md 评估后的采纳清单:

A1(强采纳):User 增加 `extra` flatten 透传通道,让插件字段不再污染内核模型
A1 配套:新增 `users::update_extra<T,F>`,与 set_allowed_models 同源
A2(修真 bug):state::split_value `position` → `rposition`(payload 含 0x1f
     时被 position 截断;sso 已踩、rposition 取最后一个边界)
A3:state::iter_prefix_ex 返回 (key, payload, exp);iter_prefix 保留兼容包装

不采纳:A4(iPass 已具备大部分,plugin-sso 自实现)、A5(选选项 2 零代码)、
       A6-1(破坏测试边界用例,iPass 内核最小约束,由插件加策略)、
       A6-2(admin login 端点直接用 COOKIE_NAME)

262 项回归全绿(gateway 102 + llm 160)。

详见 docs/plugin/SSO_UPSTREAM_DECISIONS.md。
2026-09-13 17:43:13 +08:00
admin ddd4172517 docs(plugin): P5 收尾 —— 方案转正 PLUGIN_ARCHITECTURE.md + 文档对齐 workspace
- docs/plugin/PLUGINIZATION_PLAN.md 转正为 PLUGIN_ARCHITECTURE.md(as-built):
  记录三处方案修正(sso 不迁入已拍板、CoreExt 注册表、trend 留 gateway、
  apix 记账走 plugin_llm::stats 单一写入口)
- CLAUDE.md:目录地图改 workspace 结构 + 三条插件化新纪律 + 单 crate 迭代命令
- readme.md:§6 目录结构对齐(crate 划分 / apix 页 / 262 项回归)
- 新增用户级技能 ipass-core-add-plugin(5 处装配缺一不可 + 症状→根因表)
2026-09-13 12:22:15 +08:00