recursive http

启动 HTTP API 服务器。

recursive http [选项]

说明

启动基于 axum 的 HTTP 服务器，提供带会话和 SSE 流式输出的 REST API。默认配置为无状态；添加 Redis 和 S3 可支持水平扩展。

选项

选项	默认值	说明
--addr <addr>	127.0.0.1:3000	绑定地址
--workspace <path>	当前目录	所有会话的文件系统沙箱根目录
--auth-keys <keys>	(开放)	逗号分隔的 X-API-Key 白名单

快速开始

recursive http --addr 127.0.0.1:3000

另开终端：

# 健康检查
curl http://localhost:3000/health

# 创建会话
SESSION=$(curl -sX POST http://localhost:3000/sessions \
  -H 'Content-Type: application/json' \
  -d '{"system_prompt":"你是一个有用的助手。"}' | jq -r .session_id)

# 发送消息（流式）
curl -N http://localhost:3000/sessions/$SESSION/run \
  -H 'Content-Type: application/json' \
  -d '{"message":"列出 /workspace 中的文件"}'

另见

• HTTP API 参考 — 完整接口文档
• 部署指南 — Docker、Redis、S3