前言¶
DeepSeek Harness 裏若同時啓用官方「思考過程機器翻譯」組合包和 dsh-better-display 的閱讀頁，常見現象是：主對話區能看到譯文，切到「閱讀」頁籤後思考塊仍是原文。原因不在翻譯服務本身，而是官方組合包把譯文掛在 conversation.chat.reasoning.body 插槽上，而閱讀頁用自有組件渲染思考，該插槽在閱讀視圖裏不會被繪製。下面介紹社區插件 dsh-cot-translation-reader（維護者 LingMoe404），它把同一套官方翻譯接到閱讀頁的 dsh-better-display.text-transform 縫上，屬於 DSH 生態裏的「聯網工具」類插件。
這是什麼¶
dsh-cot-translation-reader 當前 npm 版本爲 0.1.7（MIT 許可）。一句話：在 dsh-better-display 的「閱讀」頁籤裏顯示 DeepSeek Harness 官方「思考過程機器翻譯」的譯文。它不實現新的翻譯後端，而是複用 @deepseek-ai/dsh-experimental-cot-translation-bundle 提供的 cotTranslation 服務與面板裏的翻譯設置（翻譯服務、目標語言）。
依賴與生效條件¶
兩個依賴缺任意一個時，插件安靜地不生效：不報錯、不改界面。
| 組件 | 作用 |
|---|---|
dsh-better-display ≥ 0.3.9 |
提供 dsh-better-display.text-transform 縫 |
@deepseek-ai/dsh-experimental-cot-translation-bundle |
提供 cotTranslation 服務與翻譯設置 |
翻譯服務與目標語言仍在官方組合包的插件面板裏配置；本插件只負責閱讀頁展示適配。
核心功能¶
自動翻譯與語言選擇¶
進入閱讀頁後會自動請求譯文，無需額外點擊。目標語言優先使用官方面板裏手動指定的值；設爲 auto 時讀取當前界面語言，再回退到文檔或瀏覽器語言，不會把請求頭裏的 * 當作目標語言。
單卡片「查看原文 / 查看譯文」¶
在 better-display 爲思考文本節點提供穩定塊標識 data-reader-reasoning-block-key 時，每張思考卡片右上角會出現 查看原文 / 查看譯文 按鈕，只切換所點擊的卡片，不影響其他卡片；相同文本也按獨立標識區分，緩存仍在時不會重新請求。配套改動見 dsh-better-display PR #82。該補丁尚未合併發佈，npm 上的 better-display 0.3.9 不包含此標識：仍可自動翻譯，但不會顯示單卡片按鈕，也不會通過文本或順序猜測對應卡片。
只改顯示、流式與失敗行爲¶
會話記錄、摺疊、複製回答拿到的都是原文。流式生成中的最後一段保持原文，只翻譯已經完成的段落。翻譯失敗時保留原文、自動重試最多 3 次，並在控制台 warn，不會打斷閱讀。
請求與緩存¶
譯文按段落串行請求，避免觸發提供商限流；單次長度遵守 Host 返回的 maxTextChars。已緩存的片段不會重複請求。緩存最多保留 512 條卡片；滿額時只回收至少五分鐘未讀取的條目。沒有可回收條目時，新卡片繼續顯示原文且不發送額外翻譯請求；閒置緩存被回收後，再次閱讀可能重新請求。
生命週期¶
按鈕只在啓動時掃描一次文檔，之後按相關 DOM 變化增量維護，不在每次流式更新時重掃整頁。關閉插件或卸載時中止進行中的請求並清理重試定時器。
安裝與啓用¶
在 profile 所在目錄用包管理器安裝（命令來自倉庫 README）：
# npm（推薦）
pnpm add dsh-cot-translation-reader
# 從 GitHub 安裝（跟蹤 main，不用等發佈）
pnpm add github:LingMoe404/dsh-cot-translation-reader
# 本地目錄
pnpm add file:../dsh-cot-translation-reader
裝完後重啓 DSH（Desktop 從托盤完全退出；Web Host 重開一次），確認 dsh-cot-translation-reader 已出現在 profile package.json 的 dsh.profile.bundles 中（插件管理器安裝時會自動寫入）。
典型用法無需單獨配置文件：先安裝並啓用 dsh-better-display 與 @deepseek-ai/dsh-experimental-cot-translation-bundle，在官方組合包面板裏選好翻譯服務與目標語言，再安裝本插件並重啓；打開 better-display 的閱讀頁籤即可看到與主對話區一致的官方 COT 譯文行爲。
適用場景與注意¶
適合已經在用官方思考翻譯、又經常在 dsh-better-display 閱讀頁裏讀長思考鏈的用戶。插件以當前 DSH 進程的權限運行，安裝前應自行查看 GitHub 源碼 與 MIT 許可證；社區目錄 skillhub.cn 插件頁 與 DeepSeek / 幻方無官方從屬關係，並非官方應用商店。
若只需要主對話區的 COT 翻譯，不必安裝本插件；若閱讀頁從未打開，也感受不到差異。單卡片切換按鈕依賴 better-display 尚未隨 0.3.9 發佈的 PR，需要該能力時可關注 PR 合併後再升級 better-display。
相關鏈接¶
- 社區目錄：https://www.skillhub.cn/plugins/LingMoe404/dsh-cot-translation-reader
- 倉庫：https://github.com/LingMoe404/dsh-cot-translation-reader
經過上面的步驟，閱讀頁與官方 COT 翻譯組合包可以對齊：同一套設置、同一套譯文邏輯，只是渲染路徑從對話插槽改接到閱讀頁的 text-transform 縫。
