docs: add resource.hash field to PI V2 (v2.6.0) (#1284)

Author: MistEO

docs/en_us/3.3-ProjectInterfaceV2.md

@@ -26,6 +26,7 @@ We have designated the version number for the independent release (January 30, 2
 | 2026-03-05 | v2.3.1  | Clarified option applicability filtering |
 | 2026-03-09 | v2.4.0  | Added top-level `group` declarations and `task.group` task grouping |
 | 2026-03-23 | v2.5.0  | Convention for `PI_*` environment variables when the Client starts Agent subprocesses (UI / Client metadata and the selected controller and resource with i18n resolved) |
+| 2026-04-18 | v2.6.0  | Added `resource.hash` resource integrity check field |
 
 ## `interface.json`
 
@@ -227,6 +228,12 @@ We have designated the version number for the independent release (January 30, 2
     _Optional._ Resource-level option configuration, an array of strings. Array elements should correspond to the key names in the outer `option` configuration. The parameters generated by this option will participate in the pipeline override of all tasks, serving as resource-level parameter passing.  
     If a referenced option does not satisfy the current controller/resource constraints, that option's `pipeline_override` (including nested `option.option`) must not be merged. **💡 v2.3.1**
 
+  - **hash** `string` **💡 v2.6.0**  
+    _Optional._ Resource integrity check value. This should be the hash string obtained via `MaaResourceGetHash` after loading only `path`.  
+    Verification should occur after loading `path` but before loading `controller.attach_resource_path`.  
+    If the actual hash does not match, a warning should be shown to the user (e.g. suggest re-downloading the resource package) without preventing continued use.  
+    Debug builds (e.g. pre-release versions) may skip this check. If this field is not set, no verification is needed.
+
     ```jsonc
     "resource": [
         {
@@ -238,7 +245,8 @@ We have designated the version number for the independent release (January 30, 2
         {
             "name": "GeneralResource",
             "label": "$GeneralResource",
-            "path": ["resource"]
+            "path": ["resource"],
+            "hash": "1a2b3c4d"
         }
     ]
     ```

docs/zh_cn/3.3-ProjectInterfaceV2协议.md

@@ -26,6 +26,7 @@
 | 2026-3-5 | v2.3.1 | 明确 option 适用性过滤规则 |
 | 2026-3-9 | v2.4.0 | 新增顶层 `group` 分组声明与 `task.group` 任务分组字段 |
 | 2026-3-23 | v2.5.0 | 约定 Client 启动 Agent 子进程时注入 `PI_*` 环境变量，传递 UI / Client 属性及当前选中的控制器与资源（i18n 已解析） |
+| 2026-4-18 | v2.6.0 | 新增 `resource.hash` 资源完整性校验字段 |
 
 ## `interface.json`
 
@@ -227,6 +228,12 @@
     可选。资源包级的选项配置，为一个字符串数组，数组元素应与外层 option 配置中的键名对应。  
     该选项生成的参数会参与到所有任务的 pipeline override 中，起到资源包级参数传递的作用。  
     若被引用的 option 不支持当前 controller/resource 条件，则该 option 的 `pipeline_override`（含其嵌套 `option.option`）不参与合并。 **💡 v2.3.1**
+
+  - hash `string` **💡 v2.6.0**  
+    可选。资源完整性校验值。该值应为仅加载 `path` 后通过 `MaaResourceGetHash` 获取的 hash 字符串。  
+    校验时机为加载完 `path` 后、加载 `controller.attach_resource_path` 之前。  
+    若实际 hash 与该值不匹配，应向用户发出警告（例如建议重新下载资源包），但不应阻止继续使用。  
+    调试版本（如预发布版本）可跳过此校验。若未设置此字段，无需校验。
 
     ```jsonc
     "resource": [
@@ -239,7 +246,8 @@
         {
             "name": "通用资源",
             "label": "$通用资源",
-            "path": ["resource"]
+            "path": ["resource"],
+            "hash": "1a2b3c4d"
         }
     ]
     ```

tools/interface.schema.json

@@ -677,6 +677,12 @@
                     "items": {
                         "type": "string"
                     }
+                },
+                "hash": {
+                    "type": "string",
+                    "minLength": 1,
+                    "title": "资源 hash",
+                    "description": "资源校验值，通过 MaaResourceGetHash 获取。校验时机为加载 resource.path 后、加载 controller.attach_resource_path 之前"
                 }
             },
             "required": [