MemRelay/projects/6f47523e-e22e-4cdd-bd18-76e5e474ee0c/FastAPI 后端 API 端点.md

title, type, permalink, stable_id, scope, memory_type, project_id, usage_profile_id, status, revision, request_id, created_at, updated_at, tags

title	type	permalink	stable_id	scope	memory_type	project_id	usage_profile_id	status	revision	request_id	created_at	updated_at	tags
FastAPI 后端 API 端点	fact	main/projects/6f47523e-e22e-4cdd-bd18-76e5e474ee0c/fast-api-后端-api-端点	86452d01-8146-41aa-80f9-7d5481135394	project	fact	6f47523e-e22e-4cdd-bd18-76e5e474ee0c	7aee455b-24cc-4008-bdaf-443721e6f939	active	1	migrate-fact-04	2026-08-12T17:21:15.347344+00:00	2026-08-12T17:21:15.347344+00:00	api endpoints

只读端点

• GET /api/profiles — 列出可用设备配置
• GET /api/status — 构建状态（running、exit_code、started_at、ended_at）
• GET /api/artifacts/{profile} — 列出构建产物
• GET /api/runtime-mirror/{profile}/{mirror_id} — 检查运行时镜像兼容性
• GET /api/package-catalog/{profile} — 软件目录
• GET /api/saved-config/{profile} — 读取已保存配置
• GET /api/logs/stream — SSE 实时日志流

写入端点

• PUT /api/saved-config/{profile} — 保存配置
• DELETE /api/saved-config/{profile} — 删除已保存配置
• POST /api/build — 启动构建
• POST /api/stop — 停止构建
• POST /api/package-catalog/{profile}/refresh — 同步软件目录

安全注意

• 所有端点无身份认证，监听 0.0.0.0
• 构建状态保存在单进程内存，重启或多 worker 会丢失