Skip to content

Transforms complex documents like PDFs and Office docs into LLM-ready markdown/JSON for your Agentic workflows.

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.md
index 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.md
index 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.md
index 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.json
new file mode 100644
index 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.md
new file mode 100644
index 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 | 暂缓记录 |