This commit is contained in:
2026-05-01 20:29:09 +08:00
parent 8718472dbd
commit 87fbf41fab
137 changed files with 2922 additions and 989 deletions

View File

@@ -1,6 +1,6 @@
# Rust API Server 路由索引2026-04-23
更新时间:`2026-04-30`
更新时间:`2026-05-01`
## 1. 文档目标
@@ -10,7 +10,7 @@
## 2. 当前统计
当前 Rust `api-server``app.rs` 可抽取到 `102` 条路由:
当前 Rust `api-server``app.rs` 可抽取到 `116` 条路由:
1. 管理后台 API`6` 条。
2. 内部鉴权调试接口:`2` 条。
@@ -18,11 +18,12 @@
4. assets / OSS 接口:`15` 条。
5. auth 接口:`12` 条。
6. custom world / agent 接口:`23` 条。
7. llm proxy 接口:`1` 条。
8. profile / runtime profile 接口:`12` 条。
9. runtime story / story gameplay 接口:`15` 条。
10. legacy generated 静态路径兼容`6` 条。
11. health check`1` 条。
7. match3d creation / runtime 接口:`14` 条。
8. llm proxy 接口:`1` 条。
9. profile / runtime profile 接口:`12` 条。
10. runtime story / story gameplay 接口`15` 条。
11. legacy generated 静态路径兼容`6` 条。
12. health check`1` 条。
## 3. 路由清单
@@ -117,7 +118,24 @@
1. `POST /api/llm/chat/completions`
### 3.8 Profile / Runtime Profile
### 3.8 Match3D Creation / Runtime
1. `POST /api/creation/match3d/sessions`
2. `GET /api/creation/match3d/sessions/{session_id}`
3. `POST /api/creation/match3d/sessions/{session_id}/messages`
4. `POST /api/creation/match3d/sessions/{session_id}/messages/stream`
5. `POST /api/creation/match3d/sessions/{session_id}/actions`
6. `POST /api/creation/match3d/sessions/{session_id}/compile`
7. `GET /api/creation/match3d/works`
8. `GET / PATCH / PUT / DELETE /api/creation/match3d/works/{profile_id}`
9. `POST /api/creation/match3d/works/{profile_id}/publish`
10. `GET /api/runtime/match3d/gallery`
11. `POST /api/runtime/match3d/works/{profile_id}/runs`
12. `GET /api/runtime/match3d/runs/{run_id}`
13. `POST /api/runtime/match3d/runs/{run_id}/click`
14. `POST /api/runtime/match3d/runs/{run_id}/stop / restart / time-up`
### 3.9 Profile / Runtime Profile
1. `GET /api/profile/dashboard`
2. `GET /api/runtime/profile/dashboard`
@@ -132,7 +150,7 @@
11. `POST /api/profile/save-archives/{world_key}`
12. `POST /api/runtime/profile/save-archives/{world_key}`
### 3.9 Runtime Story / Gameplay
### 3.10 Runtime Story / Gameplay
1. `POST /api/runtime/save/snapshot`
2. `GET /api/runtime/settings`
@@ -150,7 +168,7 @@
14. `POST /api/story/npc/battle`
15. `GET /api/runtime/sessions/{runtime_session_id}/inventory`
### 3.10 Legacy Generated 路径
### 3.11 Legacy Generated 路径
1. `GET /generated-character-drafts/{*path}`
2. `GET /generated-characters/{*path}`
@@ -159,7 +177,7 @@
5. `GET /generated-custom-world-covers/{*path}`
6. `GET /generated-qwen-sprites/{*path}`
### 3.11 Health
### 3.12 Health
1. `GET /healthz`