diff --git a/docs/openapi.yaml b/docs/openapi.yaml
index 5d9abe4..13e1289 100644
--- a/docs/openapi.yaml
+++ b/docs/openapi.yaml
@@ -42,7 +42,7 @@ paths:
                 code: 0
                 msg: "success"
                 data:
-                  url: "http://localhost:6666/api/docx/download?id=d8d4122719c8465ea75ab62b37f6ce10"
+                  url: "/api/docx/download?id=d8d4122719c8465ea75ab62b37f6ce10"
                   fileName: "annualReport.docx"
         "400":
           description: 参数校验失败（exportId 为空 / businessData 为空）
@@ -77,7 +77,7 @@ paths:
       summary: 下载缓存的 DOCX 文件
       description: |
         根据 export 接口返回的 key 下载已生成的 DOCX 文件。
-        key 为临时 UUID，有效期不确定（服务重启后失效）。
+        key 为临时 UUID，生成后 30 分钟自动过期清理。
       operationId: downloadDocx
       tags:
         - Docx Export
@@ -175,9 +175,8 @@ components:
       properties:
         url:
           type: string
-          format: uri
-          description: 文件下载链接
-          example: "http://localhost:6666/api/docx/download?id=d8d4122719c8465ea75ab62b37f6ce10"
+          description: 文件下载路径（pathname only，无 origin）
+          example: "/api/docx/download?id=d8d4122719c8465ea75ab62b37f6ce10"
         fileName:
           type: string
           description: 文件名