前言¶
用 DeepSeek Harness（DSH）做文献工作，常见状态是：PDF 散落在磁盘各处，读的时候要开另一个窗口看原文，记笔记又回到另一个工具，最后写论文再手工整理参考文献。深度求索的 DSH 一直强调「一切皆插件」，这次介绍的 xurui2022/dsh-paper-manager 就是一个把「读论文」和「写论文」接在同一条工作流里的插件。它把论文库挂在 DSH 的左侧全局面板，右侧栏仍保留一个阅读标签页，选段可以翻译、概括、画思维导图、查术语，写论文时能跨文件夹多选论文生成参考文献，并把参考文献页追加到 Word 文档末尾。
下面介绍这个插件的定位、功能、安装和用法。事实以 GitHub README 和 package.json 为准。
这是什么¶
dsh-paper-manager 面向学生、研究者和教授，维护者是 XuRui2022，分类为联网工具，在社区目录的星标为 0。它的前身是 jypjypjypjyp/dsh-paper-reader（MIT），本插件保留其 PDF 原样渲染、批注与人机共管能力，新增左侧栏、文件夹、AI 阅读、引用工作台、Word 插入与发布流程。原始 MIT 归属见仓库的 LICENSE。
一句话定位：一个跑在 DSH 里的论文阅读与引用管理器，入口在左侧栏，数据落在本机，AI 能力通过宿主对话模型完成。
核心功能¶
阅读¶
pdf.js 按页把 PDF 渲染成画布，排版、字体、插图、公式都不经过转换。上传的原始文件保存在 ~/.dsh/paper-manager/，不做改写。左侧栏入口在 sidebar.panellist 中，点论文管理器图标切换到 main 全局面板；右侧栏的「论文阅读器」标签页仍然可用，两个入口共享同一份论文库。
论文库支持新建、重命名、删除文件夹，每篇论文可移动到文件夹，过滤器按「全部 / 未分类 / 某文件夹」筛选，上传自动归入当前文件夹。
选中正文任意文字会浮出菜单：第一行是「高亮 / 笔记 / 提问」，第二行是「翻译选段 / 查术语」。高亮与笔记按页保存，跨缩放定位，面板的「标注」页可以回看、跳转、删除。选段和问题可以写进会话输入框，左栏没有当前会话时自动新开一个，提问语言跟随界面语言。
工具栏下方是一排 AI 按钮：翻译本页或整篇论文（目标语言默认跟随界面语言，也可手动切换中/英）、概括、生成思维导图、提取术语。概括输出结构化摘要，包含问题 / 方法 / 关键结果 / 局限 / 值得读的理由；导图返回可展开的树；术语给出 8–16 条技术名词与解释，每个名词可跳转 Google Scholar、Semantic Scholar 或 Wikipedia。
批注是人机共管的：批注存在磁盘上，agent 通过 paper_annotations 工具读写，人在阅读器里读写，AI 写的批注带 AI 标签。每篇论文还可以挂一个开源仓库地址和/或本地代码目录，点文件让 agent 对照论文读代码。
写作与引用¶
书库里的复选框不会因为切换文件夹而丢失，可以跨文件夹累积选择，服务端上限 200 篇。支持六种参考文献格式：GB/T 7714、APA 7、MLA 9、Chicago、IEEE、BibTeX，切换格式即时重排。引用元数据可以编辑作者、年份、标题、期刊/会议、卷、期、页码、出版社、DOI、URL、文献类型，保存后写回论文元数据。
引用工作台左侧列出已选论文，右侧显示格式化预览，可以复制、选择 Word 文件、插入。.docx 用零依赖 OOXML 追加，保留原文档的样式、字体、图片和其他 ZIP 条目，只在 word/document.xml 的节属性前插入分页、标题和编号条目；.doc 在 Windows 且安装了 Microsoft Word 时，通过 Word COM 把生成的参考文献页插入原文件末尾，不解析二进制 .doc，也不破坏原文件。插入完成后默认用系统默认程序打开文档。
发布¶
发布流程分两段：GitHub 连接和插件市场提交。连接时在弹窗中粘贴有 repo 权限的 Personal Access Token，服务端校验 /user 后以 0600 权限保存在 ~/.dsh/paper-manager/github.json。发布仓库会创建或复用 <login>/<repo>，改写 package.json 的 repository/homepage/bugs，执行 git init/commit/push，成功后把远端改回不含 token 的干净 URL。提交市场则是 fork awesome-dsh-plugin/awesome-dsh-plugin，向 data/plugins/<owner>__<repo>.yml 写入条目并向主仓库开 PR。
安装与启用¶
本插件按 DSH bundle 方式安装。开发目录在 D:\deepseekHarness\paper-manager 时，在 Harness 会话里执行：
plugin_manager action=install_bundle target=D:\deepseekHarness\paper-manager
或从 GitHub 安装：
dsh plugin --profile desktop add github:<your-account>/dsh-paper-manager
装完刷新页面。左侧栏应出现论文管理器图标，右侧栏 + 中仍有「论文阅读器」。
工作目录、MinerU Token、模型、语言等设置在左侧「插件」→ dsh-paper-manager 详情页，使用插件自己的表单和宿主主题 token。
典型用法¶
- 点左侧栏论文管理器图标，打开全局面板。
- 点工具栏上传按钮（或把 PDF 拖进面板）导入论文；先在库面板新建/选择文件夹，论文会自动归档。
- 选中正文文字，使用浮出菜单；工具栏下方一排按钮可翻译本页、概括、生成思维导图、提取术语。
- 面板分为四栏：标注、笔记（论文级结论）、代码、AI 阅读（翻译 / 概括 / 思维导图 / 术语）。
- 写论文时：在书库勾选多篇论文（可跨文件夹）→ 点「参考文献」→ 选格式、核对/编辑元数据 → 选
.docx或.doc→ 插入。 - 发布：更多菜单 → GitHub → 连接账号 → 发布仓库 → 提交市场。
AI 请求都走 /paper-manager/api/ai/*，只发送抽取出的正文，不发送 PDF 原件或标注数据。翻译优先使用 profile 里的 translator 服务，没有时回退到默认对话模型（agentDefaultModel），约 6000 字分块、3 路并发；概括、思维导图、术语提取直接调用默认对话模型，提示词按界面语言切换。长论文按页抽取文字，最多 60 页 / 15 万字符。
适用场景与注意¶
适合需要长期读论文、写综述或学位论文，并希望在同一个界面里完成阅读与引文整理的人。插件的 AI 能力依赖宿主配置的对话模型与 translator 服务，因此行为会随模型变化。
几个必须知道的限制：
.doc插入依赖 Windows 上安装的 Microsoft Word，其他平台请先另存为.docx。- GitHub 连接目前是「粘贴 Token」而不是 OAuth Device Flow；没有 Token 时无法代替用户创建仓库或开 PR。
- 插件市场提交是开 PR，是否收录由市场维护者的 CI 与人工审核决定，新仓库需满 1 天。
- 本机没有可用的已连接浏览器控制，UI 只做了 JS 语法、manifest、live slot 与 HTTP API 验证，未做自动点击截图，首次使用请按上面的步骤走一遍。
- 插件以当前 dsh 进程权限运行，安装前应检查源码与许可证：MIT，原件存储在
~/.dsh/paper-manager/，对外论文文件夹在~/.paper_reading/<论文名>/。 - 渲染部分使用 vendored pdf.js 3.11（Apache-2.0，许可证见
public/LICENSE-pdfjs.txt）。
社区目录是独立站点，与 DeepSeek / 幻方无官方从属关系，也不等同于官方应用商店。
结尾¶
dsh-paper-manager 的价值在于把论文库、AI 阅读和引文工作台收进 DSH 的面板，不用频繁切换窗口。目录页：https://www.skillhub.cn/plugins/XuRui2022/dsh-paper-manager，GitHub：https://github.com/XuRui2022/dsh-paper-manager。
