diff --git a/src/BuildFlow.Host/BuildFlowHostModule.cs b/src/BuildFlow.Host/BuildFlowHostModule.cs
index 9a71226..351b635 100644
--- a/src/BuildFlow.Host/BuildFlowHostModule.cs
+++ b/src/BuildFlow.Host/BuildFlowHostModule.cs
@@ -108,6 +108,8 @@ public class BuildFlowHostModule : AbpModule
         services.Configure<BuildFlow.Shared.Api.ApiResponseMiddlewareOptions>(opts =>
         {
             opts.PassthroughPrefixes.Add("/api/files/download");
+            // Swagger/OpenAPI 文档必须保持原始结构，不能包裹成 { code, data, message }，否则 Swagger UI 无法识别 openapi 字段。
+            opts.PassthroughPrefixes.Add("/swagger");
         });
     }