DeepSeek Harness plugin

dsh-paper-reading

论文阅读伴侣:复制文字/图片给 harness 解释、整理与归档的文献阅读插件

Jump to install

Source facts

Repository
mrk-king/dsh-paper-reading
Latest update
Aug 17, 2026
Category
Docs & Rendering
GitHub stars
0
Format
plugin
Catalog evidence
Upstream dsh.bundle evidence
Evidence path
package.json#dsh.bundle
Checked against
0.1.0-rc.8
Upstream check date
2026-08-21

This evidence comes from the upstream catalog. This site has not installed, run, or security-reviewed the plugin.

Install

Start with a prompt that asks an agent to review the GitHub repository and source. Switch to the command if you want to install it yourself.

Copy this prompt into DSH, Codex, or another agent and ask it to review the GitHub repository and source first.

Do not install or run any commands yet. Read this plugin's GitHub repository, README, and relevant source code. Then answer the questions below clearly and directly so I can decide whether it fits my needs:

1. What is this plugin, and what problem does it solve?
2. Who is it for, and what are its typical use cases?
3. How is it used after installation? Include one minimal example.
4. What known limitations or privacy, security, compatibility, or maintenance risks does it have?
5. Give a clear recommendation: recommend, conditionally recommend, or do not recommend, with reasons.

Distinguish statements documented by the repository, inferences from source code, and unknowns. If evidence is insufficient, say so explicitly. Do not guess or simply repeat the README.

GitHub: https://github.com/mrk-king/dsh-paper-reading
Plugin: dsh-paper-reading
Author: mrk-king

Check the source files

Read the README and other files from this plugin directory before installing.

File explorer3 files
README.mdSource · read only

📄 dsh-paper-reading — DeepSeek Harness 论文阅读伴侣

文献阅读插件:把论文 PDF、复制文字、图表交给 AI 解读、整理与归档, 配套论文窗口(自托管 pdf.js 阅读器、文件夹/多标签管理、按论文记忆的笔记问答)。

> 配合预设 dsh-preset-literature > (📚 文献精读 · Router Paper)使用:论文功能仅在该预设下开放。

功能

  • 🧹 文字清洗归档:PDF 复制出来的乱排版(页码、断行、连字符、重复页眉)

自动修复,归档到当前论文,并按内容去重

  • 📄 PDF 论文:拖入 PDF → 自动入库(标题=文件名)+ pdftotext 全文提取;

论文窗口内自托管 pdf.js legacy 阅读器(缩放/搜索/翻页/旋转,文字可直接选中复制; 图片因 pdf.js 画在 canvas 上无法原生复制,用工具条「🖼 提取图片」一键提取页码图片—— 支持按页/区间/全部提取、自动去重、逐张「复制到剪贴板 / 下载」)

  • 🖼️ 图片解读(visionMode=auto,默认):当前会话模型自带识图(如 GPT-4o/Claude/

Gemini 等,harness 按模型能力自动判定)→ 图片直接发给模型解读,无需 ModLens;

模型无识图能力时 → 走 ModLens OCR 转录再发给 AI。也可用 visionMode=modlens|model

强制指定。识图模式在窗口状态栏实时显示(模型识图 / ModLens)

  • 📒 论文库与文件夹:每篇论文独立笔记(notes.md 问答片段、figures.md

图表转录、glossary.md 术语表);文件夹系统支持多文件夹归属(虚拟收藏集)、 过滤、拖入归类、新建/重命名/删除

  • 🧠 当前论文记忆:对话自动注入「当前论文」上下文;per-session 独立指针,

多对话并行各看各的论文、各归各的笔记;粘贴内容含另一篇论文标题时自动识别切换

  • 🔒 预设门控:工具与 UI 仅对 allowedPresets 配置的预设开放
  • 🤖 模型工具集:paper_switch / paper_capture / paper_read_figure /

paper_attach_pdf / paper_glossary / paper_qa / paper_summary / paper_find

设计文档见 [DESIGN.md](DESIGN.md)。

安装

方式一:预构建包(推荐)

下载 dsh-external-dsh-paper-reading-<version>.tgz(仓库 dist/ 目录或 Releases):

cd ~/.dsh/profiles/web
npm i /path/to/dsh-external-dsh-paper-reading-<version>.tgz
# 注册 bundle:把 "@dsh-external/dsh-paper-reading" 加入
# 本目录 package.json 的 dsh.profile.bundles 数组(插件自带 cordis.patch.yml,
# 注册后由 harness 自动装配;不加则插件不会被加载)
# 重启 DeepSeek Harness

> 更省事:直接用 dsh-preset-literature > 的 install.sh,一键完成预设 + 插件 + bundle 注册。

方式二:源码构建

git clone https://github.com/mrk-king/dsh-paper-reading.git
cd dsh-paper-reading
npm run build        # host 编译(tsc)+ client bundle(tsdown)
npm pack             # 产出 tgz(含 lib/ 与 assets/)

使用

1. 安装 dsh-preset-literature 预设,用「📚 文献精读 · Router Paper」新建会话 2. 右下角「📄 论文」按钮打开论文窗口 3. 把 PDF 拖进窗口(或页面任意位置)→ 自动入库(标题=文件名),在线阅读 4. 对话中粘贴文字/提问 → 自动归档问答与术语;窗口切换论文后记忆自动跟随 5. 也可以直接用对话:粘贴文字/图片发给 AI,模型按提示词自动清洗归档

配置

字段默认说明
libraryRoot~/Documents/papers-library论文库根目录
modlensBin自动探测ModLens 视觉引擎(读图 OCR,模型无识图时兜底)
visionModeauto识图模式:auto(模型自带识图优先,否则 ModLens)/ modlens(永远 ModLens)/ model(永远直接发图给模型,当前模型无识图能力时报错)
allowedPresets["channel-router"]允许论文功能的预设 id 列表
chatPushtrue面板内容可推送到对话
promptSectiontrue注入论文阅读行为提示词段
# profile 层配置示例
- id: paper-reading
  name: '@dsh-external/dsh-paper-reading'
  config:
    allowedPresets: ['channel-router']
    chatPush: true
    # visionMode: auto   # auto / modlens / model

数据位置

默认论文库:~/Documents/papers-library/(每篇论文一个目录: paper.pdf / paper.txt / notes.md / glossary.md / figures.md / figures/; 删除论文先进回收站 trash/,30 天自动清除)。

构建产物说明

  • lib/ — 编译后的 host 插件 + client 模块
  • assets/pdfjs/ assets/pdfjs-legacy/ — 自托管 Mozilla pdf.js viewer

(Apache-2.0,见各目录 LICENSE)

  • 运行时仅依赖 Node 内建(node 20+);识图优先用当前模型的视觉能力(visionMode=auto),

模型无识图时可选 ModLens 兜底

License

MIT(内置 pdf.js 资源为 Apache-2.0,见 assets/pdfjs/LICENSE)