REST API 参考

本章节是 GitHub Wiki: API Reference 的镜像。

接口概览

所有 REST API 路径前缀：/api/v1

示例

归档

curl -X POST http://localhost:8765/api/v1/sessions/sess-001/archive \
  -H "Content-Type: application/json" \
  -d '{"turns": [...], "project_id": "proj-a"}'

获取摘要

curl http://localhost:8765/api/v1/sessions/sess-001/summaries

渲染 prompt

curl http://localhost:8765/api/v1/sessions/sess-001/prompt

检索记忆

curl http://localhost:8765/api/v1/sessions/sess-001/memories/<hook_id>

周期任务

curl -X POST http://localhost:8765/api/v1/sessions/sess-001/compaction \
  -H "Content-Type: application/json" -d '{"period": "weekly"}'

启动服务

MEMORY_CENTER_HOST=0.0.0.0 \
MEMORY_CENTER_PORT=8765 \
MEMORY_CENTER_ROOT=./data \
cargo run -p memory-center-server

完整文档

完整 API 文档（含请求/响应 schema、错误码、鉴权）见：

• Wiki: API Reference
• crates/memory-center-server/src/handlers.rs