MinerU 0.5.1 Run multiple files bug. #828

Closed
opened 2026-02-16 10:20:38 -05:00 by yindo · 2 comments
Owner

Originally created by @suntao2015005848 on GitHub (Nov 24, 2025).

Self Checks

  • I have read the Contributing Guide and Language Policy.
  • This is only for bug report, if you would like to ask a question, please head to Discussions.
  • I have searched for existing issues search for existing issues, including closed ones.
  • I confirm that I am using English to submit this report, otherwise it will be closed.
  • 【中文用户 & Non English User】请使用英语提交,否则会被关闭 :)
  • Please do not modify this template :) and fill in all the required fields.

Dify version

1.9.1

Cloud or Self Hosted

Self Hosted (Docker)

Steps to reproduce

Please resolve the multi-file upload parsing issue in the MinerU Dify Plugin version 0.5.1.

✔️ Expected Behavior

Image

Actual Behavior

No response

Originally created by @suntao2015005848 on GitHub (Nov 24, 2025). ### Self Checks - [x] I have read the [Contributing Guide](https://github.com/langgenius/dify/blob/main/CONTRIBUTING.md) and [Language Policy](https://github.com/langgenius/dify/issues/1542). - [x] This is only for bug report, if you would like to ask a question, please head to [Discussions](https://github.com/langgenius/dify/discussions/categories/general). - [x] I have searched for existing issues [search for existing issues](https://github.com/langgenius/dify/issues), including closed ones. - [x] I confirm that I am using English to submit this report, otherwise it will be closed. - [x] 【中文用户 & Non English User】请使用英语提交,否则会被关闭 :) - [x] Please do not modify this template :) and fill in all the required fields. ### Dify version 1.9.1 ### Cloud or Self Hosted Self Hosted (Docker) ### Steps to reproduce Please resolve the multi-file upload parsing issue in the MinerU Dify Plugin version 0.5.1. ### ✔️ Expected Behavior <img width="858" height="564" alt="Image" src="https://github.com/user-attachments/assets/2407f56b-500f-4c65-a6e5-813eaa8fb4dd" /> ### ❌ Actual Behavior _No response_
yindo added the bug label 2026-02-16 10:20:38 -05:00
yindo closed this issue 2026-02-16 10:20:38 -05:00
Author
Owner

@dosubot[bot] commented on GitHub (Nov 24, 2025):

The MinerU plugin v0.5.1 only supports single-file input—both the tool schema and backend code expect a single file, not an array. If you provide multiple files, only the first is processed and the rest are ignored, which causes the workflow to fail when a step expects a single file but receives multiple files instead. This is a known limitation and is tracked in open issues, but there is no official fix or merged pull request for multi-file support yet.

If you need multi-file upload support now, the best-practice workaround is to customize the OpenAPI schema for the plugin: define the files parameter as an array of binary strings and add a servers element. This allows you to transfer multiple files into the Dify app and process them as needed. You can see an example of this workaround and schema in this discussion.

To fully support multi-file uploads, both the plugin's YAML schema and the backend code would need to be updated to accept and process arrays of files instead of a single file parameter.

To reply, just mention @dosu.


How did I do? Good | Irrelevant | Incorrect | Verbose | Hallucination | Report 🐛 | Other

Chat with Dosu Open in Cursor Join Discord Share on X

@dosubot[bot] commented on GitHub (Nov 24, 2025): <!-- Answer --> The MinerU plugin v0.5.1 only supports single-file input—both the tool schema and backend code expect a single file, not an array. If you provide multiple files, only the first is processed and the rest are ignored, which causes the workflow to fail when a step expects a single file but receives multiple files instead. This is a known limitation and is tracked in open issues, but there is no official fix or merged pull request for multi-file support yet. If you need multi-file upload support now, the best-practice workaround is to customize the OpenAPI schema for the plugin: define the `files` parameter as an array of binary strings and add a `servers` element. This allows you to transfer multiple files into the Dify app and process them as needed. You can see an example of this workaround and schema in [this discussion](https://github.com/langgenius/dify-official-plugins/issues/1911). To fully support multi-file uploads, both the plugin's YAML schema and the backend code would need to be updated to accept and process arrays of files instead of a single file parameter. <!-- Dosu Comment Footer --> *To reply, just mention [@dosu](https://go.dosu.dev/dosubot).* --- <sup>How did I do? [Good](https://app.dosu.dev/response-feedback/290e5b89-28f2-4356-8b0f-ca8308728e28?feedback_type=great_response) | [Irrelevant](https://app.dosu.dev/response-feedback/290e5b89-28f2-4356-8b0f-ca8308728e28?feedback_type=irrelevant_answer) | [Incorrect](https://app.dosu.dev/response-feedback/290e5b89-28f2-4356-8b0f-ca8308728e28?feedback_type=incorrect_sources) | [Verbose](https://app.dosu.dev/response-feedback/290e5b89-28f2-4356-8b0f-ca8308728e28?feedback_type=too_verbose) | [Hallucination](https://app.dosu.dev/response-feedback/290e5b89-28f2-4356-8b0f-ca8308728e28?feedback_type=hallucination) | [Report 🐛](https://app.dosu.dev/response-feedback/290e5b89-28f2-4356-8b0f-ca8308728e28?feedback_type=bug_report) | [Other](https://app.dosu.dev/response-feedback/290e5b89-28f2-4356-8b0f-ca8308728e28?feedback_type=other)</sup> [![Chat with Dosu](https://dosu.dev/dosu-chat-badge.svg)](https://app.dosu.dev/6088a4f4-073a-43f3-b3d4-4f06fb0c05a0/ask?utm_source=github)&nbsp;[![Open in Cursor](https://dosu.dev/dosu-in-cursor.svg)](https://cursor.com/link/prompt?text=The%20MinerU%20plugin%20v0.5.1%20only%20supports%20single-file%20input%E2%80%94both%20the%20tool%20schema%20and%20backend%20code%20expect%20a%20single%20file%2C%20not%20an%20array.%20If%20you%20provide%20multiple%20files%2C%20only%20the%20first%20is%20processed%20and%20the%20rest%20are%20ignored%2C%20which%20causes%20the%20workflow%20to%20fail%20when%20a%20step%20expects%20a%20single%20file%20but%20receives%20multiple%20files%20instead.%20This%20is%20a%20known%20limitation%20and%20is%20tracked%20in%20open%20issues%2C%20but%20there%20is%20no%20official%20fix%20or%20merged%20pull%20request%20for%20multi-file%20support%20yet.%0A%0AIf%20you%20need%20multi-file%20upload%20support%20now%2C%20the%20best-practice%20workaround%20is%20to%20customize%20the%20OpenAPI%20schema%20for%20the%20plugin%3A%20define%20the%20%60files%60%20parameter%20as%20an%20array%20of%20binary%20strings%20and%20add%20a%20%60servers%60%20element.%20This%20allows%20you%20to%20transfer%20multiple%20files%20into%20the%20Dify%20app%20and%20process%20them%20as%20needed.%20You%20can%20see%20an%20example%20of%20this%20workaround%20and%20schema%20in%20%5Bthis%20discussion%5D%28https%3A//github.com/langgenius/dify-official-plugins/issues/1911%29.%0A%0ATo%20fully%20support%20multi-file%20uploads%2C%20both%20the%20plugin%27s%20YAML%20schema%20and%20the%20backend%20code%20would%20need%20to%20be%20updated%20to%20accept%20and%20process%20arrays%20of%20files%20instead%20of%20a%20single%20file%20parameter.)&nbsp;[![Join Discord](https://img.shields.io/badge/join-5865F2?logo=discord&logoColor=white&label=)](https://go.dosu.dev/discord-bot)&nbsp;[![Share on X](https://img.shields.io/badge/X-share-black)](https://twitter.com/intent/tweet?text=%40dosu_ai%20helped%20me%20solve%20this%20issue!&url=https%3A//github.com/langgenius/dify/issues/28617)
Author
Owner

@dosubot[bot] commented on GitHub (Nov 25, 2025):

The MinerU plugin v0.5.1 only supports single file uploads—both the local and remote parsing logic expect a single file object and do not handle lists of files. When multiple files are uploaded, the plugin processes only the first file and ignores the rest, which causes the workflow to fail if the parameter receives more than one file. This is a limitation in the plugin code, even though the backend API supports arrays of files in its schema. There is no official fix for this as of now. A user workaround is to customize the OpenAPI schema and implement a custom tool to handle multi-file uploads, but this requires manual changes and is not part of the official plugin release. If you need to process multiple files, you can upload them one at a time or consider adapting the plugin code to iterate over a list of files and submit each to the backend in sequence. For more details, see the code and related discussion here and here.

To reply, just mention @dosu.


How did I do? Good | Irrelevant | Incorrect | Verbose | Hallucination | Report 🐛 | Other

Open in Cursor Join Discord Share on X

@dosubot[bot] commented on GitHub (Nov 25, 2025): <!-- Answer --> The MinerU plugin v0.5.1 only supports single file uploads—both the local and remote parsing logic expect a single file object and do not handle lists of files. When multiple files are uploaded, the plugin processes only the first file and ignores the rest, which causes the workflow to fail if the parameter receives more than one file. This is a limitation in the plugin code, even though the backend API supports arrays of files in its schema. There is no official fix for this as of now. A user workaround is to customize the OpenAPI schema and implement a custom tool to handle multi-file uploads, but this requires manual changes and is not part of the official plugin release. If you need to process multiple files, you can upload them one at a time or consider adapting the plugin code to iterate over a list of files and submit each to the backend in sequence. For more details, see the code and related discussion [here](https://github.com/langgenius/dify-official-plugins/blob/1dd51cd351698fff818facea860a359293bfbe90/tools/mineru/tools/parse.py#L157-L547) and [here](https://github.com/langgenius/dify-official-plugins/issues/1911). <!-- Dosu Comment Footer --> *To reply, just mention [@dosu](https://go.dosu.dev/dosubot).* --- <sup>How did I do? [Good](https://app.dosu.dev/response-feedback/ce24894b-bb13-47b0-8401-1dbdbd4f4289?feedback_type=great_response) | [Irrelevant](https://app.dosu.dev/response-feedback/ce24894b-bb13-47b0-8401-1dbdbd4f4289?feedback_type=irrelevant_answer) | [Incorrect](https://app.dosu.dev/response-feedback/ce24894b-bb13-47b0-8401-1dbdbd4f4289?feedback_type=incorrect_sources) | [Verbose](https://app.dosu.dev/response-feedback/ce24894b-bb13-47b0-8401-1dbdbd4f4289?feedback_type=too_verbose) | [Hallucination](https://app.dosu.dev/response-feedback/ce24894b-bb13-47b0-8401-1dbdbd4f4289?feedback_type=hallucination) | [Report 🐛](https://app.dosu.dev/response-feedback/ce24894b-bb13-47b0-8401-1dbdbd4f4289?feedback_type=bug_report) | [Other](https://app.dosu.dev/response-feedback/ce24894b-bb13-47b0-8401-1dbdbd4f4289?feedback_type=other)</sup> [![Open in Cursor](https://dosu.dev/dosu-in-cursor.svg)](https://cursor.com/link/prompt?text=The%20MinerU%20plugin%20v0.5.1%20only%20supports%20single%20file%20uploads%E2%80%94both%20the%20local%20and%20remote%20parsing%20logic%20expect%20a%20single%20file%20object%20and%20do%20not%20handle%20lists%20of%20files.%20When%20multiple%20files%20are%20uploaded%2C%20the%20plugin%20processes%20only%20the%20first%20file%20and%20ignores%20the%20rest%2C%20which%20causes%20the%20workflow%20to%20fail%20if%20the%20parameter%20receives%20more%20than%20one%20file.%20This%20is%20a%20limitation%20in%20the%20plugin%20code%2C%20even%20though%20the%20backend%20API%20supports%20arrays%20of%20files%20in%20its%20schema.%20There%20is%20no%20official%20fix%20for%20this%20as%20of%20now.%20A%20user%20workaround%20is%20to%20customize%20the%20OpenAPI%20schema%20and%20implement%20a%20custom%20tool%20to%20handle%20multi-file%20uploads%2C%20but%20this%20requires%20manual%20changes%20and%20is%20not%20part%20of%20the%20official%20plugin%20release.%20If%20you%20need%20to%20process%20multiple%20files%2C%20you%20can%20upload%20them%20one%20at%20a%20time%20or%20consider%20adapting%20the%20plugin%20code%20to%20iterate%20over%20a%20list%20of%20files%20and%20submit%20each%20to%20the%20backend%20in%20sequence.%20For%20more%20details%2C%20see%20the%20code%20and%20related%20discussion%20%5Bhere%5D%28https%3A//github.com/langgenius/dify-official-plugins/blob/1dd51cd351698fff818facea860a359293bfbe90/tools/mineru/tools/parse.py%23L157-L547%29%20and%20%5Bhere%5D%28https%3A//github.com/langgenius/dify-official-plugins/issues/1911%29.)&nbsp;[![Join Discord](https://img.shields.io/badge/join-5865F2?logo=discord&logoColor=white&label=)](https://go.dosu.dev/discord-bot)&nbsp;[![Share on X](https://img.shields.io/badge/X-share-black)](https://twitter.com/intent/tweet?text=%40dosu_ai%20helped%20me%20solve%20this%20issue!&url=https%3A//github.com/langgenius/dify-official-plugins/issues/2131)
Sign in to join this conversation.
1 Participants
Notifications
Due Date
No due date set.
Dependencies

No dependencies set.

Reference: langgenius/dify-official-plugins#828