DeepSeek Harness PDF 閱讀器插件

前言¶

DeepSeek Harness (DSH) 採用插件化架構，旨在將特定功能模塊化。開發者常需在閱讀論文或技術文檔時結合模型解讀與翻譯能力，但常見閱讀器缺乏上下文交互，而專業 AI 工具往往需要額外付費。dingyiliao/dsh-bundle-pdf 插件將 PDF 閱讀器、標註工具與 DSH 的模型能力整合在同一個工作流中，允許用戶在本地文件處理的同時直接調用模型能力。

插件簡介¶

名稱：dingyiliao/dsh-bundle-pdf

定位：DSH 的 PDF 閱讀器、標註、OCR、翻譯和導航插件。

維護者：dingyiliao

許可證：MIT License

安裝與啓用¶

安裝此插件需要下載預構建的原生包，並通過 CLI 安裝到對應的 DSH profile。

下載構建產物：
訪問 GitHub Actions。選擇 main 分支上構建成功的 native 工作流，下載與系統和 CPU 匹配的 dsh-pdf-npm-package-<target>（支持 linux-x64、linux-arm64、darwin-x64、darwin-arm64 或 win32-x64）。將下載的 ZIP 解壓，取出其中的 .tgz 文件。
安裝到 Web Profile：
如果使用 Web profile，可以直接運行安裝命令：

    dsh plugin --profile web add /absolute/path/to/package.tgz
    dsh web

安裝到 Desktop Profile：
Desktop 用戶需先啓動一次應用以初始化 desktop profile，然後完全退出應用。通過 Desktop 菜單“管理 dsh 命令…”安裝其自帶的 CLI，再運行以下命令：

    dsh plugin --profile desktop add /absolute/path/to/package.tgz

最後重新打開應用。

核心功能¶

安裝完成後，在 DSH 的文件欄打開本地 PDF，即可使用以下功能：

導航與搜索：支持頁碼與目錄跳轉、逐級返回、個人書籤以及文字搜索。
交互與標註：支持在 PDF 上進行標註。
模型能力：提供選區翻譯、解釋模式以及後臺打開 PDF 工作副本的能力。

模型使用與費用說明¶

插件的翻譯、解釋以及首版 OCR 默認使用當前會話模型與 DSH 已配置的憑據，不提供免費模型。

解釋模式：框選解釋默認要求當前會話模型明確支持圖像輸入。插件支持三種圖像理解路線：
1. session-vision (默認)：向當前視覺模型發送原圖。
2. ocr-text：只提取文字，不發送原圖。
3. auxiliary-vision：由另一配置的視覺模型（輔助路線）描述圖像，將派生文字送入當前會話。
費用：輔助路線（auxiliary-vision）會額外請求所配置的模型，可能產生費用。內置 SessionLLM OCR 後端也需要視覺模型支持。

配置選項¶

閱讀器通過 pdf-image-understanding 配置項選擇圖像理解後端。

僅使用 OCR 文字路線：
在 profile 的 cordis.patch.yml 中合併以下覆蓋項：

    - id: pdf-image-understanding
      config:
        backend: ocr-text

使用輔助視覺路線：
配置 auxiliary-vision 以指定額外的視覺模型。provider 和 model 必須是 DSH 已配置且支持圖像輸入的精確標識。

    - id: pdf-image-understanding
      config:
        backend: auxiliary-vision
        auxiliaryVision:
          provider: your-provider
          model: your-vision-model

注意事項¶

加密 PDF：暫不支持。
第三方組件：插件依賴 PDFium、pdf-lib、Tesseract.js 等第三方組件，這些組件遵循各自的許可證（見 dist/THIRD_PARTY_NOTICES.md）。
構建環境：從源碼開發時，需要在倉庫目錄執行 npm ci && npm run native:build && npm run build，然後通過 dsh plugin --profile web add . 鏈接本地目錄。直接通過 Git URL 安裝不會獲得原生構建產物。
版本兼容：package.json 的 peerDependencies 列出了兼容的 DSH 版本，當前 CI 使用 0.2.0-rc.2 進行驗證。

總結¶

dingyiliao/dsh-bundle-pdf 插件通過將原生 PDF 渲染能力與 DSH 的模型調用能力結合，爲開發者提供了一個集閱讀、標註與 AI 解讀於一體的本地工作流。在使用前，請務必確認當前會話模型支持圖像輸入，並留意輔助路線可能產生的額外費用。

插件目錄：https://www.skillhub.cn/plugins/dingyiliao/dsh-bundle-pdf
源碼地址：https://github.com/dingyiliao/dsh-bundle-pdf