Commit Graph
65 Commits
Author SHA1 Message Date
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
admin 85ea0a1531 refactor(plugin): P4 拆 plugin-apix —— API 代理迁入独立插件,过渡期路由清空
- plugin-apix 新 crate:apix/handlers/api/config/models/store
- ApiProxy/ApiProxyStore、api-proxies.json 读写、ax: 键空间与 APIX_* 常量自内核迁入
- ApiProxyHandler 与 $apix_* 六变量注册归 ApixPlugin;用量记账仍走 plugin_llm::stats(同一片键空间、单一写入口)
- gateway 路由表只剩 trend 组合端点(需 users+upstreams+apix 三方名册)
- 行为等价:262 项回归全绿(gateway 102 + llm 160)
2026-09-13 12:16:47 +08:00
admin 0d8e1c94d1 refactor(plugin): P3 拆 plugin-llm —— LLM 路由/配额/计量/审计/趋势迁入独立插件
- plugin-llm 新 crate:llm/upstreams/usage_filter/llm_audit/stats/handlers/api/config/models/store
- 下行契约(downstream_key/identity/check_quota/fail)与记账原语(usage::bump/read/bump_day)已下沉 ipass-core
- usage_filter 改走 loc::enabled(Switch::Llm) + core::plugin::ctx_index(解除对 gateway 私有 ModuleConfig 的依赖)
- gateway 收缩为壳:LlmHandler/LlmHealthHandler/AuditHandler 随 LlmPlugin 装配;
  /api/admin/trend 留 gateway(需 users+upstreams+apix 三方名册,组合根职责)
- 行为等价:262 项回归全绿(gateway 102 + llm 160)
2026-09-13 12:08:34 +08:00
admin 74aeefee58 refactor(plugin): P0-P2 插件化落地 —— workspace 化 + ipass-core + plugin-domain
- P0: rust/ 改 workspace(ipass-core 内核 + gateway 唯一 cdylib),
  [profile.release] 上移根、依赖收敛 workspace.dependencies;
  users::delete 的 stats::forget 依赖改为 on_delete 钩子注册表
- P1: 契约层 core/plugin.rs(Plugin trait)+ core/loc.rs(Switch 并集 +
  set_switch_fn,未实现变体保守 false);gateway PLUGINS 分发循环,
  不认领统一 404(插件绝不自行 404)
- P2: 身份端点下沉 core/api.rs(CorePlugin + CoreExt 扩展注册表,
  gateway 作装配根回填域名数/用量/连带回收/白名单校验);
  plugin-domain crate(domains + DomainEntry + sub: 前缀 + ResolveHandler
  + $proxy_backend_addr + 域名类端点含 purge)
- 行为等价:conf/nginx.conf、Dockerfile、tests 零改动,262 回归全绿
- 方案文档 docs/plugin/PLUGINIZATION_PLAN.md
2026-09-13 11:43:22 +08:00
adminand小K 1fb83e4dda feat(admin/apix): 编辑改弹出卡片 + API 代理去「市场」概念 + 修示例地址拼接
1. LLM 上游 / API 代理的「新建 / 编辑」改为弹出卡片(IP.modal),
   列表页只留复制地址 / 测试 / 编辑 / 启停 / 删除,体验更轻。
2. API 代理彻底去「API 市场 / 平台级凭据」概念:souyi 仅作供应商之一,
   每条代理自带 base / 供应商 Key / asset_id(后端 platform 概念已移除),
   源码与文档均不再出现 souyi / AIMALL 品牌与目录直拉。
3. 修 apix.js 示例地址拼接 bug:之前末尾出现 `?q=?q=`,
   现 url 只拼一次 `?q=`、示例给出 `?q=关键词`(base 由后端返回纯基址)。

Co-Authored-By: 小K <[email protected]>
2026-09-13 10:19:33 +08:00
admin dbee9ff3fd fix(admin): 登录页因会话探测 401 被通用兜底重定向,导致自刷新死循环
登录页通过 GET /api/admin/session 探「是否已登录」,未登录时后端返回 401。
core.js 的 api() 通用兜底『401 且路径不含 /login → 跳 login.html』会把这个
本属正常的 401 也当作会话过期重定向回 login.html,形成自刷新死循环,
使未登录用户永远卡在刷新、无法进入。

修复:将 /api/admin/session 排除出通用 401 兜底(其 401 = 未登录,本就该留页)。
已逐条验证:未登录留页 / 已登录跳 overview / 后台页过期跳登录 / 其它接口 401 兜底不变。
2026-09-13 09:30:03 +08:00
admin 1f548ac953 feat(api-proxy): 新增「API 代理」板块,把外部免费 API 市场挂到网关下
后端(rust/src/apix.rs,新模块)
- /apix/<slug>?<参数> → 市场 POST /api/v1/ai/request;复用 LLM 的 sk_ 鉴权 +
  配额 + 用量统计(slot 带 api/ 前缀,天然归组)
- 请求体由网关从 query 拼:asset_id 服务端决定(调用方只能选参数),堵住
  「客户端自选最贵资产」的口子;GET 经 proxy_method POST + proxy_set_body 转带体
- data/api-proxies.json(含平台真 Key,等同 users.json 敏感度):base+key+items
  shm 写穿 ax:,停用=摘键;平台 Key 不回显(只给掩码)
- 6 个 nginx 变量 + /_apix_probe/<slug>(internal)免费预估探测,复用 $apix_probe_*

前端(www/apix.html + assets/apix.js)
- 市场凭据配置 / 目录直拉(GET /api/v1/assets,跨域已开)/ 代理增删启停 /
  复制地址 / 免费预估测试(带回平台余额)

验证
- 回归 261 条全绿(网关 102 + LLM 159,新增 34 条 apix 断言)
- 涵盖:无/坏 Key→401、不存在/停用 slug→404、GET 改写 POST、换平台 Key、
  体由网关拼、下行 Key 不泄漏、写穿 shm、探测归 api/<slug>

文档
- readme §15.1 API 代理使用 + 变更日志;CLAUDE.md location 表补 ipass_apix
2026-09-13 02:46:35 +08:00
admin c426789734 feat(admin): 用量图表(趋势/token/按人/按 API 组)+ 管理台单页拆分多页
后端
- 新增日桶 ud:/udu:/uds:(键名带日窗 id,TTL 90 天),record 记请求、
  add_tokens 记 token,两者写同一批键、字段互补;forget 同步清 udu:
- 新增 GET /api/admin/trend?days=N(默认 14、上限 90),返回图表可直接吃的
  {labels,total,users,slots},每条含 requests/in/out 三条等长数组
- util::fmt_day 供 x 轴用(%m-%d)

前端(原 www/admin.html 1100+ 行单文件)
- 拆为 login.html + overview/review/domains/users/upstreams/usage.html
- 抽出 assets/:admin.css + core.js(请求/登录守卫/外壳)+ chart.js(自绘 SVG)
- 每页 <base href="/admin/">;nginx 侧 /admin 仍进总览,/admin/ alias 到 www/
- 图表零第三方依赖(CDN 会让内网部署白屏,本地副本要塞几百 KB 进镜像)

验收
- 回归 227 条全绿(网关 102 + LLM 125)
- agent.sh verify 新增「趋势接口返回 7 天序列」作为镜像换新证据
2026-09-13 00:42:13 +08:00
admin adbd2dee61 docs(readme): §12.5 控制面自更新脚本 / §12.6 tag 表补 ipass-1.0.7 / §16 续5 变更日志 2026-09-12 18:02:34 +08:00
admin 401f9be351 feat(llm): token 计量 + 对话审计日志(10GiB 容量触发式清理)
- llm_usage.rs: body filter 旁路(FFI 注册 top_body_filter,无需额外 C 模块),
  透传 SSE 的同时抓尾部 usage chunk(OpenAI stream_options.include_usage / Anthropic message_delta),
  解析 prompt/completion tokens 写 shm utt:/utms: 键
- llm_audit.rs: log 阶段把请求体临时文件复制进审计目录(audit/ = data 兄弟目录),
  meta.jsonl 记 user/slot/status/token;10 GiB 容量阈值触发式清理,按日期目录从最旧删起
- conf/nginx.conf: LLM location 去掉 proxy_request_buffering off(它管请求体方向、
  与 SSE 无关且与 client_body_in_file_only 互斥),SSE 流式由 proxy_buffering off 保障
- stats/api: 用量接口增加 tokens 维度(today/total per user per slot)
- ipass-agent.py: 容器重建时自动挂审计卷(宿主 audit/ = data 兄弟目录,自动建目录)
- update-agent-face.sh: 控制面自更新脚本(.11 上一行命令完成下载/备份/校验/重启/自检)
- tests: LLM 117/117(+6: 审计 4 + token 2)、网关 90/90,共 207 全绿
2026-09-12 17:59:34 +08:00
admin 658356b20a feat(deploy): 控制面收敛到 deploy/agent.sh,凭据不再出现在命令行
安全策略里有一条:**可疑的 bash 命令即使已加进 permissions.allow 白名单,
仍需人工批准**(内置文档 cli/security.md「命令注入检测」)。含
`Authorization: Bearer …` / `. ./.env` / 从环境取口令的命令正好命中,表现是
每次弹「凭证授权」;被拒时命令静默无输出,看着像服务故障——本轮实测一次
`/update` 就是这样根本没发出去(/jobs 里没有新任务、镜像还是旧的)。

所以把控制面全部封进 deploy/agent.sh:凭据只从仓库根 .env 读,对外暴露的
全是无凭据子命令,只需放行 `Bash(bash deploy/agent.sh:*)`。

- status / containers / logs / data / jobs / job / raw:只读查询
- update [tag] / wait <job> / rollback [tag] / restart / pull:变更与轮询
- release <tag>:构建推送 → 更新 → 验收,一条龙
- verify:**正式环境验收** —— 登录线上管理台 → 核对页面新标记
  (布局 max-width:1100px、subdomain_rule、cdSubRoll)→ 读
  GET /api/admin/domains 确认后端 subdomain_rule 已生效。
  只看容器起来是不够的,这条才证得了「镜像真换新 + 新代码在跑」。

修一个中文项目高频坑:变量后紧跟中文标点会被并进变量名
(`$LIVE_PORT(` → 变量名 `LIVE_PORT(`)→ unbound variable;已改 ${LIVE_PORT}
并用脚本全量扫过一遍(0 处残留)。

CLAUDE.md 补「含凭据的命令不要手敲」硬约定 + 沙箱启用前必须先解决的两条
(docker 与沙箱不兼容需 excludedCommands;测试 nginx 绑 0.0.0.0 与沙箱冲突)。
readme §12.5 补 agent.sh 用法,§12.6 登记 ipass-1.0.6,§16 补本条目。
2026-09-12 16:27:30 +08:00
admin 12f20dd342 fix(admin): 管理台布局改为自适应(去掉 1180px 居中和宽度锁)
大屏上 .wrap 的 max-width:1180px 让面板只占中间一小块,右侧留大片空白、
表格被压窄。改为铺满视口,面板/表格跟着自适应。

配套给 .grid-form 限宽 1100px:面板铺满后 auto-fit 的 minmax(160px,1fr)
会把字段摊成十几列;限住表单容器宽度即可让列数自然收敛,表格不受影响。

1920 视口实测:面板 1872px / 表格 1830px(改造前 ~1132px),表单 1100px。
2026-09-12 16:11:28 +08:00
admin e14d2c6512 feat(domains): 子域名规则固化为 i + 8 位随机数 + dm
管理台「新建域名(直接放行)」的子域名不再是自由输入,改为三段拼装:
固定 i + 8 位随机数字(带「换一个」)+ 固定 dm。

- **规则真源收敛到 config.rs**(ENTERPRISE_ZONE / SUBDOMAIN_PREFIX /
  SUBDOMAIN_SUFFIX / SUBDOMAIN_RAND_DIGITS / SUBDOMAIN_GEN_ATTEMPTS),
  经 GET /api/admin/domains 的 subdomain_rule 下发给面板,前端不硬编码。
- **dm 后缀是硬约束**:conf/nginx.conf 企业域名 server 的 `^(?<subdomain>.+dm)`
  要求捕获组以 dm 结尾,否则域名建出来也匹配不上转发 server。已在
  config.rs / CLAUDE.md / readme §4 三处互标(改一处必改另一处)。
- **API 同规则**:POST /api/admin/domains/create 的 subdomain 缺省/空串即
  自动生成同形态子域名,撞车自动换号重试(最多 5 次);手填撞车直接报错。
  管理台与 API 共用 domains::create_by_admin,规则不会两处漂移。
- **域名列表点完整域名即复制**,且带端口——端口跟随调用方(location.port),
  用 :88 打开面板就复制成 …:88;view() 增 host 字段供面板渲染。
- util::rand_digits 用**拒绝采样**(只收 <250 的字节)保证 0-9 等概率;
  随机源不可用时退化 xorshift,绝不 panic(panic=abort 会打死 worker)。

回归:网关 +13 条(→90),全量 **201 条**(网关 90 + LLM 111)失败 0;
新增段覆盖规则下发 / 形态 ^i[0-9]{8}dm$ / 空串同自动 / 两次随机不同 /
手填合规 / 重复手填 400。另用真实 Chromium 实测布局、换号、非数字过滤、复制。

顺带纠正文档里偏 1 的旧条数(78→90 / 77→111),readme §16 补本条目。
2026-09-12 15:43:12 +08:00
admin 82ca6a6302 docs(claude): 新增「凭据与授权」章节
- 约定凭据唯一入口为仓库根 .env(已 gitignore),开工先 source,不再向用户索要令牌/口令/域名
- 禁止把 .env 内容打印到输出;上游厂商真 Key 不复制到本地
- 记录命令免授权白名单位置 .workbuddy/settings.local.json(本机、不入库)
2026-09-12 15:11:17 +08:00
admin f9cc76d4b4 docs: readme 登记 ipass-1.0.5(健康标记/测试按钮/复制地址)与客户端防错指引 2026-09-12 14:53:36 +08:00
admin 1b0bde9f72 feat(llm): 上游健康自动标记 + 管理台连通性测试 + 可复制 API 地址
- 健康标记(log 阶段):真实转发的上游状态码写入 uh:<slot>(4xx=活着,
  5xx/502/504=失效,下次成功自动自愈),数据来源就是真实流量本身,
  无需常驻探测进程。状态码读 $upstream_status 变量(r->upstream 在
  上游 finalize 时已置空,log 阶段读不到——access log 同款手法)。
- 管理台「测试」按钮:POST /api/admin/upstreams/test?slot=X,校验后
  ngx_http_internal_redirect 到管理 server 内部 location /_upstream_test,
  复用 LLM 链路的取 slot / 拼路径 / 换真 Key 逻辑,上游原话透传给面板。
  ⚠️ 内部重定向只浅拷贝 ngx_str_t,URI 必须拷进请求池——否则函数返回
  即悬垂,log 阶段 r->uri 全是 NUL,健康标记静默失效(实测踩坑)。
- 上游列表每行 slot 旁 OpenAI / Anthropic 两枚点击复制地址按钮,
  模型发现(/v1/models 与 /api/v1/models、/api/v1/upstreams)附
  anthropic_base_url 与健康状态;anthropic_base_url 统一收口
  upstreams::anthropic_base_url(),base 已钉 /anthropic 时不重复追加。
- 统计卡片挪进独立「数据总览」tab 并设为默认页。
- 回归 +12 条(第 12 节健康标记断言),LLM 111 + 网关 78,失败 0。
- 测试卫生:run.sh 启动靶机前 pkill 残留进程(占 18999 会造成假 200)。
2026-09-12 14:42:32 +08:00
admin b76213bebb docs(llm): 补落地记录(出站头策略 + 统一注册),并同步 readme
- docs §七:本次改造实际发出的配置、生产验收表(.11 临时挂 echo 上游)、
  反证结果(还原成改造前 → 3 条凭据断言如实变红)、统一注册的改前改后实测、
  两个副作用(路径空间放大 / base_url 变协议中立)与回退命令。
- readme:§12.6 tag 表补齐 1.0.2 / 1.0.3 / 1.0.4(这三版此前没登记);
  §15 增加提示框说明「base 写到哪一层决定 base_url 是否协议中立」及
  Anthropic 客户端必须自己补 /anthropic;§16 补本轮变更记录。
2026-09-12 12:46:42 +08:00
admin 9ebee9c96d fix(llm): 出站请求头默认不放行(allowlist),堵住网关 Key 经 x-api-key 泄漏
行业做法(LiteLLM / one-api / Higress 完全一致):**不由客户端决定**上游该收到哪些头,
而是网关按「上游需要什么」重新构造。nginx 侧对应 proxy_pass_request_headers off。

改造前实测(本机靶机 + .11 生产双确认):本块只覆写了 Authorization,客户端放在
x-api-key 里的**网关自己的 Key** 会被原样送给上游厂商,厂商可拿它反调本网关挂的
**全部**上游(横向越权)。MiniMax 两处都认,把这个缺陷掩盖成了 200。

改动:
- conf/nginx.conf 与两个测试模板:off + 凭据头显式抹空(x-api-key / api-key /
  x-goog-api-key,两层叠加,将来谁改回 on 仍兜底)+ 显式放行
  Content-Type / Accept / anthropic-version / anthropic-beta / openai-beta / User-Agent
- tests/llm/e2e.sh:+12 条断言。凭据头不泄漏、必需头存活(漏 Content-Type 会让所有
  POST 直接废)、以及 host 粒度 base 下一条记录吃 OpenAI + Anthropic 两种路径
- 反证:把模板还原成改造前状态(无 off、无抹空)重跑,3 条凭据断言如实变红(86/3),
  证明这组断言不是空转

回归:LLM 89 + 网关 78,失败 0。调研与实测证据见 docs/llm/UPSTREAM_PROTOCOL_AND_AUTH.md
2026-09-12 12:39:03 +08:00
admin 9ede90b06e docs(llm): 多协议路由与鉴权头调研(开源实现 + 官方指引 + 实测)
- LiteLLM:/anthropic/* 路径前缀路由;clean_headers 的 authenticated_with_header
  语义 + 默认摘凭据头 + 双层 allowlist + 日志/转发两副本分离
- one-api:根地址 + 路径天然区分,model 只选 channel,出站三头齐设
- Higress:Automatic Protocol Detection;v2.2.3 把按模型名宽泛匹配改成路径后缀判断
- Anthropic 官方:走网关用 ANTHROPIC_AUTH_TOKEN(发 Authorization),直连才用
  ANTHROPIC_API_KEY(发 X-Api-Key)
- 靶机改为记录全部收到的头:手挑字段会让未替换的头在回归里全绿通过

结论:协议由客户端路径表达,不需要网关分发;统一注册的实体是 base 写到 host。
鉴权头两种修法与 off 模式的必注入清单(漏 Content-Type 会让所有 POST 废)见文档。
2026-09-12 12:27:41 +08:00
admin 02601f6d33 test(llm): 靶机补记 x-api-key / anthropic-version
Anthropic 协议的鉴权头是 x-api-key,而网关当前只覆写 Authorization。
靶机原来不记录 x-api-key,导致「下游那把 sk_ 是否被原样漏给上游」
在回归里是看不见的 —— 实测已确认会漏。先让靶机把它记下来。
2026-09-12 12:15:35 +08:00
admin 2ad9ac7815 fix(admin): 上游表单的地址/密钥输入框独占整行,不再被网格压到 ~170px
问题:`.grid-form` 用 `repeat(auto-fit,minmax(160px,1fr))`,在 1180px 容器里
排成 6 列、每格仅 172px。上游地址(如 https://api.minimaxi.com/anthropic
约需 266px)与密钥(60+ 字符约需 670px)必然显示不全。

改动(www/admin.html):
- 新增 `.span-all{grid-column:1/-1}`,上游表单用 `.up-form` 收成两列:
  slot / 备注 各一列(539px),地址 / 密钥 / 模型各独占整行(1090px)
- 窄屏(≤600px)收成一列
- 地址 / 密钥输入框加 `.field-mono`(等宽字体,便于逐字符核对路径与密钥)
- 地址标签补「含路径段,如 /v1」,placeholder 换成真实在用的带路径地址
- 上游列表的地址列加 `word-break:break-all`,长地址折行而非撑破表格

实测(Playwright 无头 Chromium,1440 / 1180 / 420 三种视口):
- 地址框 1090px(可用文本 1068px)vs 需要 266px → 余量充足
- 密钥框 1090px vs 需要 673px → 完整可见(约可容纳 127 字符)
- 窄屏 420px 收成一列(330px),地址完整显示
- 上游列表表格宽 1090px < 面板 1132px,未撑破;地址单元格折行

回归:bash tests/run.sh all → 网关 78 / LLM 77 = 155 条,失败 0。
2026-09-12 12:06:09 +08:00
admin d870168ca3 docs(CLAUDE): 硬规矩补「写共享内存失败必须出声」 2026-09-12 11:48:57 +08:00