前言¶
在 DeepSeek Harness（DSH）里做文献调研时，常见做法是：PDF 放在文件夹里，摘要和笔记散落在聊天记录或单独文档里，阅读和提问还要在多个窗口之间切换。上游的 paper-reader 类插件已经能解决一部分阅读需求，但如果希望用模型直接规划嵌套专题库、批量导入 PDF、在确认费用后再跑摘要与物理改名，并把翻译队列、伴读和可选批注收进同一套界面，就需要一个以「文献管理工具」为入口的工作台型插件。
下面介绍社区维护的客户端插件 DSH Paper Workbench（@fxz729/dsh-paper-workbench），维护者为 fxz729，归类为 DSH 客户端插件。它把文献库管理、PDF 阅读与 DSH 原生 AI 伴读放进同一个工作区；核心入口是宿主暴露给模型的文献管理工具 library_manage。
这是什么¶
DSH Paper Workbench 是面向 DSH 用户的文献工作台插件，包名 @fxz729/dsh-paper-workbench，当前发行版本 1.0.0。项目在 GGboya/dsh-paper-reader 1.6.1 基础上扩展，应用代码采用 MIT 许可；仓库声明其为独立扩展，不以 DSH 官方插件身份发布。
运行要求（README 与 package.json 一致）：DeepSeek Harness 0.2.2-rc.1、Node.js >=24.9.0；其他宿主版本需自行验证。默认数据目录沿用 ~/.dsh-paper-reader/data。
同一 DSH profile 中，请只启用本插件或上游 @ggboy123/dsh-paper-reader 中的一份，避免同名工具与路由冲突。迁移或替换插件前，建议先备份整个文献库。
核心功能¶
README 将能力归纳为几条主工作流，均可与图形界面或 library_manage 配合使用。
文献管理与嵌套文献库¶
支持嵌套文献库、本地库备注、非覆盖式 PDF 导入，以及稳定的 paperId / collectionId。物理改名带计划与确认流程，避免模型或自动化误改文件名。图形界面提供文献树、目录导入、库备注、摘要生成和改名预览入口。
文献管理工具不提供删除或任意配置修改类动作；费用相关意愿通过 confirmCosts: true 表达，实际执行仍依赖宿主对本次工具调用的授权。
摘要与命名¶
可展示论文摘要，在界面中按需生成，或由模型将已有摘要直接本地保存。全局自动摘要 / 命名默认关闭，且为 future-only 策略：仅处理启用后符合资格的新文献，启用时不对已有文献回填。自动命名会实际重命名 PDF 及受管理的关联文件。
阅读与伴读¶
文献工作台提供文献树、PDF 与 DSH 原生聊天三栏布局；普通工作区也可在右侧阅读文献。支持页码跳转、选文提问，以及转录检索与学习记录相关能力（具体配置见仓库内配置说明）。
批注与墨迹¶
阅读器支持注释及可选手写墨迹；原文、中文版与双语版的墨迹独立保存。手写墨迹基于 tldraw SDK 5.6.0，生产使用需要每位用户自行取得并输入有效的 tldraw 许可 key；未配置许可时墨迹功能保持禁用，普通 PDF 阅读与文献管理可单独使用。
整篇翻译与可选增强¶
整篇翻译依赖 OpenAI 兼容 API 与 BabelDOC，支持后台队列、暂停 / 恢复、失败重试与有效译本检查；可配置全局或按库的自动翻译，与自动摘要 / 命名分别控制。可选增强包括本地 PDF 文本层转录、可选 MinerU OCR、embedding 与重排等，均通过各自服务端点配置，连接测试也可能产生请求和费用。
文献管理工具 library_manage¶
对 DSH 中的模型直接用自然语言说明意图即可，例如：
建一个「课题 / 方法」子库，备注写「优先阅读可复现实验」。把指定目录中的 PDF 复制导入，保留外部原件。
这篇论文我已有摘要，帮我保存为本地摘要，不再调用生成 API。
先为新论文列出摘要和命名计划，等我确认费用后再执行。
工具动作固定如下：
| Action | 用途 |
|---|---|
list |
读取库树与文献 |
create_collection |
创建根库或子库，附本地备注 |
update_collection |
修改备注；库名变更先返回改名计划，再按计划确认执行 |
import_pdfs |
复制外部 PDF 到指定库，同名不覆盖，保留源文件 |
get_paper |
读取论文或文献库详情 |
update_paper |
本地保存模型已知摘要与书目信息 |
plan_enrichment |
生成摘要 / 命名费用计划 |
run_enrichment |
经宿主确认后执行指定计划 |
set_automation |
设置全局自动摘要 / 命名；开启新功能需费用确认 |
job_status |
查询任务状态 |
更多示例见仓库 使用指南。
安装与启用¶
发行包、版本说明和 SHA-256 校验和见 GitHub v1.0.0 Release。
在 DSH Desktop 的「插件 → 添加插件」中输入 Release .tgz 地址，安装后启用：
https://github.com/fxz729/dsh-paper-workbench/releases/download/v1.0.0/fxz729-dsh-paper-workbench-1.0.0.tgz
使用普通 Web profile 时，可用 CLI 添加同一地址（示例针对 web profile；Desktop 使用自己的 profile）：
dsh plugin --profile web add https://github.com/fxz729/dsh-paper-workbench/releases/download/v1.0.0/fxz729-dsh-paper-workbench-1.0.0.tgz
Desktop 安装或替换插件后，请完全退出并重新打开 DSH，使后端模块与前端页面版本一致。也可按仓库 安装和市场 添加自定义插件索引后从「发现」页面安装。
典型用法¶
按 README「开始使用」流程，启用插件后可以按下面步骤走通主路径：
- 打开「文献库」，创建文献库或子库。
- 上传 PDF，或选择目录并在导入预览中确认；目录内 PDF 会递归收集到同一目标专题，同名与译文产物跳过，原目录保留。
- 打开文献：在文献工作台三栏中阅读，或切回普通工作区使用右侧伴读。
- 在「文献摘要」中阅读或生成摘要，在「库备注」中编辑本地备注；自动相关开关初始保持关闭。
- 需要整篇翻译时再配置兼容端点；聊天模型仍由 DSH provider 管理。
本地库备注、已有摘要保存与普通文献盘点在本地执行。翻译、摘要 / 命名生成、云端 OCR、embedding 与重排会使用各自配置的服务。许可 key、端点凭据与私人文献应保留在用户自己的环境中；细节见 配置说明 与 SECURITY.md。
适用场景与注意¶
适合需要在 DSH 内长期维护嵌套专题库、希望用 library_manage 让模型参与建库 / 导入 / 摘要规划，同时要在同一宿主里阅读 PDF、伴读提问和可选队列翻译的研究者与智能体开发者。
使用前请注意：
- 插件在当前 DSH 进程权限下运行，安装前应自行审阅源码与 MIT 许可证 及 第三方声明。
- 社区插件目录站点 SkillHub 插件页 与 GitHub 仓库用于发现与安装，与 DeepSeek / 幻方无官方从属关系；DSH 生态奉行「一切皆插件」，本插件为社区独立维护。
- 自动翻译关闭后停止新增入队，已入队任务由队列「暂停」控制后续执行；启用任何自动能力前建议先阅读费用与数据相关章节。
文档与链接¶
- 社区目录：fxz729/dsh-paper-workbench
- 源码与 README：github.com/fxz729/dsh-paper-workbench
- 使用、配置、开发与发布验证：仓库内
docs/及CHANGELOG.md
经过上面的步骤，你可以在 DSH 内把文献树、PDF 阅读、模型侧库管理与按需付费的摘要 / 翻译能力放在同一工作台中完成，而不必在文件夹、聊天和单独阅读器之间来回切换。
