Yurzi/dsh-pdf-mineru

README 摘要

dsh-pdf-mineru 让 DeepSeek Harness 拥有强大的 PDF 与文档智能解析能力 支持 MinerU 官方云 (v4) 与 私有化自建服务 (v2) ，为 AI Agent 提供高精度的文档版面分析、公式与表格提取、图文解析，原生支持后台异步任务与智能缓存。 ✨ 核心亮点 · 🚀 快速开始 · 💬 对话示例 · ⚙️ 模型工具 · 🏗️ 工作架构 · 🔌 Provider 选型 · 🛠️ 设置与配置 · ❓ 常见问题 · 🧑‍💻 开发者指南 ✨ 核心亮点 - 📑 高质量结构化提取 ：精准识别双栏排版、复杂多级标题、LaTeX 数学公式、表格与插图，输出排版优雅的 Markdown。 - ☁️ 云端 / 本地自由切换 ：支持开箱即用的 MinerU 官方云 API （无需本地显卡）与 私有化自建服务 （数据不出内网），统一工具接口无缝切换。 - ⚡ 无感后台异步解析 ：几十页至数百页的长篇论文或研报，Agent 会自动提交为 DSH 原生后台任务（Native Job），解析期间不阻塞聊天，解析完成后自动提醒。 - 💾 智能内容寻址缓存 ：基于文件指纹与解析配置自动去重，同一份文档无需重复解析，极大节省 Token、官方 API 额度与计算资源，二次调用秒级响应。 - 🖥️ 深度集成 Web GUI ：提供内置可视化设置面板，支持一键连通性测试、参数预设、缓存统计与磁盘管理，配置即改即用。 🚀 快速开始 1. 安装插件 在 DeepSeek Harness 环境中一键安装： 本地开发或测试源码时，可使用： dsh plugin --profile web add link:/absolute/path/to/dsh-pdf-mineru 2. 配置与连接 打开 DSH 界面中的 Settings → Plugins → MinerU ，根据您的使用场景选择 Provider： 方案 A：使用 MinerU 官方云（推荐，免部署） 1. 前往 MinerU 官网 注册并获取 API Token。 2. 在终端配置环境变量（或通过 DSH 凭据服务管理）： 3. 在设置中选择 Official v4 ，保持 API Key Env Var 为 MINERU API KEY ，点击 Test Active Provider 即可完成验证。 方案 B：使用本地 / 私有化自建服务 1. 启动您的 MinerU 自建服务（如 FastAPI v2，默认端口 18000）。 2. 在设置中选择 Self-hosted v2 ，填入服务地址（例如 http://localhost:18000 ）。 3. 若使用本地 HTTP，勾选 Allow Insecure HTTP ，点击 Test Active Provider 验证连…

分类