前言¶

在 DeepSeek Harness（DSH）裏做研究或寫代碼，經常要對着 PDF 查方法、對公式、掃圖表。常見做法是：PDF 在一個窗口，對話在另一個窗口，選中一段文字再粘貼進助手，整篇翻譯還要另開工具或腳本。Paper Harness（文獻臺）是維護者 baigaobai 發佈的客戶端類 DSH 插件，把文獻庫、原文閱讀、AI 問答、譯文和檢索收進同一界面；PDF 放進本地文件夾即建索引，閱讀時左中右三欄並排，選中句子即可提問或翻譯。

下面按定位、能力、安裝、用法和邊界說明，事實均來自 GitHub 倉庫 README 與 package.json（當前版本 0.1.0，MIT 許可證）。

這是什麼¶

Paper Harness 是給 DeepSeek Harness 用的文獻閱讀工作臺插件（npm 包名 dsh-paper-harness）。核心思路是：文獻以 PDF 形式落在本地「文獻庫」目錄，插件自動解析元數據、正文、文字座標和插圖；閱讀界面保留整頁排版，同時在 invisible 文字層上支持任意句子的選擇與 AI 交互。索引、裁圖、譯文緩存都在本機 library/ 下，不依賴把文獻上傳到第三方服務器。

插件在 DSH 生態裏以 bundle 形式安裝（cordis.patch.yml），Web 客戶端即時注入，側邊欄會出現「文獻臺」入口。社區目錄頁：skillhub.cn/plugins/baigaobai/dsh-paper-harness（獨立站點，與 DeepSeek / 幻方無官方從屬關係）。

核心功能¶

入庫與索引¶

把 PDF 拖進文獻庫目錄（或其下任意分類子文件夾）即可觸發解析：標題、作者、年份、DOI/arXiv、逐頁正文、插圖及文字座標。默認監聽目錄（watch: true），啓動時也可自動掃描（autoIndex: true）。分類即文件夾，可直接在資源管理器裏整理。

三欄精讀¶

打開一篇文獻後，界面爲文獻庫 | 原文 · AI · 譯文三欄：左側與 Harness 助手對話，中間是整頁渲染的原文，右側是譯文。原文上覆蓋透明文字層，公式與插圖仍在，任意句子可選中；浮層提供「問 AI / 翻譯」。對整篇提問時，上下文會帶上題目、摘要、當前頁與正文片段。

插圖速覽¶

插件會把每張圖連同圖注一起裁出（README 說明對矢量圖、多面板圖、流程圖等均支持），便於快速瀏覽圖表再決定是否精讀全文。

翻譯¶

選中語段可即時翻譯；整篇支持按頁流式翻譯，可指定頁碼區間（例如只譯第 5–6 頁、從當前頁開始或單頁補譯），逐頁落盤，中斷可續，並支持一鍵複製。已緩存譯文可通過 HTTP API 讀取或清空。

整理與檢索¶

支持閱讀狀態、評分、標籤、筆記；分類與標籤均可作爲篩選維度。庫內全文檢索與在線檢索（arXiv、Semantic Scholar、Crossref 三源合併）在同一界面完成，檢索結果可一鍵下載入庫。

給 Agent 用的 paper_library 工具¶

Harness 助手可通過 paper_library 直接操作你的文獻庫，常見 action 包括：

大模型調用走 Harness 自帶的 llm 服務，使用「設置 → 模型」中的默認項，README 寫明不需要單獨配置 API Key；調用前會解析模型支持的推理檔位並選最低一檔，以避免整篇翻譯過慢。

安裝與啓用¶

前置要求¶

• DeepSeek Harness（桌面端或 Web 端均可）
• Node.js ≥ 22（Harness 自帶運行時亦可）
• pnpm（推薦）或 npm

獲取代碼並安裝依賴¶

官方 README 給出的步驟如下：

git clone https://github.com/baigaobai/dsh-paper-harness.git
cd dsh-paper-harness
pnpm install

然後在 Harness 裏把該目錄作爲 bundle 裝入當前 profile，任選一種方式：

A. 讓助手安裝——對助手說明要把 clone 下來的絕對路徑裝進當前 profile，助手會調用 plugin_manager install_bundle。

B. 命令行：

dsh plugin --profile <profile> add link:<你 clone 下來的絕對路徑>

裝好後重啓 Harness，側邊欄應出現「文獻臺」圖標。

若啓動時報 Cannot find native binding，說明平臺預編譯包未裝上，需按平臺手動補依賴：Windows 爲 @napi-rs/canvas-win32-x64-msvc，macOS 爲 @napi-rs/canvas-darwin-arm64，Linux 爲 @napi-rs/canvas-linux-x64-gnu（與 README 一致）。

安裝前建議自行瀏覽倉庫源碼與 MIT 許可證；插件以當前 DSH 進程權限運行，文獻庫路徑與網絡檢索行爲需結合本機環境評估。

配置文獻庫¶

文獻庫根目錄默認爲倉庫下的 library/，可在 profile 的 cordis.patch.yml 中修改，例如：

- insert:
    - id: paper-harness
      name: paper-harness
      config:
        libraryRoot: 'D:\papers'   # 文獻庫根目錄
        maxPages: 80               # 每篇最多解析多少頁
        pageScale: 1.7             # 閱讀視圖頁面渲染倍率
        figureScale: 2             # 插圖裁剪渲染倍率（越大越清晰、越慢）
        maxFigures: 16             # 每篇最多抽多少張圖
        watch: true                # 監聽目錄，拖入即索引
        autoIndex: true            # 啓動時自動掃描

索引與緩存位於 library/.paper-harness/（元數據 JSON、裁圖、封面、按需渲染的整頁圖、譯文 JSON 等）；刪除該目錄會重建索引，不影響原始 PDF。README 提醒不要把 library/ 提交到 Git。

典型用法¶

1. 側邊欄點擊「文獻臺」。
2. 將 PDF 拖入文獻庫目錄（或某分類子文件夾）。
3. 等待幾秒出現卡片，進入閱讀；選中正文任意一句，使用「問 AI」或「翻譯」。

需要 Agent 代勞檢索或讀庫時，在對話中讓助手使用 paper_library 的 search、read、import 等 action 即可，與頁面側 HTTP API（如 /api/paper-harness/state、/api/paper-harness/chat 等）對應同一套後端能力。

適用場景與注意¶

適合誰：需要在 DSH 內長期管理本地 PDF 文獻、邊讀邊問模型、按頁翻譯並歸檔狀態/標籤的研究者與開發者；也希望助手能基於私有文獻庫檢索與寫筆記的場景。

已知邊界（來自 README）：

• 掃描版（無文本層）PDF：頁面可顯示，但無可選文字，也無法提取正文。
• 極少數頁面可能導致 Skia 渲染崩潰：該頁顯示佔位，其餘頁仍可索引。
• 圖注不規範時可能裁不到圖，需回到原文頁查看。
• 在線檢索受站點限流影響；Crossref 多數條目無開放 PDF，僅元數據。
• 主要驗證環境爲 Windows + DeepSeek Harness 桌面端。

隱私：文獻、索引、譯文僅存本機 library/；僅在「問 AI / 翻譯」時，纔會把選中文字與論文上下文發給當前配置的模型服務。

結尾¶

Paper Harness 把「丟 PDF → 索引 → 三欄精讀 → 按頁翻譯 → 分類檢索 → Agent 讀庫」串成一條可在 DSH 內完成的工作流，適合作爲個人文獻臺而不是外接一堆零散工具。

• 社區目錄：https://www.skillhub.cn/plugins/baigaobai/dsh-paper-harness
• 源碼與文檔：https://github.com/baigaobai/dsh-paper-harness