前言¶
DeepSeek Harness（DSH）常作爲桌面宿主長期運行，模型和 API 已在宿主裏配好。若只爲「選中一段文字 → 翻譯 / 解釋 / 總結」再單獨裝一套帶劃詞能力的聊天客戶端，會多佔一套進程和界面，模型配置也要維護兩份。
下面介紹社區插件 dsh-selection-assistant（倉庫 bjcdeshu/dsh-selection-assistant）：在 Windows 10/11 上提供全局劃詞工具條與快捷翻譯窗口，取詞基礎複用 Cherry Studio 同款的 MIT selection-hook，模型調用走 DSH 已配置的 LLM，不另起完整 Agent 會話。維護者爲 bjcdeshu，分類爲客戶端插件，MIT 開源。當前 README 標明爲開發預覽版，兼容 DSH Desktop 0.2.x（自 0.2.0-rc.2 起，含 0.2.1-rc.2）；跨到 0.3 需重新驗證。package.json 版本爲 0.1.1。
這是什麼¶
DSH Selection Assistant 是 DSH 的 Windows 劃詞助手插件：選中文字後彈出原生工具條，可執行翻譯、解釋、總結；另有可輸入或粘貼 OCR 文字的快捷翻譯窗口。界面、提示詞與 DSH 集成由本倉庫獨立實現，不復制 Cherry 應用源碼或長提示詞，也不宣稱 Cherry / DeepSeek 官方出品。
設計要點：選中文字只彈工具條，點擊動作後才調用模型；通過 ctx.llm.stream 使用 DSH 已配置模型，不復制 API Key，不啓動完整 Agent，不開放文件/命令工具，不批量創建「未分組」會話。
核心功能¶
劃詞工具條與結果窗¶
- 三種模型操作：翻譯、解釋、總結；單次請求無歷史。
- 語言：英文默認譯中文、明顯中文默認譯英文；解釋/總結默認中文，也可固定輸出語言；支持 96 種目標語言（可按中文、英文或本地名稱搜索）及自定義語言。
- 可自定義三類提示詞，支持佔位符
{{targetLanguage}}；可爲每類操作指定獨立模型，或跟隨 DSH 全局默認模型（不跟隨當前打開的會話）。 - 非激活時工具條儘量不搶原窗口焦點；結果窗可選中、複製、停止、置頂、拖動與縮放；支持輕量 Markdown 展示，不執行 HTML、不自動打開鏈接。
快捷翻譯¶
Ctrl+Alt+T或雙擊托盤圖標打開；支持輸入、粘貼、清空、選目標語言、複製、停止、重試，Ctrl+Enter觸發翻譯。- 打開、粘貼、改語言均不自動發請求；關閉後本次進程內保留內容，清空或退出後釋放，不寫入歷史文件。剪貼板僅有圖片時會提示先 OCR（首版不含 OCR 能力）。
監聽、熱鍵與托盤¶
- 首次加載處於暫停；須在設置中勾選「啓用全局劃詞監聽」後纔開始監聽。
- 托盤可暫停全局劃詞；
Ctrl+Alt+D可手動取詞。 - 浮條默認在鼠標鬆開點左下方，靠屏幕邊緣自動避讓；支持系統、淺色、深色主題，窗口透明度與尺寸分別持久化。
架構與資源¶
DSH Host 插件 Node 取詞伴生進程 C# WPF 原生界面
模型/設置/取消 ← stdio → selection-hook 2.1.1 ← stdio → 工具條/結果/設置/托盤
相對「再開一個 Chromium 劃詞客戶端」，本插件增加兩個輔助進程，不增加 Chromium/WebView2 進程；取詞 native addon 不裝入 DSH 主宿主。WPF 使用系統 .NET Framework 4.8，首次加載由系統 C# 編譯器從倉庫源碼構建並緩存到插件數據目錄，不下載編譯器、不要求管理員。
隱私邊界：無公開 HTTP 端口、無網頁腳本橋、無遙測、無原文/結果歷史文件；剪貼板兜底默認關閉，密碼管理器與終端默認排除。選區可能含敏感信息，不需要時應暫停，勿把敏感選區提交雲模型。
安裝與啓用¶
安裝前請確認 DSH Desktop 版本在 0.2.x 兼容範圍內，並已配置可用模型。
優先在 DSH 界面 插件 → 添加插件，輸入：
github:bjcdeshu/dsh-selection-assistant
若你的實例確實使用 desktop profile，也可用 CLI（profile 名以你當前實例爲準，勿盲目改其他 profile）：
dsh plugin --profile desktop add github:bjcdeshu/dsh-selection-assistant
倉庫無需 JavaScript 構建步驟；依賴 selection-hook 含 Windows 預編譯 native 包，包管理器可能詢問是否允許 node-gyp-build 安裝腳本，請先審閱再授權，不要授權無關生命週期腳本。
宿主提示需要重啓時，請先保存任務再重啓；本插件不會自行重啓 DSH。
首次加載會出現托盤圖標，右鍵打開設置，建議按下面順序操作：
- 確認 DSH 已配置可用模型。
- 閱讀隱私說明，勾選「啓用全局劃詞監聽」，保存。
- 在普通文本應用或瀏覽器中選中文字，點擊翻譯、解釋或總結。
- 取不到詞時先試
Ctrl+Alt+D；僅對必須模擬複製的應用再顯式開啓剪貼板兜底。
典型用法¶
日常劃詞：在記事本、瀏覽器或文檔中選中一段文字 → 在工具條點「翻譯」「解釋」或「總結」→ 在結果窗查看流式輸出，必要時停止或複製。
手動取詞：自動監聽未命中時按 Ctrl+Alt+D。
長段或 OCR 文本：按 Ctrl+Alt+D 或雙擊托盤打開快捷翻譯，粘貼內容，選目標語言後 Ctrl+Enter 翻譯。
暫時不用劃詞：托盤 → 暫停全局劃詞（hook 與取詞熱鍵停止，快捷翻譯仍可用）。
停用、卸載與數據位置¶
- 完全停止：在當前 DSH 插件頁關閉或卸載；卸載會清理自有進程。
- 設置保存在
$DSH_HOME/plugin-data/dsh-selection-assistant/settings.json（未定義DSH_HOME時爲用戶目錄下.dsh同路徑）；含偏好與自定義提示詞，不含模型密鑰、選區或結果。 - 窗口寬高與不透明度在同級
window-state.json；原生編譯緩存在native-cache。清除數據前應先停用插件，再刪除該插件數據目錄，勿刪整個 DSH 數據目錄。
適用場景與注意¶
適合：已在 Windows 上長期使用 DSH Desktop 0.2.x、希望劃詞翻譯/解釋/總結複用同一套模型與計費策略的開發者或寫作者。
注意：
- 插件以當前 DSH 進程權限運行；安裝前建議閱讀 GitHub 倉庫 源碼與 MIT 許可證及
THIRD_PARTY_NOTICES.md。 - 提權應用、部分 PDF/canvas/特殊編輯器可能無法取詞；自動化測試不等於所有應用兼容，詳見倉庫
docs/VERIFICATION.md。 - 首版不包含 OCR、原文替換、翻譯歷史、自動聯網搜索或自動執行工具；翻譯質量取決於所選模型。
DSH 生態強調「一切皆插件」；SkillHub 目錄頁 爲社區收錄，與 DeepSeek / 幻方無官方從屬關係。
結尾¶
若你希望常開的 DSH 順便承擔 Windows 全局劃詞，而不爲多這一個功能再留一整套客戶端，可以在確認版本兼容後安裝 dsh-selection-assistant，在設置裏顯式啓用監聽，再按場景使用工具條或快捷翻譯。
- 目錄頁：https://www.skillhub.cn/plugins/bjcdeshu/dsh-selection-assistant
- GitHub：https://github.com/bjcdeshu/dsh-selection-assistant
- 問題反饋：https://github.com/bjcdeshu/dsh-selection-assistant/issues（請勿上傳 API Key、私人選區或完整本機配置）
