@tencentcloud/sdk-mcp 1.6.7 → 1.7.0

package/resource/knowledge/push/api-reference/unreal-engine.md

@@ -118,6 +118,5 @@ class PushListener：Push 监听器类
 点击通知栏消息回调。
 
 > **注意：**
->
 > 控制台推送证书需要配置为"打开应用内指定界面"，并使用默认填充值生效。
 >

package/resource/knowledge/push/config/android/fcm.md

@@ -16,7 +16,6 @@
 ## Firebase 控制台配置
 
 > **提示：**
->
 > 本文配置流程可对照 Firebase 官方 [将 Firebase 添加到 Android 项目](https://firebase.google.cn/docs/android/setup) 操作。
 >
 
@@ -63,7 +62,6 @@
 在 Firebase 控制台**项目设置 > Cloud Messaging** 中，确认 **Firebase Cloud Messaging API (V1)**已启用。新接入场景请使用 HTTP v1 API 和服务账号私钥进行 FCM 鉴权。
 
 > **注意：**
->
 > FCM 旧版 Server Key（HTTP/XMPP）已被弃用。TIMPush 的 Google FCM 通道应使用 HTTP v1 API 和服务账号私钥，请勿混用旧版 Server Key 凭据。
 >
 
@@ -72,9 +70,6 @@
 ### 添加 Google FCM 厂商证书
 
 登录腾讯云 [即时通信 IM 控制台](https://console.qcloud.com/avc)，在**推送服务 Push** > **推送设置** > **厂商配置**中添加 Google FCM 厂商证书，并按控制台要求上传或填写服务账号私钥相关配置。
-| <strong>厂商推送平台</strong> | <strong>腾讯云即时通信 IM 控制台</strong> |
-| --- | --- |
-|  |  |
 
 ### 选择 FCM 消息类型
 
@@ -89,7 +84,6 @@ FCM 支持通知消息和数据消息。腾讯云控制台默认选择通知消
 控制台可通过**消息类型**选项进行切换：
 
 > **注意：**
->
 > FCM 数据消息能力仅支持 TIMPush 7.8 及以上版本的 Pixel 手机，其他厂商设备需自测支持情况。
 >
 

package/resource/knowledge/push/config/android/honor.md

@@ -15,7 +15,6 @@
 ## 荣耀开发者服务平台配置
 
 > **提示：**
->
 > 本文配置流程可对照荣耀官方 [推送服务上架申请指南](https://developer.honor.com/cn/docs/11002/guides/app-registration) 操作。
 >
 
@@ -55,9 +54,6 @@
 ### 添加荣耀厂商证书
 
 登录腾讯云 [即时通信 IM 控制台](https://console.qcloud.com/avc)，在**推送服务 Push** > **推送设置** > **厂商配置**中添加荣耀厂商证书，并按控制台要求填写厂商参数。其中"应用内指定界面"请使用控制台默认配置。
-| <strong>厂商推送平台</strong> | <strong>腾讯云即时通信 IM 控制台</strong> |
-| --- | --- |
-|  |  |
 
 ### 配置回执和点击统计
 
@@ -77,14 +73,12 @@
 |资讯营销类|可能受到每日推送数量、展示策略或夜间管控影响。|适用于活动、资讯、营销推广等非即时消息。|
 
 > **警告：**
->
 > 如果消息分类与实际内容不符，可能导致消息被厂商降级、限频或影响通道权限。营销、广告类消息不建议配置为服务通讯类。
 >
 
-完成荣耀平台和腾讯云控制台配置后，后续发送离线推送时可在 SDK API 或腾讯云控制台默认配置中设置荣耀 `importance`。具体 API 使用方式请参见 Android SDK 接入文档中的 配置消息分类（可选）。
+完成荣耀平台和腾讯云控制台配置后，后续发送离线推送时可在 SDK API 或腾讯云控制台默认配置中设置荣耀 `importance`。具体 API 使用方式。
 
 > **说明：**
->
 > 荣耀推送和系统版本有关。当前荣耀通道仅支持国内 Magic UI 4.0 及以上和境外 Magic UI 4.2 及以上荣耀设备使用，低于上述版本的荣耀设备可以按华为厂商接入推送。
 >
 

package/resource/knowledge/push/config/android/huawei.md

@@ -15,7 +15,6 @@
 ## 华为 AppGallery Connect 配置
 
 > **提示：**
->
 > 本文配置流程可对照华为官方 [推送服务](https://developer.huawei.com/consumer/cn/doc/HMSCore-Guides/service-introduction-0000001050040060) 操作。
 >
 
@@ -37,7 +36,6 @@
 单击**项目设置 > 常规**，添加应用。
 
 > **注意：**
->
 > 应用包名与 Android 工程的 `applicationId` 需要保持一致。
 >
 
@@ -46,7 +44,6 @@
 单击**项目设置 > 常规**，获取应用信息。常规页面包含项目和应用的 Client ID 和 Client Secret，两者对应的参数不一致，请下拉至页面底部，获取应用的 Client ID 和 Client Secret。
 
 > **警告：**
->
 > 必须添加打包的 [SHA256 证书指纹](https://developer.huawei.com/consumer/cn/doc/development/HMSCore-Guides/android-config-agc-0000001050170137#section193351110105114)，SHA256 证书指纹需与自己的打包证书一致，**否则可能导致无法正常接收离线推送消息**。
 >
 
@@ -55,16 +52,12 @@
 ### 添加华为厂商证书
 
 登录腾讯云 [即时通信 IM 控制台](https://console.qcloud.com/avc)，在**推送服务 Push** > **推送设置** > **厂商配置**中添加华为厂商证书，并按控制台要求填写厂商参数。Client ID 对应 AppID，Client Secret 对应 AppSecret。"应用内指定界面"请使用控制台默认配置。
-| <strong>厂商推送平台</strong> | <strong>腾讯云即时通信 IM 控制台</strong> |
-| --- | --- |
-|  |  |
 
 ### 配置回执和点击统计
 
 如需统计消息触达或点击数据，请配置回执，回调地址填写：`https://api.im.qcloud.com/v3/offline_push_report/huawei`。
 
 > **注意：**
->
 > 华为推送证书 ID <= 11344 时，使用华为推送 v2 版本接口，不支持触达和点击回执，请重新生成更新证书 ID 。
 >
 
@@ -78,11 +71,10 @@
 |资讯营销类|按应用类型设每日推送上限；0:00 - 6:00 期间可能被缓存，待管控解除后再尝试下发。|适用于活动、资讯、推广等非即时消息。|
 
 > **警告：**
->
 > 如果消息分类与实际内容不符，**可能导致消息被厂商降级、限频或影响通道权限**。营销、广告类消息不建议配置为服务与通讯类。
 >
 
-配置消息分类时，可在华为侧申请自分类权益。完成华为平台和腾讯云控制台配置后，后续发送离线推送时可在 SDK API 或腾讯云控制台默认配置中设置华为 `Category`。具体的 SDK API 使用方式请参见 Android SDK 接入文档中的 配置消息分类（可选）。
+配置消息分类时，可在华为侧申请自分类权益。完成华为平台和腾讯云控制台配置后，后续发送离线推送时可在 SDK API 或腾讯云控制台默认配置中设置华为 `Category`。具体的 SDK API 使用方式。
 
 ## 配置完成检查
 

package/resource/knowledge/push/config/android/meizu.md

@@ -14,7 +14,6 @@
 ## 魅族开放平台配置
 
 > **提示：**
->
 > 本文配置流程可对照 [魅族开放平台](https://open.flyme.cn/docs) 操作。
 >
 
@@ -43,7 +42,6 @@
 |AppSecret|服务端身份标识，腾讯云控制台配置魅族厂商证书时使用。|
 
 > **注意：**
->
 > 魅族 AppSecret 支持重置。重置后，旧 AppSecret 的服务端身份识别会失效，请同步更新腾讯云控制台和服务端相关配置，避免推送中断。
 >
 
@@ -62,10 +60,7 @@
 
 并设置回执地址为：`https://api.im.qcloud.com/v3/offline_push_report/meizu` ：
 
-同步完成回执配置，避免 SDK 接入后再返回控制台补配置。配置方法请参见 [消息触达统计配置 > 魅族](https://cloud.tencent.com/document/product/269/100626#daa658b0-1ac0-44a8-8a47-7ec8822ebe82)。
-
 > **注意：**
->
 > 打开回执开关后，请务必确保回执地址正确配置。不配置或者配置地址错误，都会影响推送功能。
 >
 
@@ -79,11 +74,10 @@
 |公信消息|可能受到每日每设备推送数量、频控或展示策略限制。|适用于活动、资讯、公告、营销推广等非即时消息。|
 
 > **警告：**
->
 > 营销、广告、活动类消息不应配置为私信消息。分类不符或滥用可能导致消息被拦截、降级、限流或影响推送权限。
 >
 
-完成魅族平台和腾讯云控制台配置后，后续发送离线推送时可在 SDK API 或腾讯云控制台默认配置中设置魅族消息分类。具体 API 使用方式请参见 Android SDK 接入文档中的 配置消息分类（可选）。
+完成魅族平台和腾讯云控制台配置后，后续发送离线推送时可在 SDK API 或腾讯云控制台默认配置中设置魅族消息分类。具体 API 使用方式。
 
 ## 平台约束与配额
 

package/resource/knowledge/push/config/android/oppo.md

@@ -14,7 +14,6 @@
 ## OPPO 开放平台配置
 
 > **提示：**
->
 > 本文配置流程可对照 OPPO 官方[申请推送服务](https://open.oppomobile.com/documentation/page/info)操作。
 >
 
@@ -62,7 +61,6 @@ OPPO [新消息分类](https://open.oppomobile.com/documentation/page/info) 会
 |活动、广告、内容推荐等营销消息|使用内容与营销类分类。|不应走通讯与服务通道，否则可能被 OPPO 判定为违规，导致提醒降级或通道权限受限。|
 
 > **警告：**
->
 > OPPO 通讯与服务通道非默认开启，需按 OPPO 官方流程申请。营销、广告、活动类消息不应走通讯与服务通道，否则可能被 OPPO 判定为违规，导致提醒降级或通道权限受限。
 >
 
@@ -84,7 +82,7 @@ OPPO `notify_level` 用于控制通知提醒等级：
 
 ### 后续 SDK/API 接入提示
 
-完成 OPPO 平台和腾讯云控制台配置后，后续发送离线推送时还需要按实际接入方式传入对应参数：新规则使用 `category`、私信模板参数和可选的 `notify_level`；旧规则仅适用于已开通 OPPO 私信通道权限的存量应用，需使用已创建并登记的私信通道 `ChannelID`。具体 API 使用方式请参见 Android SDK 接入文档中的 配置消息分类（可选）。
+完成 OPPO 平台和腾讯云控制台配置后，后续发送离线推送时还需要按实际接入方式传入对应参数：新规则使用 `category`、私信模板参数和可选的 `notify_level`；旧规则仅适用于已开通 OPPO 私信通道权限的存量应用，需使用已创建并登记的私信通道 `ChannelID`。具体 API 使用方式。
 
 ## 配置完成检查
 

package/resource/knowledge/push/config/android/vivo.md

@@ -12,14 +12,12 @@
 |腾讯云账号和即时通信 IM 应用权限|用于在腾讯云控制台添加 vivo 厂商证书。|
 
 > **注意：**
->
 > 如果应用未上架 vivo 应用商店，不可在 vivo 官网 Web 界面和 API 后台发送正式消息，只能向设置的测试设备发送测试消息。
 >
 
 ## vivo 开放平台配置
 
 > **提示：**
->
 > 本文配置流程可对照 vivo 官方 [推送接入流程](https://dev.vivo.com.cn/documentCenter/doc/281) 操作。
 >
 
@@ -32,7 +30,6 @@
 进入 vivo 开放平台，单击**分发** > **应用分发** > **应用商店** > **上传应用**，创建您的应用。
 
 > **警告：**
->
 > vivo 开放平台中的应用包名必须与 Android 工程的 `applicationId` 保持一致。包名不一致可能导致后续 SDK 注册失败或推送设备无法正确匹配。
 >
 
@@ -49,18 +46,11 @@
 ### 添加 vivo 厂商证书
 
 登录腾讯云 [即时通信 IM 控制台](https://console.qcloud.com/avc)，在**推送服务 Push** > **推送设置** > **厂商配置**中添加 vivo 厂商证书，并按控制台要求填写厂商参数。
-| <strong>vivo 推送平台</strong> | <strong>腾讯云即时通信 IM 控制台</strong> |
-| --- | --- |
-|  |  |
 
 ### 配置回执和点击统计
 
 如需统计消息触达或点击数据，请在 vivo 开放平台设置 App 回执地址为：`https://api.im.qcloud.com/v3/offline_push_report/vivo`，并在腾讯云控制台设置回执 ID。
 
-|**回调地址配置**|**腾讯云即时通信 IM 控制台**|
-|---------|---------|
-|||
-
 ## 消息分类限制对推送效果的影响
 
 vivo 会将推送消息分为系统消息和运营消息。消息分类会影响日推总量、单设备每日接收数量和夜间发送策略。IM 聊天、订单变动、账号安全等需要及时触达的消息，建议按 vivo 规则申请并使用系统消息能力。
@@ -71,13 +61,12 @@ vivo 会将推送消息分为系统消息和运营消息。消息分类会影响
 |运营消息|新闻类和其他类按通知开启有效用户数计算日推总量；单设备每日接收数量有限；夜间发送会受限制。|适用于活动、内容推荐、营销推广等非即时消息。|
 
 > **警告：**
->
 > vivo 会对系统消息进行智能分类二次修正。如果厂商识别出消息内容不属于系统消息，可能自动修正为运营消息。正式上线前，请确认消息内容和所申请的消息分类匹配。
 >
 
 运营消息存在发送时间限制。vivo 服务器通常仅允许在 `7:00 - 23:00` 之间下发运营消息，在 `23:00 - 次日 7:00` 发送的运营消息会被服务器直接丢弃，不会延迟补发。系统消息不受此限制。
 
-完成 vivo 平台和腾讯云控制台配置后，后续发送离线推送时可在 SDK API 或腾讯云控制台默认配置中设置 vivo `Category`。两者同时设置时，API 中的设置优先于控制台证书默认配置。具体 API 使用方式请参见 Android SDK 接入文档中的 配置消息分类（可选）。
+完成 vivo 平台和腾讯云控制台配置后，后续发送离线推送时可在 SDK API 或腾讯云控制台默认配置中设置 vivo `Category`。两者同时设置时，API 中的设置优先于控制台证书默认配置。具体 API 使用方式。
 
 ## 配置完成检查
 

package/resource/knowledge/push/config/android/xiaomi.md

@@ -14,7 +14,6 @@
 ## 小米开放平台配置
 
 > **提示：**
->
 > 本文配置流程可对照小米官方 [推送配置指南](https://dev.mi.com/xiaomihyperos/documentation/detail) 操作。
 >
 
@@ -60,16 +59,12 @@
 ### 配置推送证书
 
 登录腾讯云 [即时通信 IM 控制台](https://console.qcloud.com/avc)，在**推送服务 Push** > **推送设置** > **厂商配置**中添加小米厂商证书，并按控制台要求填写厂商参数。其中"应用内指定界面"请使用控制台默认配置。
-| <strong>厂商推送平台</strong> | <strong>IM 控制台配置</strong> |
-| --- | --- |
-|  |  |
 
 ## 消息分类限制对推送效果的影响
 
 小米通知消息主要分为私信消息和公信消息。**未接入分类的应用会走默认通道（按公信场景配置，但限额更严格）。**消息分类会影响推送数量和展示效果，IM 聊天、订单变化、交易提醒等需要及时触达的消息，建议按 [小米推送消息分类新规](https://dev.mi.com/xiaomihyperos/documentation/detail) 申请并使用私信消息能力。
 
 > **警告：**
->
 > 未接入消息分类的应用走默认通道，**单设备单日仅可推送 1 条**，超出后消息不会下发，是用户反馈"收不到离线推送"的最常见原因。IM 类应用上线前必须完成私信消息接入。具体限额参见 [小米推送消息限制说明](https://dev.mi.com/xiaomihyperos/documentation/detail)。
 >
 

package/resource/knowledge/push/config/donut.md

@@ -1,7 +1,6 @@
 [微信小程序多端框架](https://cloud.tencent.com/document/product/269/111208) 推送服务目前推送支持小米、华为、荣耀、OPPO、vivo、魅族、一加、realme、iQOO 、FCM 和 Apple 等厂商通道。
 
 > **注意：**
->
 > 每个厂商仅支持配置 1 个证书。
 >
 
@@ -18,7 +17,6 @@
 【小米】
 
 > **注意：**
->
 > 通知栏推送：应用需在小米软件商店上架。
 >
 
@@ -92,7 +90,6 @@
 单击**项目设置 > 常规**，添加应用。
 
 > **注意：**
->
 > 应用包名与插件应用包名保持一致。
 >
 
@@ -101,7 +98,6 @@
 单击**项目设置 > 常规**，获取应用信息。
 
 > **说明：**
->
 > - 常规页面包含项目和应用的 Client ID 和 Client Secret，两者对应的参数不一致，请下拉至页面底部，获取应用的 Client ID 和 Client Secret。
 > - 必须添加打包的 [SHA256证书指纹](https://developer.huawei.com/consumer/cn/doc/development/HMSCore-Guides/android-config-agc-0000001050170137#section193351110105114)，SHA256 证书指纹需与自己的打包证书一致。
 >
@@ -117,7 +113,6 @@
 【OPPO】
 
 > **注意：**
->
 > - 通知栏推送：应用需在 OPPO 软件商店上架；
 > - 通知栏推送测试权限：每天仅可推送1000条消息，限测试使用。应用上架后需重新申请“通知栏推送”权限，以获得正常消息推送数量；
 > - 平台将会在1个工作日内返回审核结果，开发者可以在申请页面查看审核结果，其他问题可咨询开放平台客服。
@@ -154,7 +149,6 @@
 【vivo】
 
 > **注意：**
->
 > 若应用没有上架应用市场，推送权限受限，不可在 vivo 官网的 Web 界面和 API 后台发送正式消息，可在 API 后台向设置的测试设备发送测试消息进行测试。
 >
 
@@ -319,7 +313,6 @@ p8 证书：p8 证书没有到期日期，因此您无需担心证书过期。
 确认并生成密钥：在确认页面核对您的密钥信息，然后单击 **Register** 。接下来，您将看到一个页面提示您下载密钥。单击 **Download**，将生成的 .p8 文件保存到您的计算机上。
 
 > **说明：**
->
 > - p8 证书只可以下载一次，请妥善保存。
 > - 请妥善保管下载的 p8 文件，因为您将无法再次下载该文件。您可以使用此 p8证书配置您的 iOS 应用程序以接收推送通知。
 
@@ -333,7 +326,6 @@ p8 证书：p8 证书没有到期日期，因此您无需担心证书过期。
 4. 选择 .p8 证书
 
 > **说明：**
->
 > - **Key ID**：这是您的 APNs Auth Key 的唯一标识符。当您在 Apple Developer Center 创建一个新的 APNs Auth Key 时，系统会为您生成一个 Key ID。您可以在 "Certificates, Identifiers & Profiles" 部分的 "Keys" 中找到它。
 > - **Team ID**：这是您的开发者账户的唯一标识符。您可以在 Apple Developer Center 的账户详情页面找到它。点击右上角的 "Membership"，在 "Membership Details" 部分可以找到您的 Team ID。
 > - **Bundle ID**：这是您的应用程序的唯一标识符，也称为应用程序 ID。您可以在 Apple Developer Center 的 "Certificates, Identifiers & Profiles" 部分找到它。选择 "Identifiers"，然后在您的应用程序列表中找到对应的 Bundle ID。
@@ -365,8 +357,6 @@ p8 证书：p8 证书没有到期日期，因此您无需担心证书过期。
 #### 生成证书
 1. 选中您的 AppID，选择 **Configure**。
 
-2. 可以看到在 **Apple Push Notification service SSL Certificates** 窗口中有两个 `SSL Certificate`，分别用于开发环境（Development）和生产环境（Production）的远程推送证书，如下图所示：
-
 3. 我们先选择开发环境（Development）的 **Create Certificate**，系统将提示我们需要一个 Certificate Signing Request（CSR）。
 
 4. 在 Mac 上打开**钥匙串访问工具（Keychain Access）**，在菜单中选择**钥匙串访问** > **证书助理** > **从证书颁发机构请求证书**（`Keychain Access - Certificate Assistant - Request a Certificate From a Certificate Authority`）。
@@ -405,7 +395,6 @@ p8 证书：p8 证书没有到期日期，因此您无需担心证书过期。
 4. 选择证书类型，上传 iOS 证书（.p12），设置证书密码，单击**确认**。
 
 > **说明：**
->
 > - 上传证书名最好使用全英文（尤其不能使用括号等特殊字符）。
 > - 上传证书需要设置密码，无密码收不到推送。
 > - 发布 App Store 的证书需要设置为生产环境，否则无法收到推送。
@@ -423,7 +412,6 @@ p8 证书：p8 证书没有到期日期，因此您无需担心证书过期。
 - 步骤3：获取您的 TIMPushAppGroupID。
 
 > **注意：**
->
 > 关于**点击后续动作**支持上报统计功能：
 >
 > 1. 如果选择打开应用和打开网页，购买插件后会默认支持上报统计。

package/resource/knowledge/push/config/harmonyos.md

@@ -1,9 +1,15 @@
-## 鸿蒙控制台配置
+本文将介绍如何完成 HarmonyOS 离线推送服务厂商配置。
 
-> **注意：**
->
-> 每个厂商仅支持配置 1 个证书。
->
+## 前提条件
+
+开始前，请确认您已具备以下条件：
+
+|**条件**|**说明**|
+|---------|---------|
+|华为开发者账号|已拥有或准备注册华为开发者账号。|
+|腾讯云账号和即时通信 IM 应用权限|用于在腾讯云控制台添加鸿蒙厂商证书。|
+
+## HarmonyOS 开发者平台配置
 
 ### 步骤1：开启推送服务
 1. 登录 [AppGallery Connect](https://developer.huawei.com/consumer/cn/service/josp/agc/index.html#/)，在首页选择**开发与服务**，选择对应的项目，单击**立即开通**以开启推送服务。
@@ -70,10 +76,10 @@ Push Kit 支持多种场景化消息类型，其中部分场景化消息类型
 
 登录 [AppGallery Connect](https://developer.huawei.com/consumer/cn/service/josp/agc/index.html)，选择**开发与服务**，单击**推送服务**，在**配置**页，单击申请自分类权益。按照提示申请并激活。详情介绍请参考 [推送场景化消息权益](https://developer.huawei.com/consumer/cn/doc/harmonyos-guides/push-apply-right)。
 
-## IM 控制台配置
+## 腾讯云 IM 控制台配置
 1. 登录腾讯云 [即时通信 IM 控制台](https://console.qcloud.com/avc) ，在**推送服务 Push > 推送设置 > 厂商配置**单击**添加证书**。
 
-2. 选择上面 步骤3 生成的证书凭证，上传至新添加的鸿蒙证书。
+2. 选择上面步骤3 生成的证书凭证，上传至新添加的鸿蒙证书。
 
 3. 点击后续动作：
 
@@ -82,3 +88,8 @@ Push Kit 支持多种场景化消息类型，其中部分场景化消息类型
   - 打开应用内指定界面：收到推送消息后点击通知栏，组件会回调该点击事件和透传离线消息。
 
 4. 完成添加证书后，IM 控制台会为您分配一个 证书 ID，接入使用。
+
+   > **注意：**
+   >
+   > 每个厂商仅支持配置 1 个证书。
+   >

package/resource/knowledge/push/config/ios.md

@@ -54,13 +54,12 @@ Bundle ID 是 APNs 推送主题、Apple App ID、描述文件、Xcode 工程和
 ## Apple Developer Center 配置
 
 > **说明：**
->
 > 本文配置流程可对照 Apple 官方 [User Notifications - Setting up a remote notification server](https://developer.apple.com/documentation/usernotifications) 操作；如遇页面变更，请以 Apple 官方最新文档为准。
 >
 
 ### 创建或确认 App ID
 
-App ID 用于声明你的 iOS App 能力。若你已经有与主 App Bundle ID 对应的 App ID（也就是你从上一个步骤中获取的 Bundle Identifier)，可直接确认其能力配置；如果没有，请参考下列步骤新建 App ID。
+App ID 用于声明你的 iOS App 能力。若你已经有与主 App Bundle ID 对应的 App ID（也就是你从上一个步骤中获取的 Bundle Identifier)，可直接确认其能力配置；如果没有。
 1. 登录 [Apple Developer](https://developer.apple.com/account/)。
 
 2. 进入 **Certificates, Identifiers & Profiles**。
@@ -94,14 +93,14 @@ App ID 用于声明你的 iOS App 能力。若你已经有与主 App Bundle ID
 
 ### 选择 APNs 证书类型
 
-Apple APNs 推送证书主要有 p8 和 p12 两种方式。新接入 TIMPush 时，推荐优先使用 p8 证书。
+Apple APNs 推送证书主要有 p8 和 p12 两种方式。**新接入 TIMPush 时，推荐优先使用 p8 证书**。
 
 |类型|推荐程度|适用场景|注意事项|
 |---------|---------|---------|---------|
-|p8 证书|推荐|新接入用户优先选择。|p8 文件只可下载一次，需要妥善保存。Auth Key 文件本身无有效期。多 Bundle ID 处理方式参见上文 确认 Bundle ID。|
+|p8 证书|**推荐**|新接入用户优先选择。|p8 文件只可下载一次，需要妥善保存。Auth Key 文件本身无有效期。多 Bundle ID 处理方式参见上文 确认 Bundle ID。|
 |p12 证书|传统方式|已有 p12 证书体系，或必须使用证书方式鉴权的项目。|证书有有效期，需要设置导出密码；自 2020 年起 Apple 已合并为同时覆盖 Sandbox 和 Production 的一张证书，无需分别为开发和生产创建。|
 
-#### 创建 p8 证书（推荐）
+【创建 p8 证书（推荐）】
 
 p8 证书是 APNs Auth Key，用于腾讯云服务端向 APNs 鉴权。创建 p8 证书前，请确保已完成 App ID 和 Push Notifications 配置。
 1. 登录 [Apple Developer](https://developer.apple.com/account/)。
@@ -122,21 +121,18 @@ p8 证书是 APNs Auth Key，用于腾讯云服务端向 APNs 鉴权。创建 p8
 
   - **Topic**：默认 Team-scoped（同一 Team 下所有 App 可用），也可选 Topic-specific 并指定 Bundle ID。
 
-      新接入 TIMPush 若没有特殊安全诉求，保持默认即可。该能力为 Apple 2025 年 2 月推出的可选增强项，已有 Key 不受影响。
-
+新接入 TIMPush 若没有特殊安全诉求，保持默认即可。该能力为 Apple 2025 年 2 月推出的可选增强项，已有 Key 不受影响。
 8. 单击 **Continue**。
 
 9. 确认信息后，单击 **Register**。
 
 10. 单击 **Download** 下载 `.p8` 文件。
 
-   > **警告：**
-   >
-   > p8 文件只可下载一次，请妥善保存。若文件丢失，需要重新创建新的 Key。
-   >
-
-   请同时记录以下信息，后续上传到腾讯云控制台时需要填写：
+> **警告：**
+> p8 文件只可下载一次，请妥善保存。若文件丢失，需要重新创建新的 Key。
+>
 
+请同时记录以下信息，后续上传到腾讯云控制台时需要填写：
 | 信息 | 获取位置 |
 | --- | --- |
 | Key ID | Apple Developer Center 的 Keys 列表对应行或 Key 详情页，10 位字符。 |
@@ -144,7 +140,7 @@ p8 证书是 APNs Auth Key，用于腾讯云服务端向 APNs 鉴权。创建 p8
 | Bundle ID | 主 App 的 Bundle ID。 |
 | p8 文件 | 创建 Key 后下载的 <code>.p8</code> 文件。 |
 
-#### 创建 p12 证书，传统方式
+【创建 p12 证书，传统方式】
 
 如果您选择 p12 证书，请按以下步骤创建 APNs 推送证书。详细规则可参见 Apple 官方文档 [Establishing a certificate-based connection to APNs](https://developer.apple.com/documentation/usernotifications/establishing-a-certificate-based-connection-to-apns)。
 1. 登录 [Apple Developer](https://developer.apple.com/account/)。
@@ -159,27 +155,25 @@ p8 证书是 APNs Auth Key，用于腾讯云服务端向 APNs 鉴权。创建 p8
 
 6. 在 **Production SSL Certificate** 区域单击 **Create Certificate**。自 2020 年起，Apple 的 SSL 证书已合并为同时覆盖 Sandbox 和 Production 的一张证书（即 **Apple Push Notification service SSL (Sandbox & Production)**），无需分别为开发和生产创建两张证书。
 
-7. 按页面提示在 Mac 的 **钥匙串访问** 中生成 Certificate Signing Request（CSR）文件。
+7. 按页面提示在 Mac 的**钥匙串访问**中生成 Certificate Signing Request（CSR）文件。
 
 8. 上传 CSR 文件并生成 APNs 证书。
 
-9. 下载证书并双击导入钥匙串。导入后，证书会出现在 **登录** 钥匙串的 **我的证书** 分类下。
+9. 下载证书并双击导入钥匙串。导入后，证书会出现在**登录**钥匙串的**我的证书**分类下。
 
-10. 在 **钥匙串访问** > **登录** > **我的证书** 中找到名为 `Apple Push Services: <您的 Bundle ID>` 的证书，单击左侧 **展开三角**，确认证书下方挂着对应的 **私钥**。
+10. 在**钥匙串访问** > **登录** > **我的证书**中找到名为 `Apple Push Services: <您的 Bundle ID>` 的证书，单击左侧**展开三角**，确认证书下方挂着对应的 **私钥**。
 
-11. 同时选中 **证书** 和 **私钥**，右键选择 **导出 2 项**，文件格式选择 **个人信息交换 (.p12)**，并在弹窗中输入密码保护 p12 文件。
+11. 同时选中**证书**和**私钥**，右键选择**导出 2 项**，文件格式选择**个人信息交换 (.p12)**，并在弹窗中输入密码保护 p12 文件。
 
-   > **注意：**
-   >
-   > 1. 必须连同私钥一起导出，否则生成的 p12 文件不能用于 APNs 鉴权。如果证书下方没有私钥，说明 CSR 不是在当前 Mac 生成的，请回到生成 CSR 的 Mac 重新导出。
-   > 2. 上传 p12 证书到腾讯云控制台时需要填写证书密码。无密码或密码错误可能导致推送失败。
+> **注意：**
+> - 必须连同私钥一起导出，否则生成的 p12 文件不能用于 APNs 鉴权。如果证书下方没有私钥，说明 CSR 不是在当前 Mac 生成的，请回到生成 CSR 的 Mac 重新导出。
+> - 上传 p12 证书到腾讯云控制台时需要填写证书密码。无密码或密码错误可能导致推送失败。
 
 ### 创建或确认描述文件
 
 描述文件（Provisioning Profile）用于将 App ID、证书和设备等签名信息绑定到 Xcode 工程。
 
 > **说明：**
->
 > 如果您在 Xcode 中使用 **Automatically manage signing**（自动签名），Xcode 会在 App ID 启用 Push Notifications 后自动同步描述文件，本节可跳过。仅在使用手动签名，或 Xcode 自动签名失败需要手动处理时，才需按以下步骤创建描述文件。
 >
 
@@ -224,17 +218,17 @@ p8 证书是 APNs Auth Key，用于腾讯云服务端向 APNs 鉴权。创建 p8
    > Push 的 Key 和 Chat 的 Key 不同，不能混用。后续调用 `registerPush` 使用 Push 的客户端密钥；Chat 登录使用 Chat 的密钥。
    >
 
-| <strong>registerPush 使用的客户端密钥</strong> | <strong>Chat 登录使用的密钥</strong> |
-| --- | --- |
-|  |  |
-
 ### 上传 APNs 证书到腾讯云控制台
 
 在腾讯云控制台上传 APNs 证书后，控制台会生成证书 ID。该证书 ID 是后续 SDK 接入文档中的 `businessID`。
 
 操作路径：`腾讯云控制台 > 即时通信 IM > 推送服务 Push > 推送设置 > 厂商配置 > iOS > 添加 APNs 证书`。
 
-#### 上传 p8 证书
+> **说明：**
+> p8 和 p12 证书二选一上传即可。
+>
+
+【上传 p8 证书（推荐）】
 1. 进入 iOS APNs 证书配置页面。
 
 2. 选择 p8 证书类型。
@@ -249,7 +243,7 @@ p8 证书是 APNs Auth Key，用于腾讯云服务端向 APNs 鉴权。创建 p8
 
 7. 记录控制台生成的证书 ID。
 
-#### 上传 p12 证书
+【上传 p12 证书】
 1. 进入 iOS APNs 证书配置页面。
 
 2. 选择 p12 证书类型。
@@ -264,10 +258,9 @@ p8 证书是 APNs Auth Key，用于腾讯云服务端向 APNs 鉴权。创建 p8
 
 7. 记录控制台生成的证书 ID。
 
-   > **注意：**
-   >
-   > 上传证书时，请确认 Bundle ID 与主 App 的 Bundle Identifier 一致。发布到 App Store 的 App 需要使用生产环境证书配置。
-   >
+> **注意：**
+> 上传证书时，请确认 Bundle ID 与主 App 的 Bundle Identifier 一致。发布到 App Store 的 App 需要使用生产环境证书配置。
+>
 
 ## 触达统计资源配置（可选）
 

package/resource/knowledge/push/config/react-native.md

@@ -1,7 +1,6 @@
 React Native 推送目前支持小米、华为、荣耀、OPPO、vivo、魅族、APNs、一加、realme、iQOO 、FCM 和 苹果等厂商通道。
 
 > **注意：**
->
 > 每个厂商仅支持配置 1 个证书。
 >
 
@@ -34,7 +33,6 @@ p8 证书：p8 证书没有到期日期，因此您无需担心证书过期。
 确认并生成密钥：在确认页面核对您的密钥信息，然后单击 **Register** 。接下来，您将看到一个页面提示您下载密钥。单击 **Download**，将生成的 .p8 文件保存到您的计算机上。
 
 > **说明：**
->
 > - p8 证书只可以下载一次，请妥善保存。
 > - 请妥善保管下载的 p8 文件，因为您将无法再次下载该文件。您可以使用此 P8证书配置您的 iOS 应用程序以接收推送通知。
 
@@ -48,7 +46,6 @@ p8 证书：p8 证书没有到期日期，因此您无需担心证书过期。
 4. 选择 **p8 证书**。
 
 > **说明：**
->
 > - **Key ID**：这是您的 APNs Auth Key 的唯一标识符。当您在 Apple Developer Center 创建一个新的 APNs Auth Key 时，系统会为您生成一个 Key ID。您可以在 "Certificates, Identifiers & Profiles" 部分的 "Keys" 中找到它。
 > - **Team ID**：这是您的开发者账户的唯一标识符。您可以在 Apple Developer Center 的账户详情页面找到它。点击右上角的 "Membership"，在 "Membership Details" 部分可以找到您的 Team ID。
 > - **Bundle ID**：这是您的应用程序的唯一标识符，也称为应用程序 ID。您可以在 Apple Developer Center 的 "Certificates, Identifiers & Profiles" 部分找到它。选择 "Identifiers"，然后在您的应用程序列表中找到对应的 Bundle ID。
@@ -80,8 +77,6 @@ p8 证书：p8 证书没有到期日期，因此您无需担心证书过期。
 #### 生成证书
 1. 选中您的 AppID，选择 **Configure**。
 
-2. 可以看到在 **Apple Push Notification service SSL Certificates** 窗口中有两个 `SSL Certificate`，分别用于开发环境（Development）和生产环境（Production）的远程推送证书，如下图所示：
-
 3. 我们先选择开发环境（Development）的 **Create Certificate**，系统将提示我们需要一个 Certificate Signing Request（CSR）。
 
 4. 在 Mac 上打开**钥匙串访问工具（Keychain Access）**，在菜单中选择**钥匙串访问** > **证书助理** > **从证书颁发机构请求证书**（`Keychain Access - Certificate Assistant - Request a Certificate From a Certificate Authority`）。
@@ -120,7 +115,6 @@ p8 证书：p8 证书没有到期日期，因此您无需担心证书过期。
 4. 选择证书类型，上传 iOS 证书（.p12），设置证书密码，单击**确认**。
 
 > **说明：**
->
 > - 上传证书名最好使用全英文（尤其不能使用括号等特殊字符）。
 > - 上传证书需要设置密码，无密码收不到推送。
 > - 发布 App Store 的证书需要设置为生产环境，否则无法收到推送。
@@ -145,7 +139,6 @@ p8 证书：p8 证书没有到期日期，因此您无需担心证书过期。
 登录腾讯云 [即时通信 IM 控制台](https://console.qcloud.com/avc) ，在**推送服务 Push > 推送设置 > 厂商配置**功能栏添加各个厂商推送证书，并将您在步骤一中获取的各厂商的 AppId、AppKey、AppSecret 等参数配置给添加的推送证书。
 
 > **说明：**
->
 > 关于**点击后续动作**选项，如需使用本插件提供的点击跳转能力，请保持默认值不变，即通常是 “打开应用内指定页面” 并带有默认配置。
 >
 > 如需使用上报统计功能，也请保持此项默认值不变。
@@ -153,10 +146,6 @@ p8 证书：p8 证书没有到期日期，因此您无需担心证书过期。
 
 【小米】
 
-|厂商推送平台|IM 控制台配置|
-|---------|---------|
-|||
-
 【华为】
 | 厂商推送平台 | IM 控制台配置 |
 | --- | --- |
@@ -164,34 +153,15 @@ p8 证书：p8 证书没有到期日期，因此您无需担心证书过期。
 
 【OPPO】
 
-|厂商推送平台|IM 控制台配置|
-|---------|---------|
-|||
-
 【vivo】
 
-|厂商推送平台|IM 控制台配置|
-|---------|---------|
-|||
-
 回执配置请参考：[消息触达统计配置-vivo](https://cloud.tencent.com/document/product/269/100626#daa658b0-1ac0-44a8-8a47-7ec8822ebe82)
 
 【魅族】
 
-|厂商推送平台|IM 控制台配置|
-|---------|---------|
-|||
-
 回执配置请参考：[消息触达统计配置-魅族](https://cloud.tencent.com/document/product/269/100626#daa658b0-1ac0-44a8-8a47-7ec8822ebe82)
 
 【荣耀】
 
-|厂商推送平台|IM 控制台配置|
-|---------|---------|
-|||
-
 【Google FCM】
 
-|厂商推送平台|IM 控制台配置|
-|---------|---------|
-|||