GET /memory/counts
获取每层的记忆条目数量。键覆盖全部七层,含值为 0 的层。
GET /cells/{cellID}/memory/counts
认证
Authorization: Bearer $TOKEN
查询参数
| 参数 | 类型 | 必填 | 说明 |
|---|---|---|---|
actor | string | 否 | 指定 actor 统计。仅 admin token 有效,非 admin 一律取 token 中的 actor |
namespace | string | 否 | 按命名空间过滤统计 |
请求示例
获取当前用户的记忆计数:
curl "http://localhost:9091/cells/dept-legal/memory/counts" \
-H "Authorization: Bearer $TOKEN"
管理员查看指定用户的计数:
curl "http://localhost:9091/cells/dept-legal/memory/counts?actor=alice" \
-H "Authorization: Bearer $TOKEN"
响应
成功(200 OK)
{
"environment": 12,
"consensus": 3,
"about_me": 25,
"agent_memory": 48,
"session": 0,
"working": 0,
"unknown": 0
}
响应字段
| 字段 | 类型 | 说明 |
|---|---|---|
environment | int | 环境信息层(宿主感知器产出) |
consensus | int | 部门/Cell 级共识层 |
about_me | int | 关于我(个人偏好与事实) |
agent_memory | int | 角色记忆(按 Agent 命名空间隔离) |
session | int | 会话记忆(运行时态) |
working | int | 工作缓存(运行时态) |
unknown | int | 未识别层(引擎兜底出口) |
注意事项
- 键覆盖全部七层,包括值为 0 的层。消费方据此区分"这层是空的"和"这层不存在"——缺键会让 UI 渲染成"什么都没有",而新加的层恰好最容易缺键。
- 数字是
COUNT查询结果,不是逐页折叠的近似值。 - 计数必须与列表长度一致——不一致时用户会读作"列表被过滤了"。
错误码
| HTTP | 错误 | 说明 |
|---|---|---|
| 401 | — | Token 缺失或无效 |
| 403 | — | Token 权限不足 |
相关端点
- GET /memory — 按层列表
- POST /memory — 保存记忆
- DELETE /memory/layer — 清空指定层