前言¶

在 DeepSeek Harness（DSH）里读带公式的论文时，常见做法是把 PDF 丢给通用对话，或借助整份 PDF 翻译工具生成新文件。前者难以对齐页码与段落，后者往往会改动原稿版式。若你希望在同一套 Web UI 中本地打开 PDF、按段翻译且保留公式与引用语义，同时做笔记和基于文献的 AI 问答，可以看下社区客户端插件 dsh-pdf-math-reader（界面名 PDF Math Reader）。

这是什么¶

dsh-pdf-math-reader 由维护者 xiayifan1024 发布，分类为 DSH 客户端插件，当前版本 1.3.0，许可证 MIT。它在 DSH Web UI 内提供 PDF 阅读、段落级双语对照翻译、术语表、阅读笔记与 AI 文献问答，设计思路参考 PDFMathTranslate 对「保持公式、引用与版式语义」的处理，但以 本地阅读 + 段落级双语对照 落地，不修改原 PDF 文件。

插件目录页：skillhub.cn 插件页
源码与文档：GitHub 仓库

核心能力¶

阅读与导航¶

侧边栏提供「PDF 阅读」入口；PDF 在浏览器内通过 PDF.js（4.10.38）渲染，支持目录与页面缩略图、翻页、缩放与适合宽度。文本层使用 PDF.js 原生 TextLayer，选中范围与页面文字对齐。首屏会按论文结构重排：标题、作者列表、摘要与关键词等有单独标识；长摘要按完整句子分组。左右侧栏宽度可拖动并自动保存。

翻译¶

译文面板支持 双语 / 仅译文 / 仅原文 三种视图，可做单页翻译、选中文本翻译或全文批量翻译，带进度与停止。翻译提示词要求原样保留公式、LaTeX、引用、DOI、编号、代码与 URL。术语表每行 source=target 或 source：target，命中后强制使用指定译名。译文按段缓存；目标语言与术语表保存在浏览器 localStorage。翻译与 AI 阅读可各自选择模型 / 推理等级，未选择时跟随 DSH 当前默认模型。

公式与图表¶

独立公式按区域识别，以高清裁剪图 + 编号展示，双语模式下公式只显示一次；可点击定位 PDF 原区域，误识别时可「框选公式」或标记「不是公式」，修正按文档指纹与页码持久化。行内公式在翻译请求中用 ⟦MATH_xxx⟧ 占位，译后做完整性校验，失败可重试。

图表按页面绘图区域识别，以卡片展示裁剪图、图号与可展开的图内文字列表；图注仍作为正文段落参与翻译。误判可撤销，修正同样持久化。

笔记、AI 阅读与导出¶

点击段落可在「笔记」标签记录要点，笔记按文档指纹存于 localStorage，有笔记的段落在页面上高亮。「AI 阅读」支持多轮问答，上下文可选本页及相邻页或全文；可导入 DSH Skill 或本地 .md / .txt 阅读方法。导出支持双语 Markdown、Markdown + 公式/图表图片 ZIP，以及可打印的对照 HTML。

隐私要点¶

README 说明：PDF 在浏览器内读取和渲染，只有你主动翻译或提问的文本会发送到模型；插件不保存 API Key，走当前 profile 的模型路由。

安装与启用¶

环境要求¶

• DSH Desktop / Web UI，且 profile 中已配置可用的模型路由。
• 从源码构建客户端需要 Node.js 22+ 与 npm；运行时不需要 Python 或额外 PDF 工具。
• package.json 中 engines.node 为 >=18（构建脚本以 README 快速开始为准）。

安装命令¶

推荐从 GitHub 安装：

dsh plugin --profile <你的 profile> add github:xiayifan1024/dsh-pdf-math-reader

也可在克隆仓库后使用本地 bundle（README 示例，路径按本机修改）：

plugin_manager install_bundle target=<本仓库绝对路径>

安装成功后侧边栏会出现「PDF 阅读」。若 Web UI 已打开，请用 Ctrl+Shift+R 刷新以加载新的客户端 bundle。首次打开面板时会请求 GET /pdf-reader/api/health，用于确认模型服务、provider、model 与请求限制。

典型用法¶

1. 点击侧边栏「PDF 阅读」。
2. 点击「打开 PDF」或将 PDF 拖入面板。
3. 检查译文面板中的公式块；不准时用工具栏「框选公式」或卡片上「不是公式」修正。
4. 在「译文」中翻译当前页、选中文本或全文。
5. 点击段落，切到「笔记」记录要点。
6. 切到「AI 阅读」，选择上下文范围后提问；需要时导入 Skill。
7. 从右上角导出双语 Markdown、ZIP 或对照 HTML。

常用快捷键：翻页 ← / → 或 A / D；当前页滚动 ↑ / ↓；Esc 取消段落高亮、选区与公式框选。

配置说明¶

默认配置在 cordis.patch.yml，可在 profile 的 patch 层覆盖。示例：

config:
  provider: deepseek-account   # 留空则使用 profile 默认模型
  model: deepseek-flash
  maxSegmentsPerRequest: 5
  maxCharsPerRequest: 3800
  maxTextChars: 8000
  timeoutMs: 180000
  cacheEntries: 600
  chatMaxChars: 24000
  chatTimeoutMs: 150000
  chatMaxTokens: 2048

其中 maxSegmentsPerRequest、maxCharsPerRequest 等控制单次翻译批量与超时；chatMaxChars、chatTimeoutMs、chatMaxTokens 控制 AI 阅读上下文与输出上限。具体字段含义以 README 配置表为准。

适用场景与注意¶

适合阅读带文本层的论文、技术报告与教材：需要在同屏对照原文与译文、保留公式语义、做页码级笔记，或基于文档片段做问答时，该插件比「整份丢给聊天窗口」更可控。

安装与使用前请注意：

• 插件以当前 DSH 进程权限运行，安装前建议查看仓库源码与 MIT 许可证。
• 社区目录 skillhub.cn 与 GitHub 为独立信息源，与 DeepSeek / 幻方无官方从属关系；DSH 生态理念是「一切皆插件」，本文仅介绍该社区插件本身的能力与用法。
• 扫描版或无可靠文本层的 PDF，段落重建与翻译效果会受限；路线图中的限制以 README「限制与路线图」为准。

结尾¶

dsh-pdf-math-reader 把 PDF 本地渲染、段落级双语翻译、公式/图表块识别、笔记与 AI 文献问答收进 DSH 同一面板，适合日常读论文时少切换工具。进一步了解可访问 插件目录页 与 GitHub 仓库。