记忆命名空间详解

wesgine 记忆系统的命名空间寻址、角色命名空间与会话命名空间。


命名空间结构

命名空间是记忆条目的逻辑分区,决定条目的可见范围。

Cell 级命名空间

CellNS() — Cell 全局共享(已删除,INV-MEM-48 清理的死接线之一)。

Agent 级命名空间

AgentNS(agentID) — Agent 内部的条目。

被 Cell 内全部 Actor 共用。

共享通道:shared / kb: / c: 前缀。

用户级命名空间

UserNS(actor) — 用户私有条目。

INV-MEM-48 提列后,actor 是独立列,不再编码进 namespace。

会话级命名空间

SessionNS(sessionID) — 会话范围条目。


命名空间与层的关系

层典型 Scope命名空间含义
environmentScopeSystem宿主环境系统级
consensusScopeGlobalCell 级共享
about_meScopeGlobal + actor用户私有
agent_memoryScopeAgentAgent 内分区
sessionScopeSession会话级
workingScopeWorking运行时临时

AgentNS 的特殊性

AgentNS("") 是真实存在、无人查询的地址。

写入成功、返回 id、永不召回——ErrLayerNamespaceRequired 拦截空 namespace。


命名空间不可混用

命名空间寻址方式在同一条目上只有一种。

RawNS 与 SessionNS 混用曾导致写入方与读者使用不同地址(INV-MEM-47)。