接口速查表
按功能分组列出所有 REST API 端点，涵盖系统检查、Bank 管理、记忆读写、文档管理、实体关系、后台操作、心智模型、指令和配置管理。
系统检查
| 方法 |
路径 |
用途 |
| GET |
/health |
健康检查 |
| GET |
/version |
版本信息（需认证） |
Bank 管理
| 方法 |
路径 |
用途 |
| GET |
/banks |
列出 Bank |
| POST |
/banks |
创建 Bank |
| GET |
/banks/{bankId} |
获取 Bank 详情 |
| DELETE |
/banks/{bankId} |
删除 Bank 及全部数据 |
| GET |
/banks/{bankId}/config |
获取 Bank 配置 |
| PATCH |
/banks/{bankId}/config |
更新 Bank 配置 |
| GET |
/banks/{bankId}/stats |
获取 Bank 统计信息 |
| POST |
/banks/{bankId}/consolidate |
手动触发整合 |
记忆读写
| 方法 |
路径 |
用途 |
| POST |
/memories/retain |
同步写入记忆 |
| POST |
/memories/retain_async |
异步写入记忆 |
| POST |
/files/retain |
上传文件并写入记忆 |
| POST |
/recall |
检索相关记忆 |
| POST |
/reflect |
基于记忆生成综合回答 |
| GET |
/list |
列出记忆 |
文档管理
| 方法 |
路径 |
用途 |
| GET |
/documents |
列出文档 |
| GET |
/documents/{documentId} |
获取文档详情 |
| PATCH |
/documents/{documentId} |
更新文档标签 |
| DELETE |
/documents/{documentId} |
删除文档及关联记忆 |
| GET |
/documents/{documentId}/chunks |
列出文档分块 |
实体关系
| 方法 |
路径 |
用途 |
| GET |
/entities |
列出实体 |
| GET |
/entities/graph |
获取实体关系图 |
后台操作
| 方法 |
路径 |
用途 |
| GET |
/operations/{bankId} |
列出后台操作 |
| DELETE |
/operations/{bankId} |
取消后台操作 |
心智模型
| 方法 |
路径 |
用途 |
| GET |
/banks/{bankId}/mental-models |
列出心智模型 |
| POST |
/banks/{bankId}/mental-models |
创建心智模型 |
| GET |
/banks/{bankId}/mental-models/{modelId} |
获取心智模型详情 |
| PATCH |
/banks/{bankId}/mental-models/{modelId} |
更新心智模型 |
| DELETE |
/banks/{bankId}/mental-models/{modelId} |
删除心智模型 |
| POST |
/banks/{bankId}/mental-models/{modelId}/refresh |
刷新心智模型内容 |
指令
| 方法 |
路径 |
用途 |
| GET |
/banks/{bankId}/directives |
列出指令 |
| POST |
/banks/{bankId}/directives |
创建指令 |
| GET |
/banks/{bankId}/directives/{directiveId} |
获取指令详情 |
| PATCH |
/banks/{bankId}/directives/{directiveId} |
更新指令 |
| DELETE |
/banks/{bankId}/directives/{directiveId} |
删除指令 |
