在构建需要本地处理文档的智能体时,通常需要 Microsoft Office 或 LibreOffice 等重型依赖。下面介绍的插件使用轻量级的 Rust/Skia 引擎解决了这个问题。
这是什么¶
这是一个 DeepSeek Harness (DSH) 插件,暴露一个名为 dxpdf_convert 的工具。它使用 dxpdf 引擎将 Microsoft Word .docx 文件转换为 PDF,无需依赖 MS Office、LibreOffice 或网络连接。该插件还会修复 WPS Office 写入的 schema 无效构造,并恢复 Word 在奇偶页分页符处插入的空白页。
核心功能¶
- 将 Word .docx 转换为 PDF。
- 修复 WPS Office schema 无效构造。
- 恢复 Word 的奇偶页对齐。
- 降低 dxpdf 引擎会丢弃的数学方程。
- 暴露工具
dxpdf_convert。
先决条件¶
在安装和使用该插件前,需要满足以下环境要求:
- Node.js >= 22:用于运行 DSH 插件宿主。
- Python >= 3.8 on PATH:插件通过 Python 调用引擎。
- dxpdf 引擎:必须安装到指定的 Python 解释器中。
- lxml:用于 Word 对等分页检查(可选,但推荐)。
安装与启用¶
该插件是一个 DSH bundle。安装后,需要将 dxpdf 引擎安装到插件使用的 Python 解释器中。
1. 安装插件¶
在终端中执行以下命令:
dsh plugin --profile web add bauerelizabeth07139/dsh-plugin-dxpdf
2. 安装转换引擎¶
插件依赖 dxpdf 引擎。请确保你的 Python 环境已安装该引擎及 lxml(用于分页修复):
python -m pip install dxpdf lxml
3. 卸载(如需要)¶
dsh plugin --profile web remove dsh-plugin-dxpdf
典型用法¶
安装完成后,DSH 将暴露 dxpdf_convert 工具。该工具支持以下选项:
--fraction native|linear:控制分数的处理方式(默认为 native)。--radical parens|overline:控制根号的显示样式(默认为 parens)。--scripts unicode|brackets:控制分数内脚本字符的表示方式。
如果缺少 lxml 模块,分页检查将跳过,并报告 paginationSkipped。
适用场景与注意¶
- 适用场景:智能体需要在不依赖网络和大型办公软件套件的情况下,将 Word 文档转换为 PDF。
- 权限注意:插件以当前 DSH 进程的权限运行,安装前应检查源码与许可证(MIT)。
结尾¶
该插件通过引入 Rust/Skia 引擎,为 DSH 提供了轻量级的文档转换能力,解决了传统方案中依赖重、网络依赖大的问题。
- 目录页:https://www.skillhub.cn/plugins/bauerelizabeth07139/dsh-plugin-dxpdf
- 源码地址:https://github.com/bauerelizabeth07139/dsh-plugin-dxpdf