前言¶
在 DeepSeek Harness（DSH）裏查資料、改提示詞、讀文檔時，中英混排很常見。瀏覽器頁籤和獨立翻譯站點能出譯文，但例句、糾錯、跟進問答往往要再開一輪工具，上下文也容易斷。下面介紹社區插件 dsh-translate：把 DSH 側邊欄擴展成中英互譯工作臺，在同一塊面板裏完成流式翻譯、學習向附註、常駐 AI 助教、例句與糾錯，以及英文神經朗讀。
這是什麼¶
dsh-translate 是 DSH 的 sidebar 插件（倉庫 ChenYichener/dsh-translate，維護者 ChenYichener）。在 SkillHub 目錄 中歸類爲「聯網工具」。插件複用當前 profile 的默認模型，不單獨要求額外 API Key；朗讀可選依賴本機 Python 與網絡，核心翻譯能力隨 DSH 宿主與模型配置運行。
許可證爲 MIT；package.json 標註版本 0.1.0，運行需 Node.js >= 20。README 寫明在 DSH 0.2.1-rc.5 上做過驗證，外部插件 API 仍處於早期階段。
翻譯與交互¶
方向與流式輸出¶
支持 zh↔en，默認可 自動 判斷方向：CJK 佔比高走中→英，拉丁字符爲主走英→中；頁頭也可鎖定 中→英 或 英→中。
翻譯走流式輸出。README 說明調用時會關閉模型推理、使用緊湊提示；本地測試中首 token 約 0.3–0.8 s，常見句子約 1 s 內結束。源文框在面板打開時即獲焦點：Enter 發起翻譯（流式過程中再按 Enter 可中止），Shift+Enter 換行。單次最多 6000 字符，界面有實時計數。
歷史複用與學習模式¶
同一源文、同一方向、同一「學習深度」完全重複時，可直接複用歷史記錄（標記 已複用歷史），不產生新的模型調用；需要新譯文時用 重譯 / Retranslate。
可選 學習模式 / Study mode（默認關，開關會記憶）：在同一次翻譯結果上附加簡短教學說明（約 2–4 個有用表達及釋義、用法與搭配，必要時含語法點）。切換側邊欄面板時，草稿、當前結果與學習狀態仍在內存中保留，重啓應用後清空。
常駐 AI 助教¶
譯文旁有 IM 風格的聊天欄，提問時不遮擋譯文。可問語法、用法、搭配、更自然的說法或例句；回答流式輸出、可中止，並用輕量 Markdown 渲染（粗體、斜體、行內代碼、列表、標題、圍欄代碼塊），不執行 HTML。
每條問題最多 1000 字符，會自動帶上當前原文、譯文與學習附註；最多 12 輪已完成對話納入上下文。會話僅存於內存，不入歷史、不寫盤。
單次 Insight 附帶的學習塊¶
每次翻譯完成後，宿主再發起 一次 額外模型調用，一次性返回下列塊並寫入該條歷史；從歷史重放時這些塊不再調用模型。
| 塊 | 內容 |
|---|---|
| 常用例句 | 2–3 句，基於譯文中有用表達；英文句與中文釋義分行 |
| 猜你想問 | 2–3 條可能追問；一點擊即發給助教 |
| 原文糾錯 | 僅檢查你輸入的一側：中→英查中文；英→中查英文語法、時態、一致、複數、冠詞、介詞、所有格、語序、拼寫、大小寫與搭配等；每行 錯 → 建議、類別標籤與一行理由及正例 |
| 音標 | 2–4 個有用英文詞/短語及 IPA 與中文釋義 |
| 譯文優化 | 在確有改進空間時給出 1–2 條更自然、禮貌或準確的譯法及理由 |
糾錯要求模型引用的片段必須真實出現在你的原文中，否則丟棄，避免「對着譯文編造糾錯」。拼寫、語法、大小寫、搭配分塊返回。任意糾錯可一鍵變成「爲什麼 X 改成 Y？」類問題交給助教。
朗讀（TTS）¶
只讀 英文側：中→英讀英文譯文，英→中讀英文原文。默認 Microsoft Edge 神經音色 Aria（en-US），由宿主經插件私有 edge-tts 環境合成 MP3；內置 15 種在線音色（美/英/澳/加/愛/印等口音）。語速四檔：慢 / 稍慢 / 正常 / 快（100 / 140 / 165 / 190 wpm，默認 140）。
回落順序：Edge 神經音 → macOS 本地 say（含 Premium/Enhanced）→ 瀏覽器 speechSynthesis。Windows/Linux 若無 Python，插件保持瀏覽器語音而不失敗。音頻按提供方 + 文本 + 音色 + 語速緩存；譯文就緒後後臺預合成，點 朗讀 接近即時，再點可停止；改音色或語速會使緩存失效並重新預熱當前結果。
首次使用在線朗讀時，插件在 ~/.dsh/dsh-translate/tts-venv 創建私有 venv 並安裝 edge-tts 7.3.1（約 20–60 s、~20 MB），需 Python 3.9+ 與網絡，不修改系統 Python。
歷史記錄¶
完成的翻譯自動保存（原文、譯文、方向、學習附註、例句、猜問、糾錯、IPA、優化譯法等），按日分組、新者在前。可搜索原文/譯文/筆記、重新打開、單條刪除或兩步確認清空全部。中止或未完成的翻譯不保存。最多保留 500 條；宿主每天在歷史文件旁保留一份按日備份（保留 7 份）。
界面¶
顏色取自 DSH 主題 token，明暗模式可用；文案隨應用語言在中英文間切換。窄面板（≤ 880 px）時助教欄移到結果下方。輸入框無焦點光暈，按鈕保留鍵盤焦點環。安裝啓用後，側欄入口在番茄鍾項下方（順序 22；未裝 dsh-pomodoro 時緊挨上一項）。
安裝與啓用¶
官方推薦從 GitHub 安裝（將 <profile> 換成你的 profile 名）：
dsh plugin --profile <profile> add github:ChenYichener/dsh-translate
也可克隆倉庫後從本地路徑添加，或在 DSH 桌面應用 Plugins → Install from local directory 選中 dsh-translate 文件夾並啓用。安裝後重啓 dsh web 或刷新頁面。
依賴概覽：DSH 桌面或自託管 Web profile；Node >= 20；模型用當前 profile 默認模型；朗讀在線可選 Python 3.9+ 與網絡；macOS 本地 say 開箱可用；瀏覽器 speechSynthesis 零依賴回落。
典型用法¶
- 側欄點 翻譯 / Translate。
- 輸入或粘貼中文或英文；方向選 自動，或鎖定中→英 / 英→中。
- 按 Enter 或點翻譯；流式完成後查看例句、猜你想問、音標、糾錯與譯文優化。
- 在助教欄追問語法、用法或更自然的表達。
- 需要聽發音時點朗讀（僅英文側）；可在歷史裏搜索並復開舊記錄。
適用場景與注意¶
適合在 DSH 內做中英對照閱讀、提示詞潤色、短句學習與糾錯，又不想在多個標籤頁間來回粘帖的場景。插件與當前 dsh 進程同權限 運行，會調用 profile 已配置的模型；啓用在線 TTS 時會拉取依賴並在用戶目錄下建 venv。安裝前建議自行查看倉庫源碼與 MIT 許可證。社區目錄 SkillHub 爲獨立站點，與 DeepSeek / 幻方無官方從屬關係；DSH 生態理念是「一切皆插件」，本文介紹的是社區維護的聯網工具類插件之一。
結尾¶
dsh-translate 把翻譯、教學向 insight、側邊助教和英文朗讀收進 DSH 一側欄，歷史可搜可複用，適合日常在 Harness 裏處理中英文本時減少工具切換。詳情與更新以倉庫 README 爲準：
- 目錄頁：https://www.skillhub.cn/plugins/ChenYichener/dsh-translate
- GitHub：https://github.com/ChenYichener/dsh-translate
