前言¶
DeepSeek Harness（DSH）通過插件擴展能力，其中模型推理類插件負責調用底層模型服務。在 DSH 中直接發起翻譯時，通常會依賴語言檢測、固定語言參數或 Agent 工具，難以精確控制提示詞。對於需要中英文翻譯、流式輸出與本地歸檔的場景，一個輕量、可控的翻譯頁面是剛需。
插件介紹¶
wanyi424/dsh-quick-translate 是一個爲 DSH 提供的翻譯插件，將獨立的中英文翻譯頁面集成到左側菜單。它不依賴語言檢測服務、不使用 Agent 或會話交互，而是直接複用 DSH 已配置的模型，將翻譯行爲完全交給提示詞決定。維護者爲 Wanyi424，分類爲模型推理。
核心功能¶
- 使用 DSH 已配置模型進行翻譯，無額外 API Key
- 流式輸出：譯文逐段出現，按鈕在翻譯期間變爲「停止」，保留已輸出部分
- 提示詞管理：默認提示詞保存在插件內，支持切換到自定義並保存到本地文件
- 本地歷史記錄：按天分組，每條顯示原文與譯文首行，支持查看詳情與右鍵操作
- 目錄遷移：從舊目錄自動遷移到新的
plugin-data/dsh-translate/history - 性能優化：頁面按需加載、增量推送、無 Markdown 全文重渲染
安裝與啓用¶
在 DSH 左側「插件」頁面選擇「添加插件」，添加壓縮包：
dist/dsh-translate-0.2.6.tgz
按安裝頁面提示啓用或重啓後，左側菜單出現「翻譯」。無需修改 DSH 配置文件，也不需要另填 API Key。此項目不會自動安裝到用戶的 DSH profile，也不會修改筆記插件或已有筆記。
典型用法¶
- 在原文欄底部的模型標籤中選擇 DSH 已配置的模型。剛在 DSH 設置裏修改過模型時，展開菜單點擊「刷新模型列表」。
- 輸入或粘貼原文，點擊「翻譯」或按
Ctrl + Enter。翻譯期間按鈕變爲「停止」，停止後保留已輸出的部分。 - 譯文欄依次顯示「正在連接模型 → 模型思考中 → 正在翻譯」，文字隨光標逐段出現，完成後顯示耗時。點擊「複製」得到保留原文格式的譯文。
- 譯文欄底部顯示本次的輸入 / 輸出 token（輸入包含緩存命中部分）。點擊它打開「翻譯詳情」：緩存命中、總耗時與首字時間、「等待響應 → 思考 → 輸出譯文」的耗時分佈、輸出速度、模型標識、結果與錯誤代碼、當次提示詞快照；「複製診斷信息」得到一段純文本，便於排查或反饋。
- 用量來自模型在流式結束時返回的數據。手動停止、連接中斷或舊版本的記錄通常沒有用量，會顯示「無用量數據」。 - 修改原文後，上一次的譯文會變淡並提示「原文已修改」，避免誤複製舊結果。點擊原文欄右上角的「×」清空，開始新的翻譯。
- 切換到 DSH 的其他頁面時，翻譯在後臺繼續；返回後恢復進度。
- 歷史記錄按「今天 / 昨天 / 近 7 天 / 月份」分組，每條顯示原文和譯文的首行，滾動到底部自動加載更多。
- 點擊一條記錄進入只讀查看。頂部顯示「返回」，也可按Esc回到當前翻譯；「用此原文重譯」把原文放回工作臺。
- 右鍵一條記錄，可以複製譯文、用原文重譯、查看翻譯詳情或刪除。
- 頂部「…」可打開這條記錄的「翻譯詳情」，或刪除這條記錄。
- 歷史記錄欄收起時，頂部左側顯示帶記錄數的「歷史記錄」按鈕，新記錄產生時數字會輕微跳動；譯文欄底部的「已保存到歷史」也可以直接打開歷史記錄。 - 窗口較窄時，歷史記錄變爲從左側滑出的抽屜，點空白處滑回；寬屏下收起和展開歷史欄時欄寬平滑過渡。更窄時，原文和譯文上下排列。菜單、設置面板和對話框關閉時也有退場動畫。
提示詞與歷史記錄¶
默認提示詞保存在 prompts/default.md，爲普通文本，不插入語言參數或模板變量。模型請求只包含當次提示詞和待翻譯原文，不帶其他翻譯歷史或 DSH 對話。
在「設置 → 提示詞」中切換「默認 / 自定義」：默認提示詞只讀顯示；選擇「自定義」後編輯並點擊「保存」，會自動生成或更新獨立的 Markdown 文件：
%USERPROFILE%\.dsh\plugin-data\dsh-translate\prompts\custom.md
切回「默認」立即生效，不改寫也不刪除 custom.md；再次選擇「自定義」即恢復已保存的版本。未保存的修改在關閉設置面板後仍會保留，直到你保存或放棄。修改只用於之後發起的翻譯，正在運行的任務和歷史記錄繼續使用各自的提示詞快照。改變模型不會改寫提示詞文件。
設置文件只保存當前使用默認還是自定義，不存儲提示詞正文；歷史記錄保留當次提示詞正文用於回看。當前仍在開發階段，本版本不讀取或遷移舊的 .dsh-quick-translate 和 Documents/DSH Translations 數據，已移除舊版提示詞兼容邏輯。
所有工作區共用一套翻譯歷史，默認在：
%USERPROFILE%\.dsh\plugin-data\dsh-translate\history
若存在舊版本 plugin-data/dsh-quick-translate 會自動無縫平滑遷移；文件仍保持普通 JSON / Markdown 格式。每次翻譯單獨保存爲 UTF-8 JSON 文件，包含原文、譯文、時間、模型提供方、模型名稱、當次提示詞、狀態和錯誤信息，以及模型返回的 token 用量、首字與首段譯文時間、提供方錯誤代碼。舊記錄沒有這些字段，照常可讀。
適用場景與注意¶
適合需要中英文翻譯、流式輸出與本地歸檔的 DSH 用戶。插件以當前 DSH 進程權限運行，安裝前應檢查源碼與許可證。使用 DSH 現有模型服務會佔用所選模型的額度或產生其正常費用；插件不會發起後臺自動翻譯或自動重試整篇翻譯。宿主自身的模型重試策略仍然適用。
小結¶
這個插件通過複用 DSH 的模型與提示詞機制，提供了一個可控、輕量的翻譯頁面，兼顧流式輸出與本地歷史歸檔。在需要精確提示詞與本地歸檔的場景下，可以作爲補充工具使用。
外部鏈接¶
- 插件目錄頁：https://www.skillhub.cn/plugins/Wanyi424/dsh-quick-translate
- GitHub 倉庫：https://github.com/Wanyi424/dsh-quick-translate
