@mappedinfo/dsh-paper-library

使用

按下方步骤安装到 Harness profile 后，重启 Harness，在右侧面板的入口页选择 文献库 / Paper Library。启动时不会导入或扫描现有 Zotero 文献。

1. 把 PDF 拖入窗口，或粘贴论文链接 / DOI，自动下载或复制、解析并保存。支持多文件顺序导入；「文献库」工具栏的「导入」可选择文件、输入本地路径，或导入 JSON、RIS、BibTeX。目录和元数据按每批 100 条继续处理，显示累计进度；每条记录保存检查点。

2. 搜索标题、作者、年份、DOI、引用键、标签或摘要。侧栏卡片用于选文阅读；「文献库」或「展开表格」用于排序、分页和维护资料。点击文献题名进入阅读界面（无 PDF 的条目只显示资料，不产生 PDF 读取）；演示文稿题名打开对应 Slides 项目。PDF 默认单页连续滚动，可在阅读工具栏切为「双页」并排，奇数尾页单独保留；页码输入框可精确跳转。单页最多保留当前页附近 3 页的图像和文字，双页最多 4 页，后续页面按需载入；首屏与页面均显示加载提示，失败可重试，动画遵循系统的减少动态效果偏好。「全屏阅读」扩展阅读区域，Esc 返回。阅读工具栏提供缩放：默认「全宽」自适应窗宽，可用 −／＋、直接输入 25–400 的百分比，或点「全宽」复位；支持触控板双指捏合和触屏双指缩放，保持手势中心对应的阅读位置；普通双指滚动继续滚动。放大后页面可横向移动，停止手势后按屏幕像素密度提高图像清晰度；单页最多 1,600 万像素／单边 8,192 像素，达到上限会提示，驻留仍限单页模式 3 页／双页模式 4 页。点击文中的批注标记会定位并高亮批注栏里对应的条目；点击批注栏条目则滚动到文中该批注并高亮闪示（选文优先：拖选文字仍走批注流程）。阅读与批注栏之间有一条分隔条，可拖动无级调整侧栏宽度（160–720 px，键盘方向键也可微调），PDF 随窗宽自动重新适配；宽度、缩放与单双页布局保存在主机，换浏览器或刷新后恢复。

3. 在顶部「批注」工具栏选择高亮、下划线、删除线及颜色，然后拖选文字保存想法；「便笺」可点选页面位置。阅读侧栏用「文献库／批注」标签切换内容，可整体移到右侧；切换时保留检索、列表滚动与 PDF 阅读位置。Ctrl/Cmd + K 返回文献库检索。窄屏或全屏时可收起侧栏，恢复 PDF 空间。点击批注窗口外部时，有文字就先保存后关闭，空白不新增记录；保存失败保留输入，显式「取消」或 × 仍取消。本插件新建及随后编辑的下划线使用更清楚的线宽，已有外部样式不批量改写。保存完成后，标准批注已写进管理副本 PDF。

4. 顶部工具栏按当前操作切换。库和阅读工具栏中的「引用与导出」菜单提供 APA 7、BibLaTeX、批注 PDF 和批注文本导出，打开菜单保留当前视图和阅读位置；「资料详情」打开快速编辑窗口。资料草稿保存在运行 DSH 的本机，关闭页面、切换论文或换浏览器后可恢复。APA 7 同时提供富文本和纯文本；插件「设置 → 导出与维护」中的「导出文献库」导出文献与数据集的引用元数据；演示稿在 Slides 工作台导出。「生成 references.bib」根据文献库条目在 exports/ 目录生成引用文件与身份审计 bibliography.audit.json，不选择本次提问的引用（引用键冲突、DOI 重复、缺失字段、受管 PDF 文件核对；缺 DOI 的条目按"有页面链接可补全／只能手工"分别列出）；AI 会话也可用 library_bibliography 工具触发同一构建，并可显式分批核验 DOI 的公开登记信息——逐字段比较题名、年份、期刊与第一作者，冲突会同时保留目录值与登记值，只比较，不回写。

5. 在「本文图谱」中添加方法、数据集、主张、证据、概念、作者或机构，并记录有方向的关系及依据。顶栏「全库图谱」或本文图谱中的「查看全库图谱」可跨文献浏览已保存的节点与关系，按目录每批最多 40 篇翻页，当前视图最多 100 个节点；可打开来源论文及已记录的 PDF 页码。全库视图只供浏览，编辑仍回到所属论文。作者、机构和标签等元数据节点与读者记录的主张分别标示；图中关系不会自动成为学术证据。

   图谱支持「＋／−」缩放、「适应全图」和拖动空白平移；Ctrl／⌘ + 滚轮也可缩放。键盘可用方向键平移、+／− 缩放、0 或 Home 适应全图；Tab 进入节点后用 Enter／空格选择。当前节点以外环、强调名称和关联边标识，来源说明在图下展开，选中不会重置缩放。全库图谱右上角「全屏」优先使用浏览器全屏；不支持时展开至当前页面，「退出全屏」恢复。

   图下的年份与引用量图表统计整个有效文献目录，与当前图谱批次无关，并提供可展开的数据明细。年份缺失单列；引用量按已保存的 Crossref／OpenAlex／Semantic Scholar 来源快照分别显示已知覆盖数，不把缺失当作 0，也不按当前图中的连线数推算。尚未采集可识别引用量时明确显示无数据；这些统计只读取已有元数据，不联网补齐或更新。字段与结果上限见 图谱统计接口。

6. 打开论文时，插件自动建立或复用这篇论文的 DSH 对话。「对话」打开阅读中的可缩放浮窗，关闭后保留问题与引用并停止刷新历史。通过「新增与更新」「选择…」或「全部」建立本次引用集合，可混选新旧批注、增删条目，并附加临时选文。之后保存的批注会提示加入，不会改变已有选择。插件内与 DSH 主页面使用同一段历史。

7. 点击「放入主输入框」将固定的批注集合以原生引用标签追加到论文主对话，由你编辑问题、发送。左侧批注卡片的「问 DSH」会直接提问。仅准备草稿不会调用模型；「发送」和可选的「实时伴学」会使用模型额度。新安装默认关闭自动回复，升级保留已有选择。

8. 对带批注引用的提问，DSH 完成回复后会自动将 AI 原文保存到对应批注下面，折叠显示为「AI 回复」。涉及多条批注的回复会在各自下面显示关联；批注计数只统计原批注。PDF 保存标准回复关系以及会话、消息、当次引用快照标识，重复保存不会增加副本。保存失败可在对话中重试，DSH 原回复保留。没有明确批注引用的回复仍可手动保存，显示在「未关联回复」中。

9. 选中文字后点击「直接翻译」或「优化表述」，在「语言与词条」大窗口查看结果与表达说明。顶部只保留统一入口，翻译与表述、本篇记录和难词检索共用该窗口，切换时保留输入草稿。翻译默认按原文自动选择中英文方向，也可手动指定；表述优化保留原文语言、含义和证据强度。翻译默认优先使用已配置的轻量模型（DeepSeek Flash 非思考，其次 Kimi HighSpeed 低推理；不可用时沿用宿主），润色默认跟随 DSH。可在「语言与词条」中的「语言设置」或插件「设置 → 语言模型与提示词」中单独指定模型，并分别补充翻译／润色提示词；语言设置保存在主机，不改变 DSH 默认模型或论文对话模型。结果自动落盘，可复制或带入论文对话草稿。

10. 「难词本」自动积累处理原文中出现的难词，保留原句、论文、已知页码与 AI 释义。可以检索、核对和编辑释义、标记已掌握、删除或导出 JSON / CSV。AI 推荐的难词初始为「待学习」，不代表已经学会。

语言窗口左侧的「侧边窗」可切换为不遮挡选文操作的右侧窗口，再点「大窗口」恢复；切换保留草稿与结果。「跟随语言设置」旁显示当前有效目标，自动模式随输入更新检测结果；没有输入或设置读取失败时明确提示。优化表述提供通用、语法纠错、精简表达、学术表达、逻辑衔接、通俗解释，选择方向后再点击生成；各方向均保留原文语言、事实、引用与证据强度。结构目录扫描采用增量更新，保留未变化卡片、展开状态、滚动位置和已载入截图。

在「语言与词条 → 词条 → 新建词条」输入难词和包含该词的原句，点「自动翻译并保存」即可同时保存词义与原句译文。默认带入当前论文、页码和所选原文；已有难词可点「补充原句与译文」关联另一处来源，保留手动修订的释义和学习状态。原句与 AI 译文并排展示，来源按钮回到 PDF 页码。原句标明由用户选取或填写，不冒充已经逐字核验。作者语言背景默认未知；可展开填写中文／非中文／混合语言背景及核实依据，仅作为用户注明，不从姓名、机构、国籍或文章语言推断。翻译使用已配置的语言模型路线，同一次保存重试不重复生成。

目录同时显示文献、数据集和演示文稿，可按类型筛选、排序和分页；点击演示文稿的题名或「打开」进入对应 Slides 项目。阅读项目只筛选其关联文献，演示文稿不属于阅读项目。

内容导航分为 文献 / 画板 / LaTeX 写作 / 阅读项目，搜索与分类共用一行，库计数和表格操作在其下；文献的阅读项目筛选与类型、范围、排序合并。阅读项目按学习或研究主题组织文献，与 LaTeX 写作项目分开；项目目录支持检索、分页与新建，打开后直接浏览成员文献及已关联的画板和写作项目。选择条目后，「路径」和「关联」按钮按需展开当前路径与关联内容，不再常驻占行；通过阅读项目建立的联系会注明来源，不按名称推断关联或移动文件。检索栏限制宽度。选定 LaTeX 写作项目后，同排「编译版本」按钮打开版本面板；成功手动编译保存源码、PDF 和自审快照。四个入口共用导航与列表样式，切换前保护未保存改动，详见内容导航。

草稿、引用选择、阅读位置、旧版偏好、语言记录与难词本存入 $DSH_HOME/paper-library//state；未设置 DSH_HOME 时使用 ~/.dsh。不同浏览器连接同一个 DSH 服务时共享这些文件。文献与 PDF 继续放在配置的文献库目录，主对话继续使用 DSH 原生会话文件。浏览器只保留当前操作所需的内存数据，不把内容写入 localStorage 或浏览器缓存。旧版浏览器草稿会在首次打开时迁移并核对；冲突版本另存为本机备份，可从「导出旧草稿」取回。同时编辑发生冲突时，界面保留当前未保存文字并提供导出，不会覆盖另一窗口的版本。

资料库默认在 ~/.local/share/dsh-paper-library。PDF 导入时复制到该目录；原件不修改。关闭 Zotero 后可以继续使用全部本地功能。模型功能需要连接经过身份验证的 DSH 服务；同一服务可从不同浏览器访问。独立预览服务可以管理和阅读资料，但没有单独连接 DSH 模型的代理。

界面沿用 DSH 的中性色、系统无衬线字体、按钮与侧栏样式。在 DSH 中打开时，浅色／深色主题和内容字号随主应用实时更新，不需要刷新阅读页；独立网页跟随系统的浅色／深色设置。主题变化只调整阅读工具、面板和表单，PDF 原文及所选批注颜色保持原样。插件不另存一套主题偏好。

插件内的资料详情、论文对话、百科与语言词条、后台整理、研究难点及对话窗口共用标题拖拽：拖动标题空白处或移动图标；聚焦移动图标后可用方向键移动，Shift 加速。窗口可前置、调整大小并恢复位置，缩小桌面窗口后保持可触达。资料窗口的左右切换会重新停靠。论文关联数据集是非阻断窗口，始终显示它绑定的原条目；切换论文后仍按该条目保存关系，删除继续要求明确确认。

在 DSH 中，文献库、画板、LaTeX 和 Slides 的工具栏提供「返回 DSH」，全屏时也保留。返回前先检查写入和草稿；保存失败或存在冲突时留在当前页面。嵌入式标签使用宿主返回动作，DSH 挂载路径下独立打开的页面返回同源首页；独立预览服务不显示此入口。