前言¶

DeepSeek Harness（DSH）的 Web 界面默认以英文等内置语言为主。对需要越南语界面的使用者，要么忍受英文文案，要么依赖零散改字，很难与 Harness 发布的整套 locale namespace 对齐。社区维护者 dinhdev666 提供的 dsh-vi-pack（npm 包名 @dinhdev666/dsh-vi-pack）是一套标准 DSH 语言包插件：在 Settings → General → Language 中增加 Tiếng Việt (vi)，并用词典覆盖 Harness 对外发布的 locale，同时翻译插件列表中的包标题与描述。

这是什么¶

dsh-vi-pack 是面向 DSH Web GUI 的越南语语言包，分类上属于社区目录中的「趣味换装」类（界面语言与展示文案）。仓库：https://github.com/dinhdev666/dsh-vi-pack；目录页：https://www.skillhub.cn/plugins/dinhdev666/dsh-vi-pack。许可证为 MIT（见仓库 LICENSE）。

插件在浏览器侧通过 ctx.locale.addLanguage 注册语言、按 namespace 调用 ctx.locale.register(ns, 'vi', dict)，并对插件名/描述通过 ctx.locale.resolveText 做覆盖；Host 侧为 no-op。未翻译的键会 fallback 到 en，界面不会露出原始 locale 键名。

核心功能¶

下面介绍 README 中已写明、且与当前仓库状态一致的能力（资料截断处前的「Trạng thái hiện tại」）。

1. 界面词典：63 个 namespace，共 2.901 个键，覆盖 DSH 53 个 client 包发布的 locale 结构；与 extract/en/ 中英文源文件键序一致。
2. 插件元数据翻译：216 条插件标题与 29 条包描述（Plugin Manager 与 Settings → Plugins → Built-in plugins）。Host 从各包的 locale/en.json 拼装展示文案，本包在 vi-meta/ 中补充翻译并覆盖 resolveText。
3. 标准 bundle 形态：根目录 package.json 声明 dsh.bundle 指向 plugin/cordis.patch.yml，exports 指向 plugin/；运行时 bundle 含自动生成的 plugin/client.js（勿手改，由 tools/build-client.mjs 从 vi-packs/ 与 vi-meta/ 生成）。
4. 质量校验工具链：validate-vi.mjs、validate-meta.mjs、audit-vi.mjs、build-client.mjs、test-client.mjs 用于键对齐、placeholder、元数据完整性及 smoke test（维护者文档称上述校验与 build 均已通过）。

当前发布版本在 package.json 中为 1.2.0。

安装与启用¶

DSH 生态强调「一切皆插件」；SkillHub 插件目录 为社区站点，与 DeepSeek / 幻方无官方从属关系。安装前请自行审阅仓库源码与 MIT 许可证；插件随当前 DSH 进程权限运行。

通过 Plugin Manager（推荐）¶

在 DSH Web 界面打开 Plugins → Add plugin，粘贴仓库地址：

https://github.com/dinhdev666/dsh-vi-pack

DSH 会对该地址执行 pnpm add，读取仓库根目录的 package.json（含 dsh.bundle 与 exports），将 bundle 加入 profile 并激活。安装完成后重新加载页面（Cmd/Ctrl+R），进入 Settings → General → Language，选择 Tiếng Việt。

升级新版本时：在 Plugin Manager 中移除该 bundle 后重新安装上述地址。

若只希望安装 bundle 目录、避免拉取整个仓库（含 extract/、vi-packs/、tools/ 等），可使用指向 plugin/ 的 spec（README 原文）：

https://github.com/dinhdev666/dsh-vi-pack#path:/plugin

固定默认语言（可选）¶

若要在 profile 的 cordis.patch.yml 中固定偏好为越南语，README 给出示例：

- id: locale
  name: "@deepseek-ai/dsh-client-locale"
  config:
    preference: vi

修改后需按你使用的 profile 方式重启或重载 DSH，再在界面确认语言项。

典型用法¶

对普通使用者，完整路径只有两步：

1. 按上一节在 Plugin Manager 添加 https://github.com/dinhdev666/dsh-vi-pack（或精简的 #path:/plugin spec）。
2. 重载页面后在 Settings → General → Language 选择 Tiếng Việt；在 Plugin Manager 或内置插件列表中应看到已翻译的标题与描述（未译部分仍显示英文）。

对翻译维护者，README 给出的日常命令（在仓库根目录执行）包括：

node tools/validate-vi.mjs
node tools/validate-meta.mjs
node tools/build-client.mjs
node tools/test-client.mjs

当上游 DSH 更新英文词典时，需先运行 extract-dicts.mjs、prepare-dataset.mjs、extract-meta.mjs 再更新 vi-packs/ 与 vi-meta/；build-client.mjs 在缺 namespace、键不齐、placeholder 不一致或缺少包名/描述翻译时会拒绝构建。每次重新 build 后需重载 GUI（Ctrl/Cmd+R）才能看到新译文。

适用场景与注意¶

适合谁：日常使用 DSH Web 界面、希望界面与插件列表以越南语展示的用户；参与 DSH 越南语本地化、需要与 Harness namespace 键对齐的维护者。

不适合或需知悉：

• 本包只增加 vi 语言与相关覆盖，不改变模型能力或业务逻辑。
• 安装完整仓库地址会下载维护用的大体量目录；生产环境若只关心运行时可优先 #path:/plugin。
• 包标题/描述按 Host 返回的英文原串匹配；DSH 改动英文文案后需重新 extract-meta.mjs 并更新 vi-meta/。
• 社区目录标注星标为 0（截至撰稿线索），选用时请自行评估维护活跃度与版本 1.2.0 是否满足你的 DSH 版本。

结尾¶

dsh-vi-pack 把 DSH Web 界面的越南语支持做成可安装的官方形态 bundle：完整 locale、插件列表元数据、英文回退与校验流水线都在同一仓库内。需要安装或贡献翻译时，可从目录页 https://www.skillhub.cn/plugins/dinhdev666/dsh-vi-pack 进入，或直接打开 GitHub：https://github.com/dinhdev666/dsh-vi-pack。