portmind.memory模块 51平台模块
平台模块Agent memory snapshots
检查智能体记住了什么，并对其记忆做一个带签名的、以 Merkle 为根的快照，使用带版本、限定工作区的存储。
portmind.memory 读写限定于智能体的记忆存储，snapshot 把其条目以 Merkle 树为根，并用该区域的账本证据包密钥将根签署为 memory-attestation。网关在每个区域都通过服务绑定访问该存储。
portmind.memory模块 51检查智能体记住了什么，并对其记忆做一个带签名的、以 Merkle 为根的快照，使用带版本、限定工作区的存储。
portmind.memory 读写限定于智能体的记忆存储，snapshot 把其条目以 Merkle 树为根，并用该区域的账本证据包密钥将根签署为 memory-attestation。网关在每个区域都通过服务绑定访问该存储。
网关将 /api/v1/portmind/* 转发到各区域中的 Portmind 运行时。记忆限定于调用方的工作区，并存储在该区域的工作区数据库中。
agentRefkeyentryentriesPOST /api/v1/portmind/memory 为 agentRef 和 key 更新插入一个条目，冲突时为其加版本，而不是悄悄覆盖。
带有 agentRef 的 将该条目作为 返回，若已被删除则返回墓碑结果。
此模块的调用会改变真实状态或访问外部服务，因此共享演示不会运行它们。请登录后在您自己的工作区中运行。 portmind.memory 文档
此模块的调用会改变真实状态或访问外部服务，因此共享演示不会运行它们。请登录后在您自己的工作区中运行。
一个符合 API 接受格式的请求，以及模块返回格式的示例响应。
GET /api/v1/portmind/memory/billing-agent Authorization: Bearer av_workspace_•••• → 200 { entry: { agentRef, key, value, contentSha256, tags, version, createdAt, updatedAt } } for one key (add ?agentRef=); 404 if no live entry. The no-key list route returns { entries }
带签名的记忆证明显示智能体的记忆在那一刻确切持有什么，而不是它现在持有什么。
运维人员删除或更新智能体记忆中的一个 key，而不是清空其整个存储，因为条目是单独寻址和加版本的。
该证明使用与账本证据包相同的区域密钥签名，因此 intramedial-verify 对照 /.well-known/ledger-bundles-keys.json 检查它，无需回调 Intramedial。
模块是对一件狭窄事情的强力保证。请仅在其确切范围内依赖它。
snapshot 返回 503 ，且不会返回任何未签名的内容。runtime/portmind 是一个 Cloudflare Worker，有自己的存储、测试和仪表盘客户端，只能通过网关的服务绑定访问。
Portmind 不属于 /api/v1/acp/* 分发系统，也没有 coordination.* 操作 ID；它是独立的 Worker，只能通过上述网关绑定访问。
单 key 路径的 URL 段指名的是记忆 key，而不是智能体 ID；智能体总是单独以 agentRef 给出。
使用工作区 API 密钥作为 Bearer 令牌进行认证。基础 URL 为 https://api.intramedial.com。
/api/v1/portmind/memory列出智能体的在用记忆条目。/api/v1/portmind/memory/:key按 key 读取一个记忆条目。
versionmerkleRootsnapshot 在那一刻对智能体当前记忆计算的根。GET /api/v1/portmind/memory/<key>entry带有 agentRef 和可选 limit 的 GET /api/v1/portmind/memory 将该智能体的每个在用条目作为 entries 返回。
POST /api/v1/portmind/snapshot 对智能体当前记忆中排序后的 {key, contentSha256} 叶子构建 Merkle 根，并将其作为带签名的 memory-attestation 返回。
{
"entry": {
"key": "billing-agent",
"agentRef": "did:web:acme.example:agent:billing",
"value": "last reconciled through invoice inv_4471",
"version": 3,
"updatedAt": "2026-10-30T08:12:00.000Z"
}
}记忆浏览器控制台直接从这个客户端读取，没有演示数据兜底，所以它显示的就是存储实际持有的内容，没有任何布置。
{ entries } 当作单 key 读取的形态。该读取返回的是单数的 entry。signing_unavailablecontentSha256 比较。entry；只有无 key 的列表读取才返回 entries。/api/v1/portmind/memory此模块没有 MCP 操作。请通过 REST 从任何智能体或程序调用它。
ledger.blame10civics.records48Public records search向记录询问某个资源发生了什么，或平实地读取工作区的事件，并按您的权限实际允许的范围涂黑。ledger-bundles.snapshot49Signed evidence bundles把工作区的审计链封存为带签名的证据包，审计师可以对照一个公开发布、任何人都能读取的密钥离线检查。remediation.blast50Blast map and remediation在撤销任何内容之前，先查看某个已声明检查点的数据触及了什么，然后只有在真人输入短语确认后，才依据它恢复。rehoming.plan52Region rehoming规划此工作区的协调记录应存放在哪里，准确查看哪些内容会迁移，然后在您自己同意时将其迁往另一个区域。exit.objectives53Exit and export读取本平台为每种数据发布的恢复时间和恢复点，并对照实际测得的结果。compliance.pack54Compliance evidence packs查看监管映射的每个控制项，以及此工作区今天究竟能为其提供什么证据、不能提供什么，无论哪种都保持列出。