（在 DSH 内使用 dev_install_package 注入器，或手动编辑 profile package.json：

配置

插件行（cordis.patch.yml 或预设 agent.cordis.yml 的 config）：

键	默认	说明
installPreset	false	host 面：安装/升级随包预设
pdftotext	"auto"	auto/on/off：是否优先使用 poppler pdftotext
imageDir	".paper-figures"	图表输出目录（相对会话工作区）
maxPdfBytes	200MB	单次解析的 PDF 大小上限
visionBaseURL	""	OpenAI 兼容视觉端点（如 https://dashscope.aliyuncs.com/compatible-mode/v1）
visionApiKey	""	API Key（优先于环境变量）
visionApiKeyEnv	"VISION_API_KEY"	存放 Key 的环境变量名
visionModel	"gpt-4o-mini"	视觉模型名
visionMaxTokens	2048	视觉回答上限
visionTimeoutMs	90000	视觉调用超时

视觉端点也可用环境变量配置：PAPER_TUTOR_VISION_BASE_URL、PAPER_TUTOR_VISION_API_KEY、PAPER_TUTOR_VISION_MODEL。未配置时 paper_figure 返回图片路径并给出引导，不报错。

使用示例

1. 开一个「论文精读 · Paper Tutor」会话，工作区放好论文 PDF（或 LaTeX 源码 + 代码）。
2. 说："精读这篇论文" 或 "帮我看一下 xxx.pdf，讲清楚方法部分"。
3. Agent 会：paper_scan 盘点 → pdf_extract 建卡片 → 逐节讲解 → paper_figure 读图 → 对照工作区代码 → 输出精读笔记。

建议把论文配套代码放在同一工作区（或子目录），溯源讲解效果最佳。

插件市场

本插件已关联 DSH 插件市场（索引：bradeGithub/DSH-Plugins-Marketplace，按 topic:dsh-plugin 聚合、每 2 小时自动刷新）：

• 仓库 topics：dsh-plugin deepseek-harness dsh paper-reading pdf latex academic agent-preset llm
• 市场页搜索 paper-tutor（或 dsh-paper-tutor）即可找到；市场按 cordis-plugin 管线安装（根目录刻意不放 install 脚本以避免误判为脚本型；包声明 dsh.plugin + bundle.patch + scripts.build，市场会克隆仓库 → 检测到未构建的 lib/ 自动执行 npm run build → 注册 bundle → 重启生效），预设由插件运行时自动安装到 $DSH_HOME/.agent-presets/，卸载可回滚
• 市场安装同样会触发包内安装器：$DSH_HOME/.agent-presets/paper-tutor/ 自动就位

若刚发布/刚加 topic 暂时搜不到，等市场索引刷新（≤2 小时）或先用上方一键安装命令。

视觉端点（可选）配置对照

paper_figure 与 dsh-tool-vision 共用同一套约定，任选一种配置方式：

配置途径	键/变量	示例
环境变量（本插件）	PAPER_TUTOR_VISION_BASE_URL / VISION_API_KEY / PAPER_TUTOR_VISION_MODEL	https://dashscope.aliyuncs.com/compatible-mode/v1 / sk-... / qwen-vl-max
插件 config（本插件预设行）	visionBaseURL / visionApiKey / visionModel	同上
dsh-tool-vision Web UI 设置	设置页"tool-vision"分区	同一端点，UI 可视化编辑、热生效

常见免费/低门槛端点：DashScope（阿里云百炼，qwen-vl 系列）、智谱 GLM-4V、Ollama 本地（llava/qwen2.5vl 等）。