init: WordFileParse docx→HTML 解析服务(含 Word EQ 域公式修复)

服务:Spring Boot 3.2 + docx4j 8.3.9,POST /api/v3/server_office_file/file/parse
      接受 .docx,返回 HTML(公式 → LaTeX,图片 → RustFS 外链)

公式支持三类来源:
- OMML(Word 2007+ 公式)      → Python omml_mathml2latex
- MathType OLE 对象            → Ruby mathtype2mathml → MathML → LaTeX
- Word EQ 域(老教辅主力)      → EqToLatexUtil(本次新增)

本次改动:
1. 新增 java-svc/.../core/EqToLatexUtil.java:
   移植自 jby backend-services office-core,EQ 语法 → LaTeX
   (\f→\dfrac、\r→\sqrt、\i→\int/\sum/\prod、\s→^{}/_{}、\b→\left\right、
     \a→array、\x→\boxed/\overline、\o\al 堆叠、圈码、化学符号、极限、连等式)
   品牌标记 JBYU* → WPU*,与采集端一致
2. CtoMathFinder:接上 EQ 分支(原为 not-ported 桩),域代码经
   EqToLatexUtil.convert 转 LaTeX 写入 eqLatexMap(WPEQNUM 占位符)
3. WordParseUtil.dealPlaceholder:EQ 的 LaTeX 同样加 \( \) 包裹
   (原先因 WPEQNUM 例外不加包裹,前端/MathJax 不渲染)

修前症状:教辅 Word 里分式/方程组/上下标整段丢失(如 {−1/3, 1} 变成 {-,1})
修后实测:46 份教辅 2908 处 EQ 域全部还原,公式总数 2954 处、零未包裹残留

安全:application.yml(含 RustFS 密钥)不入库,提供 application.yml.example;
      OssService 的 @Value 默认密钥已清空
This commit is contained in:
2026-09-29 09:43:13 +08:00
commit 3271fee5cc
360 changed files with 86082 additions and 0 deletions

View File

@@ -0,0 +1,74 @@
"""
Visitor implementations for MathML elements.
This package contains visitor classes that handle conversion of specific
MathML element types to LaTeX format.
"""
from .visitor_registry import VisitorRegistry
from .mi_visitor import MiVisitor
from .mo_visitor import MoVisitor
from .mn_visitor import MnVisitor
from .mfrac_visitor import MfracVisitor
from .msup_visitor import MsupVisitor
from .msub_visitor import MsubVisitor
from .mrow_visitor import MrowVisitor
from .msqrt_visitor import MsqrtVisitor
from .mroot_visitor import MrootVisitor
from .msubsup_visitor import MsubsupVisitor
from .mover_visitor import MoverVisitor
from .munder_visitor import MunderVisitor
from .munderover_visitor import MunderoverVisitor
from .mfenced_visitor import MfencedVisitor
from .mtext_visitor import MtextVisitor
from .mtable_visitor import MtableVisitor
from .mtr_visitor import MtrVisitor
from .mtd_visitor import MtdVisitor
from .mspace_visitor import MspaceVisitor
from .mstyle_visitor import MstyleVisitor
from .merror_visitor import MerrorVisitor
from .menclose_visitor import MencloseVisitor
from .mmultiscripts_visitor import MmultiscriptsVisitor
from .mpadded_visitor import MpaddedVisitor
from .mphantom_visitor import MphantomVisitor
from .maction_visitor import MactionVisitor
from .ms_visitor import MsVisitor
from .mglyph_visitor import MglyphVisitor
from .mlabeledtr_visitor import MlabeledtrVisitor
from .maligngroup_visitor import MaligngroupVisitor
from .malignmark_visitor import MalignmarkVisitor
__all__ = [
'VisitorRegistry',
'MiVisitor',
'MoVisitor',
'MnVisitor',
'MfracVisitor',
'MsupVisitor',
'MsubVisitor',
'MrowVisitor',
'MsqrtVisitor',
'MrootVisitor',
'MsubsupVisitor',
'MoverVisitor',
'MunderVisitor',
'MunderoverVisitor',
'MfencedVisitor',
'MtextVisitor',
'MtableVisitor',
'MtrVisitor',
'MtdVisitor',
'MspaceVisitor',
'MstyleVisitor',
'MerrorVisitor',
'MencloseVisitor',
'MmultiscriptsVisitor',
'MpaddedVisitor',
'MphantomVisitor',
'MactionVisitor',
'MsVisitor',
'MglyphVisitor',
'MlabeledtrVisitor',
'MaligngroupVisitor',
'MalignmarkVisitor',
]