docs(readme): 补 1.0.21/1.0.22 变更记录
- 1.0.21: passthrough 新建可空 Key(upsert 按 mode 放宽校验) - 1.0.22: usage_hint 字段,/api/v1/me 把调用语法下发给用户 AI
This commit is contained in:
1 parent
26a0f2f4f4
commit
3635b18797
2 files changed
+8
-3
No files matched your search
@@ -811,7 +811,9 @@ DRY_RUN=1 bash deploy/release.sh 1.0.3 # 只构建不推送
|
||||
| `ipass-1.0.17` | **备份路径迁 `~/ipass/backup/` + 删 `rollback-*` 本地标签**。commit `6b8d694`。 |
|
||||
| `ipass-1.0.18` | **运行期统计落盘 / 重启恢复 + 审计口径收口**。worker 退出钩子 + 周期落盘(默认 60s)双保险 → `data/llm-stats.json`;恢复 put-if-absent 跨 worker 幂等。**新增统计前缀必须同步 `stats_persist::PREFIXES`**(漏一处 → 该列发版后从 0 起算)。审计改只追加 `meta.jsonl`(不再复制完整 body),`excerpt` = 前 100 字节,`body_hash` = 全文 SHA256 前 16 hex;`AUDIT_MAX_BYTES` 10GB→1GB。回归 292 条全绿(网关 102 + LLM 190)。commit `16cf68d`。 |
|
||||
| `ipass-1.0.19` | **「上次落盘/恢复」记录移入共享内存**(`spr:`/`spd:`)—— 1.0.18 把它放在进程内静态量上,落到哪个 worker 报哪个数,「日志里明明发生了 N 次、状态页报 0」踩过两次。commit `1bc316e`。 |
|
||||
| `ipass-1.0.20` | **apix 透传模式 passthrough —— 通用内部 REST 出口**。vendor 模式假设单一供应商收口 + 网关拼体,OCR / 文生图 / TTS 这类多端点多 body 的内部服务接不进来。passthrough 走独立 `/apixp/` location(不施加 vendor 强约束,方法/请求体/Content-Type 原样透传,含 multipart),上游路径 = base + `/apixp/<slug>` 之后的 URI 尾部(含 query 由模块拼),Key 可空(内部服务免鉴权)。模型加 `mode` 字段(默认 vendor,旧数据零迁移);shm payload 4 字段 `base\nkey\nasset_id\nmode`;handler 校验「路径前缀 vs mode」一致(vendor slug 走 `/apixp/` → 404,反之亦然);探测按 mode 分流(vendor POST 预估 / passthrough GET 打上游根);鉴权仍走同一把 `sk_` + 配额 + 用量统计(slot 前缀 `api/<slug>`,passthrough 同样计)。真源 `docs/apix/PASSTHROUGH_MODE.md`。回归 327 条全绿(网关 102 + LLM 225,§11.6 新增 35 条)。commit `4533db8`,digest `ff34f7ef…`。
|
||||
| `ipass-1.0.20` | **apix 透传模式 passthrough —— 通用内部 REST 出口**。vendor 模式假设单一供应商收口 + 网关拼体,OCR / 文生图 / TTS 这类多端点多 body 的内部服务接不进来。passthrough 走独立 `/apixp/` location(不施加 vendor 强约束,方法/请求体/Content-Type 原样透传,含 multipart),上游路径 = base + `/apixp/<slug>` 之后的 URI 尾部(含 query 由模块拼),Key 可空(内部服务免鉴权)。模型加 `mode` 字段(默认 vendor,旧数据零迁移);shm payload 4 字段 `base\nkey\nasset_id\nmode`;handler 校验「路径前缀 vs mode」一致(vendor slug 走 `/apixp/` → 404,反之亦然);探测按 mode 分流(vendor POST 预估 / passthrough GET 打上游根);鉴权仍走同一把 `sk_` + 配额 + 用量统计(slot 前缀 `api/<slug>`,passthrough 同样计)。真源 `docs/apix/PASSTHROUGH_MODE.md`。回归 327 条全绿(网关 102 + LLM 225,§11.6 新增 35 条)。commit `4533db8`,digest `ff34f7ef…`。 |
|
||||
| `ipass-1.0.21` | **fix(apix): passthrough 新建可空 Key**。1.0.20 现场踩坑:`upsert` 统一要求「基址与密钥」,但 passthrough 设计是 Key 可空(handler 已放行),管理台提交 passthrough + 空 Key 直接 400。修:vendor 必须 base + key 都填;passthrough 仅 base 必填,key 可空。补 2 条断言防回归。commit `d05ebfb`,digest `f1087cf2…`。 |
|
||||
| `ipass-1.0.22` | **feat(apix): `usage_hint` 字段 —— 让用户 AI 自己知道怎么调**。`/api/v1/me` 把账号能力目录下发给用户 AI 后,AI 必须能自己拼出调用语法(路径尾部 / Content-Type / 字段名 / Swagger)。`desc` 是中文给运维看的,`params` 只对 vendor 有意义,对 passthrough 是空数组——AI 拿到后不知怎么调。加 `usage_hint` 字段:管理员按 OpenAPI 风格填自由文本(截断 1KB),由 `/api/v1/me` 原样透传给用户 AI。**不进 shm**(热路径只查 base/key/asset_id/mode,进 shm 占带宽)。真源 `docs/apix/PASSTHROUGH_MODE.md` §3「`/api/v1/me` 用法」。commit `26a0f2f`,digest `8bb81353…`。 |
|
||||
|
||||
---
|
||||
|
||||
|
||||
+5
-2
@@ -420,12 +420,15 @@ ck "★趋势含 api/<slug> 维度" yes "$(curl -s -b "$JAR" "$API/api/admin/tre
|
||||
ck "★usage_hint 写入与回显(1.0.22 能力目录 hint)" yes \
|
||||
"$(curl -s -b "$JAR" -X POST $API/api/admin/apix/save \
|
||||
-H 'Content-Type: application/json' \
|
||||
-d "$(jbody slug med asset_id asset_26476ef1-4687-45 usage_hint 'POST /<tail> multipart fields=[file]; POST /<tail>/base64 json {image_base64:string}')" >/dev/null; \
|
||||
-d "$(jbody slug hintsrc asset_id asset_hint_26476ef1 base http://127.0.0.1:18999 key ak_test_supplier_key usage_hint 'POST /<tail> multipart fields=[file]; POST /<tail>/base64 json {image_base64:string}; Swagger: http://x/docs')" >/dev/null; \
|
||||
curl -s -b "$JAR" $API/api/admin/apix | "$PY" -c '
|
||||
import sys, json
|
||||
d = json.load(sys.stdin)
|
||||
it = next((x for x in d["data"]["items"] if x["slug"] == "med"), None)
|
||||
it = next((x for x in d["data"]["items"] if x["slug"] == "hintsrc"), None)
|
||||
print("yes" if it and "POST /<tail>" in it.get("usage_hint","") else "no")')"
|
||||
# 清理
|
||||
curl -s -b "$JAR" -X POST $API/api/admin/apix/delete -H 'Content-Type: application/json' \
|
||||
-d "$(jbody slug hintsrc)" >/dev/null
|
||||
|
||||
echo
|
||||
echo "【11.6】★ API 代理透传模式(/apixp/<slug>/<尾部> → 内部 REST 服务)"
|
||||
|
||||
Reference in new issue
Block a user