前言¶

在 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 倉庫。