UnisKB/scripts/README_native_mindmap.md

33 lines
2.3 KiB
Markdown
Raw Blame History

This file contains ambiguous Unicode characters!

This file contains ambiguous Unicode characters that may be confused with others in your current locale. If your use case is intentional and legitimate, you can safely ignore this warning. Use the Escape button to highlight these characters.

# 原生思维导图与文档解析
思维导图工作台位于 `ui/src/views/mindmap/workbench`,通过 MaxKB API 使用当前用户和工作空间,不再嵌入外部页面。旧 `MINDMAP_URL` 不再作为页面入口。
## 责任边界
- MaxKB:资源授权、同步/异步解析器适配、格式分流、任务与成果、智能整理、图片附件和预览。
- UnisMindMap(本地仓库名 markitdown):官方 `mineru-2.7.4-released` 解析源码、运行依赖及厂商镜像。`mineru/` 保持官方发布包内容。
- 解析器适配位于 `apps/system_manage/parsers`;现有 4.x v1 适配保持独立。调用方只消费统一 Markdown、图片和来源信息。
## 格式分流
- PDF、受支持图片:调用登记的 MinerU 服务。
- DOCX、XLS/XLSX、CSV、HTML、Markdown、TXT:复用 MaxKB 内置处理器。工作台的内置解析无需外部解析资源;知识库继续原有分段和附件流程。
- DOC:有 LibreOffice 时在独立临时目录转换为 DOCX;不可用时提示另存 DOCX。
- 未引入微软 MarkItDown,也不宣称当前支持 PPT、OFD、EPUB 等格式。
PDF/图片的解析图片会转为知识库附件,沿用知识库读取权限及保留机制;导图图片继续使用 AI Hub 私有资产和离线导出。
## 解析资源
官方 2.7.4 使用根地址(如 `http://127.0.0.1:8100`),`protocol=legacy`,`engine_version=2.7.4`;调用 `/file_parse`。旧项目 `/api` 前缀不属于官方 API。
4.x 使用登记的 `/v1` 地址和 `protocol=v1`。不能仅改下拉框而保留不相符的地址,也不将四档参数映射为旧版引擎。
业务任务继续由现有单消费者执行。2.7.4 上游同步接口不提供细粒度任务进度,页面显示真实处理阶段和耗时,不模拟百分比。长文整理按上下文分块、合并;失败时保留原稿和已完成分块。
## 部署
无新增数据库迁移。切换前检查活动任务、备份资源配置及源文件;保留原解析器环境作为回退。不要覆盖厂商 Torch/vLLM。NVIDIA 与天数的验证结果分别记录。
前端统一构建:`npm run build-only -- --base=/admin/ --outDir=dist-native-mindmap`。发布至 8080 实际使用的 `apps/static/admin`,先上传资源、最后替换入口;不再单独构建或发布 markitdown/web_ui。