dsh-paper-reader

dsh-paper-reader

English: README_EN.md

DeepSeek Harness (dsh) 插件：论文伴读工作台 —— 文献库 + PDF 阅读器 + AI 伴读，回答自带页码、点页码跳回原文。当前版本 v1.9.0。 💬 QQ 交流群：1127244508 —— 安装/使用问题、功能建议、bug 反馈都欢迎来聊。 为什么用论文伴读

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

核心能力 📚 三栏工作台：专题文献库 + PDF 阅读器 + 右侧原生对话；安装后不改动官方界面，侧栏只多一行开关 💬 带页码的伴读：回答必带页码，点页码跳回原文并高亮；选中文字即问；支持历史对话 🌙 PDF 深色模式：dsh 切深色时 PDF 一起变深（默认跟随）；设置面板与阅读器「A」按钮同源、四档强度可调。实现是整页反色 + 色相回正，图片/照片会明显褪色偏色（实测纯红 [255,0,0] → 浅粉 [229,134,134]，不是真负片；已知代价，可一键关闭）；下载/导出始终是原文 🗂️ 按论文分文件夹：每篇论文的 PDF/译文/转录/学习档案收进 / /；旧库有一条幂等、可中断、可回滚的迁移（先复制后删，先出干跑报告再执行） 🌳 嵌套子专题：专题下可建子专题、任意层嵌套；可改名、可移动到另一父专题；删除非空专题仍走「清空计划 + 手输确认」 🎯 按范围提问：提问时可指定范围（本篇 / 所在专题含子专题），只把该范围的目录内容与检索命中交给模型；范围外内容不出现，截断会明确说明 🤖 可选教练式带读：专用 preset 制定分步计划；你读原文、作答，AI 点评追问，当前阶段答好才继续，学习进度跨会话累积 🀄 一键中文版：原文 ↔ 纯中文原地切换，译文 PDF 一键导出（纯中文 / 中英对照），翻译引擎零预装自动安装 📏 长段落不截断 + 实时进度：翻译由 babeldoc-driver.py 驱动 babeldoc —— 按输入估算输出预算（不再吃 babeldoc 写死的 2048），finish_reason=length 自动拆段重译；顶栏进度条实时显示「翻译段落 76%（521/798）」这样的阶段进度，端点拒绝关闭推理时自动降推理强度重试 🈯 划词翻译（公式保留）（v1.9.0）：选中点「译」出纯译文气泡；选区含公式时用 MinerU 识别的 LaTeX 替换文本层乱码、要求模型原样保留 🖥️ 中英对照 / 分屏（v1.9.0）：并排对照页或左右分屏同步滚动，随时切换、按文献记忆 📝 笔记（v1.9.0）：划词仍直接弹回「选中即问」气泡（与旧版一致），气泡里新增「笔记」「全局搜索」小按钮；记过的文字下方画蓝色波浪线，鼠标停上去看笔记内容、点一下改或删；笔记窗口与查找窗同一套交互（可拖动、拖边框缩放、位置记忆），批量列表按页排序、点条目跳回原文，也可在条目上直接删除（二次确认）。笔记存在 .notes.json（跟文献走，换浏览器不丢） ⚡ 长文档也流畅：滚动模式只画视口附近的页、页离开视口即释放画布（其余保留等高占位，滚动条与页码始终准）；原文 ↔ 中文切换只摘挂缓存好的页节点，不重新解析不重绘；切语言 / 重开论文不重传 PDF（ETag 304）。前提与已知边界见 docs/features.md 🗂️ 文献

各功能的前提与配置细节见 docs/features.md。 安装 普通用户：桌面端装好即用（推荐）

两步：装 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 不再支持。 想逛插件市场可另装社区插件 dshmarket，本插件已在其目录中。

排坑（都是实测踩过的）： 升级后插件开关会回到停用：重新打开「启用」并重启。症状有迷惑性——文献树还在但点论文没反应 添加务必带 @latest：不带版本号对已装过的插件是 no-op，不会追新 pnpm 供应链策略 minimumReleaseAge 拦新包时：等过窗口期，或把本包加进豁免清单（~/.dsh/profiles/web/.npmrc 的 minimum-release-age-exclude[]；桌面端在 ~/.dsh/profiles/desktop/pnpm-workspace.yaml 的 minimumReleaseAgeExclude） 开发者：命令行 dsh 不要用 github:GGboya/dsh-paper-reader 安装 —— dist 不入库，git 安装会导致 profile 起不来。 怎么用

1. 进入：侧栏底部点「📚 论文伴读」（再点还原） 2. 入库：＋ 新建专题 → ⬆ 上传 PDF 3. 读 + 问：直接提问（回答自带页码），或选中文字弹框提问；点「第 N 页」跳回原文 4. 中文版：顶栏「中」一键生成（首次需在弹出表单里配一次 OpenAI 兼容端点，DeepSeek/GLM/Kimi 的 key 都行） 5. 管理：行悬停点「⋯」，文件名原地改名（Enter 保存 / Esc 取消），论文可移动到其它专题，也可删除；对话头部 🕐 历史、＋ 新开 文献管理（安全说明） 删除 = 移入回收站 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-* 残留）；伴读会话历史不删。运行中会话/翻译中的文献会被前置拒绝；路径穿越一律拒绝、失败自动回滚——细则见 docs/features.md 参与开发