前言¶
在 DeepSeek Harness（DSH）裏查資料、對回覆時，正文往往還在外面的 PDF、EPUB 或 Markdown 裏。反覆切窗口複製，既打斷思路，也容易漏掉上下文。若能在客戶端右側欄直接打開常見文檔，劃詞後翻譯、解釋、總結或發到輸入框，閱讀與對話可以在同一界面完成。下面介紹的 Side Reader（包名 dsh-side-reader）就是面向這一需求的客戶端插件，由維護者 kaiqiangzhao 發佈在 SkillHub 目錄 與 GitHub。
插件定位¶
Side Reader 是 DSH 的右側欄閱讀插件：在側邊欄上傳並打開文件，選中文字後通過工具欄執行翻譯、解釋、總結、複製，或「發到輸入框」。文件解析與批註數據留在瀏覽器本地，插件說明中明確不寫上傳文件到服務端。插件類型爲 客戶端（platform: web，注入右側欄等 UI）；package.json 要求 DSH 引擎版本 >=0.2.1-rc.5，當前包版本爲 1.0.0，主許可證爲 MIT。
支持的格式與閱讀能力¶
通用¶
- 支持 PDF、EPUB、Markdown、TXT、XLSX、CSV（說明中還提到舊版
.xls能打開，但上傳框未列出該類型）。 - 上傳過的文件保存在瀏覽器本地，可從歷史列表重新打開。
PDF¶
- 縮放、適應寬度，文字可選。
- 劃詞後可四色高亮，或通過批註按鈕高亮並寫筆記；點擊高亮可改色、改筆記或刪除。
- 工具欄批註列表可跳轉到對應位置，並可導出帶批註的 PDF（標準 Highlight 批註，其他閱讀器可見）。
- 高亮與筆記隨本地文件記錄存在，刪除文件時一併清除。渲染與導出分別依賴包內所列的 PDF.js、pdf-lib 等組件。
EPUB¶
- 保留書籍樣式與圖片，提供目錄與字號調節。
Markdown¶
- 可渲染標題、表格、代碼高亮、任務列表、腳註等；眼睛圖標可切換爲帶
#的源碼視圖。 - 不支持數學公式與 Mermaid 圖（README 限制節寫明）。
表格類¶
- XLSX、CSV 通過 SheetJS CE 等在本機解析後展示（與 README 功能列表一致）。
劃詞工具欄與自定義¶
選中文字後彈出工具欄，默認提供：翻譯、解釋、總結、複製、發到輸入框。按鈕可新增、刪除、更換圖標、拖動排序，也可摺疊到下拉菜單。具體能力取決於你當前 DSH 對話與模型配置，插件側負責把選中內容送入對應動作或輸入框。
安裝與啓用¶
推薦在 DSH 桌面版 側邊欄打開 Plugins，在 Add plugin 中輸入包名 dsh-side-reader，安裝後啓用；無需命令行，也不必手動填寫 profile。
若使用命令行，--profile 爲必填，應填 你自己的 profile 名。桌面應用自帶的 dsh 命令才允許使用保留名 desktop：
dsh plugin --profile <你的 profile 名> add dsh-side-reader
也可按 DSH 打包與安裝文檔 從 GitHub 或 tarball 安裝；本插件 不需要構建步驟。
裝好後，在右側欄 Side Reader 入口上傳文件即可。Side Reader 不接管 *.pdf 的默認打開方式，只通過自身入口打開文件。
典型用法¶
- 在右側欄進入 Side Reader，從歷史或上傳框選擇 PDF / EPUB / Markdown 等文件。
- 閱讀時按需縮放、調節 EPUB 字號，或在 Markdown 渲染與源碼之間切換。
- 劃詞後點工具欄上的「解釋」「總結」或「發到輸入框」，把片段送入當前對話流程。
- 讀 PDF 需要留痕時，用高亮與批註，必要時從批註列表導出帶標註的 PDF。
限制與適用說明¶
README 中列出的限制包括：加密（DRM）EPUB、固定版式 EPUB 未測試；Markdown 不支持公式與 Mermaid；.xls 行爲見上文。
適用對象：經常在 DSH 裏對照長文檔、希望劃詞即用的開發者或重度用戶。
安全與權限：插件以當前 DSH 客戶端進程權限在本地 Web 環境中運行；安裝前可在 GitHub 查看源碼與各第三方組件許可證文件（如 LICENSE.pdfjs.txt 等）。社區目錄 SkillHub 爲獨立站點，與 DeepSeek / 幻方無官方從屬關係，安裝包名與版本以倉庫與目錄頁爲準。
結語¶
Side Reader 把 PDF、EPUB、Markdown 與表格類文件收進 DSH 右側欄，並在本地完成閱讀與劃詞操作，減少窗口切換。如需安裝說明與問題反饋，可訪問 SkillHub 插件頁 與 GitHub 倉庫。
