前言¶

在 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