前言¶
在 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。
典型用法¶
- 打開任意會話，點標題欄右側 PDF 圖標，或右側欄「PDF 閱讀」卡片。
- 把 PDF 拖進右側面板，或點「選擇 PDF 文件」。
- 在 PDF 內拖選段落 → 右鍵 → 解讀 / 翻譯 / 複製。
- 左側輸入框出現引用原文與默認提示詞；確認後發送，或先編輯提示詞。
若要改默認提示詞，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
