# Pdf Batch

> 批量把含正文、表格、数学公式和图片的 PDF、DOCX、PPTX、XLSX 与图片转换为 Dify 文本库 Markdown 和多模态图片检索包。用户要求一键转换论文、OCR 扫描件、保留 LaTeX 公式/原图或生成批量转换清单时使用。

- **Type:** Skill
- **Install:** `agentstack add skill-mrsgsa-math-modeling-skill-dify-pdf-batch`
- **Verified:** Yes — security-reviewed for prompt injection and unsafe behavior
- **Seller:** [MrSGSA](https://agentstack.voostack.com/s/mrsgsa)
- **Installs:** 0
- **Category:** [Content & Media](https://agentstack.voostack.com/c/content-and-media)
- **Latest version:** 0.1.0
- **License:** MIT
- **Upstream author:** [MrSGSA](https://github.com/MrSGSA)
- **Source:** https://github.com/MrSGSA/math-modeling-skill-dify/tree/main/.agents/skills/math-modeling/tools/pdf-batch

## Install

```sh
agentstack add skill-mrsgsa-math-modeling-skill-dify-pdf-batch
```

Requires the [AgentStack CLI](https://agentstack.voostack.com/docs/cli). Works with Claude Code, Cursor, and any MCP-compatible agent.

## About

# 文档批量转 Markdown

调用 scripts/batch_convert.py 和 MinerU。保持输入文档只读，将结果写入 PROJECT_ROOT。旧式 `.doc` 先转换为 `.docx`。

## 环境与运行

MinerU 在 Windows 上要求 Python 3.10 至 3.12。本机默认 Python 可以用于启动批处理，但 MinerU 应使用 uv 建立的独立 Python 3.12 工具环境：

    uv tool install --python 3.12 "mineru[all]"

安装体积较大，未经用户同意不要自动安装或下载模型。在 PROJECT_ROOT 中运行：

    python \tools\pdf-batch\scripts\batch_convert.py --input knowledge_inbox\pdf --output knowledge_ready

默认使用支持纯 CPU 的 pipeline 后端。可用 --backend auto 切换默认后端，--dry-run 只检查计划，--force 强制重新转换。

推荐单次高精度转换同时生成文本库与图片库成品：

    python \tools\pdf-batch\scripts\batch_convert.py --input  --output  --markdown-output  --backend auto --effort high --image-analysis --dify-multimodal

此模式对每份文档只调用一次 MinerU，同时发布：

- 纯 Markdown：保留公式和图表分析文字、移除无法上传的本地图片链接，用于现有文本知识库。
- `.dify-mm.zip`：包含 `manifest.json`、`document.md` 和唯一命名的原图，用于配套 Dify 插件和统一多模态图片库。该包只索引含图片的块，正文仍由文本库负责。

只有两份成品都存在且不早于源文档时才跳过。中间 JSON、布局结果和临时目录在单篇完成后自动清理。

只需要一个 Markdown 时仍可使用 `--md-only`。

## 输出与检查

- 图片名包含源文档哈希、图序号和图片哈希；插件再按清单路径与 SHA-256 校验，避免跨论文串图。
- 同名且同扩展名的源文档会在输出名中加入内容哈希，避免覆盖。
- batch_report.json 记录源文件 SHA-256、命令、状态、耗时和输出。
- dify_upload_list.txt 列出成功生成的 Markdown，供用户手动上传。
- conversion.log 保存每篇文档的 MinerU 输出。

重复运行时跳过未变化且两份成品均已存在的文件。文本 Markdown 上传普通知识库；`.dify-mm.zip` 只上传统一多模态图片库。

## Source & license

This open-source skill is cataloged on AgentStack and links to its original source — we do not rehost the code.

- **Author:** [MrSGSA](https://github.com/MrSGSA)
- **Source:** [MrSGSA/math-modeling-skill-dify](https://github.com/MrSGSA/math-modeling-skill-dify)
- **License:** MIT

Install and usage instructions live in the source repository linked above.

## Pricing

- **Free** — Free

## Security capabilities

Automated source analysis of v0.1.0 — what this tool can access:

- **Network access:** no
- **Filesystem access:** no
- **Shell / process execution:** no
- **Environment & secrets:** no
- **Dynamic code execution:** no

*"Yes" means the capability is present in the source — more access means more to trust, not that it is unsafe.*


## Versions

- **0.1.0** — security scan: passed — Imported from the upstream source.

## Links

- Listing page: https://agentstack.voostack.com/l/skill-mrsgsa-math-modeling-skill-dify-pdf-batch
- Seller: https://agentstack.voostack.com/s/mrsgsa
- Browse the marketplace: https://agentstack.voostack.com/browse

---
Listed on AgentStack — the marketplace for AI agent skills and MCP servers. Every listing is security-reviewed. Creators keep 70%.