dsh-pdf-jump

DSH PLUGIN文档与办公

仓库 taoziliyouchong/dsh-pdf-jump · npm dsh-pdf-jump

文档与办公 未标注验证等级 安全审查:未标注 可信度:未标注 可安装插件
安装这个插件

在 DSH 侧栏查看本地 PDF 的插件:支持按页码跳页、整本缩略图浏览并滚动换高清,也可用原生预览直接打开。

一句话选型结论

按资料字段整理

dsh-pdf-jump 是文档与办公类的 DSH 可安装插件,未做沙盒验证,暂无安全审查结论,列出 5 项功能,有可直接复制的安装命令。验证通过不等于安全:插件会读写文件、执行命令或联网,装前先到仓库确认它做了什么;涉及密钥或系统权限的,建议先在隔离环境试装。

分类文档与办公 收录类型可安装插件 验证等级未标注验证等级 安全审查未标注
验证等级 UNKNOWN 未标注验证等级
GitHub 星标 1 复刻 0 · 未关闭 issue 0
最近更新 2026-11-07 创建于 2026-10-28
README 6.7 KB 正文体量,越大说明说明书写得越细

安装

可安装插件
在 DSH 里执行,装完用 dsh plugin list 确认已挂上;标了 L4 / L5 的命令已在沙盒里真实跑通
dsh plugin --profile web add dsh-pdf-jump
  1. 1
    确认版本与运行环境

    Node.js 要求 ^22.19.0 || >=24.0.0;版本不匹配时安装会报错。

  2. 2
    执行安装命令

    在 DSH 里执行上面的命令;多包仓库要注意区分具体子包名,别装错包。

  3. 3
    确认已挂载

    用 dsh plugin list 查看列表里是否出现这个插件,出现即挂载成功。

  4. 4
    试跑并检查权限

    加载后跑一个最小用例,确认它能正常工作;同时看它申请了哪些文件、命令或网络权限。

兼容 DSH 版本未标注版本不匹配时安装会报错
Node.js 要求^22.19.0 || >=24.0.0来自仓库 package.json 的 engines 字段
前置依赖无需要同时安装的同级依赖
npm 包名dsh-pdf-jump可用 npm view 查看包信息

能做什么

5 项功能
字段来自项目仓库与公开索引,中文说明由本站标注

dsh-pdf-jump:在 DeepSeek Harness 侧栏里翻阅本地 PDF 的 DSH plugin

  • 按页码跳页与方向键翻页
  • 整本缩略图浏览、滚动换高清
  • 原生 PDF 预览直接打开
  • /pdf 命令免模型直开
  • 本地渲染缓存,不上传内容

上游标签

dsh-plugin

验证等级与安全审查

未标注验证等级
自动化流程结论,不是人工审核
验证等级未标注验证等级上游未给出验证结论,安装前请自行确认
安全审查未标注静态分析结论,未标注不代表已通过审查
仓库健康度未标注按仓库活跃度与最近更新时间给出
可信度未标注综合仓库活跃度与验证结果

选择建议

装之前先看这几条
按条目字段给出的判断,不替你决定用不用

值得选的地方

  • 有可直接复制的安装命令,不用自己翻文档找入口。
  • 列出了 5 项功能,能直接看出它解决什么问题。

先想清楚的地方

  • 安全审查还没结论,装之前先看仓库改了什么、要什么权限。
  • 验证通过不等于安全:插件会读写文件、执行命令或联网,装前先到仓库确认它做了什么。

更适合

  • 需要在文档与办公场景里给 DSH 补能力的人。
  • 能接受在本地装依赖、愿意自己确认权限的人。

不太适合

  • 只使用 DSH 官方内置能力、不接受第三方插件的人。

同类对比

6 个同类
同分类里挑最接近的几条,字段以各自详情页为准
插件验证等级安全审查星标兼容版本安装命令
dsh-pdf-jump当前 未做沙盒验证 未标注 1 未标注 有
reactive-resume L3 · 安装规范通过 低风险 4.4 万 未标注 有
webnovel-writer L4 · 沙盒安装通过 低风险 7,742 未标注 有
baoyu-design L4 · 沙盒安装通过 低风险 6,403 未标注 有
answer-me-with-html L4 · 沙盒安装通过 低风险 4,782 未标注 有
Pagekin L4 · 沙盒安装通过 低风险 2,601 未标注 有

仓库档案

文档与办公
字段来自项目仓库与公开索引,中文说明由本站标注
作者 / 维护方taoziliyouchong仓库 dsh-pdf-jump · 默认分支 main
分类文档与办公docs
收录类型可安装插件声明了 dsh.bundle、可用 dsh plugin add 安装的条目
开发语言JavaScript仓库主语言
许可证MIT商用或二次分发前请确认条款原文
星标 / 复刻 / issue1 / 0 / 0收录时的数值,非实时
创建 / 更新2026-10-28 · 2026-11-07最后推送 2026-11-13
本站收录2026-11-05首次进入本站目录的时间

README 全文

6.7 KB
作者原文,中文版优先;只做安全转义,不改内容

dsh-pdf-jump

中文 | English

在 DSH 侧栏里看本地 PDF。一个包装两个独立工具,装一次两个都可用:

  • pdf-view(默认入口):本地把页面渲染成图——按页码跳、整本浏览;整本页先出缩略图、滚到哪页换高清,页顶还能输入页码直接跳。不依赖原生预览,任何 profile 都能用。
  • pdf-open:用 DSH 原生的 PDF 预览打开(客户端直接渲染,不生成图片、不起本地服务、有文字层);只在明确要「原生预览、不生成图片、最快」时用。它会自己调 sidebar_open;本会话没有 sidebar_open(提供它的第三方侧栏插件未装,或它的「模型打开侧栏」开关没开)时,自动回落到 pdf-view 的渲染查看器,返回可点的链接(opened=false)。

页码按 PDF 页序(1 = 文件第一页)。不从页脚推断印刷页码:手册常把全书页码和「章-页」编号混着用,猜出来的差值会把正文页整体错位。

按页码跳页:工具条里输入页码直接跳到那一页,方向键翻页。

整本浏览:缩略图先铺满,滚到哪页换高清;顶部也有页码框,输入即跳。

安装

dsh plugin --profile web add dsh-pdf-jump

还没发布到 npm 时,直接从 GitHub 装:

dsh plugin --profile web add github:taoziliyouchong/dsh-pdf-jump

然后重启 DSH。用别的 profile 就把 web 换成你的 profile 名。

装好后除了两个工具,还会注册一个 /pdf 命令:/pdf 繁易手册 300 直接出链接,不经过模型判断。

要求:DSH 带宿主 tools 与 systemPrompt 服务(普通基础组合都含),Node 22.19+ 或 24+。

要求 DSH >= 0.2.1-alpha.1。

用法

你说 用哪个工具
打开某本 PDF、跳到第 N 页、整本翻 pdf-view(默认;page = PDF 页序)
要原生预览(不生成图片、能选中文字) pdf-open
在整本里跳到某页 整本页顶部输入页码,或地址带 #p40
不让模型判断、直接开 /pdf <文件或片段> [页码]
提取文字 / 读元数据 另装 dsh-pdf 插件,用它的 pdf_info / pdf_extract_text

两个工具都接受绝对/相对路径或文件名片段(如 NB系列 安装手册);相对路径按会话工作目录解析。结果都会显示成一条可点的文档行,pdf-open 自己调 sidebar_open 用原生预览打开(没有它时回落到查看器链接),pdf-view 指向本地查看页。

机制

  • pdf-open 解析路径后直接调 sidebar_open(若本会话有)用原生预览打开;没有 sidebar_open 时自动回落到 pdf-view 的查看器链接。
  • pdf-view 的本地 HTTP 服务只绑 127.0.0.1,端口从 8731 往上试,复用别的 DSH 进程已起的服务;插件一加载就启动,整个 DSH 会话期间常驻(idleMinutes: 0),旧对话里的链接不用重新生成。
  • pdf-view 用 pdfjs-dist + @napi-rs/canvas 把页面渲成 PNG 缓存在系统临时目录;工具一调用先暖请求页和前后各 2 页,打开后以当前页为中心向两边各暖 6 页,已缓存的页直接读盘、不进渲染队列。页图与缩略图带 1 小时浏览器缓存,来回翻页不重复下载。
  • 渲染在子进程里做(lib/render-child.mjs,一页一进程):同一个宿主里若还有别的插件带不同版本的 pdf.js,后写的那份会把 globalThis.pdfjsWorker 换成自己的,同进程混合会报「API version … does not match Worker version …」。子进程有自己的 module graph 与全局,互不影响;代价是每页首次渲染多 0.3–0.8 秒。
  • 整本浏览先用 0.8 倍 JPEG 缩略图铺满(每页十几毫秒),滚到哪页再把那页换成全尺寸 PNG;每一页都有锚点(#p40),整本页顶部输入页码即滚到该页。
  • /pdf 命令固定走 pdf-view(单页跳转模式),不带页码时从第 1 页起;要原生预览就直接调 pdf-open,或说「原生预览打开」。
  • 查看地址是短路径(/v//<页>、/d/、/p//<页>.png、/t//<页>.jpg),不带查询串;id 通过系统临时目录里的小注册表映射到文件。配合「插件加载即启动、端口固定」,DSH 重启后旧对话里的链接也能重新打开。
  • 不上传任何内容。

配置

可选,写在 profile 的 patch 行里(只影响 pdf-view);字段与默认值:

字段 默认 含义
port 8731 起始端口;被占用或已有同款服务时自动向上找
scale 2 渲染倍率,2 约等于 144 dpi
idleMinutes 0 空闲多少分钟后关掉服务;0 表示整个 DSH 会话常驻
prefetch true 是否在后台暖当前页附近的页面
prefetchWindow 6 当前页两侧各暖多少页
roots [] 文件名片段搜索的额外根目录

环境变量 PDF_JUMP_ROOTS 也可以加搜索根,按平台的路径分隔符分隔(Windows 是 ;,其他是 :)。

限制

  • pdf-open 的原生预览依赖一个提供 sidebar_open 工具的侧栏插件(如 dsh-better-sidebar),且该功能默认关闭、需要在它的设置里打开「模型打开侧栏」。没有它时 pdf-open 自动回落到 pdf-view 的渲染查看器;只想看 PDF 的话不装任何第三方也能用。
  • pdf-view 的页面是图片:不能选文字,也不能全文搜索;要文字另装 dsh-pdf 插件,用它的 pdf_extract_text。
  • 渲染依赖 @napi-rs/canvas 的预编译二进制,覆盖 Windows / macOS / Linux 的 x64 与 arm64。

打不开时

  • 侧栏空白或提示「已阻止」:应用内侧栏浏览器默认拦截本机回环地址。把 127.0.0.1:8731(及 8732–8750 中实际用到的)加进侧栏设置的「允许访问的本机地址」,或把「设置 → 通用 → 网页链接默认打开方式」改成「默认浏览器」。
  • 旧对话里的链接提示「拒绝连接」:要么端口被别的程序占了导致换了端口,要么 PDF 文件被移动/删除。重新调用一次工具取新地址;pdf-open 返回的文件路径不受影响。

反馈

插件有问题,按这个顺序:

  1. 开 Issue:https://github.com/taoziliyouchong/dsh-pdf-jump/issues —— 能留痕、能搜历史,别人也可能已经遇过;
  2. 急着问或不想开 Issue,QQ 号:2171960697(加好友请注明装的是哪个插件)。

反馈时带上:DSH 版本、插件版本、报错原文、截图。少一样多半要再问一轮。

许可

MIT

常见问题

8 问
答案由本站依据条目字段整理,不引用上游原文
dsh-pdf-jump 怎么安装?

在 DSH 里执行 `dsh plugin --profile web add dsh-pdf-jump` 即可。对应的 npm 包名是 `dsh-pdf-jump`。

dsh-pdf-jump 的验证等级是什么意思?

未标注验证等级。上游未给出验证结论,安装前请自行确认

dsh-pdf-jump 安全吗?

未标注。

dsh-pdf-jump 装之前要先确认什么?

先看它会读写哪些文件、执行哪些命令、连接哪些网络地址;验证等级只说明装得上、跑得起来,不等于安全。涉及密钥或系统权限的,建议先在隔离环境试装。

dsh-pdf-jump 需要什么运行环境?

Node.js ^22.19.0 || >=24.0.0。环境不满足时安装会失败,建议先确认本机版本。

dsh-pdf-jump 用的是什么许可证?

上游标注为 MIT。商用或二次分发前请到仓库确认许可证原文。

dsh-pdf-jump 有哪些功能?

按页码跳页与方向键翻页、整本缩略图浏览、滚动换高清、原生 PDF 预览直接打开、/pdf 命令免模型直开、本地渲染缓存,不上传内容。

这条记录的数据可靠吗?

本站按仓库名去重后合并整理,字段以作者仓库与 npm 元数据为准;安装命令、仓库地址与 README 保持原文,带 L4 / L5 标记的安装命令已在隔离沙盒里真实跑通。

文档与办公
按星标排序,可作替代方案

webnovel-writer

webnovel-writer

基于 Claude Code 的长篇网文辅助创作系统,解决 AI 写作中的「遗忘」和「幻觉」问题,支持 200 万字量级 连载创作。

L4 · 沙盒安装通过 7,742 星

baoyu-design

baoyu-design

L4 · 沙盒安装通过 6,403 星

answer-me-with-html

answer-me-with-html

Answer me with HTML — an agent skill that answers hard questions with

L4 · 沙盒安装通过 4,782 星

Pagekin

Pagekin

Pagekin,免费 AI 小说写作软件,从设定、蓝图到正文、审稿、定稿;支持拆解仿写、续写、改写,可导入写作 Skill(如去 AI 味)

L4 · 沙盒安装通过 2,601 星

taoziliyouchong 的其它插件

6 个

插件的元信息来自作者仓库;分类、验证等级与安全结论的中文说明为中文整理,最近核验 —。