前言¶
在 DeepSeek Harness（DSH）裏讀英文文檔、對照外文界面時，常見做法是複製到翻譯工具裏再看結果，或者截圖後另開窗口對照。譯文和原文分離，截圖翻譯也很難把排版和引用樣式留在原位。dsh-translate-pin 是社區插件，面向 Windows 上的 DSH 用戶：在會話裏劃詞出譯文卡片，在桌面任意區域框選後由 DeepSeek 讀圖翻譯，並把中文按段落回填到原區域；劃詞結果還可以釘在桌面做置頂對照。下面按安裝、用法和注意點說明。
這是什麼¶
- 名稱：
dsh-translate-pin（bundle id：translate-pin） - 維護者：zhaopw5
- 分類：聯網工具（社區目錄 SkillHub 插件頁）
- 倉庫：github.com/zhaopw5/dsh-translate-pin，許可證 MIT；
package.json版本 0.8.4 - 平臺：僅 Windows（OCR 依賴
Windows.Media.Ocr，浮標與全局快捷鍵依賴 Win32）
插件在 DSH 內提供劃詞翻譯；同時拉起桌面助手（pinwin.py），負責全局劃詞、截圖框選、原地譯文窗和桌面浮標。翻譯優先走 DSH 已配置的 DeepSeek（支持圖片輸入的模型直接讀圖）；不可用時回退 Bing / Google / MyMemory，並結合 Windows OCR。
核心功能¶
劃詞翻譯（DSH 頁面內）¶
在對話或文章內容裏選中外文（輸入框、contenteditable 內不觸發），鬆手後選區旁出現「譯」，點擊後顯示源語言 → 簡體中文、譯文與服務商。卡片支持複製、查看原文、釘在桌面。純中文選區會自動跳過。快捷鍵：Ctrl+Shift+T。
全局劃詞（瀏覽器、PDF、Word 等）¶
在 DSH 外的任意應用中拖動選中文字（拖動超過約 6px），鬆手後光標旁出現「譯」。也可用 Ctrl+Shift+T。原理是模擬 Ctrl+C 讀剪貼板並在讀後恢復；部分終端、遊戲等不支持 Ctrl+C 的場景無法取詞。
截圖翻譯（譯文貼回原區域）¶
通過右下角「截圖翻譯」、桌面「譯」浮標，或全局 Ctrl+Shift+S（DSH 最小化仍可用）進入框選。確認「✓ 翻譯」後：OCR 分行並按行距/縮進/字號分段，DeepSeek 整段翻譯，再合成圖把每段中文排回對應矩形，儘量保留引用框底色、左側豎線與文字主色。靜止時譯文區外有灰色漸變邊框；鼠標移入顯示圖釘、複製、原文等工具條。支持拖動譯文框，雙擊切換譯文/原文。
表格模式¶
框選整張表格時，按單元格翻譯，保留表格線、列寬與數字，只替換文字單元格。複雜合併單元格或 OCR 並列失敗時會退回段落模式。
問 AI（截圖對話）¶
框選後點「✨ 問 AI」，在獨立窗口裏帶截圖預覽與對話；問題發給 DSH 配置的 DeepSeek，可連續追問。截圖只發給該模型，不上傳其他服務（每次提問消耗圖片與文本 token）。
桌面浮標與釘在桌面¶
屏幕右側常駐圓形「譯 · 截圖」浮標，單擊開始框選。劃詞卡片的「釘在桌面」生成始終置頂、可拖動、可複製的對照小窗。
環境要求¶
| 依賴 | 說明 |
|---|---|
| Windows 10 / 11 | OCR、置頂窗（tkinter） |
| DeepSeek Harness | 桌面端或 dsh web（需 Connection / WebServer） |
| Python 3.10+（tkinter、Pillow） | DSH 桌面端自帶運行時時可不再單獨安裝 |
| Windows PowerShell 5.1 | 系統自帶 |
| RapidOCR（可選） | python -m pip install rapidocr_onnxruntime，未裝則回退 Windows OCR |
| 中文 OCR 語言包 | Windows 設置 → 語言 → 中文(簡體) 的「光學字符識別」可選功能 |
插件啓動時會自動查找 $DSH_HOME/dsh-runtimes/*/dependencies/python/pythonw.exe 等路徑，也可用環境變量 DSH_TRANSLATE_PYTHON 指定 Python。
安裝與啓用¶
DSH 生態裏插件通過 profile 的 bundle 加載；社區目錄 SkillHub 與 DeepSeek / 幻方無官方從屬關係，安裝前建議查看倉庫源碼與 MIT 許可證。插件以當前 DSH 進程權限運行，涉及剪貼板、截圖與聯網翻譯，請自行評估環境是否合適。
從 GitHub 安裝（推薦）¶
在 DSH「插件」頁選擇「從 GitHub 安裝」，填寫：
github:zhaopw5/dsh-translate-pin
或在允許 dsh plugin 管理的 profile 中執行：
dsh plugin --profile <profile> add github:zhaopw5/dsh-translate-pin
安裝後 cordis.patch.yml 會自動插入 translate-pin。桌面端若 dsh plugin 被拒，應優先用應用內「插件」頁安裝。
裝完重啓客戶端¶
客戶端插件模塊清單在啓動時注入，需完全退出 DeepSeek Harness 再打開。驗證：
- 任意會話右下角出現「截圖翻譯」；
- 選中外文後選區旁出現「譯」；
- 控制台無
dsh-translate-pin報錯。
配置¶
bundle 安裝後，在 profile patch 裏按 id 覆蓋配置（勿重複 insert）：
- id: translate-pin
config:
targetLanguage: zh-Hans # 默認簡體中文；可填 en / ja / zh-Hant ...
| 字段 | 默認 | 說明 |
|---|---|---|
targetLanguage |
zh-Hans |
目標語言碼（DeepSeek 與 Bing/Google 回退共用） |
修改後已打開頁面需刷新；host 行可隨 HMR 重載。
典型用法速覽¶
劃詞：頁面內選中外文 → 點「譯」→ 可選「釘在桌面」。
全局劃詞：其他應用裏拖動選詞 → 點「譯」或 Ctrl+Shift+T。
截圖：Ctrl+Shift+S 或浮標 → 拖拽框選 → 「✓ 翻譯」→ 在原區域查看回填譯文；需要對話時點「✨ 問 AI」。
表格：框選含表線的整表，等待按格翻譯。
排查時可查看日誌：%USERPROFILE%\.dsh\translate-pin\host.log。
適用場景與限制¶
適合：Windows 上長期使用 DSH、需要外文網頁/文檔/截圖快速中文化且希望譯文落在原位的用戶；已配置 DeepSeek 且模型支持讀圖時，截圖翻譯質量更穩。
需注意：
- 僅 Windows；DSH 完全退出後桌面浮標與快捷鍵一併退出（子進程隨宿主結束）。
- 樣式還原爲啓發式，一行內多種顏色/字號時只取佔比最大樣式。
- 全局劃詞與部分應用剪貼板限制；
Ctrl+Shift+S若被佔用，日誌會有RegisterHotKey ... failed，可改用浮標或頁面按鈕。 - OCR 主要負責版面；正文翻譯以 DeepSeek 讀圖爲主，模型不可用時精度會下降。
- 卸載：插件頁卸載或
dsh plugin --profile <profile> remove dsh-translate-pin，重啓客戶端；可選刪除%USERPROFILE%\.dsh\translate-pin日誌目錄。
結尾¶
dsh-translate-pin 把 DSH 會話劃詞、系統級選詞和「框選 → DeepSeek 讀圖 → 原位回填」串成一條鏈路，並支持桌面釘住對照。需要安裝與細節時，以倉庫 README 爲準：
