论文阅读面板 louwenbo580/read-paper

paper-review

给 DeepSeek Harness 用的论文阅读面板：上传 PDF 论文，在对话旁边以结构化、可选择的文本形式阅读，图表和独立公式以图像呈现。

功能

- PDF → 结构化文本（在 Harness 主机上运行，依赖 poppler）：
- 双栏排版重建（栏间距检测 + 通栏行重组）
- 标题（字号 + 全大写归一化）与段首标题拆分
- 表格（几何列检测、单元格折行续接）
- 上下标、点线引导的目录
- 扫描版 PDF 回退为页面图像
- 图表和独立公式渲染为图像（pdftoppm 裁剪 + pdfimages 位图提取），公式文本保留为隐藏 span，仍可搜索。
- 右侧阅读面板：空间足够时作为真正的第三栏（harness 的 details 栏），自动折叠侧边栏腾出空间，窄窗口时浮动回退，折叠后收成细标签。
- 提问对话框：选中文本 → 弹出小对话框 → 输入问题（「解释一下这段」「这和……有什么关系」）→ 问题连同选中内容、其上下文以及摘要一起发给模型。
- 项目：Create project 会把论文（paper.pdf、paper.md、paper.html、图表、带标题/摘要的 README）落到一个 Paper 工作区，在那里打开会话，并让智能体加载论文——每个项目保留自己的论文，多篇论文可以共存。

环境要求

- 已安装 DeepSeek Harness（dsh）。
- PATH 中有 poppler 命令行工具：pdftotext、pdftoppm、pdfimages。
- macOS：brew install poppler
- Debian/Ubuntu：sudo apt-get install poppler-utils

安装

从 npm 安装（推荐）

dsh plugin --profile readPaper add @deepseek-ai/dsh-web-app paper-review
then start the harness:
dsh --profile readPaper

dsh plugin 会安装这些包，然后协调 dsh.profile.bundles——声明了 dsh.bundle 的包会自动加入配置档的层栈。

为什么要把 @deepseek-ai/dsh-web-app 一起加上： 在从未用过它的机器上新建的配置档，只会预置 @deepseek-ai/dsh-base（对于未知的配置档名，web 界面 bundle 不是默认项）。显式加上 @deepseek-ai/dsh-web-app，配置档才有浏览器 GUI，本插件的面板就渲染在里面。如果机器上已存在带 web app 的 readPaper 配置档，那么只跑 dsh plugin --profile readPaper add paper-review 就够了。

前置条件

- PATH 中有 poppler 命令行工具（pdftotext、pdftoppm、pdfimages）——见环境要求。
- dsh plugin 命令需要 pnpm（它会转发给 pnpm）。如果没装 pnpm：corepack enable pnpm 或 npm i -g pnpm。

手动安装（不用 npm）

1. 把这个目录复制到 ~/.dsh/profiles/readPaper/packages/paper-review。
2. 让它可被解析（不需要 pnpm）： bash
mkdir -p ~/.dsh/profiles/readPaper/node_modules
ln -s ../packages/paper-review ~/.dsh/profiles/readPaper/node_modules/paper-review

3. 在 ~/.dsh/profiles/readPaper/package.json 里，把 "paper-review" 加进 dsh.profile.bundles。
4. dsh --profile readPaper

用法

- 右侧边缘的 Paper 标签页，点开就是阅读栏。
- Load PDF… 用来上传（把 PDF 拖到阅读栏里也行）。
- 选中文字 → 弹出 ask dialog → 输入问题，按 Enter。
- Create project 会把论文写进 Paper 工作区，并打开一个会话，论文已作为上下文加载。
- 转换后的文档存放在 ~/.dsh/paper-review/ 下，重启后依然在。

工作原理

- lib/index.js（宿主侧）：提供 HTTP 路由（/paper-review/…），负责上传、转换、文档、插图、项目，以及按会话划分的存储。转换器用 pdftotext -bbox 提取文字的位置信息，重建分栏与行，对区块分类（标题、表格、目录、公式），再用 pdftoppm 把插图与公式区域栅格化。
- lib/client.js（客户端侧）：面板、标签页、ask dialog，以及项目流程。以手写的 __ModuleLoader__ CJS bundle 形式发布，无需构建步骤。
- cordis.patch.yml：bundle 补丁，用来插入插件那一行。

开发

- npm run check —— 语法检查。
- npm run eval —— 下载 10 篇近期的 astro-ph 论文及其 arXiv HTML 版本，做转换，再对照参考文本给文字覆盖率打分（想快速跑一遍就用 PAPERS=2 npm run eval）。语料落在 eval/run/（已加入 gitignore）。

限制

- 转换效果取决于 PDF 的文字层（扫描版论文只能渲染成页面图片）。
- 展示公式是图片（公式文字以隐藏 span 的形式保留）；行内公式会重建为上下标文字。
- 只存在于 PDF 注释里的内容（比如某些期刊那种超长作者名单）无法提取。
- 插件的 HTTP 路由遵循 harness 的 localhost 信任模型。