fix(agent): 会话作用域拒绝时说明 session_id 从哪来 —— 独立 MCP 宿主的实测卡点
## 触发它的实测 跑「独立 MCP 宿主 E2E」时,第一版客户端卡在这里: 它收到了 new_mail 事件、**知道该读那封信**,却不知道该传什么 session_id, 于是一封信都读不到,报的是「这封信不在你当前所在的那条会话里」。 ## 原文案缺的那半句 原文案说「要读它,就在它那条会话里读」—— 只说了**去哪读**, 没说**怎么去读**(id 从哪来)。缺的那句正是接入端唯一缺的信息。 实测依据:new_mail 事件的 payload 有 16 个键,含 `session_id` / `session_alias` / `mail_id`;桥侧另有 `GET /api/v1/agent/session/default` 可查默认会话。 ## 安全边界未动 ★ 只报**调用方自己所在的会话**(`self`),绝不把目标会话 id 拼进文案 —— 那是 2026-09-15 用户订正过的语义(原文案刻意不提目标会话,避免泄露别人的会话)。 判据第③条专门盯这一点。 ## 判据自己踩了两个坑(与「变异必须确认真的应用」同族) 1. **变异一度删掉了 490 行** —— 循环没写终止条件,从提示那行一路删到文件末尾。 备份救回(608 行完好)。 2. **判据窗口取太宽导致假绿** —— 初版按「文案起点 + 2200 字符」截取,而 **同一文件别处的文档注释**里也写了 `/agent/session/default`(agentScope 上方的说明) ⇒ 删掉提示后窗口里仍有它 ⇒ 判据绿。 修法:按**单条 Error(...) 调用**取段,不按固定窗口。 ★ 这两个坑的共同教训:**「变异应用了」≠「判据看到了正确的范围」**。 变异一次"没生效"(我以为代码没问题)、一次"生效了但判据看错范围"(我以为判据有效) —— 两种都表现为 0 红。 **「0 红」的第一反应必须是「变异或判据有一方错了」。** 14 包全绿。
This commit is contained in:
@ -105,7 +105,18 @@ func canReadSession(w http.ResponseWriter, r *http.Request, agentName string, sc
|
||||
Error(w, http.StatusForbidden,
|
||||
"这封信不在你当前所在的那条会话里:每个会话各有各的收件箱(会话之间的记忆是隔离的)。"+
|
||||
"你当前在会话 "+self+"。要读它,就在它那条会话里读 —— 每封来信都会把 worker 唤醒到"+
|
||||
"它自己那条会话上,那时你看到的就是那条会话的收件箱。")
|
||||
"它自己那条会话上,那时你看到的就是那条会话的收件箱。"+
|
||||
// ★ 2026-10-04 补:调用方多半是**拿不到**目标会话 id,而不是
|
||||
// 「知道却不传」。原来那句「就在它那条会话里读」只说了去哪读,
|
||||
// 没说 id 从哪来 —— 实测(独立 MCP 宿主 E2E)第一版客户端就卡在
|
||||
// 这里:拿到 new_mail 事件、知道该读,却不知道该传什么,于是一封
|
||||
// 信都读不到。
|
||||
//
|
||||
// id 就在**那封信的事件载荷**里:new_mail 的 payload 带 session_id
|
||||
// (实测 16 个键,含 session_id / session_alias / mail_id)。
|
||||
// 桥侧另有 GET /api/v1/agent/session/default 可查默认会话。
|
||||
" 目标会话 id 在 new_mail 事件的 payload 里(session_id 字段);"+
|
||||
"没有事件时可查 GET /api/v1/agent/session/default。")
|
||||
default:
|
||||
Error(w, http.StatusForbidden, "无权访问该会话")
|
||||
}
|
||||
|
||||
Reference in New Issue
Block a user