==================================================
MinerU 文档提取器 · uTools 插件
==================================================

将 PDF / Word / PPT / Excel / 图片 / 网页 一键转换为
Markdown、HTML、DOCX、JSON、LaTeX 等格式，
基于 MinerU 高精度文档解析引擎。


--------------------------------------------------
一、功能亮点
--------------------------------------------------
- 多格式输入：PDF、Office 全家桶、常见图片、网页 URL
- 多格式输出：一次提取可同时生成 MD / HTML / DOCX / JSON / LaTeX
- 双模型可选：VLM（高精度，推荐）/ Pipeline（零幻觉）
- 四种触发方式：关键词搜索、拖入文件、剪贴板图片、URL 匹配
- 实时进度：进度条 + 子进程日志实时输出，可随时取消
- 结果预览：内嵌 Markdown 渲染预览，支持复制 / 另存 / 打开目录
- 主题适配：自动跟随 uTools 亮 / 暗主题
- 隐私安全：Token 仅保存在本机，通过环境变量传递，不上传任何服务器


--------------------------------------------------
二、前置准备（首次使用必读）
--------------------------------------------------

1. 安装 mineru-open-api 命令行工具

本插件依赖 MinerU 官方 CLI，需先在命令行安装：

npm install -g mineru-open-api

验证安装成功：

mineru-open-api version

（也可在插件内若检测到未安装，点击“复制安装命令”获取上述命令。）


2. 获取并配置 MinerU Token

提取（extract）与网页（crawl）功能需要 Token：

(1) 前往 https://mineru.net/apiManage/token 创建 Token
(2) 在插件内点击“配置 Token”（顶部状态行或环境提示横幅）
(3) 粘贴 Token → 点击“验证并保存”

Token 仅保存在本机 uTools 数据库，通过环境变量 MINERU_TOKEN
传递给 CLI，不会随插件包外泄。


--------------------------------------------------
三、四种触发方式
--------------------------------------------------

1) 关键词
在 uTools 搜索框输入 MinerU / 文档提取 / 文档解析 /
PDF转MD / pdf转markdown
→ 进入主界面手动选择文件或粘贴图片

2) 拖入文件
从文件管理器拖文件到 uTools 搜索框 → 选“MinerU 提取此文件”
→ 跳过选择，直接进入配置确认

3) 剪贴板图片
复制截图 / 图片后，在主界面按 Ctrl+V 粘贴
→ 自动存为临时图片进入提取流程

4) 输入 URL
在 uTools 输入 http(s):// 开头的网址 → 选“MinerU 提取网页”
→ 走 crawl 模式提取网页内容


--------------------------------------------------
四、配置项说明
--------------------------------------------------

输出目录 默认 ~/MinerU-Skill/ 提取结果保存位置，可点“选择”更换
输出格式 默认 MD 可多选：MD / HTML / DOCX / JSON / LaTeX
识别模型 默认 VLM VLM 高精度（推荐）；Pipeline 零幻觉
语言 默认 中文 (ch) 可选 ch / en / auto
超时（秒） 默认 120 大文件建议调大（如 600）
页范围 默认 全部 仅文件模式可选，如 1-10

注意：网页提取（crawl）仅支持 MD / JSON / HTML 三种格式，
且无需模型与页范围。设置项会自动记忆，下次使用时自动填充。


--------------------------------------------------
五、使用步骤
--------------------------------------------------

1. 触发插件：用上述任一方式进入插件
2. 确认配置：在配置面板核对文件、输出目录、格式、模型等
3. 开始提取：点击“开始提取”，进入进度面板
4. 查看进度：进度条 + 实时日志显示提取过程，可点“取消”中止
5. 查看结果：提取完成后，内嵌预览 Markdown 渲染结果
6. 后续操作：
- 复制 MD：将 Markdown 内容复制到剪贴板
- 保存为文件：另存到指定位置
- 打开输出目录：在系统文件管理器中打开
- 重新提取：回到配置面板再次提取


--------------------------------------------------
六、Token 管理
--------------------------------------------------

- 状态查看：配置面板顶部“MinerU Token”状态行显示当前状态
（已配置 / 未配置 / 无效过期）
- 配置 / 重新配置：点状态行右侧按钮，打开 Token 弹窗
- 验证机制：保存前会调用 mineru-open-api auth --verify 校验，
无效则不保存


--------------------------------------------------
七、支持格式
--------------------------------------------------

文档：.pdf .docx .doc .pptx .ppt .xlsx .xls .txt
图片：.png .jpg .jpeg .bmp .webp .tiff .gif
网页：.html .htm 及任意 http(s):// URL


--------------------------------------------------
八、常见问题
--------------------------------------------------

Q：提示“mineru-open-api 未安装”
A：未安装 CLI，执行 npm install -g mineru-open-api

Q：提示“Token 无效或已过期”
A：Token 失效，重新到官网创建并配置

Q：提取超时
A：大文件请在配置中增大“超时”秒数（如 600）

Q：文件过大或页数超限
A：extract 受 Token 限制，确认 Token 有效；超大文件可分页提取

Q：输出目录无写入权限
A：更换到有权限的目录，如 ~/MinerU-Skill/

Q：未生成 Markdown
A：可能仅选了其它格式，检查输出格式勾选

Q：进度不动
A：CLI 进度输出到 stderr，若长时间无更新可能是网络问题，可取消重试


--------------------------------------------------
九、隐私与安全
--------------------------------------------------

- Token：仅存储于本机 uTools 数据库（utools.dbStorage），通过
环境变量传递给本地 CLI，绝不上传
- 文件：所有文件操作均在本地完成，不经过任何中间服务器
- 网络：仅 mineru-open-api CLI 与 MinerU 官方 API 通信，
插件本身不发起网络请求


--------------------------------------------------
十、技术信息
--------------------------------------------------

插件 ID：mineru-doc-extractor
依赖：Node.js 环境、mineru-open-api CLI、MinerU Token
技术栈：原生 HTML + CSS + Vanilla JS + Node.js（preload）
平台：Windows / macOS / Linux
官网：https://mineru.net

--------------------------------------------------
如遇问题，可先检查 CLI 是否正常（mineru-open-api version）
与 Token 是否有效，再重试提取。