dsh-bilingual-reader：DeepSeek Harness 側欄的 PDF 劃詞翻譯插件

DeepSeek Harness (DSH) 的核心理念是「一切皆插件」。dsh-better-sidebar 作爲側欄擴展機制，允許開發者注入自定義功能。在閱讀論文 PDF 時，如果將選中的術語直接複製到主對話去翻譯，會污染上下文，且頻繁切換窗口效率較低。dsh-bilingual-reader 解決了這個問題，它是在 dsh-better-sidebar 中直接對 PDF 進行原生渲染，並利用大模型進行劃詞翻譯的插件。

插件定位¶

這是一個運行在 DeepSeek Harness 環境下的側欄插件，由開發者 Johnblur 維護。它主要解決在閱讀長篇論文時，需要快速、精準地獲取特定段落或術語翻譯，同時保持主對話上下文乾淨的需求。插件複用 DSH 現有的模型配置，翻譯過程完全隔離於主對話之外。

核心功能¶

PDF 原生渲染：利用瀏覽器或 Electron 的 PDF 引擎顯示文檔，保持排版完美，支持翻頁與文本選擇。
劃詞翻譯：選中文字並複製，桌面版可自動觸發翻譯；若自動翻譯不可用，可通過點擊「翻譯」按鈕或按 Ctrl+V 觸發。
多語種互譯：支持中文、英語、日語、韓語之間的互譯，也支持手動添加任意語言。
語種自動識別：源語言選擇「自動識別」時，優先使用字符集啓發式判斷（對中、日、韓語識別準確率高），不確定時再交由大模型識別。
上下文感知：在全文中定位選中內容的唯一位置，提取周邊文字作爲上下文進行翻譯，確保翻譯準確。
上下文長度可調：通過滑塊控制提取上下文的長度。
設置持久化：源語言、目標語言、上下文長度及自定義語言設置會被保存，下次打開自動加載。
原文 + 譯文對照：界面下方同時展示原文與譯文，支持一鍵複製譯文。
隔離主對話：翻譯調用通過獨立的 ctx.llm 進行，結果不寫回主會話，不消耗主對話 Token。

安裝與啓用¶

安裝該插件需要 DSH 環境已就緒。執行以下命令即可安裝：

dsh plugin add github:Johnblur/dsh-bilingual-reader

安裝完成後，需要徹底退出托盤中的 DSH Desktop 應用並重新打開，以確保插件生效。

使用步驟¶

打開 dsh-better-sidebar 側欄，點擊 + 號添加標籤。
在新標籤中找到「雙語閱讀」或「翻譯」選項（取決於界面語言），點擊進入。
點擊「瀏覽…」按鈕選擇工作區中的 PDF 文件，或直接輸入路徑點擊「加載」。
在 PDF 閱讀器中選中一段文字並複製（桌面版支持自動監聽剪貼板翻譯）。
下方會顯示原文與譯文。你可以通過下拉框選擇互譯語言，拖動「上下文」滑塊調整取詞範圍，或通過「領域」選項指定或讓插件自動識別。

依賴與版本要求¶

該插件的運行依賴 DSH 運行時注入的特定服務，且對 DSH 版本有明確要求：

依賴項：dsh-better-sidebar、@deepseek-ai/dsh-llm、pdfjs-dist。
DSH 版本適配：
- @deepseek-ai/dsh-llm 必須大於等於 0.1.2-rc.1。
- dsh-better-sidebar 必須大於等於 0.17.1。
- 若安裝後提示 does not provide an export named 'deepFreeze'，需升級 dsh-llm 到 v1.0.2 或以上。
DSH Desktop 兼容性：
- 在 DSH Desktop 2.0.9+ 版本中，electron.clipboard 因運行在 utilityProcess 中不再可用。
- 此版本下必須升級插件到 v1.1.1+ 才能正常工作。
配置覆蓋：插件複用 DSH 現有的模型與 API Key，無需額外配置。也可通過環境變量覆蓋：
- DSH_BILINGUAL_PROVIDER（默認 deepseek-official）
- DSH_BILINGUAL_MODEL（默認 deepseek-v4-flash-vision-exp）
Web 端限制：「自動翻譯」功能依賴主機讀取系統剪貼板，在純 Web 端可能不可用。此時請使用「翻譯」按鈕或按 Ctrl+V。

結語¶

dsh-bilingual-reader 爲 DeepSeek Harness 的用戶提供了一個輕量級的論文閱讀輔助工具。它通過隔離翻譯上下文，使得在閱讀長文時能保持主對話的整潔與專注。對於需要頻繁查閱雙語文獻的開發者或研究人員，該插件能有效提升閱讀效率。

插件目錄：dsh-bilingual-reader
源碼倉庫：GitHub