Add youth mode restriction labels

docs/IM-青少年模式前后端对接文档.md

@@ -23,6 +23,8 @@ Idempotency-Key: <uuid>
 
 测试环境验证码固定为 `123456`。`action_token` 为 5 分钟有效、单次消费，只能用于指定动作，不能在多个接口之间重复使用。
 
+当前默认策略项为 `night_quiet`、`content_filter`、`payment_guard` 三条。现阶段后端已完成状态持久化、开启/关闭校验和策略返回；业务接口层的深夜消息免打扰、内容过滤、支付拦截尚未实际强制执行，响应中的 `restriction_items[].enforced=false` 用于明确表达这一点。后续某条规则真正接入后台策略和业务拦截后，应把对应项改为 `true`。
+
 ## 2. 开启青少年模式
 
 ### 2.1 查询当前状态
@@ -40,6 +42,26 @@ GET /v1/im/settings/youth-mode
     "enabled": false,
     "policy_version": 1,
     "restrictions": ["night_quiet", "content_filter", "payment_guard"],
+    "restriction_items": [
+      {
+        "code": "night_quiet",
+        "title": "深夜免打扰",
+        "description": "夜间减少消息提醒打扰，帮助用户保持健康作息。",
+        "enforced": false
+      },
+      {
+        "code": "content_filter",
+        "title": "内容过滤",
+        "description": "对不适合青少年的内容进行识别和限制展示。",
+        "enforced": false
+      },
+      {
+        "code": "payment_guard",
+        "title": "支付守护",
+        "description": "限制或确认支付、充值等敏感消费行为。",
+        "enforced": false
+      }
+    ],
     "password_set": false,
     "can_enable": false,
     "updated_at": "2026-08-20T09:00:00Z"
@@ -47,7 +69,7 @@ GET /v1/im/settings/youth-mode
 }
 ```
 
-前端使用 `policy_version` 和 `restrictions` 渲染开启确认页。最终开启时需要提交用户确认过的 `policy_version`。
+前端优先使用 `restriction_items` 渲染开启确认页，`restrictions` 保留为兼容旧客户端的 code 数组。最终开启时需要提交用户确认过的 `policy_version`。
 
 ### 2.2 发起短信身份验证
 
@@ -175,6 +197,26 @@ POST /v1/im/settings/youth-mode/enable
     "policy_version": 1,
     "password_set": true,
     "restrictions": ["night_quiet", "content_filter", "payment_guard"],
+    "restriction_items": [
+      {
+        "code": "night_quiet",
+        "title": "深夜免打扰",
+        "description": "夜间减少消息提醒打扰，帮助用户保持健康作息。",
+        "enforced": false
+      },
+      {
+        "code": "content_filter",
+        "title": "内容过滤",
+        "description": "对不适合青少年的内容进行识别和限制展示。",
+        "enforced": false
+      },
+      {
+        "code": "payment_guard",
+        "title": "支付守护",
+        "description": "限制或确认支付、充值等敏感消费行为。",
+        "enforced": false
+      }
+    ],
     "updated_at": "2026-08-20T09:00:00Z"
   }
 }