Transforms complex documents like PDFs and Office docs into LLM-ready markdown/JSON for your Agentic workflows.
Python ai4sciencedocument-analysisdocxextract-datalayout-analysisocrparserpdfpdf-converterpdf-extractor-llmpdf-extractor-pretrainpdf-extractor-ragpdf-parserpptxpythonxlsx
Document PR triage outcomes and service retention and recovery settings
myhloli5b477601a0af
diff --git a/docs/next/api/uploads-files.md b/docs/next/api/uploads-files.mdindex 503ca0df..b943aab0 100644--- a/docs/next/api/uploads-files.md+++ b/docs/next/api/uploads-files.md@@ -376,3 +376,12 @@ Router 把完成上传的源字节缓存在私有临时存储,并按调用方本地未命中时,即使某个 worker 已保存该 blob,Router 仍接收客户端字节以保留跨 worker 转移能力。`/v1/tasks` 与 `/v1/file_parse` 的上传共用此缓存;只改变源文件名视图不需要再次发送字节。删除一个文件别名不会删除其他别名或正在传输的数据。完整行为见 [V1 便捷解析](tasks.md)。++## Local Server 保留期限++Local Server 的任务及解析产物默认保留 86400 秒,从任务清理完成时间计算。到期后的+新请求返回 404;已提交任务持有输入字节租约,源文件视图在排队期间到期不影响该任务。+Upload 的显式 `expires_after` 保持生效,已完成 Upload 到期后也不再允许读取其旧视图。+源文件由独立文件视图和任务引用共同保护,删除一个同哈希文件不会删除其他引用使用的字节。+`--retention-seconds 0` 关闭自动回收,但不取消 Upload 的显式期限。+详见 [服务配置](../cli/mineru-kit-api-server.md)。diff --git a/docs/next/api/usage-limits.md b/docs/next/api/usage-limits.mdindex 37e72a14..8d088ea4 100644--- a/docs/next/api/usage-limits.md+++ b/docs/next/api/usage-limits.md@@ -134,7 +134,8 @@ Local Parse Server 的 usage 不表达计费周期,而是表达本地进程视- `billing_period.start` 是服务进程启动时间。- `billing_period.end` 为 `null`。- `current.*` 是自启动以来的累计值。-- `limits.max_file_retention_days` 为 `null`,除非本地实现了自动清理策略。+- `limits.max_file_retention_days` 默认 1;`retention_seconds` 为 0 时是 `null`,其他秒数按天向上取整展示。+- 终态任务和产物默认保留 24 小时,清理后 `current.*` 累计用量不减少。具体配置和输入租约见 [服务说明](../cli/mineru-kit-api-server.md)。- `access_level` 取决于是否启用并通过 API Key 鉴权。本地 server 可以不实现公网同等级别的限流。若实现限流,也应复用同一错误 envelope、`Retry-After` 和 `X-RateLimit-*` 响应头。diff --git a/docs/next/cli/mineru-kit-api-server.md b/docs/next/cli/mineru-kit-api-server.mdindex 5ad25961..990ba92c 100644--- a/docs/next/cli/mineru-kit-api-server.md+++ b/docs/next/cli/mineru-kit-api-server.md@@ -174,6 +174,7 @@ Python 可使用 `create_app(vlm_config=VlmConfig(...))` 完整覆盖全局配- disable-image-analysis- concurrency- upload-dir+- retention-seconds(默认 86400 秒,0 关闭自动回收)- url-timeout- allow-local-source- max-inline-bytes@@ -203,3 +204,40 @@ Python 可使用 `create_app(vlm_config=VlmConfig(...))` 完整覆盖全局配- `/invalidate`完整设计背景见 [ADR-0017](../decisions/0017-mineru-kit-api-server-command.md)。++## 资源保留、引擎状态与离线文档++API 创建参数 `create_app(retention_seconds=...)`、API/Router 的 `--retention-seconds`+及环境变量 `MINERU_API_RETENTION_SECONDS` 使用同一设置,显式参数优先,默认 86400 秒。+零关闭自动回收;上传的显式 `expires_after` 期限继续生效。每 300 秒扫描一次,已到期资源+立即对新的读取/提交返回 404,磁盘删除可延迟至下一次扫描。任务和产物的保留时间从任务+取消或推理结束后的实际清理完成时计算,排队和运行时间不计入。长时间运行任务已产生的+产物在清理完成前不会到期。++```bash+mineru-kit api-server --retention-seconds 172800+mineru-kit router --retention-seconds 172800+# 持久保留:+mineru-kit api-server --retention-seconds 0+```++源文件的多个名字视图和多个任务共享内容寻址字节。排队、运行、哈希预检、下载、写入+及跨 worker 传输期间保护字节,最后一个引用释放后才允许回收。元数据保持内存模式;+服务重启后旧资源 ID 不恢复,启动扫描只清理超过保留时间的受管无引用文件。一个上传目录+只能由一个 API 服务实例占用;多实例应分别配置目录。Router 同步回收过期路由及源缓存,+等待重试的输入副本清理仍由后台处理,过期资源不重新向用户开放。++明确的本地引擎死亡(例如 vLLM `EngineDeadError`)使健康检查和后续提交返回现有错误+封装及 HTTP 503,错误码为 `engine_dead`。当前任务取消后等清理完成,排队任务失败,+用户主动取消仍为 `canceled`。普通解析错误或远程超时不会判定本地引擎死亡。Router+立即剔除故障 worker;托管进程按现有启停超时重建,失败按 5/10/20/30 秒退避;外部+worker 由其管理方恢复。旧 generation 的未完成任务保留失败快照供查询至到期。++`/docs`、`/redoc`、`/openapi.json` 默认启用,JS/CSS/图标位于 `/docs/assets` 下并来自+安装包。Swagger 的 Bearer 授权和 OAuth 回调支持代理 `root_path`;ReDoc 的品牌图标也+使用本地资源。`MINERU_API_ENABLE_FASTAPI_DOCS=false` 同时关闭文档入口及资源挂载。++Torch 小模型首次初始化时限制 CPU 线程,并传播到后续工作线程。有效 OMP/MKL 显式+配置优先,否则依次使用 `MINERU_CPU_NUM_THREADS`、`MINERU_INTRA_OP_NUM_THREADS`、8。+按 CPU 亲和性及 cgroup 配额裁剪,且不调高已有更低值。单独设置 OpenBLAS 不视为 Torch+线程限制。纯 ONNX/Flash 的启动路径保持惰性加载。diff --git a/docs/next/pr-review-20261010-closures.json b/docs/next/pr-review-20261010-closures.jsonnew file mode 100644index 00000000..cf027d6d--- /dev/null+++ b/docs/next/pr-review-20261010-closures.json@@ -0,0 +1,162 @@+{+ "5490": {+ "reason": "当前 DocVortex 已按字形来源保护连字展开,旧字符去重实现已移除。",+ "comment_id": 6084772277,+ "comment_url": "https://github.com/opendatalab/MinerU/pull/5490#issuecomment-6084772277",+ "state": "closed",+ "url": "https://github.com/opendatalab/MinerU/pull/5490",+ "verified_at": "2026-10-09T17:01:37.703464+00:00"+ },+ "5424": {+ "reason": "对应渲染测试已迁到 DocVortex,其测试依赖已经包含 Markdown。",+ "comment_id": 6084774355,+ "comment_url": "https://github.com/opendatalab/MinerU/pull/5424#issuecomment-6084774355",+ "state": "closed",+ "url": "https://github.com/opendatalab/MinerU/pull/5424",+ "verified_at": "2026-10-09T17:01:37.741095+00:00"+ },+ "5420": {+ "reason": "当前基础依赖已移除 OpenCV,不再需要替换为 headless 包。",+ "comment_id": 6084776289,+ "comment_url": "https://github.com/opendatalab/MinerU/pull/5420#issuecomment-6084776289",+ "state": "closed",+ "url": "https://github.com/opendatalab/MinerU/pull/5420",+ "verified_at": "2026-10-09T17:01:37.809655+00:00"+ },+ "5402": {+ "reason": "输出文档已按新协议重写,原错误图片引用已经不存在。",+ "comment_id": 6084778495,+ "comment_url": "https://github.com/opendatalab/MinerU/pull/5402#issuecomment-6084778495",+ "state": "closed",+ "url": "https://github.com/opendatalab/MinerU/pull/5402",+ "verified_at": "2026-10-09T17:01:37.784107+00:00"+ },+ "5382": {+ "reason": "当前支持的 MLX 版本已升级,不继续维护旧版解码器运行时补丁。",+ "comment_id": 6084780522,+ "comment_url": "https://github.com/opendatalab/MinerU/pull/5382#issuecomment-6084780522",+ "state": "closed",+ "url": "https://github.com/opendatalab/MinerU/pull/5382",+ "verified_at": "2026-10-09T17:01:37.755555+00:00"+ },+ "5364": {+ "reason": "当前共享 Markdown renderer 已处理普通文本中的 HTML 标签转义。",+ "comment_id": 6084782471,+ "comment_url": "https://github.com/opendatalab/MinerU/pull/5364#issuecomment-6084782471",+ "state": "closed",+ "url": "https://github.com/opendatalab/MinerU/pull/5364",+ "verified_at": "2026-10-09T17:01:40.306935+00:00"+ },+ "5354": {+ "reason": "当前运行时已有窗口及文档结束时的显式堆回收能力。",+ "comment_id": 6084784530,+ "comment_url": "https://github.com/opendatalab/MinerU/pull/5354#issuecomment-6084784530",+ "state": "closed",+ "url": "https://github.com/opendatalab/MinerU/pull/5354",+ "verified_at": "2026-10-09T17:01:40.553673+00:00"+ },+ "5335": {+ "reason": "当前实现已经覆盖文档结束后的可选堆回收,此实现重复。",+ "comment_id": 6084786434,+ "comment_url": "https://github.com/opendatalab/MinerU/pull/5335#issuecomment-6084786434",+ "state": "closed",+ "url": "https://github.com/opendatalab/MinerU/pull/5335",+ "verified_at": "2026-10-09T17:01:40.506057+00:00"+ },+ "5261": {+ "reason": "当前 V1 API 已提供具体响应模型,旧 API 实现已移除。",+ "comment_id": 6084788503,+ "comment_url": "https://github.com/opendatalab/MinerU/pull/5261#issuecomment-6084788503",+ "state": "closed",+ "url": "https://github.com/opendatalab/MinerU/pull/5261",+ "verified_at": "2026-10-09T17:01:40.600825+00:00"+ },+ "5240": {+ "reason": "被修改的旧多桶 S3 reader/writer 已移除,不适用于当前版本。",+ "comment_id": 6084790442,+ "comment_url": "https://github.com/opendatalab/MinerU/pull/5240#issuecomment-6084790442",+ "state": "closed",+ "url": "https://github.com/opendatalab/MinerU/pull/5240",+ "verified_at": "2026-10-09T17:01:40.473537+00:00"+ },+ "5208": {+ "reason": "旧模型路径配置写回流程已移除,当前模型 registry 不经过该函数。",+ "comment_id": 6084792343,+ "comment_url": "https://github.com/opendatalab/MinerU/pull/5208#issuecomment-6084792343",+ "state": "closed",+ "url": "https://github.com/opendatalab/MinerU/pull/5208",+ "verified_at": "2026-10-09T17:01:43.053240+00:00"+ },+ "5184": {+ "reason": "当前相关安装示例已经加引号或改写。",+ "comment_id": 6084794422,+ "comment_url": "https://github.com/opendatalab/MinerU/pull/5184#issuecomment-6084794422",+ "state": "closed",+ "url": "https://github.com/opendatalab/MinerU/pull/5184",+ "verified_at": "2026-10-09T17:01:43.332651+00:00"+ },+ "5119": {+ "reason": "当前没有 albumentations 调用,HF 依赖已包含 hf_xet extra。",+ "comment_id": 6084796404,+ "comment_url": "https://github.com/opendatalab/MinerU/pull/5119#issuecomment-6084796404",+ "state": "closed",+ "url": "https://github.com/opendatalab/MinerU/pull/5119",+ "verified_at": "2026-10-09T17:01:43.093813+00:00"+ },+ "5107": {+ "reason": "当前使用明确的 concurrency 配置,macOS 已能按配置运行。",+ "comment_id": 6084798343,+ "comment_url": "https://github.com/opendatalab/MinerU/pull/5107#issuecomment-6084798343",+ "state": "closed",+ "url": "https://github.com/opendatalab/MinerU/pull/5107",+ "verified_at": "2026-10-09T17:01:43.275471+00:00"+ },+ "5136": {+ "reason": "当前已有公开 parser/kit 接口,此旧 SDK 实现不兼容并重复现有能力。",+ "comment_id": 6084800349,+ "comment_url": "https://github.com/opendatalab/MinerU/pull/5136#issuecomment-6084800349",+ "state": "closed",+ "url": "https://github.com/opendatalab/MinerU/pull/5136",+ "verified_at": "2026-10-09T17:01:43.374276+00:00"+ },+ "5441": {+ "reason": "当前对应 Advanced 的 VLM 布局;暂不在 MinerU 添加去重,后续需要时应由 mineru-vl-utils 处理。",+ "comment_id": 6084802167,+ "comment_url": "https://github.com/opendatalab/MinerU/pull/5441#issuecomment-6084802167",+ "state": "closed",+ "url": "https://github.com/opendatalab/MinerU/pull/5441",+ "verified_at": "2026-10-09T17:01:45.654118+00:00"+ },+ "5412": {+ "reason": "当前不计划支持 Word 自定义编号模板,以控制列表模型及渲染复杂度。",+ "comment_id": 6084804045,+ "comment_url": "https://github.com/opendatalab/MinerU/pull/5412#issuecomment-6084804045",+ "state": "closed",+ "url": "https://github.com/opendatalab/MinerU/pull/5412",+ "verified_at": "2026-10-09T17:01:45.669151+00:00"+ },+ "5270": {+ "reason": "当前不恢复 Word 编号模板及计数,标题编号维持既有语义规则。",+ "comment_id": 6084805942,+ "comment_url": "https://github.com/opendatalab/MinerU/pull/5270#issuecomment-6084805942",+ "state": "closed",+ "url": "https://github.com/opendatalab/MinerU/pull/5270",+ "verified_at": "2026-10-09T17:01:45.917604+00:00"+ },+ "5369": {+ "reason": "DOCX 按流式语义文档处理,维持分节分页,不增加手动分页符或排版属性驱动的分页。",+ "comment_id": 6084807744,+ "comment_url": "https://github.com/opendatalab/MinerU/pull/5369#issuecomment-6084807744",+ "state": "closed",+ "url": "https://github.com/opendatalab/MinerU/pull/5369",+ "verified_at": "2026-10-09T17:01:45.974763+00:00"+ },+ "5607": {+ "reason": "问题已在维护分支 dev 通过负载调度和上传轮转解决(提交 e61475184757d3fe02aa1dd74b935493ce721f92),此替代实现关闭。此处指维护分支实现,不代表上游发布版已经包含。",+ "comment_id": 6084809761,+ "comment_url": "https://github.com/opendatalab/MinerU/pull/5607#issuecomment-6084809761",+ "state": "closed",+ "url": "https://github.com/opendatalab/MinerU/pull/5607",+ "verified_at": "2026-10-09T17:01:46.158840+00:00"+ }+}diff --git a/docs/next/pr-review-20261010.md b/docs/next/pr-review-20261010.mdnew file mode 100644index 00000000..fca887f1--- /dev/null+++ b/docs/next/pr-review-20261010.md@@ -0,0 +1,108 @@+# MinerU PR 处理记录:2026-10-10++本轮范围为原审查的 54 个开放 PR:20 个已评论并关闭,6 个问题已在当前维护代码修复,28 个暂缓。+本轮未自动合并、推送或发布版本;未对六个待修复 PR 和暂缓 PR 发表评论。原有未跟踪 `examples/` 保留。++## 关闭结果++失败项:0。评论 ID、URL、逐项关闭原因和最终核验时间保存于 [关闭记录 JSON](pr-review-20261010-closures.json)。++| PR | 原因 | 评论 ID | 最终状态 |+| --- | --- | --- | --- |+| [#5490](https://github.com/opendatalab/MinerU/pull/5490) | 当前 DocVortex 已按字形来源保护连字展开,旧字符去重实现已移除。 | [6084772277](https://github.com/opendatalab/MinerU/pull/5490#issuecomment-6084772277) | closed |+| [#5424](https://github.com/opendatalab/MinerU/pull/5424) | 对应渲染测试已迁到 DocVortex,其测试依赖已经包含 Markdown。 | [6084774355](https://github.com/opendatalab/MinerU/pull/5424#issuecomment-6084774355) | closed |+| [#5420](https://github.com/opendatalab/MinerU/pull/5420) | 当前基础依赖已移除 OpenCV,不再需要替换为 headless 包。 | [6084776289](https://github.com/opendatalab/MinerU/pull/5420#issuecomment-6084776289) | closed |+| [#5402](https://github.com/opendatalab/MinerU/pull/5402) | 输出文档已按新协议重写,原错误图片引用已经不存在。 | [6084778495](https://github.com/opendatalab/MinerU/pull/5402#issuecomment-6084778495) | closed |+| [#5382](https://github.com/opendatalab/MinerU/pull/5382) | 当前支持的 MLX 版本已升级,不继续维护旧版解码器运行时补丁。 | [6084780522](https://github.com/opendatalab/MinerU/pull/5382#issuecomment-6084780522) | closed |+| [#5364](https://github.com/opendatalab/MinerU/pull/5364) | 当前共享 Markdown renderer 已处理普通文本中的 HTML 标签转义。 | [6084782471](https://github.com/opendatalab/MinerU/pull/5364#issuecomment-6084782471) | closed |+| [#5354](https://github.com/opendatalab/MinerU/pull/5354) | 当前运行时已有窗口及文档结束时的显式堆回收能力。 | [6084784530](https://github.com/opendatalab/MinerU/pull/5354#issuecomment-6084784530) | closed |+| [#5335](https://github.com/opendatalab/MinerU/pull/5335) | 当前实现已经覆盖文档结束后的可选堆回收,此实现重复。 | [6084786434](https://github.com/opendatalab/MinerU/pull/5335#issuecomment-6084786434) | closed |+| [#5261](https://github.com/opendatalab/MinerU/pull/5261) | 当前 V1 API 已提供具体响应模型,旧 API 实现已移除。 | [6084788503](https://github.com/opendatalab/MinerU/pull/5261#issuecomment-6084788503) | closed |+| [#5240](https://github.com/opendatalab/MinerU/pull/5240) | 被修改的旧多桶 S3 reader/writer 已移除,不适用于当前版本。 | [6084790442](https://github.com/opendatalab/MinerU/pull/5240#issuecomment-6084790442) | closed |+| [#5208](https://github.com/opendatalab/MinerU/pull/5208) | 旧模型路径配置写回流程已移除,当前模型 registry 不经过该函数。 | [6084792343](https://github.com/opendatalab/MinerU/pull/5208#issuecomment-6084792343) | closed |+| [#5184](https://github.com/opendatalab/MinerU/pull/5184) | 当前相关安装示例已经加引号或改写。 | [6084794422](https://github.com/opendatalab/MinerU/pull/5184#issuecomment-6084794422) | closed |+| [#5119](https://github.com/opendatalab/MinerU/pull/5119) | 当前没有 albumentations 调用,HF 依赖已包含 hf_xet extra。 | [6084796404](https://github.com/opendatalab/MinerU/pull/5119#issuecomment-6084796404) | closed |+| [#5107](https://github.com/opendatalab/MinerU/pull/5107) | 当前使用明确的 concurrency 配置,macOS 已能按配置运行。 | [6084798343](https://github.com/opendatalab/MinerU/pull/5107#issuecomment-6084798343) | closed |+| [#5136](https://github.com/opendatalab/MinerU/pull/5136) | 当前已有公开 parser/kit 接口,此旧 SDK 实现不兼容并重复现有能力。 | [6084800349](https://github.com/opendatalab/MinerU/pull/5136#issuecomment-6084800349) | closed |+| [#5441](https://github.com/opendatalab/MinerU/pull/5441) | 当前对应 Advanced 的 VLM 布局;暂不在 MinerU 添加去重,后续需要时应由 mineru-vl-utils 处理。 | [6084802167](https://github.com/opendatalab/MinerU/pull/5441#issuecomment-6084802167) | closed |+| [#5412](https://github.com/opendatalab/MinerU/pull/5412) | 当前不计划支持 Word 自定义编号模板,以控制列表模型及渲染复杂度。 | [6084804045](https://github.com/opendatalab/MinerU/pull/5412#issuecomment-6084804045) | closed |+| [#5270](https://github.com/opendatalab/MinerU/pull/5270) | 当前不恢复 Word 编号模板及计数,标题编号维持既有语义规则。 | [6084805942](https://github.com/opendatalab/MinerU/pull/5270#issuecomment-6084805942) | closed |+| [#5369](https://github.com/opendatalab/MinerU/pull/5369) | DOCX 按流式语义文档处理,维持分节分页,不增加手动分页符或排版属性驱动的分页。 | [6084807744](https://github.com/opendatalab/MinerU/pull/5369#issuecomment-6084807744) | closed |+| [#5607](https://github.com/opendatalab/MinerU/pull/5607) | 问题已在维护分支 dev 通过负载调度和上传轮转解决(提交 e61475184757d3fe02aa1dd74b935493ce721f92),此替代实现关闭。此处指维护分支实现,不代表上游发布版已经包含。 | [6084809761](https://github.com/opendatalab/MinerU/pull/5607#issuecomment-6084809761) | closed |++## 六项修复与提交++实现基线:MinerU dev `e61475184757d3fe02aa1dd74b935493ce721f92`;DocVortex main `896daf3d702ca8f6a9a945f6171c31d855b5eab3`。原 PR 的旧路径实现未直接合并。++| PR | 当前实现 | 本地提交 |+| --- | --- | --- |+| [#5188](https://github.com/opendatalab/MinerU/pull/5188) | 异常类型/链识别、引擎死亡锁定、503/engine_dead、排队失败、取消清理、单 generation 替换及退避、失败快照与迟到响应保护。 | c92834be、6a5e7b2d、aa30e087 |+| [#5477](https://github.com/opendatalab/MinerU/pull/5477) | Torch 初始化边界及后续工作线程传播,配置优先级、有效 CPU 配额和已有更低上限保护;Linux 对照工具。 | ae2f957e、26c31974、7b19a73a |+| [#5495](https://github.com/opendatalab/MinerU/pull/5495) | 默认 24h/0 禁用、300s 扫描、终态和产物 TTL、CAS 输入/预检/写入/下载保护、源缓存与路由回收、目录锁、累计用量保留。 | 56f90f98、badb8cee、143077ef |+| [#5526](https://github.com/opendatalab/MinerU/pull/5526) | 仅补 5 个行尾标点及 3 个行首标点,Python 与原生快照统一传递规则;真实 PDF 边界与邻框归属。 | ee8244be |+| [#5389](https://github.com/opendatalab/MinerU/pull/5389) | PPTX 按 run/XML 顺序保留表格富文本链接;DOCX 公式表格重建/完整上下文 fallback 保留链接,无效目标保留文字。MinerU 只通过公开接口验收。 | DocVortex 519cd623;MinerU 132a7728 |+| [#5341](https://github.com/opendatalab/MinerU/pull/5341) | fastapi-offline>=1.7.7,<2,本地文档资源、Bearer 授权、OAuth 代理前缀、关闭时无资源挂载,ReDoc 不请求远程品牌图标。 | 2ce1df87、329b6250 |++## 验收++- MinerU:18 个相关模块共 **485 passed**,覆盖服务/Router/异步清理、缓存、CLI、ONNX、Torch、PDF 字符与 Office 公开入口。+- DocVortex:6 个 Office/公式模块共 **74 passed**。共享源码当前提交为 `519cd623`,工作区干净;MinerU Office 集成使用该同一提交。+- CJK 真实 PDF 比较:源文、修复前缺失标点、修复后回填与框图已逐行查看;8 个新增标点补齐,邻框的“邻”没有串入。产物:`output/pdf/cjk-boundary-comparison.pdf`、`.png`。+- 浏览器禁止非 localhost 请求:Swagger 展示 23 个操作,Bearer 授权的文件查询返回 200;ReDoc 展示 32 个标题;最终两页均无外部资源请求。图片:`output/playwright/offline-swagger.png`、`offline-redoc.png`。+- 真实托管进程冒烟:generation 1 解析 DOCX 后结束该测试进程,Router 重建到 generation 2;新代首次 PPTX 解析成功、链接保留、负载归零,关闭后进程和临时存储已清理。+- 从独立目录安装 MinerU wheel 与 fastapi-offline 1.7.7 wheel,确认实际导入安装目录,文档入口、JS/CSS/favicon 全部 200。+- Ruff 与 git diff --check 通过。完整命令输出存于 `/tmp/mineru-pr-audit-20261010/`。+- **Linux 六轮 1/3 并发性能对照待验收**:本机为 macOS,无 Linux 容器运行时;现有 Hugging Face SSH 返回“SSH is only allowed in Dev mode”。本轮未开启 Dev mode 或更改部署。真实 Torch 线程池和配置回归已通过,但不能代替 Linux PDF 的线程数/耗时/RSS/输出验收。+- **发布集成待办**:DocVortex 519cd623 尚未发布。当前最低依赖版本未擅自提高到一个未发布版本;发布包含该提交的版本后,再提高 MinerU 的最低 DocVortex 依赖并验证安装集成。当前 editable 提交验收不代表 PyPI 版本已经包含修复。++## Linux 对照步骤++用同一 Linux 主机、同一个 Python 环境、同一 DocVortex 提交与固定 PDF,分别运行CPU 上限修改前的基线(`ee8244be`,已包含本轮 CJK 修复)和候选 MinerU。先保持 OMP/MKL 配置一致并记录,再测试无显式配置的默认上限;不将两个不同宿主的结果相比较。工具每个进程预热一次,然后交替执行六轮 1/3 并发,记录线程数、耗时、RSS、实际导入的源码路径和 Markdown/Structured Content 哈希。++```bash+PYTHONPATH=/path/to/mineru-before /path/to/python /path/to/mineru-after/tools/benchmark_torch_cpu_threads.py --pdf /path/to/fixed.pdf --label before --output /path/to/before.json --require-linux+PYTHONPATH=/path/to/mineru-after /path/to/python /path/to/mineru-after/tools/benchmark_torch_cpu_threads.py --pdf /path/to/fixed.pdf --label after --output /path/to/after.json --require-linux+```++逐轮核对所有输出哈希、线程数是否趋于稳定、耗时和 RSS 的变化;暂不宣称已达到 Linux 性能验收或获得加速。++## 保持现状及暂缓++DOCX 仍按分节标记划分语义页面。本轮不增加手动分页符、软分页或排版属性驱动的分页,不支持 Word 自定义编号模板。VLM 布局去重暂不在 MinerU 增加,需要时归 mineru-vl-utils。++- #5376:保留合法 Markdown 效果;后续拿明确的字面意义丢失样本决定是否仅转义普通文本,结构化列表另行讨论。+- #4791:U+2060 是合法 WORD JOINER;默认 OCR 字典没有该字符,合成样本不足以证明默认模型故障。待真实输入区分 OCR 输出与原文,暂不全局清理。+- #5333:保留 read-only openpyxl 多次 `.cell()` 导致重复 XML 扫描的性能问题。后续验证单次 iter_rows 与尾部空值;内部空值和顺序要保留,SVG 支持另议。++以下 28 个 PR 本轮未评论、未关闭、未修改对应功能:++| PR | 标题 | 处理 |+| --- | --- | --- |+| [#5625](https://github.com/opendatalab/MinerU/pull/5625) | Degrade to local layout blocks when VLM output decoding fails mid-window (Refs #5604) | 暂缓记录 |+| [#5620](https://github.com/opendatalab/MinerU/pull/5620) | feat: add request-level table, formula and image analysis options | 暂缓记录 |+| [#5575](https://github.com/opendatalab/MinerU/pull/5575) | chore(docker): set compose project name to mineru | 暂缓记录 |+| [#5563](https://github.com/opendatalab/MinerU/pull/5563) | docs: add AMD GPU installation guide for MinerU 4.x | 暂缓记录 |+| [#5449](https://github.com/opendatalab/MinerU/pull/5449) | docs: add CONTRIBUTING.md with verification loop, link from CLAUDE.md | 暂缓记录 |+| [#5447](https://github.com/opendatalab/MinerU/pull/5447) | feat: add request priority scheduling for mineru-api | 暂缓记录 |+| [#5388](https://github.com/opendatalab/MinerU/pull/5388) | fix(xlsx): preserve images anchored in merged cells | 暂缓记录 |+| [#5377](https://github.com/opendatalab/MinerU/pull/5377) | fix(vlm): serialize Transformers predictor execution | 暂缓记录 |+| [#5376](https://github.com/opendatalab/MinerU/pull/5376) | fix(markdown): escape leading block-quote and ordered-list markers in text blocks | 暂缓记录 |+| [#5366](https://github.com/opendatalab/MinerU/pull/5366) | fix: support filename prefix search | 暂缓记录 |+| [#5365](https://github.com/opendatalab/MinerU/pull/5365) | fix: support page:last doclib locators | 暂缓记录 |+| [#5337](https://github.com/opendatalab/MinerU/pull/5337) | feat: add offset pagination to find | 暂缓记录 |+| [#5333](https://github.com/opendatalab/MinerU/pull/5333) | Fix PPTX chart stalls and render charts as SVG | 暂缓记录 |+| [#5327](https://github.com/opendatalab/MinerU/pull/5327) | Add VietOCR recognizer for high-accuracy Vietnamese OCR (lang='vi') | 暂缓记录 |+| [#5197](https://github.com/opendatalab/MinerU/pull/5197) | feat: add async parse pause resume support | 暂缓记录 |+| [#5161](https://github.com/opendatalab/MinerU/pull/5161) | feat(api): expose async task page progress | 暂缓记录 |+| [#5143](https://github.com/opendatalab/MinerU/pull/5143) | Add MinerU-Diffusion benchmark harness | 暂缓记录 |+| [#5128](https://github.com/opendatalab/MinerU/pull/5128) | docs(README): add LightRAG to supported RAG frameworks | 暂缓记录 |+| [#5097](https://github.com/opendatalab/MinerU/pull/5097) | feat: add CPU-only Docker deployment | 暂缓记录 |+| [#5052](https://github.com/opendatalab/MinerU/pull/5052) | feat: add optional external VLM visual details enrichment | 暂缓记录 |+| [#5047](https://github.com/opendatalab/MinerU/pull/5047) | docs: add 'Using SGLang as the Inference Backend' guide (en/zh) | 暂缓记录 |+| [#5020](https://github.com/opendatalab/MinerU/pull/5020) | feat: add MinIO/S3 image upload support to FastAPI | 暂缓记录 |+| [#5015](https://github.com/opendatalab/MinerU/pull/5015) | docs: add Japanese README translation | 暂缓记录 |+| [#4825](https://github.com/opendatalab/MinerU/pull/4825) | feat: implement return_md_pages feature for per-page markdown output | 暂缓记录 |+| [#4801](https://github.com/opendatalab/MinerU/pull/4801) | feat: add Intel XPU transformers support | 暂缓记录 |+| [#4791](https://github.com/opendatalab/MinerU/pull/4791) | fix: strip invisible word joiner from OCR output | 暂缓记录 |+| [#4762](https://github.com/opendatalab/MinerU/pull/4762) | Enhance markdown navigation links and reference formatting | 暂缓记录 |+| [#4748](https://github.com/opendatalab/MinerU/pull/4748) | Add MinIO round-trip markdown demo | 暂缓记录 |