API 概览

所有 API 端点需通过 X-API-Key 请求头或 Authorization: Bearer <jwt> 认证。

基础地址： http://localhost:9090

健康检查

GET /healthz

无需认证。

核心端点

方法	路径	说明
POST	/v1/chat	发送消息
POST	/v1/chat/stream	流式聊天（SSE）
GET	/v1/skills	列出可用技能
GET	/v1/version	版本信息
GET	/v1/metrics	使用指标

记忆

方法	路径	说明
GET	/v1/memory/stats	记忆层统计
GET	/v1/memory/search	搜索记忆
POST	/v1/memory/add	添加记忆

知识库

方法	路径	说明
GET	/v1/knowledge/search	混合搜索
GET	/v1/knowledge/sources	列出知识源
POST	/v1/knowledge/ingest	导入文档
POST	/v1/knowledge/upload	上传文件

审计

方法	路径	说明
GET	/v1/audit/tail	最近审计记录
GET	/v1/audit/verify	验证 Merkle 链完整性