dsh-paper-workbench
fxz729/dsh-paper-workbench
Paper libraries and literature management tools with nested collections, PDF imports, local metadata, reading, translation queues and optional ink annotations. An extension of GGboya/dsh-paper-reader 1.6.1 that reuses its default data directory (~/.dsh-paper-reader/data), so back up the library before migrating and enable only one of the two in a profile, because tool names and routes clash. Needs Harness 0.2.2-rc.1 and Node 24.9 or later; the ink annotations use tldraw, which needs a tldraw license key that you obtain and enter yourself.
설치
dsh plugin --profile web add github:fxz729/dsh-paper-workbenchREADME
DSH Paper Workbench · 文献工作台
把文献库管理、PDF 阅读和 DSH 原生 AI 伴读放进同一个工作区。
核心入口是文献管理工具 library_manage：让模型创建嵌套文献库、维护库备注、复制导入 PDF、保存已有摘要，再按需规划摘要生成与物理命名。图形界面提供文献树、目录导入、库备注、摘要生成和改名预览入口。
- 仓库：fxz729/dsh-paper-workbench
- 包名：
@fxz729/dsh-paper-workbench，版本：1.0.0 - 运行要求：DeepSeek Harness
0.2.2-rc.1、Node.js>=24.9.0。其他宿主版本需另行验证。
能做什么
| 工作流 | 功能 |
|---|---|
| 文献管理 | 嵌套文献库、本地库备注、非覆盖 PDF 导入、稳定 paperId／collectionId、带计划与确认的物理改名 |
| 摘要与命名 | 展示论文摘要、界面按需生成、模型已有摘要直接本地保存；全局自动摘要／命名默认关闭，仅处理启用后符合资格的新文献 |
| 阅读与伴读 | 文献树、PDF、DSH 原生聊天三栏；普通工作区也可在右侧阅读文献；页码跳转、选文提问、转录检索与学习记录 |
| 批注与墨迹 | 阅读器注释及可选手写墨迹；原文、中文版与双语版的墨迹独立保存 |
| 整篇翻译 | OpenAI 兼容 API + BabelDOC；后台队列、暂停／恢复、失败重试、有效译本检查；独立的全局或按库自动翻译 |
| 可选增强 | 本地 PDF 文本层转录、可选 MinerU OCR、embedding 与重排 |
文献管理工具
直接对 DSH 中的模型说：
建一个“课题／方法”子库，备注写“优先阅读可复现实验”。把指定目录中的 PDF 复制导入，保留外部原件。
这篇论文我已有摘要，帮我保存为本地摘要，不再调用生成 API。
先为新论文列出摘要和命名计划，等我确认费用后再执行。
工具动作固定为：
| Action | 用途 |
|---|---|
list | 读取库树与文献 |
create_collection | 创建根库或子库，附本地备注 |
update_collection | 修改备注；库名变更先返回改名计划，再按计划确认执行 |
import_pdfs | 复制外部 PDF 到指定库，同名不覆盖，保留源文件 |
get_paper | 读取论文或文献库详情 |
update_paper | 本地保存模型已知摘要与书目信息 |
plan_enrichment | 生成摘要／命名费用计划 |
run_enrichment | 经宿主确认后执行指定计划 |
set_automation | 设置全局自动摘要／命名；开启新功能需费用确认 |
job_status | 查询任务状态 |
工具不提供删除或任意配置修改动作。confirmCosts: true 表达费用意愿；实际执行仍核对宿主对本次工具调用的授权。更多示例见使用指南。
以下管理画面使用隔离演示环境：虚构资料、生产组件与真实本地 Host/runtime，周围宿主外壳使用替身，不含真实模型会话。
界面预览
以下截图同样使用虚构文献与自产 PDF，展示生产阅读器、详情与批量页面；宿主外壳使用替身，未输入许可的墨迹功能正常保持禁用。演示不调用模型服务。
| 文献摘要与全局自动开关 | 批量翻译与候选筛选 |
|---|---|
 |  |
安装
迁移前先备份整个文献库。 默认数据目录沿用 ~/.dsh-paper-reader/data。同一 DSH profile 中，请只启用本插件或上游 @ggboy123/dsh-paper-reader 中的一份，避免同名工具与路由冲突。
在 DSH Desktop 的“插件 → 添加插件”中输入下面的 Release .tgz 安装包地址，安装后启用。发行包、版本说明和 SHA-256 校验和见 v1.0.0 Release：
https://github.com/fxz729/dsh-paper-workbench/releases/download/v1.0.0/fxz729-dsh-paper-workbench-1.0.0.tgz
普通 Web profile 的 CLI 示例：
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，使后端模块与前端页面版本一致。
该 CLI 示例操作 web profile，Desktop 使用自己的 profile。也可添加本仓库的自定义插件索引后从“发现”页面安装；步骤与社区收录进度见安装和市场。
开始使用
- 启用插件，打开“文献库”，创建文献库或子库。
- 上传 PDF，或选择目录并检查导入预览。目录内 PDF 递归收集到同一目标专题，同名与译文产物跳过，原目录保留。
- 打开文献：在文献工作台三栏中阅读，也可切回普通工作区使用右侧伴读。
- 在“文献摘要”中阅读或生成摘要，在“库备注”中编辑本地备注；自动开关初始保持关闭。
- 需要整篇翻译时再配置兼容端点；聊天模型仍由 DSH provider 管理。
手写墨迹使用 tldraw SDK 5.6.0。生产使用需要每位用户自行取得并输入有效 tldraw 许可 key；仓库与安装包不提供私人 key，许可校验保持启用。普通 PDF 阅读与文献管理可单独使用。
费用与数据
- 本地库备注、已有摘要保存与普通文献盘点在本地执行。
- 翻译、摘要／命名生成、云端 OCR、embedding 与重排会使用各自配置的服务；配置连接测试也可能产生请求和费用。
- 自动摘要／命名为全局、默认关闭、future-only策略，覆盖未来子库；启用时已有文献不回填。自动命名会实际重命名 PDF 及受管理的关联文件。
- 自动翻译与摘要／命名分别控制。全局翻译覆盖当前与未来文献库；按库规则只作用于指定 CID。关闭自动翻译停止新增入队，已入队任务由队列“暂停”控制后续执行。
- 许可 key、端点凭据与私人文献应保留在用户自己的环境中；详见配置说明和安全说明。
文档与验证
- 使用指南：文献管理工具、界面、阅读与删除恢复。
- 配置说明：模型、翻译、OCR、许可与数据目录。
- 开发指南：维护源码、构建与隔离验证。
- 安装和市场：Release 资产、自定义索引与发布状态。
- 发布验证记录：由发布维护者记录具体命令、范围与待验项。
- 变更记录 · 贡献指南。
验证记录分别说明本地业务、SDK 注册和实际宿主 GUI 的验收范围；界面演示的范围见上方截图说明。
来源与许可
本项目基于 GGboya/dsh-paper-reader 1.6.1 扩展，保留 GGboya 的 MIT 版权与许可。应用代码采用 MIT；tldraw、PDF.js、字体等资源遵循各自原许可，详见第三方声明。本项目是独立扩展，不以 DSH 官方插件身份发布。