DeepSeek Harness PDF Reader Plugin

前言¶

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