 adminandClaude Opus 5.5
|
5df7ca1076
|
docs(gateway): 更正扫描线程「必须在 worker 期 spawn」的理由
共享内存是 MAP_SHARED 映射,锁字是共享的而不是 fork 时复制的 ⇒ 子进程不会
「继承一份私有副本的已锁状态」。真正的理由是 .so 数据段里的 Rust OnceLock
在 fork 时是私有副本 ⇒ master 期 spawn 会让每个 worker 都命中「已初始化」
而根本不起线程。结论不变(仍必须 worker 期 spawn)。
Co-Authored-By: Claude Opus 5.5 <[email protected]>
|
2026-11-11 01:34:01 +08:00 |
|
 adminandClaude Code
|
fe32751d92
|
feat(gateway): 启用 users.json 后台重载扫描线程
Co-Authored-By: Claude Code <[email protected]>
|
2026-11-10 20:32:48 +08:00 |
|
admin
|
fea806eb33
|
chore: 本机路径迁到 ~/Documents/ipass,修正 ngxbuild 多余的 build/ 段
conf/nginx.conf 的 dev root/alias 与 tests/run.sh 的 NGINX_BIN/NGINX_BUILD_DIR
从 Desktop/workspace/iPass 迁到 Documents/ipass;ngxbuild 在仓顶层,
原写法 build/ngxbuild 指向不存在的路径,默认启动会找不到 nginx 二进制。
|
2026-11-04 10:43:05 +08:00 |
|
 adminandClaude Opus 4.8
|
359a67b657
|
feat(gateway): wire plugin toggle (load+set_current+dispatch skip); short-name config keys (R19)
- postconfiguration loads <data_dir>/plugin-config.json into registry
- disabled plugins claim no /api routes (404 fallback); core never skipped
- data-seed keys + admin_prefix now Plugin::name() short names
- collect-plugin-dist.sh: normalize keys, resolve ipass-plugin-<short> dirs,
emit <short>-admin.umd.js alias matching loader.ts protocol
Co-Authored-By: Claude Opus 4.8 <[email protected]>
wave-4-final
|
2026-09-24 20:05:48 +08:00 |
|
 adminandClaude Opus 4.8
|
bf2528de0f
|
refactor: depend on ../ipass-plugin-{domain,llm,apix} + ../ipass-core; strip local copies
Ruling 16:删除危险的 /static/plugins alias(暴露整个 workspace 根,含各仓
data/*.json),改为 scripts/collect-plugin-dist.sh 收集 core 壳与各启用插件
www dist 进 build/{shell,static-plugins}(build/ 已 gitignore),conf 与
tests 模板同构改指收集目录。www/*.html 多页管理台删除后由 ipass-core 壳接管。
deploy/data-seed/plugin-config.json 种子三插件配置(tracked)。
Co-Authored-By: Claude Opus 4.8 <[email protected]>
wave-3-done
|
2026-09-24 18:34:32 +08:00 |
|
 adminandClaude Opus 4.8
|
67e0953dff
|
fix(deploy): 修正 Gitea 仓库路径 ssw/ipass → ipass/ipass
update-agent-face.sh 与 readme.md 的 192.168.1.18:13300/raw 路径
一直写成 /ssw/ipass,实际仓库已迁移到 /ipass/ipass,需同步修正。
Co-Authored-By: Claude Opus 4.8 <[email protected]>
|
2026-09-24 16:23:39 +08:00 |
|
admin
|
9c46e27eb5
|
fix(vendor): 入库 nginx-sys/build/ 两份手摆件,解开 .gitignore 对它的误拦
|
2026-09-21 13:36:56 +08:00 |
|
admin
|
51f322e983
|
chore(release): 默认 tag → ipass-1.1.3
ipass-1.1.3
|
2026-09-18 12:56:25 +08:00 |
|
admin
|
8ca3fbec15
|
fix(admin): 面板 LLM 上游编辑 body marker 字段保存 (1.1.3)
bug:面板「额度耗尽 → 响应体标记」输入框填了值点保存,后端落不进数据。
原 因:core.js 的 IP.api() 用 application/json + JSON.stringify(body) 提交;
upstreams.js 给 payload.exhaust_markers 赋的是 JS 数组
(mk.split(',').map(...)),序列化后 body 里是 JSON 数组;
但 ipass-core/src/http.rs 的 http::params() 看 application/json 时,
serde_json::from_slice 后只接 Value::String/Number/Bool,Array/Object
走 match _ => continue 静默丢弃 —— 数组根本没进 HashMap,upsert 当作
「未传该项」,旧值([])保留。
对照:exhaust_status(frontend 赋成字符串)能保存是因为后端 match 拿到
Value::String;accounts(显式 JSON.stringify)也能保存。唯独
exhaust_markers 漏了 stringify。
修:跟 accounts 一致,前端 JSON.stringify 一层。
副作用:
- 前端 JSON 序列化的字符串里含嵌入的 " 仍由 serde_json::from_str::<Vec<String>>
正确处理(测试用 "status_code":1008 这种带引号子串是常见配法)。
- 此 commit 改 www/,需要重出镜像才能生效(前端随镜像分发,不走热同步)。
回归:无可在 bash e2e 跑的薄壳面板(无 JS runner),靠人工面板验证:
编辑 minimax,响应体标记输入 "status_code":1008,保存后
bash deploy/agent.sh upstreams 应能看到 markers="status_code":1008。
|
2026-09-18 12:54:58 +08:00 |
|
admin
|
5f559bf71a
|
chore(release): 默认 tag → ipass-1.1.2
|
2026-09-18 12:13:06 +08:00 |
|
admin
|
7b83646369
|
chore(deploy): cmd_upstreams 耗尽判定回显改用单数键 exhaust_status
view() 的字段名是 exhaust_status,之前 cmd_upstreams 拼成 exhaust_statuses,
导致所有 slot 的 markers/statuses 都显示成「-」假空——排查 minimax 整池冷却
事故时,这条假空线索让 agent 视角看不到「默认 [402,429,403]」才是真凶。
只动 agent.sh 显示拼装,不影响二进制行为;以后 cmd_upstreams 现在能如实回显
任何 slot 的 effective 状态码 + marker 列表(配合 mark_exhausted / read_upe 的
实义),便于定位误标事故的第一现场。
|
2026-09-18 12:10:55 +08:00 |
|
admin
|
f179e6e987
|
fix(llm): is_probe 跳过 mark_exhausted/bump,只留 mark_health (1.1.2)
线上事故回归:面板「测试」按钮走 /_upstream_test 真实转发,账号由 pick 随机
选;上游一旦回耗尽形态(状态码命中 upe 或 body 命中 marker),旧逻辑会把
「管理员手抖点测试」当成「账号额度耗尽」冷却一把好钥匙,恢复要走完整退避/
探测。13:50 一次面板测试轮把 minimax 三把好 key 全部点进冷却,整池不可用。
* handlers.rs LlmHealthHandler:is_probe URI 前缀请求**不写冷却/耗尽**;只
跑 mark_health(健康展示仍需)。2xx clear_cool 保留——测试成功 = 该账号此刻
健康,是正向证据。bump_acct_load 保留(测试也是真转发,统计有用)。
* tests/llm/e2e.sh:新增「管理台测试按钮不得写路由状态」剧本,6 条断言;
fixture probetest 单账号 Bearer probe-dead + exhaust_status=[401] +
markers 一并命中——status 通道 + body 通道都能触发,真实分流修复前 cool
必须为 true,修复后为 false;真实流量同时仍正常冷却(不能为避 bug 把真标记
也关掉)。
* tests/llm/fixtures/llm-upstreams.json:加 probetest 槽位(同形 401+marker)。
回归:bash tests/run.sh llm → 270/0 全绿(原 262 + 8)。
|
2026-09-18 12:10:33 +08:00 |
|
admin
|
6081151410
|
fix(release): 发版链路三处缺陷(1.1.1 发版误回滚暴露)
1. me_catalog.py 把 .env 约定的**裸主机名**当完整 URL 用:release 里
agent.sh source .env 后子进程继承,live_check 两步探针 ValueError 崩退 1,
被三态口径判成「网关侧故障」触发自动回滚(1.1.1 实测,健康版本差点被回)。
现在补 scheme + IPASS_PUBLIC_PORT;探针脚本未捕获异常统一退 2(验证不可用),
崩溃永远不该触发回滚。
2. rollback 参数键位漂移:远端控制面对 release 发的 {"tag":...} 报「需要显式传
tag」→ 自动回滚 job 失败。agent.sh 的 rollback/回滚体改 python 拼 JSON 并
tag/image 双写;ipass-agent 1.0.4 的 op_rollback 两种键都认、短 tag/裸版本
用受管容器仓库段补全;release 版本闸门抬到 1.0.4(自动回滚必须先证明可用)。
3. 线上默认 tag 迁出 .env → deploy/image.conf(非秘密、入库):release 成功
自动回写 + commit,不再需要人肉同步;.env 的 IPASS_IMAGE_TAG 仅临时覆盖。
另修 agent.sh upstream-test:旧契约(slot 塞 body、无探测体)换成面板同款
(query slot + 第一个登记模型),实测 minimax 200。
|
2026-09-17 18:52:22 +08:00 |
|
admin
|
eae2063bef
|
fix(llm): 探测通道删掉 proxy_set_body 注入体,恢复「探测体原样转发」
面板「测试」报 minimax unknown model 'test' (2013) 的根因:1.0.43 为当时的
空 body 探测兜底,在 conf/nginx.conf 的 /_upstream_test/ 注入了 model=test 的
最小 dummy 体;而 nginx proxy_set_body 是无条件覆盖——把面板发来的「第一个
登记模型」探测体整个换掉,严格校验模型名的厂商一律误报「不通」(健康徽章因
4xx 算存活仍显示正常,二者口径不一致)。测试模板本就无此行,所以本机回归全绿
——典型的 conf/模板漂移,本次连 gateway 模板里同款遗留一并清掉。
- conf/nginx.conf + tests/gateway/nginx.conf.in:删注入行,注释改写成「别加回来」的告诫
- tests/llm/e2e.sh【11】:动态闸(探测体原样到靶机)+ 静态闸(生产 conf 探测块禁 proxy_set_body)
- CLAUDE.md 排障表补一行
llm 264 / gateway 108 全绿
|
2026-09-17 18:22:31 +08:00 |
|
admin
|
6bb8c3f158
|
fix(agent): rollback 停容器**前**预检备份(1.0.3)
restore_backup 的路径/存在性/tar 可读性校验抽成 check_backup,放在 docker stop
之前——stop 是手工停止(restart policy 不救),原来若备份坏了会停在
「容器已停 + 数据未恢复」干等人工,比不回滚还糟。预检不过直接失败、容器不动。
restore_data 单测 + check_backup 越界/不存在两拒绝路径实测通过。
|
2026-09-17 08:50:38 +08:00 |
|
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 |
|