DeepSeek Harness (DSH) Brazil Portuguese Locale Plugin

前言¶

DeepSeek Harness (DSH) 是一個基於插件系統的框架。官方運行時默認只內嵌了中文 (zh) 和英文 (en)，並不支持通過官方配置直接選擇其他語言。對於習慣使用葡萄牙語瀏覽器的用戶，界面語言與瀏覽器環境不匹配是一個常見的痛點。

negriniainda/dsh-locale-ptbr 是一個針對 DeepSeek Harness 的巴西葡萄牙語 (pt-BR) 本地化插件。它負責將 Web UI 翻譯爲葡萄牙語，並在檢測到瀏覽器語言爲葡萄牙語時自動激活，解決了上述語言不匹配的問題。

該插件提供以下核心能力：

全界面翻譯：覆蓋 Web UI 的主要區域，包括菜單、設置、聊天窗口、側邊欄、工作區、子代理和 workflows。
自動語言檢測：插件會檢測瀏覽器語言。如果瀏覽器設置爲 pt、pt-BR 或 pt-PT，且用戶未在設置中做出明確的 zh 或 en 選擇，界面會自動切換爲 pt-BR。
字典註冊：通過公共 API 註冊葡萄牙語字典，確保翻譯內容能夠被運行時正確加載。
橋接機制：由於官方 DSH 運行時僅支持 zh 和 en，該插件通過一個橋接層添加 pt-BR 到可選語言列表中，使其可以被調用。

安裝該插件需要使用 DSH 的插件管理命令。插件已打包爲 dsh.bundle 和 dsh.client 格式，可以直接通過 npm 包名安裝。

dsh plugin --profile web add @negriniainda/dsh-locale-ptbr

安裝完成後，重啓 DSH 服務或刷新 Web 頁面即可生效。

根據插件實現邏輯，不同場景下的表現如下：

自動激活：如果瀏覽器語言是 pt、pt-BR 或 pt-PT，且用戶未在設置中顯式選擇 zh 或 en，界面將自動切換爲 pt-BR。
尊重顯式選擇：如果用戶已經在設置中選擇了 English 或 中文，該顯式選擇將被尊重，不會被自動切換覆蓋。
手動選擇：用戶可以在語言菜單中手動選擇 Português (Brasil)，界面會切換爲 pt-BR，但該選擇僅對當前會話有效，不會持久化寫入官方配置文件。

會話級持久性：手動選擇 Português (Brasil) 僅在當前會話內生效。由於官方配置 schema 僅支持 zh 和 en，pt-BR 無法被保存爲長期偏好設置。
文本覆蓋不全：部分固定文本尚未通過官方的 locale 機制覆蓋（這是上游 dsh-client-locale 的已知限制）。隨着上游逐步暴露更多文本，插件會同步更新。

該插件通過維護一份完整的字典文件 (lib/dicts.js) 來實現翻譯，支持根據上游官方語言的更新進行同步和修改。