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) 来实现翻译，支持根据上游官方语言的更新进行同步和修改。