@ggboy123/dsh-paper-reader

中文文档
1.13.0发布于 2026/11/16MITES Module近 30 天下载 1.3万

DeepSeek Harness 插件:论文伴读工作台 — PDF 转录 / 检索 / 原生对话伴读 + 内置阅读器页面。

原始使用文档
文档目录11 节
  1. 为什么
  2. 特点
  3. 安装
  4. 普通用户:桌面端装好即用(推荐)
  5. 开发者:命令行 dsh
  6. 快速上手
  7. 数据与安全
  8. 参与开发
  9. 贡献者
  10. Star 趋势
  11. License

dsh-paper-reader

npm version npm downloads license GitHub stars

English: README_EN.md

DeepSeek Harness (dsh) 插件:论文伴读工作台 —— 文献库 + PDF 阅读器 + AI 伴读,回答自带页码、点页码跳回原文。当前版本 v1.13.0。

💬 QQ 交流群:1127244508 —— 安装/使用问题、功能建议、bug 反馈都欢迎来聊。

为什么

  1. 论文一多,文件和阅读进度就容易乱。 按专题整理论文,每篇论文的 PDF、译文、笔记和学习记录收在一起;改名、移动、删除(可从回收站恢复)都有管理入口。
  2. 翻译不该打断阅读。 不用来回复制粘贴——中文直接生成在原 PDF 版面上:纯中文、中英对照、左右分屏、划词翻译,公式也保留。
  3. AI 的回答需要能核对。 回答自带页码,点击跳回原文并高亮;可以只问当前论文,也可以把范围扩大到整个专题,减少「答得流畅却找不到出处」。

新版演示:文献管理 → 选中即问(划词翻译 / 笔记)→ 页码回答 → 原文高亮 → 中文视图

默认安装:官方侧栏原样,只多一行开关

伴读模式:文献库 + PDF 阅读器 + 原生对话

特点

  • 🔌 零配置、不打扰:装完即用——翻译直接跟随 Harness 当前模型与账号授权,不用申请、复制任何 Key;不改动官方界面,侧栏只多一行开关
  • 🔒 本地优先:PDF、译文、笔记、学习记录都是文献文件夹里的普通文件,把 data/ 目录拷走就都带得走;未配置第三方端点时,插件不向任何外部服务发请求(伴读对话历史与端点设置存在 dsh 一侧,不随文件夹迁移)
  • ➕ 可选增强,默认关闭:MinerU 解析让扫描件可读、公式可点引用可检索;嵌入端点让大白话提问也能命中术语段落——不配置就一条请求都不发
  • ⚡ 长文档不卡:只渲染视口附近的页,原文 ↔ 中文切换零重载,重开论文不重传 PDF
  • 🤖 教练式带读(可选):AI 制定分步计划,你读原文、作答,答好才继续,学习进度跨会话累积
  • 🌙 PDF 深色模式:跟随 dsh 主题,四档强度可调(整页反色实现,图片会褪色偏色——已知代价,可一键关)

各功能的前提、代价与已知限制统一放在 docs/features.md;配置 MinerU、嵌入或翻译端点前,建议先读对应小节。

安装

普通用户:桌面端装好即用(推荐)

两步:装 DeepSeek 官方桌面端 → 里面直接装插件。

  1. 下载安装 DeepSeek 官方桌面端(即 DeepSeek Harness 桌面版),登录 DeepSeek 账号
  2. 侧栏 → 插件 → 添加插件,输入 @ggboy123/dsh-paper-reader@latest,装完点进插件详情打开「启用」开关,重启桌面端

完成。侧栏底部点「📚 论文伴读」进入文献库,上传 PDF 开始用。

官方桌面端安装并使用论文伴读插件

需要官方桌面端 V0.2.0-rc.2 或更新版本(内置 dsh ≥0.2.0-rc.2);dsh 0.1.5 不再支持。

安装排坑(都实测踩过)
  • 升级后插件开关会回到停用:重新打开「启用」并重启。症状有迷惑性——文献树还在但点论文没反应
  • 添加务必带 @latest:不带版本号对已装过的插件是 no-op,不会追新
  • pnpm 供应链策略 minimumReleaseAge 拦新包时:等过窗口期,或把本包加进豁免清单(~/.dsh/profiles/web/.npmrc 的 minimum-release-age-exclude[];桌面端在 ~/.dsh/profiles/desktop/pnpm-workspace.yaml 的 minimumReleaseAgeExclude)
  • 想逛插件市场,可另装社区插件 dshmarket,本插件已在其目录中

开发者:命令行 dsh

dsh plugin --profile web add @ggboy123/dsh-paper-reader@latest   # 升级也是这条;不带版本号是 no-op

不要用 github:GGboya/dsh-paper-reader 安装 —— dist 不入库,git 安装会导致 profile 起不来。

快速上手

  1. 进入:侧栏底部点「📚 论文伴读」(再点还原)
  2. 入库:+ 新建专题 → ⬆ 上传 PDF
  3. 读 + 问:直接提问(回答自带页码),或选中文字弹框提问;点「第 N 页」跳回原文
  4. 中文版:顶栏「中」一键生成;需要专用翻译模型时,在「设置 → 论文伴读 → 全文翻译模型」里单独配置
  5. 管理:行悬停点「⋯」,文件名原地改名(Enter 保存 / Esc 取消),论文可移动到其它专题,也可删除;对话头部 🕐 历史、+ 新开

数据与安全

  • 所有数据都是本地文件:文献库默认在 ~/.dsh-paper-reader/data(可在 profile 改);插件自身的端点凭据落盘 $DSH_HOME/.dsh-paper-reader/(权限 0600,界面只回掩码)
  • 删除 = 移入回收站 data/.trash/(带 manifest,移回即恢复),会一并处理该文献的全部产物:<文献>.pdf、.txt、.pages.json、.transcript.json、.mineru.md、.mineru.json、.embeddings.json、.study.json、.notes.json 与译文变体 <文献>-en.pdf / -zh.pdf / -dual.pdf(含 .tmp-* 残留);伴读会话历史不删
  • 有运行中会话或翻译中的文献会被前置拒绝;路径穿越(..、绝对路径、符号链接逃逸)一律拒绝;操作中途失败自动回滚

参与开发

git clone https://github.com/GGboya/dsh-paper-reader
cd dsh-paper-reader && pnpm install && pnpm run build
dsh plugin --profile web add ./dsh-paper-reader   # 从父目录执行,或用绝对路径
dsh --profile web                                  # 侧栏变为文献库树

改完 pnpm run build 重启 profile 即生效;npm test 跑全量测试(CI 跑 ubuntu / macOS / Windows 三平台)。架构、测试守卫与开发约定见 AGENTS.md。

贡献者

感谢每一位贡献者:

贡献者头像墙

Star 趋势

Star 趋势图

License

MIT

版本与发布记录

@ggboy123/dsh-paper-reader 共发布 34 个版本,首次发布于 2026/09/18;过去 12 个月发布了 34 个版本。

版本发布日期距今
1.13.0latest2026/11/16今天
1.12.12026/11/123 天前
1.12.02026/11/115 天前
1.11.02026/11/105 天前
1.10.02026/11/105 天前
1.9.02026/11/096 天前

关于 @ggboy123/dsh-paper-reader 的常见问题

@ggboy123/dsh-paper-reader 是什么?

DeepSeek Harness 插件:论文伴读工作台 — PDF 转录 / 检索 / 原生对话伴读 + 内置阅读器页面。

如何安装 @ggboy123/dsh-paper-reader?

在项目目录运行 npm install @ggboy123/dsh-paper-reader,或使用 pnpm add / yarn add / bun add。它还需要宿主项目提供 peer 依赖:@deepseek-ai/cordis(^4.0.2)、@deepseek-ai/dsh-tools(>=0.2.0-rc.2 <0.3.0-0)。npm 7 及以上与 pnpm 8 及以上默认会自动安装必需的 peer 依赖,Yarn 需要手动安装。

@ggboy123/dsh-paper-reader 支持 TypeScript 吗?

该包的 package.json 没有声明类型入口。需要类型提示时,可以在 npm 上查找社区维护的 @types/ggboy123__dsh-paper-reader 是否存在。

@ggboy123/dsh-paper-reader 支持 ESM 还是 CommonJS?

以 ES Module 形式发布,推荐使用 import 引入。在 CommonJS 项目中,Node.js 20.19+ / 22.12+ 可以直接 require() 不含顶层 await 的 ES Module,更早的版本需要改用动态 import()。

@ggboy123/dsh-paper-reader 需要什么版本的 Node.js?

package.json 的 engines 字段要求 Node.js ^22.19.0 || >=24。版本不符时 npm 默认只给出警告,开启 engine-strict 后会拒绝安装。

@ggboy123/dsh-paper-reader 可以商用吗?

@ggboy123/dsh-paper-reader 使用 MIT 许可。宽松许可:允许商业使用、修改和再分发,通常只需在分发时保留原版权与许可声明。以上为概括,不构成法律意见,请以许可原文为准。

@ggboy123/dsh-paper-reader 的下载量有多少?

根据 npm 官方下载统计,@ggboy123/dsh-paper-reader 在 2026/10/17 – 2026/11/15 这 30 天内被下载 12,554 次,日均约 418 次。下载量会把 CI 构建、镜像同步和作为其他包依赖的安装一并计入,适合横向比较热度,不能直接等同于使用人数。

@ggboy123/dsh-paper-reader 还在维护吗?

最新版本 1.13.0 发布于 2026/11/16(今天);至今共发布 34 个版本,其中过去 12 个月发布了 34 个;首次发布于 2026/09/18。发布频率只是参考信号:功能稳定的工具可能很少需要更新,建议结合源码仓库的 issue 和提交记录判断。