chore(docs): doc for fileChooserAccept in yaml (#2273)

Author: EAGzzyCSL

apps/site/docs/en/automate-with-scripts-in-yaml.mdx

@@ -454,6 +454,7 @@ tasks:
         deepThink: <boolean> # Optional, whether to use deepThink to precisely locate the element. Defaults to False.
         xpath: <xpath> # Optional, the xpath of the target element for the operation. If provided, Midscene will prioritize this xpath to find the element before using the cache and the AI model. Defaults to empty.
         cacheable: <boolean> # Optional, whether to cache the result of this API call when the [caching feature](./caching.mdx) is enabled. Defaults to True.
+        fileChooserAccept: <path> | [<path1>, <path2>] # Optional, file path(s) to upload when the tap triggers a file chooser; only available on web
 
       # Hover over an element described by a prompt.
       - aiHover: <prompt>
@@ -519,6 +520,43 @@ tasks:
       # ...
 ```
 
+#### Upload Files With `aiTap`
+
+When clicking a button opens a file chooser, you can set `fileChooserAccept` directly on the `aiTap` step. It accepts either a single path or an array of paths.
+
+```yaml
+tasks:
+  - name: upload single file
+    flow:
+      - aiTap: Choose file button
+        fileChooserAccept: ./fixtures/document.pdf
+
+  - name: upload multiple files
+    flow:
+      - aiTap: Upload images button
+        fileChooserAccept:
+          - ./fixtures/image1.jpg
+          - ./fixtures/image2.png
+```
+
+If you are already using a `locate` object for `prompt`, `images`, or other locate options, keep `fileChooserAccept` at the same level as `locate`. Do not nest it inside `locate` or inside the `aiTap` object:
+
+```yaml
+tasks:
+  - name: upload file with locate
+    flow:
+      - aiTap:
+        locate:
+          prompt: Click the upload button
+        fileChooserAccept: ./fixtures/document.pdf
+```
+
+Notes:
+
+- `fileChooserAccept` is only available for web pages (Playwright, Puppeteer).
+- Relative paths are resolved from the current command working directory, not from the YAML file directory.
+- If a file does not exist, the script throws before the tap is executed.
+
 #### Prompting with images
 
 For steps whose prompt accepts images, you can attach images to the prompt by setting the `images` field to an array of objects, each containing a `name` and a `url`. (see the [API reference](./api#prompting-with-images)), replace the string value with an object that contains:

apps/site/docs/zh/automate-with-scripts-in-yaml.mdx

@@ -458,6 +458,7 @@ tasks:
         deepThink: <boolean> # 可选，是否使用深度思考（deepThink）来精确定位元素。默认值为 False
         xpath: <xpath> # 可选，目标元素的 xpath 路径，用于执行当前操作。如果提供了这个 xpath，Midscene 会优先使用该 xpath 来找到元素，然后依次使用缓存和 AI 模型。默认值为空
         cacheable: <boolean> # 可选，当启用 [缓存功能](./caching.mdx) 时，是否允许缓存当前 API 调用结果。默认值为 True
+        fileChooserAccept: <path> | [<path1>, <path2>] # 可选，当点击触发文件选择器时，指定要上传的文件路径；仅在 web 中可用
 
       # 鼠标悬停一个元素，用 prompt 描述元素位置
       - aiHover: <prompt>
@@ -526,6 +527,43 @@ tasks:
       # ...
 ```
 
+#### 使用 `aiTap` 上传文件
+
+当点击某个按钮会弹出文件选择器时，可以在 `aiTap` 步骤上直接设置 `fileChooserAccept`。它支持单个路径，也支持路径数组。
+
+```yaml
+tasks:
+  - name: 上传单个文件
+    flow:
+      - aiTap: 选择文件按钮
+        fileChooserAccept: ./fixtures/document.pdf
+
+  - name: 上传多个文件
+    flow:
+      - aiTap: 上传图片按钮
+        fileChooserAccept:
+          - ./fixtures/image1.jpg
+          - ./fixtures/image2.png
+```
+
+如果你已经在用 `locate` 对象写 `prompt`、`images` 等定位信息，`fileChooserAccept` 仍然要和 `locate` 保持同级，不要放到 `locate` 或 `aiTap` 的嵌套对象里：
+
+```yaml
+tasks:
+  - name: 带 locate 的文件上传
+    flow:
+      - aiTap:
+        locate:
+          prompt: 点击上传按钮
+        fileChooserAccept: ./fixtures/document.pdf
+```
+
+注意：
+
+- `fileChooserAccept` 仅在 web 页面（Playwright、Puppeteer）中可用。
+- 相对路径会基于当前命令执行目录解析，而不是基于 YAML 文件所在目录解析。
+- 如果文件不存在，脚本会在执行点击前直接报错。
+
 #### 使用图像提示
 
 对于支持在提示词中附带图像的步骤（参见 [API 参考](./api#prompting-with-images)），可以把提示词改写为对象，并通过设置 `images` 字段（一个包含 `name` 和 `url` 的对象数组）来附加图像。该对象包含以下字段：