dsh-paper-manager

面向学生、研究者和教授的论文阅读与引用管理器，作为 DeepSeek Harness 的左侧全局面板运行，同时保留右侧栏阅读标签页。它把「读论文」和「写论文」接在同一条工作流里：读的时候能翻译、概括、画思维导图、查术语；写的时候能跨文件夹多选论文，生成多种格式的参考文献，并把参考文献页直接追加到 Word 文档末尾。

本项目基于 jypjypjypjyp/dsh-paper-reader（MIT）扩展而来，保留其 PDF 原样渲染、批注与人机共管能力，并新增左侧栏、文件夹、AI 阅读、引用工作台、Word 插入与 GitHub / 插件市场发布。原始 MIT 归属见 LICENSE。

功能

阅读

• 原样呈现：pdf.js 按页把 PDF 渲染成画布，排版、字体、插图、公式都不经过转换；上传的原始文件保存在 ~/.dsh/paper-manager/，不做改写。
• 左侧栏入口：sidebar.panellist 中的论文管理器图标切换到 main 全局面板；右侧栏的「论文阅读器」标签页仍然可用，两个入口共享同一份论文库。
• 论文库与文件夹：新建、重命名、删除文件夹；每篇论文可移动到文件夹；按「全部 / 未分类 / 某文件夹」筛选；上传自动归入当前文件夹。
• 选中即用：选中正文任意文字，浮出「高亮 / 笔记 / 提问」以及第二行的「翻译选段 / 查术语」。
• 高亮与笔记：按页保存，跨缩放定位；「标注」页可回看、跳转、删除。
• 在会话中提问：把选段和问题写进会话输入框；左栏没有当前会话时自动新开一个会话。提问语言跟随界面语言。
• 一键翻译：翻译当前页或整篇论文；目标语言默认跟随界面语言，也可手动切换中/英。
• 概括与思维导图：一键生成结构化摘要（问题 / 方法 / 关键结果 / 局限 / 值得读的理由）和可展开的思维导图。
• 技术名词：提取全文技术名词并给出解释，每个名词可跳转 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 文件、插入。
• 插入 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。市场 CI 还要求仓库公开、创建满 1 天、带 dsh-plugin topic；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

装完刷新页面。左侧栏应出现论文管理器图标；右侧栏 + 中仍有「论文阅读器」。

使用

1. 点左侧栏论文管理器图标，打开全局面板。
2. 点工具栏上传按钮（或把 PDF 拖进面板）导入论文；先在库面板新建/选择文件夹，论文会自动归档。
3. 选中正文文字，使用浮出菜单；工具栏下方一排按钮可翻译本页、概括、生成思维导图、提取术语。
4. 面板四栏：标注、笔记（论文级结论）、代码、AI 阅读（翻译 / 概括 / 思维导图 / 术语）。
5. 写论文时：在书库勾选多篇论文（可跨文件夹）→ 点「参考文献」→ 选格式、核对/编辑元数据 → 选 .docx 或 .doc → 插入。
6. 发布：更多菜单 → GitHub → 连接账号 → 发布仓库 → 提交市场。

设置（工作目录、MinerU Token、模型、语言）在左侧「插件」→ dsh-paper-manager 详情页，使用插件自己的表单和宿主主题 token。

AI 能力

• 翻译优先使用 profile 里的 translator 服务；没有 translator 时回退到默认对话模型（agentDefaultModel），约 6000 字分块、3 路并发，返回 engine 标识。
• 概括、思维导图、术语提取直接调用默认对话模型，提示词按界面语言切换；导图返回严格 JSON 树，术语返回 8–16 条。
• 长论文按页抽取文字，最多 60 页 / 15 万字符。
• 所有 AI 请求走 /paper-manager/api/ai/*，只发送抽取出的正文，不发送 PDF 原件或标注数据。

结构

文件	作用
index.js	Host：/paper-manager 路由（库、文件夹、上传、元数据/标注、设置、解析、论文目录、AI、引用、文件浏览、GitHub/市场）与 paper_annotations 工具
client.js	Client：左侧 main 面板 + sidebar.panellist 图标、右侧 betterSidebar 标签页、阅读器、AI 面板、引用工作台、GitHub 弹窗
lib/docx.mjs	零依赖 DOCX ZIP 读写、参考文献页追加、独立参考文献 DOCX 生成
lib/word-append.ps1	Windows Word COM 桥：把生成的参考文献 DOCX 插入 .doc 末尾
public/	vendored pdf.js 3.11（Apache-2.0，许可证见 public/LICENSE-pdfjs.txt）
docs/PRODUCT.md	产品设计：用户、信息架构、功能规格、阅读—写作闭环、竞品、指标、风险

存储：~/.dsh/paper-manager/ 是内部库（<uuid>.pdf 原件、<uuid>.json 元数据、folders.json、settings.json、github.json）；对外论文文件夹在 ~/.paper_reading/<论文名>/。

已知边界

• GitHub 连接目前是「粘贴 Token」而不是 OAuth Device Flow；没有 Token 时无法代替用户创建仓库或开 PR。
• 插件市场提交是开 PR，是否收录由市场维护者的 CI 与人工审核决定；新仓库需满 1 天。
• .doc 插入依赖 Windows 上安装的 Microsoft Word；其他平台请先另存为 .docx。
• 本机没有可用的已连接浏览器控制，UI 只做了 JS 语法、manifest、live slot 与 HTTP API 验证，未做自动点击截图；首次使用请按上面的步骤走一遍。