UnisKB/scripts/README_native_mindmap.md

2.3 KiB
Raw Blame History

原生思维导图与文档解析

思维导图工作台位于 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。