exam-paper-plugin

DeepSeek Harness 插件：自动识别上传的 Word(.doc / .docx) / PDF / 纯文本 题目文件，抽取题目与配图，按你的选择生成一张带书写空隙的可打印试卷（.docx 可编辑 + .html 网页预览）。

功能

• 自动解析题目：识别选择题 / 填空题 / 解答题 / 判断题，提取题干、选项和配图（按坐标关联到对应题目）。
• 按需抽题：先预览题目清单（带全局序号），再按序号选择要出的题。
• 生成可打印试卷：标题、卷头（姓名/班级/得分）、选择题可双列、每道题自动预留书写空隙（横线或空白、按题型定行数）。
• 双格式输出：.docx（用 Word/WPS 打开打印）+ .html（浏览器直接打印成 PDF）。

依赖

组件	用途	必需性
python3（Windows 为 python）	引擎运行	必需
poppler-utils（pdftohtml、pdfimages）	解析 PDF 文本与图片坐标	仅解析 .pdf 时需要
LibreOffice（soffice）或 antiword/catdoc	解析旧版 .doc（前者保留配图，后者仅文字）	仅解析 .doc 时需要
Python Pillow	图片尺寸检测	可选（缺失用默认尺寸）

.docx 的解析用的是 Python 标准库 zipfile，不需要 unzip。

依赖均可选、不强制：缺失只影响对应文件类型，install.sh 会提示并由你选择是否安装。

一键安装

Linux / macOS

git clone https://github.com/elegymythos/exam-paper-plugin.git exam-paper-plugin
cd exam-paper-plugin
./install.sh

install.sh 会：

1. 把插件（plugin.mjs + exam_paper.py）安装到 $DSH_HOME/plugins/exam-paper/（默认 ~/.dsh/plugins/exam-paper/）。
2. 在插件目录建一个 node_modules/@deepseek-ai 软链接，指向 Harness 自身的依赖作用域——这样 plugin.mjs 里的 @deepseek-ai/dsh-tools 裸导入才能解析（这些是 Harness 内置包，不在公开 npm 上）。
3. 在 $DSH_HOME/.agent-presets/exam-paper/ 注册一个**「试卷生成」代理预设**（引用绝对路径）。
4. 可选地检查并安装缺失依赖——会先询问，绝不强制。

install.sh 可选参数：

参数	作用