四面统一:记忆/Session/观测/Cron

2026-10-08·记忆系统·Actor 边界

Actor 边界不只是记忆的事。Session 归属、观测数据、定时任务------同一个 actor 字段在四个子系统各有一面。漏守任何一面,泄漏的不一定是"数据",可能是"执行身份"。

一、一个 actor 字段,四个子系统

大多数 Agent 框架在讨论"用户隔离"时只想到记忆。但一次 Agent Run 产生的数据远不止记忆:

子系统 数据 泄漏什么
Memory 偏好、纠正、环境信息 个人隐私
Session 对话历史、消息、检查点 对话内容
Observe Run 追踪、工具调用输入/输出 文件内容、命令输出
Cron 定时任务、执行记录 执行身份(以别人身份跑代码)

四个面的严重程度不同 :Memory 泄漏的是偏好(隐私),Observe 泄漏的是文件内容(数据),Cron 泄漏的是执行身份 ------一次不查归属的定时任务触发,不是"看到了别人的配置",是以别人的身份跑代码、写进他的记忆、消耗他的配额。


二、面 1:Memory 边界

这是上一篇的主题。核心判据:

  • 读侧:ActorVisible 单点
  • 写侧:RequireActor 在 saveCore 内
  • 删除:DeleteAs(id, actor) 判与删同调用

已知的完整反模式 :组 S #310-#323 共 20 条。最高频的问题不是"逻辑错了"------是"漏调了"。三条 HTTP 写入路径曾不调 RequireActor,两处删除路径曾 fail-open(无主即放行)。


三、面 2:Session 边界(会话规则 01~03)

Session 边界的归属键曾经和 Memory 一样------藏在 Tags["actor"] 里。现在提升为 sessions.actor 独立列。

三条不变量各守一个作用域:

会话边界 守什么 怎么守
01 变更的授权面 cell:chat 而非 cell:read(会话变更 ≠ 读取)
02 归属只有一个执行点 SessionHandle.AssertActor,开在路由漏斗 dispatchCellSessionByID 而非各 handler
03 行身份是 (session_id, id) checkpoint/branch 的 SQL 必须带 session_id

Session 面最经典的 bug :assertSessionActor 这个守卫存在------只是被 12 个 handler 中的 4 个调用。漏掉的那 8 个不是随机的------它们是 checkpoint/branch 相关的路由,路径尾部带的是 checkpoint_id 或 branch_id,开发者心里想的是"我在操作 checkpoint"而不是"我在访问 session"。

更微妙的问题 :DELETE /sessions/我的/checkpoints/受害者的------归属门回答"这个 session 是你的"(正确),然后删掉了别人 session 的 checkpoint。门的回答没有错,但它只给 session 那一半作证------id 那一半是调用方给的不透明值。

修法:WHERE id = ? AND session_id = ?,而不是 WHERE id = ?。


四、面 3:观测面边界(观测规则 08~10)

这是四个面中最容易被忽略的 ------因为"观测"听起来像元数据。但 tool_calls.input/output 是文件内容、命令输出、检索命中,work_dir 是目录结构。

核心陷阱:空 actor 是合法值。

在记忆和 Session 面,空 actor 通常意味着"忘了填"或"数据错误"。在观测面,空 actor 是 admin 跨 actor 管理视图------运维需要看所有人的 Run。

于是漏传一个参数不是编译错误、不是运行时错误、不返回空集------它返回一次可用的越权读取,症状与"功能正常"同形。

三条不变量:

观测边界 守什么 关键设计
08 查询过滤 三层单点(SQL actorClause / 公共 API actor string 首参 / 请求边界 actorFromRequestOrContext)
09 证据链不过滤 /evidence 和 /audit 抬作用域到 cell:admin------证据链是 hash chain,切片后缺环无法校验
10 事件流也要守 事件先进 per-Run 内存环再进表,只守 SQL 等于把最新最全的一份留在门外

观测面独特的测试要求 :必须成对断言"bob 看不到 alice 的"和"管理视图两个都看得到"。如果只断言前者,一个永远返回零行的坏查询同样通过测试。


五、面 4:Cron 执行身份边界(定时规则 10)

Cron 是四个面中最危险的------泄漏的不是数据,是执行身份。

executeJob 把 entry.Actor 抄进 JobRequest------job 以所有者身份跑。一次不查主的 Trigger 不是"改了别人的配置",是以别人的身份跑代码:写进他的记忆、消耗他的配额、在他的账上留下 Run 记录。

Cron 面不接受"先列出来再判断"的实现形状------判据必须在取出 job 的那一步:

bash 复制代码
// Manager 每个方法都收 actor
func (m *Manager) Trigger(ctx, id, actor) error {
    job := m.ownedJob(id, actor)  // 行身份 (id, actor)
    if job == nil { return ErrJobNotFound }
    // ...
}

升级面最诡异的形状 :actor 列是 DEFAULT '' 加的。升级前写入的每一行都无主。读侧 fail-closed 但 ListDue 不带 actor(它是调度器的内部函数,需要知道"哪些 job 该跑了")。

于是这些无主 job:

  • UI 列不出(读侧 fail-closed)
  • by-ID 全返回 ErrJobNotFound(停不掉、删不掉、改不掉)
  • 却每到点照跑照发消息 (ListDue 不过滤)
  • 派出的 Run 因 actor 为空又只有 admin 看得见

"能跑、关不掉、查不到"比"看不到"坏得多。 修法是一次性认领(ClaimOwnerless),但只给单 actor 部署用------多 actor Cell 盲调等于把某员工的任务判给另一个人。


六、四面统一的设计原则

原则 说明 对应
判据只有一处 每个面一个 Visible 函数,不在查询路径里手写 actor == x 记忆规则 39 / 观测规则 10
写侧在最深处守 不靠调用方"记得检查",在汇聚点强制 记忆规则 38 / 定时规则 10
无主 = 隐藏,不是"公共" 没有 owner 意味着 actor 在某处没被传下去,不意味着属于每个人 观测规则 10 / 定时规则 10
不存在与不属于你同返 区分两者就是存在性预言机------敌手不需要知道"那条数据确实在" 记忆规则 53 / 会话规则 03
空 actor 是 admin 特权 非 admin 路径解析不出 actor 一律 403,不得翻译成"看全部" 观测规则 08

七、行业对比:谁考虑了多面隔离

方案 记忆隔离 Session 隔离 观测隔离 Cron 隔离
Mem0 ✅ user_id scope ❌ 无 Session 概念 ❌ 无观测 ❌ 无 Cron
LangGraph ✅ namespace ✅ thread_id ❌ 无内建观测 ❌ 无 Cron
Letta ✅ Agent 级 ✅ 会话级 ❌ ❌
OpenAI Agents ✅ MemoryLayoutConfig ✅ Session 部分 ❌
AWS AgentCore ✅ IAM 部分 部分 ❌
MUXI ✅ RLS ✅ user_id 绑定 ❌ ❌
Agentium ✅ 多级 scope ✅ session-scoped 部分(决策日志) ❌
引擎 ✅ actor 列 ✅ actor 列 ✅ actorClause ✅ ownedJob

大多数框架只守了记忆这一面。Session 隔离有一半的框架做了(但通常是 thread_id 而非认证后的 user_id)。观测和 Cron 的 actor 隔离几乎只有 引擎 在做------不是因为它不重要,是因为大多数框架还没有内建的 Cron 和结构化观测。


八、小结

面 泄漏什么 最经典的 bug 修法
Memory 个人偏好/纠正 三条 HTTP 写入路径不调 RequireActor saveCore 单点
Session 对话历史 checkpoint DELETE 不带 session_id WHERE (id, session_id)
Observe 文件内容/命令输出 空 actor = 合法的跨 actor 视图 actorFromRequestOrContext 单点
Cron 执行身份 无主 job 到点照跑 ownedJob + ClaimOwnerless

一句话:Actor 边界是同一条规则在四个子系统的投影。只守记忆那一面,等于门只锁了前门。



八、常见误区

误区 1:"记忆面守住了,其他三面自然安全"

❌ 四面的数据敏感度不同。观测面的 tool_calls.input/output 包含文件内容和命令输出 ------比记忆面的偏好/纠正更敏感。Cron 面泄漏的是执行身份------不是"看到了别人的数据",是"以别人身份跑了代码"。

误区 2:"Session 面只需要检查会话归属------不需要检查 checkpoint/branch 行身份"

❌ DELETE /sessions/我的/checkpoints/受害者的 通过归属门("这个 session 是你的"=正确),但删除了别人的 checkpoint------因为 WHERE id = ? 只看 checkpoint id 不看 session id。行身份必须是 (session_id, id)。

误区 3:"观测数据是元数据------不需要 actor 过滤"

❌ tool_calls.input 包含 exec 工具的命令参数、read 工具返回的文件内容、grep 的匹配结果。这些不是"元数据"------是实际的用户数据。GET /observe/runs 曾按 Cell 全量返回所有人的 Run 轨迹。

参考

  • 记忆规则 38~47(记忆面 Actor 边界)
  • 会话规则 01~03(Session 面 Actor 边界)
  • 观测规则 08~10(观测面 Actor 边界)
  • Cron 执行身份边界
  • 反模式组 S #310-#323(记忆面 20 条)、组 T #330-#337(Session 面 8 条)、组 U #340-#351(观测面 12 条)、组 V #352-#359(Cron 面 8 条)
相关推荐
货拉拉技术14 分钟前
AI Agent 如何进入实时交易系统:货拉拉的三个实践与一套工程方法论
后端·架构·agent
qinglongcn20 分钟前
从 metadata 键到独立列
agent·ai编程
YanisJiang1 小时前
别只把 AI 聊天当成「又一个网页」:把状态驱动的陪伴内核接到你自己的项目里
ai编程
小龙66661 小时前
给 Agent 一张地图,而不是一座迷宫:前端 monorepo 目录结构重构实录
前端·agent
樊小肆1 小时前
agent 不报错才最吓人:自研编码工具半年,我踩了 10 个"看着正常"的运行时坑
前端·人工智能·agent
Jvav练习生1 小时前
别再让Agent互相传话:多Agent协作的3个致命错误(附120行可运行代码)
agent
谙弆悕博士3 小时前
多智能体架构详解:黑板共享架构(共享存储交互型)
人工智能·架构·大模型·agent·多智能体·黑板架构·anggraph
AI入职记3 小时前
RAG 一个请求吃掉 8 个核,chat 只要 0.16 个
后端·ai编程
后端小肥肠3 小时前
公众号里流量很夯的漫画赛道:趣味漫画创作全拆解
人工智能·aigc·agent