Skip to main content
POST
创建记忆

路径参数

id
string
必填

记忆库 ID。

Pattern: ^mstr_[0-9a-hjkmnp-tv-z]{26}$

请求体

application/json

创建记忆文件的请求体。

path
string
必填

文件的相对 POSIX 路径,最长 900 UTF-8 字节。路径会被严格校验、绝不静默改写:绝对路径、反斜杠、百分号编码、空段或 ./.. 段、控制字符,以及任何未规范化的值(例如 a/../ba//b)都会被拒绝。

Required string length: 1 - 900
content
string

文件内容,base64 编码,解码后不超过 20 MiB。缺省或为空时创建空文件。

响应

已创建的文件,携带其内容与哈希。

记忆库中的一个文件。

id 在重命名后保持不变。删除文件后,其 ID 和版本历史仍可读取。

id
string
必填

记忆文件 ID。文件重命名时保持不变。

Pattern: ^mem_[0-9a-hjkmnp-tv-z]{26}$
memory_store_id
string
必填

所属记忆库的 ID。

Pattern: ^mstr_[0-9a-hjkmnp-tv-z]{26}$
path
string
必填

相对于记忆库根目录的路径。

content_sha256
string
必填

解码后内容的 SHA-256 哈希。更新时回传用作乐观并发检查。

content_size_bytes
integer<int64>
必填

解码后内容的大小,单位为字节。

created_at
string<date-time>
必填

创建时间戳。

updated_at
string<date-time>
必填

最近一次内容或路径更新的时间戳。

content
string

文件内容,经 base64 编码。在创建/获取/更新响应中存在。列表响应中省略。该字段存在与否可区分空文件与内容未加载两种情况。