> ## Documentation Index
> Fetch the complete documentation index at: https://docs.qoder.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Memory Store 数据结构

> Memory Store、Memory 和 Memory Version 的对象结构。

## Memory Store 对象

| 字段            | 类型             | 说明                                                     |
| ------------- | -------------- | ------------------------------------------------------ |
| `id`          | string         | Memory Store ID，前缀为 `memstore_`                        |
| `type`        | string         | 固定值 `"memory_store"`                                   |
| `name`        | string         | Store 名称                                               |
| `description` | string         | Store 描述，未设置时为空字符串                                     |
| `status`      | string         | Store 状态，见 [Memory Store status](#memory-store-status) |
| `entry_count` | integer        | Store 内活跃 memory 数量                                    |
| `total_size`  | integer        | Store 内活跃 memory 内容总大小，单位 byte                         |
| `metadata`    | object         | 自定义键值元数据                                               |
| `archived_at` | string \| null | UTC 归档时间，未归档时为 `null`                                  |
| `created_at`  | string         | RFC 3339 创建时间                                          |
| `updated_at`  | string         | RFC 3339 最后更新时间                                        |

## Memory Store status

| 值          | 说明                                   |
| ---------- | ------------------------------------ |
| `active`   | 可以创建和更新 memory                       |
| `archived` | memory 与 version 可读取，但不能创建或更新 memory |

## Memory 对象

| 字段                   | 类型      | 说明                           |
| -------------------- | ------- | ---------------------------- |
| `id`                 | string  | Memory ID，前缀为 `mem_`         |
| `type`               | string  | 固定值 `"memory"`               |
| `memory_store_id`    | string  | 所属 Memory Store ID           |
| `path`               | string  | Memory 路径                    |
| `content_size_bytes` | integer | 内容大小，单位 byte                 |
| `content_sha256`     | string  | 内容的 SHA-256 摘要               |
| `version`            | integer | 当前版本，初始为 `1`，每次更新自动递增        |
| `metadata`           | object  | 自定义键值元数据                     |
| `content`            | string  | 完整内容，仅在创建、更新和单条查询时返回，列表响应不返回 |
| `created_at`         | string  | RFC 3339 创建时间                |
| `updated_at`         | string  | RFC 3339 最后更新时间              |

## Memory Version 对象

| 字段                   | 类型      | 说明                                                           |
| -------------------- | ------- | ------------------------------------------------------------ |
| `id`                 | string  | Memory Version ID，前缀为 `memver_`                              |
| `type`               | string  | 固定值 `"memory_version"`                                       |
| `memory_store_id`    | string  | 所属 Memory Store ID                                           |
| `memory_id`          | string  | 所属 Memory ID                                                 |
| `path`               | string  | 记录该版本时的 memory 路径                                            |
| `content_size_bytes` | integer | 版本内容大小，单位 byte                                               |
| `content_sha256`     | string  | 版本内容的 SHA-256 摘要                                             |
| `operation`          | string  | 版本动作，见 [Memory Version operation](#memory-version-operation) |
| `redacted`           | boolean | 版本内容是否已 redact                                               |
| `redacted_at`        | string  | RFC 3339 redact 时间，仅 `redacted` 为 `true` 时返回                 |
| `content`            | string  | 版本内容，仅在单条查询且未 redact 时返回                                     |
| `created_at`         | string  | RFC 3339 创建时间                                                |

## Memory Version operation

| 值         | 说明                           |
| --------- | ---------------------------- |
| `created` | memory 被创建                   |
| `updated` | memory 内容被更新                 |
| `deleted` | memory 被删除（记录为 tombstone 版本） |