前言¶

在 DeepSeek Harness 里对照长文档和模型对话时，常见做法是先把 PDF 丢进会话附件，或在外部阅读器里复制段落再粘贴到输入框，再手动写「请解读」「请翻译」之类的提示。附件会占用会话上下文，复制粘贴也容易打断阅读节奏。dsh-pdf-panel 是 inceCheng 维护的客户端插件：在 DSH 右侧栏提供独立 PDF 预览，拖入即看；选中文字后右键「解读」「翻译」，原文与默认提示词会直接进入左侧会话输入框，且拖入面板的 PDF 不会同时变成聊天附件。

这是什么¶

dsh-pdf-panel（npm 包名 dsh-pdf-panel）面向 DeepSeek Harness 0.2.x（engines.dsh 为 >=0.2.0 <0.3.0；README 记载在 0.2.2-rc.1 上实测，Web 版与桌面 App 均可）。分类为客户端插件：Host 侧 lib/index.js 仅导出空 apply()，不发起网络请求，PDF 在本机浏览器与 Web Worker 内解析，不上传、不离开本机。许可证为 MIT；当前 package 版本为 0.1.0。

核心功能¶

下面按 README 已说明的能力归纳，不超出文档表述。

入口与预览

• 会话标题栏右侧 PDF 图标，或右侧栏引导页「PDF 阅读」卡片。
• 从桌面、访达或任意目录把 .pdf 拖进面板即可渲染；也支持「选择 PDF 文件」。
• 基于 PDF.js：多页懒加载，适合宽度 / 缩放 / 实际大小、上下翻页、当前页码。

选文与右键

• 与画布对齐的文本层，支持拖选、跨页选择、⌘C 复制。
• 选中后右键「解读 / 翻译 / 复制」：
• 解读：引用原文 + 默认提示词「请解读以上我选中的内容：说明它的含义、背景和关键概念，并结合上下文指出我可能忽略的要点。」
• 翻译：引用原文 + 默认提示词「请把以上我选中的内容翻译成简体中文（若原文已是中文则翻译成英文），术语保持准确。」
• 内容以引用块形式写入左侧输入框，可直接发送或先改提示词。

其它

• 拖进 PDF 面板的文件只用于预览，不会同时变成聊天附件。
• 中英文界面、浅色 / 深色主题；主 bundle 约 13 KB，PDF.js 等在首次打开 PDF 时懒加载。
• 已知限制：每个右侧栏标签页同时只预览一个 PDF（再开一个会替换）；纯扫描件无文字层，无法选中。

安装与启用¶

要求 DeepSeek Harness 0.2.x。用户侧安装插件无需 Node.js；下列命令来自仓库 README。

npm 安装（推荐）¶

dsh plugin --profile web add dsh-pdf-panel

桌面 App：左侧栏 插件 → 添加插件 → 输入 dsh-pdf-panel → 安装 → 立即启用，然后刷新页面（桌面端 ⌘R）。

源码安装（仓库已提交 lib/ 构建产物）¶

dsh plugin --profile web add github:inceCheng/dsh-pdf-panel

无需本地构建、无需 Node.js。

本地目录（开发调试）¶

dsh plugin --profile web add /path/to/dsh-pdf-panel

桌面端的 desktop profile 由 Electron App 独占管理；CLI 会提示 profile "desktop" is managed exclusively by the Electron application。需在 App 内「插件 → 添加插件」（包名、Git 地址、tarball 或本地目录），或按 README「本地安装进桌面 profile」用 App 自带运行时链接目录并在 dsh.profile.bundles 中追加 dsh-pdf-panel。

典型用法¶

1. 打开任意会话，点标题栏右侧 PDF 图标，或右侧栏「PDF 阅读」卡片。
2. 把 PDF 拖进右侧面板，或点「选择 PDF 文件」。
3. 在 PDF 内拖选段落 → 右键 → 解读 / 翻译 / 复制。
4. 左侧输入框出现引用原文与默认提示词；确认后发送，或先编辑提示词。

若要改默认提示词，README 指向 src/client/locales.ts 中的 explainInstruction / translateInstruction，修改后执行 npm run build 并刷新页面（属于自行从源码构建的场景）。

适用场景与注意¶

适合谁

• 需要在 DSH 内边读 PDF 边问模型、又不想让每份 PDF 都占会话附件的开发者或研究者。
• 希望选中段落后一键带上结构化提示词，减少复制粘贴的用户。

运行与权限

• 插件以当前 DSH 进程（浏览器/Electron 客户端）权限运行；安装前宜浏览 GitHub 仓库 源码与 MIT 许可证。构建产物内嵌 PDF.js（Apache-2.0），见仓库 THIRD_PARTY_NOTICES.md。
• 客户端注入 DSH 的 sidebar、context-menu、locale 等 UI 槽位；不依赖外部 PDF 服务。

生态说明

DSH 采用「一切皆插件」思路；社区目录站点与 DeepSeek / 幻方无官方从属关系，本文仅从公开 README 与 package 元数据整理事实。

结尾¶

dsh-pdf-panel 把 PDF 阅读收进右侧栏，把「选段 → 解读/翻译 → 进输入框」收成右键几步，并保持预览文件与会话附件分离。目录页与源码：

• SkillHub 插件页：https://www.skillhub.cn/plugins/inceCheng/dsh-pdf-panel
• GitHub：https://github.com/inceCheng/dsh-pdf-panel