mathtype-word-equations-skill

Word MathType 公式 Codex Skill

这是一个面向 Windows 的 Codex skill：不启动 Word/WPS，不占用用户键鼠，直接在 DOCX 包内批量处理可编辑 MathType 公式。

它支持两条路径：

• 从论文等文档中提取带编号的现有 MathType 公式，并追加到另一个 DOCX；
• 将 Word/WPS 内置公式（OMML）批量转换为真正的 Equation.DSMT4 MathType OLE 对象，同时生成 WMF 预览。

安全设计

• 输入文档只读，默认只写入一个尚不存在的新输出路径；
• 不关闭或杀死 Word、WPS、MathType 等用户进程；
• 不依赖 computer-use 或界面自动化；
• 每个 OLE 都通过 MathType 回读为 MathML，不能只靠图片或 ProgID 字符串冒充；
• DOCX 解包会检查路径穿越和解压体积；失败时不发布半成品；
• 仓库不包含测试论文、用户公式、生成的 OLE/WMF 或已编译 EXE。

环境要求

• Windows；
• 本机已安装 MathType；
• Windows PowerShell 5.1 或 PowerShell 7；
• 32 位 .NET Framework C# 编译器（Windows 通常自带）。

首次运行时，skill 会从仓库内的 C# 源码本地编译两个 x86 helper，并生成带 SHA-256 的构建清单。helper 只与本机 MathType OLE 服务通信，不打开 Word/WPS。

安装与调用

把仓库中的 mathtype-word-equations 文件夹安装到 Codex skills 目录，然后在任务中调用：

使用 $mathtype-word-equations，把这个 DOCX 中的内置公式全部转换为 MathType，输出为一个新文件。

或：

使用 $mathtype-word-equations，把论文里所有带编号的 MathType 公式列到目标 DOCX 中。

具体路由、安全发布和验证标准见 mathtype-word-equations/SKILL.md。

发布前回归结果

• 6 组含分式、根式、上下标、求和、希腊字母和矩阵的合成 OMML 公式：6/6 转换，剩余 OMML 为 0，全部可编辑回读通过；
• 43 个 MathType OLE 的批量文档审计：43/43 为 Equation.DSMT4，全部可编辑回读通过；
• PowerShell 7 与 Windows PowerShell 5.1 均通过；
• 输入文档在每轮测试前后的 SHA-256 保持不变，ZIP part 名统一使用 /。

第三方组件

OMML→MathML 使用固定提交的 OMML2MML.XSL，来源、SHA-256 与许可证记录在 SOURCE.md。该文件采用 Apache License 2.0。

“MathType”名称及相关商标归 Wiris 所有。本项目与 Wiris 没有隶属、赞助或官方关联。

许可证

Apache License 2.0。详见 LICENSE。