提交qiming-mcp-proxy

2026-06-01 13:03:20 +08:00
parent 9e9486b7c2
commit afb3d9f4e6
394 changed files with 124494 additions and 0 deletions
--- a/qiming-mcp-proxy/voice-cli/src/openapi.rs
+++ b/qiming-mcp-proxy/voice-cli/src/openapi.rs
@@ -0,0 +1,84 @@
+use crate::models::{
+    AsyncTaskResponse, CancelResponse, DeleteResponse, HealthResponse, ModelInfo, ModelsResponse,
+    RetryResponse, Segment, TaskPriority, TaskStatsResponse, TaskStatus, TaskStatusResponse,
+    TranscriptionResponse,
+};
+use crate::server::handlers;
+use utoipa::OpenApi;
+use utoipa_swagger_ui::SwaggerUi;
+
+/// OpenAPI specification for Voice CLI API
+#[derive(OpenApi)]
+#[openapi(
+    info(
+        title = "Voice CLI API",
+        version = "0.1.0",
+        description = "Speech-to-text HTTP service with Whisper model support",
+        license(
+            name = "MIT",
+        ),
+        contact(
+            name = "Voice CLI Support",
+            email = "support@voice-cli.dev"
+        )
+    ),
+    servers(
+        (url = "http://localhost:8080", description = "Local development server"),
+        (url = "https://api.voice-cli.dev", description = "Production server")
+    ),
+    paths(
+        handlers::health_handler,
+        handlers::models_list_handler,
+        handlers::transcribe_handler,
+        handlers::transcribe_from_url_handler,
+        handlers::async_transcribe_handler,
+        handlers::get_task_handler,
+        handlers::cancel_task_handler,
+        handlers::get_task_result_handler,
+        handlers::delete_task_handler,
+        handlers::retry_task_handler,
+        handlers::get_tasks_stats_handler,
+        handlers::tts_sync_handler,
+    ),
+    components(
+        schemas(
+            TranscriptionResponse,
+            Segment,
+            HealthResponse,
+            ModelsResponse,
+            ModelInfo,
+            AsyncTaskResponse,
+            TaskStatusResponse,
+            TaskStatus,
+            TaskPriority,
+            CancelResponse,
+            DeleteResponse,
+            RetryResponse,
+            TaskStatsResponse
+        )
+    ),
+    tags(
+        (name = "Health", description = "Service health and status endpoints"),
+        (name = "Models", description = "Whisper model management endpoints"),
+        (name = "Transcription", description = "Speech-to-text transcription endpoints"),
+        (name = "Async Transcription", description = "Asynchronous transcription task management"),
+        (name = "Task Management", description = "Task lifecycle and monitoring endpoints")
+    ),
+    external_docs(
+        url = "https://github.com/your-org/voice-cli",
+        description = "Voice CLI GitHub Repository"
+    )
+)]
+pub struct ApiDoc;
+
+/// Create Swagger UI service
+pub fn create_swagger_ui() -> SwaggerUi {
+    SwaggerUi::new("/api/docs")
+        .url("/api/docs/openapi.json", ApiDoc::openapi())
+        .config(utoipa_swagger_ui::Config::new(["/api/docs/openapi.json"]))
+}
+
+/// Get OpenAPI JSON specification
+pub fn get_openapi_json() -> utoipa::openapi::OpenApi {
+    ApiDoc::openapi()
+}