Merge remote-tracking branch 'origin/main' into feat/pay-v2-integration

# Conflicts:
#	docs/index.html
#	server/cmd/server/main.go

server/api/openapi.yaml

@@ -294,10 +294,11 @@ paths:
   /ads/unlock:
     post:
       operationId: adsUnlock
-      summary: 激励视频广告解锁当日时长
+      summary: 激励视频广告加时（累加式）
       description: |
         免费版用户完成激励视频广告后调用。服务端向广告平台（AdMob/Unity）校验 ad_token 真伪，
-        通过后记录 `usage_daily.ad_unlocked_at`，当日 connect 接口方可放行。
+        通过后向 `usage_daily.ad_bonus_minutes` 累加固定分钟（每日封顶），当日免费额度随之上浮。
+        额度为**全账户共享**（非每设备）。响应返回本次实际加时与最新剩余分钟。
       tags: [Commerce]
       requestBody:
         required: true
@@ -315,8 +316,20 @@ paths:
                   type: string
                   description: 广告 SDK 签发的服务端回执 token
       responses:
-        "204":
-          description: 广告解锁成功（无响应体）
+        "200":
+          description: 广告加时成功
+          content:
+            application/json:
+              schema:
+                type: object
+                required: [granted_minutes, minutes_remaining]
+                properties:
+                  granted_minutes:
+                    type: integer
+                    description: 本次广告实际加时分钟（已达每日封顶时为 0）
+                  minutes_remaining:
+                    type: integer
+                    description: 加时后账户当日剩余分钟（全账户共享）
         "400":
           $ref: "#/components/responses/BadRequest"
         "401":
@@ -1051,14 +1064,23 @@ components:
           type: integer
           description: 今日已使用分钟数
           example: 3
+        minutes_cap:
+          type: integer
+          nullable: true
+          description: 今日额度 = 套餐每日分钟 + 看广告累加分钟；付费无限制时为 null
+          example: 20
         minutes_remaining:
           type: integer
           nullable: true
-          description: 今日剩余分钟数，付费无限制时为 null
+          description: 今日剩余分钟数（全账户共享），付费无限制时为 null
           example: 7
+        ad_bonus_minutes:
+          type: integer
+          description: 今日已通过看广告累加的分钟数
+          example: 10
         ad_unlocked:
           type: boolean
-          description: 免费版今日是否已完成激励广告解锁
+          description: 免费版今日是否已通过看广告加过时（ad_bonus_minutes > 0，历史字段）
           example: false
 
     Device: