记忆命名空间详解
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 | 命名空间含义 |
|---|---|---|
| environment | ScopeSystem | 宿主环境系统级 |
| consensus | ScopeGlobal | Cell 级共享 |
| about_me | ScopeGlobal + actor | 用户私有 |
| agent_memory | ScopeAgent | Agent 内分区 |
| session | ScopeSession | 会话级 |
| working | ScopeWorking | 运行时临时 |
AgentNS 的特殊性
AgentNS("") 是真实存在、无人查询的地址。
写入成功、返回 id、永不召回——ErrLayerNamespaceRequired 拦截空 namespace。
命名空间不可混用
命名空间寻址方式在同一条目上只有一种。
RawNS 与 SessionNS 混用曾导致写入方与读者使用不同地址(INV-MEM-47)。