REST API 参考

API 基础地址：

http://127.0.0.1:3000

认证

当前 /v1 路由支持两种认证方式：

本地开发最快的方式是：

POST /v1/dashboard/auth/login

旧示例中出现的 /api/v1/*、/v1/memories、/v1/search 或 /health 都来自更早的产品模型，不应再用于当前集成。

Method	Endpoint	用途
`POST`	`/v1/dashboard/auth/login`	获取 dashboard JWT token

Method	Endpoint	用途
`POST`	`/v1/users/:user_id/streams/:stream_id/events`	写入单个事件
`POST`	`/v1/users/:user_id/streams/:stream_id/events/batch`	批量写入事件
`POST`	`/v1/users/:user_id/streams/:stream_id/retrieve`	混合检索
`POST`	`/v1/memory/context`	将检索结果渲染为紧凑 text 或 XML 上下文
`POST`	`/v1/users/:user_id/graph/edges`	添加图边
`GET`	`/v1/status/pending`	待处理事件积压

Method	Endpoint	用途
`DELETE`	`/v1/users/:user_id/memories/:id`	硬删除单个记忆单元
`POST`	`/v1/users/:user_id/memories/semantic/preview`	预览语义更新或遗忘计划
`POST`	`/v1/users/:user_id/memories/semantic/execute`	执行审核后的语义计划

Method	Endpoint	用途
`GET`	`/v1/users/:user_id/streams/:stream_id/tasks/tree`	单个 stream 的任务树
`GET`	`/v1/users/:user_id/tasks/tree`	单个用户的所有任务树
`GET`	`/v1/users/:user_id/tasks/ready`	可执行任务
`PUT`	`/v1/users/:user_id/tasks/:task_id/status`	更新任务状态

Method	Endpoint	用途
`GET`	`/v1/organizations/:org_id/knowledge`	列出组织知识
`GET`	`/v1/organizations/:org_id/knowledge/:id`	获取单条知识记录
`GET`	`/v1/organizations/:org_id/knowledge/metrics`	组织知识指标

当前模型里的 stream_id 是 UUID 路径参数。
单节点默认部署下，Raft 自动引导默认开启。
memory_type 的序列化值是 factual 和 procedural。
以 crates/memorose-server/src/main.rs 和 crates/memorose-server/src/types.rs 作为路由和 payload 的权威来源。
以 crates/memorose-common/src/config.rs 作为运行时配置 schema 的权威来源。