前言¶
DeepSeek Harness(DSH)的 Web 界面默认以英文为主。若团队或用户更习惯越南语,需要在不改动 DSH 核心的前提下,把聊天、会话、工作区、设置等界面文案换成越南语,并在缺译时仍能正常阅读。
下面介绍社区插件 dsh-vietnamese-lang:它通过 DSH 官方的 LocaleRuntime 与 Cordis 客户端插件机制,为 Web UI 注册越南语语言包,并在设置里与内置语言并列可选。
这是什么¶
dsh-vietnamese-lang 是面向 DeepSeek Harness Web UI 的越南语语言包插件,维护者为 lphuxhuq,源码托管于 GitHub,当前 manifest 版本为 0.1.0,采用 MIT 许可证。
插件不修改 DSH 核心代码,仅作为 Cordis 客户端插件经标准 ModuleLoader 加载;安装后在 Settings > General > Language 中选择 Tiếng Việt 即可切换界面语言。
核心功能¶
README 中列出的能力如下,均可在仓库说明中核对:
- 核心 UI 覆盖:在 50 个命名空间内提供越南语本地化,涵盖 Chat、Conversation、Trajectory、Workspace、Settings、Model Selection、Approvals、File Explorer、Terminal、Deliverables、Diff Viewer、Document Previews 等模块。
- 原生集成:通过官方
LocaleRuntimeAPI 注册,语言项出现在 Settings > General > Language。 - 自动回退:第三方或尚未翻译的 key 缺失时,回退为英文,避免空白或报错。
- 零核心补丁:完全以 Cordis 客户端插件运行,依赖
@deepseek-ai/dsh-client-locale注入(见package.json中dsh.client配置)。
package.json 声明的对等依赖为:@deepseek-ai/cordis(>=4.0.0-rc.8 <5.0.0)、@deepseek-ai/dsh-client-locale(>=0.1.0-rc.1 <0.2.0-0);客户端平台为 web。
安装与启用¶
安装前请确认本机已安装可用的 dsh CLI,且你使用的是 Web 配置档(--profile web)。插件会以当前 dsh 进程权限运行,安装前建议浏览仓库源码与 LICENSE,再决定是否安装。
方式一:通过插件名安装
dsh plugin --profile web add dsh-vietnamese-lang
方式二:从 GitHub 仓库 URL 安装
dsh plugin --profile web add https://github.com/lphuxhuq/dsh-vietnamese-lang
安装完成后:
- 刷新 DeepSeek Harness Web GUI。
- 打开 Settings(Cài đặt)> General(Cài đặt chung)> Language(Ngôn ngữ)。
- 选择 Tiếng Việt。
经上述步骤,界面应切换为越南语;未覆盖的文案会按插件说明回退为英文。
典型用法与仓库结构¶
本插件的「用法」即安装并在设置中选择语言,无额外 CLI 或配置文件字段。若需了解实现布局,README 给出的目录结构如下:
dsh-vietnamese-lang/
├── cordis.patch.yml # Plugin entry for DSH loader
├── index.mjs # Host entry (no-op)
├── lib/
│ └── client.js # Client bundle with 50 localized namespaces
├── package.json # Manifest with dsh.bundle & dsh.client
└── README.md
cordis.patch.yml 供 DSH 加载器识别插件入口;lib/client.js 承载 50 个命名空间的客户端翻译 bundle。仓库另提供 README.vi.md 越南语版说明。
适用场景与注意¶
适合谁
- 在 DSH Web UI 上工作、希望界面为越南语的开发者或团队。
- 需要完整核心 UI 越南语覆盖、且接受缺译 key 英文回退的场景。
注意事项
- 插件分类为 Web 客户端语言包(
dsh.client.platform: web),不适用于非 Web 档或未声明支持的环境。 - DSH 生态强调「一切皆插件」;社区目录 SkillHub 插件页 为独立站点,与 DeepSeek / 幻方无官方从属关系,安装来源以 README 命令为准。
- 版本与依赖以仓库
package.json为准;升级 DSH 或 Cordis 大版本时,需核对peerDependencies是否仍满足。
链接¶
- 社区目录:https://www.skillhub.cn/plugins/lphuxhuq/dsh-vietnamese-lang
- GitHub:https://github.com/lphuxhuq/dsh-vietnamese-lang
经过上面的步骤,你可以在不动 DSH 核心的前提下,为 Web 界面启用越南语,并在设置中与内置语言一样切换。