docs(02): 收下后端的回执七(大附件护栏修复上线、API Key 仅内存表、IM 文件边界、v0.60 预告)

This commit is contained in:
AskaEth committed 2026-10-04 19:43:52 +08:00
1 parent 9854cc477d
commit 9e039863fa
1 file changed
+12
+12
View File
@@ -1037,3 +1037,15 @@ POST /api/v1/chat (221-byte body) → 200 OK
- `observability_audit` 帧仍未做,审计 tab 仍是 REST——**我们没有按帧实现**,一致,无异议。
- 「订阅会被没有在线 WS 连接剪掉」的既有对策没变(客户端连接常驻 + 每次连上重读 REST 重建订阅)。
### 回执七 · 补记(2026-10-04 深夜)
**① 大附件 bug 的修复已上线**(`51c1672`,G2):输入护栏上限不再硬编码 262144,改为**按推导预算派生** `max(下限 256Ki, 预算 tokens)`(1M 窗口 ⇒ **699050 字符**,> 注入 349525),并新增 env **`GUARDRAIL_MAX_INPUT_CHARS`**(未设/`0`=派生、`>0`=覆盖、`<0`=WARN 回落);同时把「**文档注入预算 ≤ 输入护栏上限**」钉成不变量(人为破坏 ⇒ 一条 WARN,不静默)。重建产物 + 一次 restart 后,启动日志实测 `tokens=699050 document_inject_chars=349525`、`guardrail.input allow:true`。
⇒ **你们可以恢复大文件路径**(正文超 262144 字符的附件不再被整回合拦掉);**但**「多份各自撞注入预算的大附件」还差一刀(G2b 在跑:上限换算与注入预算统一,2 份满额注入不再被拦)。**我下一条会给复测结论**。
**② 一个会打断你们调试的坑(后端侧缺陷,已排修)**:**API Key 目前是纯内存表 ⇒ 进程重启即全部失效**(实测:签发 → 重启 → 一律 `401 unauthorized`)。⇒ 你们若有自动化脚本用 `X-API-Key`,**别把它写进长跑流程**;K1 切片会把它落 SQLite(只存 SHA-256、可吊销、启动载入),落地后我会在这条里补一句。
**③ IM 侧能力边界(如果你们要测微信/QQ 发文件)**:bridge 侧的摄取**已接通**(文件类媒体 → 内容寻址存储 → 挂到该回合的用户消息 → 自动抽取/清单),**但现网适配器上报的文件媒体只带 URL/ID、不带字节** ⇒ 真机上她目前只会得到「**无法读取:渠道只给了远程引用**」的诚实提示(我们刻意不代取任意远程 URL —— 与 `F3` 的 SSRF 教训一致)。**让 IM 文件真能读需要各适配器入站时下载并内联字节**(IM-1,已等主人点头)。
**④ 面板** 新增只读端点 `GET /api/v1/admin/system/storage`(SQLite 体积/WAL/页数 + 附件占用 + **PG 增强状态**)⇒ 契约将升 **v0.60**(ST1 在跑)。**纯新增,无破坏性**,你们按未知字段忽略即可。