docs: 增加关于肉鸽任务刷探索范式功能的说明 (#9552)

docs/zh-cn/protocol/integrated-strategy-schema.md

@@ -15,8 +15,10 @@ icon: ri:game-fill
   - 主题文件夹：`Phantom/` 为傀影肉鸽资源，`Mizuki/` 为水月肉鸽资源,`Sami/` 为萨米肉鸽资源
     - `autopilot/`内是各个关卡的作战 json
       - `关卡名.json` 关卡的作战逻辑
+      - `关卡名_collapse.json` 关卡的作战逻辑（刷坍缩范式模式）
     - `encounter.json` 不期而遇类事件逻辑（刷等级模式）
     - `encounter_for_deposit.json` 不期而遇类事件逻辑（刷源石锭模式）
+    - `encounter_for_collapse.json` 不期而遇类事件逻辑（刷坍缩范式模式）
     - `recruitment.json` 干员招募逻辑
     - `shopping.json` 商店购买藏品逻辑
 
@@ -530,9 +532,17 @@ OCR 识别不期而遇事件，但是选项是操作固定的位置
             "effect": "立即进阶两个干员（不消耗希望）",
             "no": 15
         },
+        ...
+
+        {
+            "name": "警戒篱木",
+            "effect": "坍缩值-2，目标生命上限+2",
+            "No": 198,
+            "decrease_collapse": true                          // true表示获得该藏品会降低坍缩值。在mode为5时将不会购买
+        },
 ```
 
-## 单独肉鸽定制逻辑
+## 肉鸽特殊机制
 
 ### 萨米肉鸽——密文板
 
@@ -585,6 +595,57 @@ OCR 识别不期而遇事件，但是选项是操作固定的位置
 
 ```
 
+### 萨米肉鸽——坍缩范式
+
+当`check_collapsal_paradigms`为`true`时，MAA 将以两种不同的手段检查坍缩范式：
+
+- 在选关界面点击屏幕中上方展开坍缩状态栏，以下称 Panel Check ；
+- 观察屏幕右侧是否有坍缩范式通知 以下称 Banner Check 。
+
+获取坍缩值的方法多种多样，我们考虑到了以下情况：
+
+1. 战斗后因非完美战斗而使坍缩值增加，进行 Banner Check 。
+2. 战斗后因获得收藏品而使坍缩值变动，进行 Banner Check 。
+3. 在不期而遇等节点中因选择选项而使坍缩值变动，进行 Banner Check 。
+4. 再诡异行商节点中因购买收藏品而使坍缩值变动，进行 Banner Check 。
+5. 因使用密文版而使坍缩值减少，进行 Banner Check 。
+6. 因进入新的一层而使坍缩值增加，进行 Panel Check 。
+7. 若进行 Banner Check 时发现坍缩范式消退，因不知道会不会一次性消退两层（即便会也概率极低），会在下一次回到选关洁面的时候额外触发一次 Panel Check 。
+8. 在`double_check_collapsal_paradigms`为`true`的情况下，每次回到选关界面的时候都会额外触发一次 Panel Check 以验证是否之前有漏、多记录坍缩范式。
+
+以下为刷隐藏坍缩范式的任务配置示例：
+
+```json
+{
+    "theme": "Sami",
+    "mode": 5,
+    "investment_enabled": false,
+    "squad": "远程战术分队",
+    "roles": "稳扎稳打",
+    "core_char": "维什戴尔",
+    "expected_collapsal_paradigms": [
+        "目空一些",
+        "睁眼瞎",
+        "图像损坏",
+        "一抹黑"
+    ]
+}
+```
+
+当`mode`为`5`时：
+
+- 优先使用`stage_name`为`关卡名_collapse`的作战策略，例如`resource/roguelike/Sami/autopilot/事不过四_collapse.json`；
+- 使用`resource/roguelike/Sami/encounter_for_collapse.json`中描述的不期而遇事件选择的策略，
+- 不会购买`decrease_collapse`为`true`的藏品。
+
+当`mode`不为`5`但`check_collapsal_paradigms`为`true`时，仍会检测坍缩范式并在遇到`expected_collapsal_paradigms`列表中的坍缩范式时停止任务，但在遇到其他坍缩范式时将不会重开。
+
+刷隐藏坍缩范式时，推荐N10难度，建议使用以下队伍：
+
+- 维什戴尔 + 斑点 + 史都华德；
+- 焰影苇草 + 梓兰 + 泡普卡；
+- 提丰 + 斑点 + 史都华德。
+
 ## 希望实现的逻辑（todo）
 
 ### 自动编队逻辑

docs/zh-cn/protocol/integration.md

@@ -228,6 +228,8 @@ AsstTaskId ASSTAPI AsstAppendTask(AsstHandle handle, const char* type, const cha
                             // 2 - 【即将弃用】两者兼顾，投资过后再退出，没有投资就继续往后打
                             // 3 - 开发中...
                             // 4 - 刷开局，到达第三层后直接退出
+                            // 5 - 刷坍缩范式，mode为5时有效，通过漏怪、在不期而遇节点选择特定选项等方式加快坍缩值积累，
+                            //     若第一个检测到的坍缩范式在expected_collapsal_paradigms列表中则停止任务，否则重开
     "starts_count": int,    // 开始探索 次数，可选，默认 INT_MAX。达到后自动停止任务
     "investment_enabled": bool, // 是否投资源石锭，默认开
     "investments_count": int,
@@ -241,10 +243,20 @@ AsstTaskId ASSTAPI AsstAppendTask(AsstHandle handle, const char* type, const cha
     "only_start_with_elite_two": bool,  // 是否只凹开局干员精二直升且不进行作战，可选，默认 false，start_with_elite_two为true时有效
     "use_support": bool,  // 开局干员是否为助战干员，可选，默认 false
     "use_nonfriend_support": bool,  // 是否可以是非好友助战干员，可选，默认 false，use_support为true时有效
-    "refresh_trader_with_dice": bool  // 是否用骰子刷新商店购买特殊商品，目前支持水月肉鸽的指路鳞，可选，默认 false
+    "refresh_trader_with_dice": bool,  // 是否用骰子刷新商店购买特殊商品，目前支持水月肉鸽的指路鳞，可选，默认 false
+    "use_foldartal": bool,                    // 是否使用密文板，mode为5时默认 false，否则默认 true
+    "check_collapsal_paradigms": bool,        // 是否检测获取的坍缩范式，mode为5时默认 true，否则默认 false
+    "double_check_collapsal_paradigms": bool, // 是否执行坍缩范式检测防漏措施，check_collapsal_paradigms为true时有效，
+                                              // mode为5时默认 true，否则默认 false
+    "expected_collapsal_paradigms": [         // 需要刷的坍缩范式，mode为5时有效
+        string,                               // 默认 ["目空一些, "睁眼瞎", "图像损坏", "一抹黑"]
+        ...
+    ]
 }
 ```
 
+刷坍缩范式功能具体请参考 [肉鸽辅助协议](./integrated-strategy-schema.md#萨米肉鸽——坍缩范式)
+
 - `Copilot`  
     自动抄作业