7月31日同步更新

mcguide/36-审核与下架/课程03-机器审核流程及指标介绍.md

@@ -0,0 +1,111 @@
+---
+front: https://mc.res.netease.com/pc/zt/20201109161633/mc-dev/assets/img/0_25_5.cb909f47.png
+hard: 入门
+time: 5分钟
+selection: true
+---
+
+# 机器审核流程及指标介绍
+
+目前机审的流程主要由以下几个步骤构成：
+
+- 代码机审
+- 组件核价
+- 性能检测
+
+## 代码机审
+
+系统对上传的包体进行静态代码审核，检测是否存在违规代码、恶意脚本或不符合规范的代码结构。此步骤的作用是确保组件的代码安全性和规范性，避免潜在的安全风险。
+
+若代码机审不通过，将返回平台内机审邮件，请在开发者平台右上角邮箱处查收。并根据[打包错误信息文档](../50-常见问题答疑/60-我的世界中国版打包错误信息汇整.html)的提示进行调整。
+
+## 组件核价
+
+系统根据组件的复杂度、资源占用情况等因素，自动生成组件的最低定价标准。
+
+如果开发者提审时的最终售价（包括折扣）小于推荐区间的最低价格，则以开发者平台站内信的方式通知开发者进行定价更改。
+
+此步骤的作用是根据标准限定售卖价格区间，消除当前存在的价格内卷现象，使整体市场的售卖价格趋向合理和体系化。
+
+![image](./images/price_review_process.svg)
+
+## 性能检测
+
+开发者上传包体后，系统自动将包体上传至手机测试集群环境，模拟玩家操作进行性能测试，主要检测进入时长、内存占用、平均帧率三个指标是否符合要求。避免因性能问题导致玩家体验下降，确保组件在不同设备上都能流畅运行。
+
+从组件的运行周期来看，主要由启动和运行两个阶段产生性能问题。
+
+- 启动阶段：启动加载时长和组件大小，该数据将显著影响用户成功进入游戏的意愿
+- 运行阶段：内存峰值、CPU占用、体验流畅度（帧率、卡顿）等
+- 其他兼容性问题，包括脚本代码错误
+
+### 线上性能数据
+
+截至2025.3.5，对线上存量组件，进行性能测试，性能分布情况如下：
+
+| 性能指标         | 指标范围  | 占比     | 机审拦截 |
+| ---------------- | --------- | -------- | -------- |
+| 平均帧率         | [0,10]    | 0.04%    | 是       |
+|                  | (10,30]   | 0.22%    | 是       |
+|                  | (30,40]   | 0.48%    | 是       |
+|                  | (40,~)    | 99.26%   |          |
+| 加载时长（秒）   | [0,10]    | 97.52%   |          |
+|                  | (10,60]   | 0.66%    |          |
+|                  | (60,120]  | 0.09%    |          |
+|                  | (120,~)   | 0.07%    | 是       |
+| 内存峰值（MB）   | [0,150]   | 88.88%   |          |
+|                  | (150,450] | 9.33%    |          |
+|                  | (450,950] | 1.58%    | 是       |
+|                  | (950,1250]| 0.09%    | 是       |
+|                  | (1250,~)  | 0.12%    | 是       |
+
+注：上述数据基于多台中端机设备（高通 骁龙778G，高通 骁龙765G，MTK 天玑900，海思 Kirin 980）跑测结果，具备一定参考价值，但不同的玩家设备，操作系统版本，会略有差别。
+
+### 组件性能标准
+
+结合现状和线上玩家设备情况，组件性能标准如下
+
+| 阶段     | 指标           | 优秀       | 平台建议   | 达标      |
+| -------- | -------------- | ---------- | ---------- | --------- |
+| 启动阶段 | 加载时长（秒） | <10        | <60        | <120      |
+| 测试阶段 | 内存峰值（MB） | <150       | <300       | <450      |
+|          | 平均帧率       | >55        | >50        | >40       |
+| 线上数据 | 平均卡顿次数   | /          | /          | /         |
+
+### 核心指标介绍
+
+- 内存峰值：组件内存占用超过设备阈值时，可能引发崩溃等问题，严重影响用户体验。
+- 平均帧率：低帧率会使游戏画面卡顿，影响流畅性，严重影响用户体验。
+- 平均卡顿次数：卡顿会导致游戏画面不流畅，进而影响玩家的体验，严重时甚至可能破坏整个游戏的乐趣。为了评估卡顿情况，我们会记录线上Python执行时间时长超过一定时间的函数，并在一定时间范围内计算其平均发生次数。
+
+### 评测环境与方法
+
+我们主要从开发、审核和线上三个环境进行评测。
+
+- 在开发阶段，核心指标为内存、帧率和卡顿次数。开发者可使用Airperf和Tracy工具来监测内存、帧率和卡顿情况，并进行优化，确保玩家能有高质量性能体验。
+- 在审核阶段，我们将对组件进行核心指标性能测试，性能不达标的组件将被拒审。因此，开发者需在开发阶段进行自查，确保审核顺利通过。
+- 在线上环境，我们将采集玩家的帧率、内存和卡顿情况，以验证组件的性能。开发者可以通过开发者平台性能看板查看这些性能数据。
+
+### 开发者工具指引
+
+为了帮助开发者发现和解决性能问题，我的世界开发组提供了相应工具，以提高问题排查和解决的效率，详见[性能监测与调试](../30-测试/5-性能监测与调试工具.md)。
+
+#### 开发者平台
+
+后台展示了线上帧率，卡顿情况，可以查看和验证线上问题情况，效果如下图：
+
+![image](./images/developer_platform.png)
+
+![image](./images/developer_platform1.png)
+
+#### 方块探针（Tracy）
+
+卡顿排查工具，可以逐帧分析函数耗时，定位高消耗函数，帮助发现和解决问题，效果如下图
+
+![image](./images/tracy.png)
+
+#### 方块易测（Airperf）
+
+基础性能检测工具，可以抓取帧率，内存等数据，用于自测是否达标，效果如下图：
+
+![image](./images/airperf.png)

mcguide/36-审核与下架/课程04-模组性能违规及处罚细则.md

@@ -0,0 +1,133 @@
+# 模组性能违规及处罚细则
+
+## 违规及处罚细则
+
+1. **目的和范围**
+
+为推动开发者持续优化模组性能，保障玩家游戏体验，维护《我的世界》中国版游戏生态的健康与稳定发展，根据《\<我的世界\>开发者协议》等相关协议，《我的世界》开发者平台（以下简称“**平台**”或“**我们**”）特制定本细则。本细则适用于所有通过《我的世界》开发者平台注册的开发者（以下简称“**开发者**”或“**您**”）。
+
+2. **模组性能违规情况说明**
+
+    1. **模组性能违规的认定**
+
+        当开发者组件和/或开发者服务器游戏（合称“**开发者模组**”或“**模组**”）存在以下任一情形时，将被认定为开发者模组性能违规：
+
+        1. **玩家投诉频率超标**：针对同一开发者模组性能的有效投诉率（当日有效反馈次数/当日游玩该模组人数）≥5%，且有效反馈次数≥50次。
+
+        2. **模组线上性能数据不达标**：开发者模组线上崩溃率数据超过阈值。
+
+    2. **模组性能违规风险分级及示例**
+
+        平台将结合模组性能违规对游戏及玩家造成的影响等因素，综合评定开发者模组性能的违规程度，具体分级及示例如下：
+
+| **违规级别** | **分级标准** |
+| ---------------- | ------------------------------------------------------------ |
+| 轻度风险         | 线上崩溃率或玩家反馈率>=5% |
+| 中度风险         | 线上崩溃率或玩家反馈率>=8% 或 组件问题影响的玩家数量偏多 |
+| 高度风险         | 线上崩溃率或玩家反馈率>=12% 或 组件问题影响的玩家数量多 |
+| 严重风险         | 线上崩溃率或玩家反馈率>=15% 或 组件问题影响的玩家数量极多 |
+
+3. **模组性能违规处罚标准**
+
+对于违反本细则的模组，平台有权采取如下一项或者多项处罚措施：
+
+| **违规级别** | **处罚方式（合格需要三项均达标，任一项达到处罚标准则处罚升级）**                 |
+| ------------------ | ------------------------------------------------------------ |
+| 中度风险           | 1.立刻弱下架开发者模组并告知开发者改进开发者模组质量<br />2.开发者信用分-1 |
+| 高度风险           | 1.立刻弱下架开发者模组并告知开发者改进开发者模组质量<br />2.违约金：**下架时开发者模组价格 X 下架前3日的开发者模组总购买人数** X 处罚倍数<br />3.根据实际问题严重程度及对玩家的影响程度，**处罚倍数最高可至5倍** |
+| 严重风险           | 1.立刻弱下架开发者模组并告知开发者改进开发者模组质量<br />2.违约金：**下架时开发者模组价格 X 下架前7日的开发者模组总购买人数** X 处罚倍数<br />3.根据实际问题严重程度及对玩家的影响程度，**处罚倍数最高可至10倍**<br />4.开发者信用分-6<br />5.开发者模组停止上传7个工作日<br />6.推广资源取消申请资格7个工作日 |
+
+注：
+
+（1）平台有权根据违规情节严重程度，对具体的处罚措施进行调整，包括但不限于延长弱下架时间、追究违规行为给平台造成的全部损失等；
+
+（2）若一个月内单一开发者重复触发同一等级的处罚，则第二次处罚升级，第三次处罚继续升级；
+
+（3）若处罚升级前已经到达封顶等级，则该处罚系数固定为【10】。
+
+4. **模组性能违规处罚流程**
+
+    1. **组件问题处理阶段展示**：
+   <table>
+     <tr>
+       <th rowspan="2">组件状态阶段</th>
+       <th colspan="2">开发者独立整改时间</th>
+       <th colspan="2">正式整改期（固定21天）</th>
+     </tr>
+     <tr>
+       <td>开发者独立整改时间开始</td>
+       <td>开发者独立整改时间结束</td>
+       <td>整改期开始</td>
+       <td>整改期结束</td>
+     </tr>
+     <tr>
+       <td>进入此节点的判定条件</td>
+       <td>开发者收到警告邮件</td>
+       <td>后台确认组件问题后，对组件进行弱下架</td>
+       <td>开发者组件被弱下架</td>
+       <td>根据近期线上数据决定是否对组件进行正式处罚</td>
+     </tr>
+   </table>
+
+   组件收到性能警报提示邮件后需要开发者自行对组件问题进行排查和修改，这个过程称为开发者独立整改期。独立整改期的时长会根据组件的实际线上崩溃率和反馈率进行调整，为减少问题组件带给玩家的影响，**线上崩溃率和反馈率越高的组件独立整改期越短**。独立整改期结束时如果组件问题得到改善则不会进行后续处罚，若组件性能数据依然超标，我们会对组件进行弱下架处理，组件进入正式整改期。
+
+    2. **正式整改期时长为固定的21天**，此期间您需要对违规模组的性能表现进行提升，平台将视违规情况决定是否联系您并提供专项优化技术支持，您应积极配合平台。
+
+    3. **若您在正式整改期结束后未予整改，或者消极整改、不积极进行性能优化、整改结果未能达到平台规定的模组性能标准，平台将执行最终处罚决定（“处罚通知”）**，并酌情将处罚情况予以公示。  
+   若您对于处罚通知有异议，应在整改期内向平台书面提出异议并提供相关证据，平台将在收到异议后7个工作日内对您提出的异议数据及相关证据进行审查。除非有证据证明是平台故意造成数据错误的，否则您同意以平台二次审查后确认的数据作为最终处罚判定依据。若您未在整改期内提出书面异议的，视为您对处罚通知无异议。
+
+    4. 因您在开发者平台登记的联系信息不准确，导致平台无法与您取得联系的，由此造成的损失由您自行负责。
+5. **违约金支付与结算**
+
+    1. 违约金支付方式：
+
+        1. **直接扣除：** 平台有权优先从您的违规行为发生当月的开发者分成收入中直接扣除相应的违约金，并按照平台结算系统进行实际收益结算。若当月结算账单金额不足以覆盖违约金，平台将扣除您在平台缴纳的押金，并依次递延冻结后续结算月份的账单，直至累计结算金额足以全额支付违约金。
+
+        2. **汇款或转账：** 平台亦有权要求您通过汇款或转账的形式支付违约金。您需在收到平台发出的缴费通知后，按照缴费通知的要求，将违约金转账或汇款至平台指定的账户。若您逾期仍未缴纳违约金，平台有权采取进一步措施，包括但不限于暂停或终止模组的运营、封禁您的开发者账号，并将历史未结算金额及押金扣缴违约金进行结算。
+
+    2. 平台指定银行汇款账号信息如下：
+
+        公司名称：上海网之易璀璨网络科技有限公司
+
+        纳税人识别号：91310000MA1FR5564G
+
+        地址：上海市徐汇区龙水南路99号B1层-01室
+
+        电话：021-61947163
+
+        开户行：招商银行股份有限公司上海田林支行
+
+        银行账号：121922114910604
+
+    3. 关于发票和收据：
+
+        1. 若违约金是从开发者分成收入中扣除的，违约金将在账单中作为坏账处理。开发者应根据开发者平台后台显示的实际结算收益金额开具发票，不再另行开具收据。
+        2. 若违约金无法从开发者分成收入中足额扣除，采用冻结结算款项方式处理。针对冻结的结算月份账单，不另开具收据。
+
+    4. 其余开发者分成实际收益结算事宜依据《\<我的世界\>开发者协议》的相关条款进行处理。 关于开发者分成实际收益结算的任何疑问，请通过联系客服按钮提交问题。
+
+6. **其他**
+
+    1. **本细则自发布之日起生效，并将不定期进行完善或修改，完善或修改后的新细则自更新之日起生效。**
+
+    2. **您同意并理解，为适应模组开发技术与平台检测能力的不断发展，我们有权根据平台业务需要对本细则进行更新。如更新内容为重大或实质性内容，我们将通过以下任意一种或多种方式通知您：网页公告、电子邮件、手机短信或常规的信件。该等通知自发送之日视为已送达您。如果您不同意更新的全部或者部分内容，您必需立即书面通知我们并按照相关程序指引停止使用我们的服务。否则，即视为您同意遵守前述更新内容。**
+
+    3. 本细则是您已签署的《\<我的世界\>开发者协议》等相关协议的组成部分，具有同等法律效力。本细则与《\<我的世界\>开发者协议》有冲突时，以本细则为准，本细则未作规定之内容，适用《\<我的世界\>开发者协议》等相关协议之约定。
+
+
+
+## 常见问题
+
+**Q：收到了警示邮件，我的组件会被弱下架吗？我对组件优化没有头绪，能获得官方的帮助吗？**
+
+
+
+A：目前警示系统会在组件性能数据恢复正常后，自动将其移出问题组件列表。因此，如果您的组件性能指标仅在阈值附近波动，无需担心被下架处理。我们也在持续优化警示邮件的发送机制，未来将在组件性能长期稳定超出阈值时才会发送通知，避免误报或过早干预。
+
+
+
+如果您的组件确实在一段时间内稳定超过性能标准，我们会根据问题的严重程度进行处理，包括可能的**暂时弱下架**，并进入**整改期**。整改期间建议您优先尝试自助优化组件性能；若在优化过程中遇到困难，欢迎通过开发者平台提交反馈，我们将提供必要支持。
+
+
+
+目前，我们正在对组件性能服务流程进行调试与优化，并会定期汇总开发者反馈中的共性问题，形成优化建议，帮助您更高效地提升组件质量。