dsh-mathtype
DeepSeek Harness 的 MathType OLE 公式：通过 MathType SDK 将 Word 文档中的 LaTeX 占位符转换为真实的 MathType 对象（Equation.DSMT4），保留公式编号、SEQ 字段、书签和交叉引用。
插件会安装到这里；不确定时保持 web。
npx -y @deepseek-ai/dsh plugin --profile web add github:DIPPER12138/dsh-mathtype#9f4ca194a56a569817badfcb7f9a3bfd9d6ee4b4
Mathtype 以 dsh-mathtype 发布，当前版本为 0.1.0。Plugin Hub 会校验它的 manifest，并保存精确安装来源，便于复现安装结果。
A DeepSeek Harness plugin that converts LaTeX placeholders in a Word .docx
into real MathType OLE objects — ProgID="Equation.DSMT4", a CFB container
holding an Equation Native stream — through the MathType SDK. The equations
double-click into MathType like any hand-authored one. They are not Word's
built-in OMML equations and not pictures.
Left: the \[ ... \] LaTeX as written in the .docx. Right: what Word holds
after the run — real Equation.DSMT4 objects, rendered here by Word itself.
The examples are textbook identities, chosen to show the format change rather
than any one manuscript's content.
Because the document is edited in place through Word's own automation model,
existing equation numbers, SEQ fields, bookmarks, REF cross-references,
figures, tables and styles are never rebuilt.
One model-invocable skill, mathtype, registered into ctx.skills when the
plugin mounts:
| Path | Role |
|---|---|
mt_env.py | Discovers MathType, MT6.dll, Word and Python deps; smoke-tests the SDK. |
mt_sdk.py | MT6.dll wrapper: connect, set_latex, get_text, close. |
mt_prefs.py | Equation size via the MathType registry block, restored afterwards. |
word_session.py | Word session that survives RPC crashes and late-binding failures. |
convert_docx.py | The conversion. --dry-run, --overrides, --report. |
verify_docx.py | Structural proof: ProgID, CFB, Equation Native, rels, ShapeID, bookmarks, fields. |
render_check.py | Export PDF, render page and per-equation QA sheets. |
make_fixture.py | Build a 6-equation test document with real SEQ fields. |
No JavaScript dependencies: the registrar uses only node:fs, node:path and
node:url, so the package installs offline.
| Component | Requirement |
|---|---|
| OS | Windows 10/11. COM and OLE have no macOS or Linux equivalent. |
| MathType | MathType 7 desktop, full install — the fonts-only package has no System\<arch>\MT6.dll. |
| Word | Desktop Word 2016/2019/2021/365. Not a viewer, not LibreOffice. |
| Python | 3.10+, bitness matching MT6.dll (64-bit Python ↔ System\64\MT6.dll). |
| Python packages | pywin32, lxml. Optional: pymupdf + Pillow for the render check. |
python -m pip install pywin32 lxml
python -m pip install pymupdf Pillow # optional, render check only
Nothing is hard-coded: the MathType directory, SDK DLL and preference files are resolved from the registry at run time, so a non-default install location works.
# from GitHub — use the profile you actually run (`desktop` or `web`)
dsh plugin --profile desktop add github:DIPPER12138/dsh-mathtype
# or from a local checkout, for development
dsh plugin --profile desktop add /absolute/path/to/dsh-mathtype
Restart dsh afterwards. The mathtype skill then appears in the skill catalog.
If you previously copied this skill into ~/.dsh/skills/mathtype by hand, delete
that copy — otherwise the same skill is registered twice.
The plugin cannot install MathType, Word or Python for you, and it cannot install Python packages. Check the environment before converting anything:
python <skill-dir>/scripts/mt_env.py
It reports the resolved MathType directory and DLL, the Word version, dependency
status and a live MTAPIConnect result, and exits 0 only when the machine is
ready. On a new machine, prove the whole chain with the bundled fixture first
(about two minutes):
python scripts/make_fixture.py -o fixture.docx -f
python scripts/convert_docx.py fixture.docx -o fixture-out.docx --size 10.5
python scripts/verify_docx.py fixture.docx fixture-out.docx --expect 6
# what would be converted? (reads the .docx package only — no Word, no COM)
python scripts/convert_docx.py manuscript.docx -o manuscript-MathType.docx --dry-run
# convert (54 equations take roughly 10-15 minutes)
python scripts/convert_docx.py manuscript.docx -o manuscript-MathType.docx \
--size 10.5 --report conversion.json
# prove the objects are real MathType equations
python scripts/verify_docx.py manuscript.docx manuscript-MathType.docx --expect 54
# optional: PDF export plus page/equation QA sheets
python scripts/render_check.py manuscript-MathType.docx --outdir qa
Recognised placeholders, one per paragraph:
| Source | Result |
|---|---|
\[a=b\tag{7}\] | centred MathType object, number (7) right-aligned |
\[a=b\tag{2a}\] | number (2a); sub-lettering survives |
\[a=b\] | centred object, no number |
$a=b$ | inline object |
Numbers inside \tag{...} are never regenerated: an existing SEQ field,
bookmark or literal 2a is kept verbatim, so every REF still resolves.
--size sets the equation size (accepts 10.5 or "10.5 pt"); the previous
MathType setting is restored afterwards. --align none leaves paragraph layout
untouched. --overrides fixes.json replaces individual equations by label.
get_text() for single equations).dsh plugin --profile desktop remove dsh-mathtype
MIT. See LICENSE.
MathType is a trademark of Design Science. This plugin uses the MathType SDK installed on the user's machine and ships none of it.