Memory Hub API

Memory Hub 提供 RESTful API，所有鉴权接口需要在请求头中携带 JWT Token。

认证

登录

POST /api/auth/login
Content-Type: application/json

{
  "username": "your_username",
  "password": "your_password"
}

响应：

{
  "token": "eyJhbGciOiJIUzI1NiIs...",
  "user": {
    "username": "your_username",
    "role": "user"
  }
}

SSO 登录

GET /api/auth/sso

跳转到讯飞 CAS SSO 登录页面，认证成功后回调并返回 JWT Token。

健康检查

GET /api/stats

记忆操作

所有记忆接口需要 Bearer Token 认证：

Authorization: Bearer <your_jwt_token>

存储记忆

POST /api/memory/store
Content-Type: application/json

{
  "messages": [
    { "role": "user", "content": "我喜欢用 Go 写后端" },
    { "role": "assistant", "content": "好的，我记住了你偏好 Go 语言" }
  ],
  "run_id": ""
}

参数	类型	必填	说明
messages	array	是	对话消息列表
run_id	string	否	空=长期记忆，非空=短期记忆

搜索记忆

GET /api/memory/search?q=Go语言偏好&limit=10

参数	类型	说明
q	string	搜索关键词
limit	number	返回数量限制

搜索会并发查询用户可访问的所有范围（个人 + 组织 + 全局），合并返回。

获取用户记忆

GET /api/memory

返回当前用户的所有记忆列表。

删除记忆

DELETE /api/memory/:uuid

组织管理

列出组织

GET /api/orgs

创建组织

POST /api/orgs
Content-Type: application/json

{
  "name": "技术中心",
  "description": "技术中心团队"
}

WARNING

创建组织需要 super_admin 权限。

成员管理

GET /api/orgs/:id/members
POST /api/orgs/:id/members
DELETE /api/orgs/:id/members/:username

TIP

成员管理需要 org_admin 及以上权限。

用户管理

列出用户

GET /api/users

修改角色

PUT /api/users/:username/role
Content-Type: application/json

{
  "role": "org_admin"
}

WARNING

用户管理接口仅 super_admin 可用。

个人设置

获取个人信息

GET /api/profile

生成 API Token

POST /api/profile/token

为 Agent 插件生成独立的 Bearer Token，可用于非交互式场景。

修改密码

POST /api/profile/password
Content-Type: application/json

{
  "old_password": "...",
  "new_password": "..."
}

记忆时间线

获取片段

GET /api/episodes

返回记忆按时间聚合的片段列表。