越南语界面主题 DucLong06/dsh-vietnam

DSH Việt Nam

插件，用于 DeepSeek Harness（dsh），包含三部分：

- dsh 整个界面的越南语：dsh 0.2.0-rc.2 的 58 个命名空间中共 2.615 条字符串，翻译覆盖率 100%。
- 三套越南配色，每套都有浅色和深色版本：Sơn mài、Hạ Long sương、Lụa Hội An。
- 越南风景壁纸自动轮换：图片来自 Wikimedia Commons，附作者与许可信息。

Sơn mài，深色模式，Tam Cốc 背景，图片不透明度 = 100

Sơn mài（深色）配 Tam Cốc 背景，默认设置（图片不透明度 = 100）。

| Hạ Long sương（浅色），默认 | Lụa Hội An（深色），图片不透明度 = 40 |
| Hạ Long sương | Lụa Hội An |

| Hạ Long sương，图片不透明度 = 40（文字最易读） | Sơn mài（深色），图片不透明度 = 40 |
| Hạ Long sương 默认 | Sơn mài 默认 |

| 「Giao diện Việt」设置项 | 越南语界面 | 手机 |
| Giao diện Việt 设置行 | 越南语的通用设置 | 手机上的 Lụa Hội An |

要求

- dsh 0.2.0-rc.1 及以上。更早的版本还没有 addLanguage API，加不了越南语。
- 插件只在 web 和 desktop 配置档下运行。

安装

dsh plugin --profile web add dsh-vietnam

或者在 dsh 里：Plugin → 添加插件 → 包名或地址输入框 → 输入 dsh-vietnam → 安装。想用 GitHub 上的最新版，就用 github:DucLong06/dsh-vietnam 安装。

重启 dsh web，然后：

1. 进入 Settings → General → Language，选择 Tiếng Việt。
2. 往下滚到 Giao diện Việt 一栏，选配色、浅色/深色模式，开关壁纸。

卸载：

dsh plugin --profile web remove dsh-vietnam

功能

越南语

- 在 dsh 的语言列表里加上「Tiếng Việt」。没有译文的字符串会自动显示英文，所以界面永远不会空着。
- 术语统一遵循术语表。部分专业词保持原样：agent、subagent、skill、plugin、token。
- 斜杠命令的 token（/compact、/plan……）不翻译，因为 dsh 只认用英文或中文 token 输入的命令。

配色

| 配色 | 主色调 |
| Sơn mài | đen sơn, đỏ son, vàng dát, ngà |
| Hạ Long sương | xanh ngọc, xám đá vôi, trắng sương |
| Lụa Hội An | lụa vàng nhạt, lục bảo, vàng nghệ, đỏ đèn lồng |

- 每套配色都有三种模式：Sáng、Tối、Theo hệ thống（跟随操作系统自动切换）。
- 所有实色文字/背景配色对都按 WCAG AA 标准做了自动测试：正文 ≥ 4.5:1，注释和状态图标 ≥ 3:1。叠在背景图上的文字见下方「Hình nền」一节。
- 如果你在 dsh 原有的 Diện mạo 里选了 Sáng/Tối/Theo hệ thống，插件会把界面让回给 dsh。在「Giao diện Việt」里选「Mặc định DSH」，就会恢复成你之前用的那套主题。

Hình nền Việt Nam

- 共有 8 个图集：Vịnh Hạ Long · Lan Hạ、Ruộng bậc thang、Tam Cốc · núi đá vôi、Phong Nha · hang động、Sông hồ · thác nước、Làng quê、Biển Việt Nam、Ảnh tuyển chọn Commons。默认开启 6 个，合计约 500 张图。
- 图片自动筛选：横图、宽度 ≥ 1920px、许可为 CC0 / Public domain / CC BY / CC BY-SA。地图、横幅和 logo 会被排除。
- 图片每 1 / 5 / 15 / 30 / 60 分钟切换一次，淡入淡出，带缓慢移动效果（Ken Burns）。Ảnh tiếp 按钮可立即换图。
- 有 Độ hiện ảnh 和 Làm mờ ảnh 两个滑块，还有 Ảnh riêng 输入框，可把你自己的图片 URL 加进轮播。自定义图片直接加载，不需要服务器支持 CORS，但也不会被缓存，断网时用不了。
- 易读性： 图片始终至少覆盖 65% 的配色背景色。在默认档位（Độ hiện ảnh = 100，图片最清晰），正文在任意像素点上都达到 WCAG AA。辅助文字（描述、注释）在亮度相同的图片区域上可能不好读；把滑块拉到 40 或以下，正文和辅助文字在任意像素点上都达到 AA。这两项承诺通过扫描像素的所有灰度值来测试。
- 只有页面背景和侧边栏透明。对话框、菜单、输入框、卡片、吸顶 header 和队列 dock 始终保持实色。
- 省资源： 每个图集的图片列表每天最多重新加载 1 次。标签页隐藏时幻灯片暂停。如果操作系统里开了减弱动态效果，切换动画会关闭。
- 断网时： 如果加载不到新图，插件会切到浏览器里最近缓存的 30 张图轮播，联网后自动恢复加载新图。如果一张都没缓存，就显示配色渐变背景。
- 署名： 右下角始终显示图片名、作者和许可，点击会打开 Commons 上的图片页。CC BY / BY-SA 许可要求每次显示图片都要署名，所以这个标签只在关闭背景图时才会隐藏。

Quyền riêng tư

背景图开启时，你的浏览器会直接向 commons.wikimedia.org 和 upload.wikimedia.org 发请求，所以 Wikimedia 会看到你的 IP 地址。插件不会把任何 dsh 数据发到外部。如果不想有对外请求，在设置里关掉 Hình nền Việt Nam 即可，配色和越南语功能照常可用。
插件的选项（配色、壁纸设置）保存在各浏览器的 localStorage 里。

已知限制

- Commons 上的图片质量参差不齐，偶尔会碰到差图（路牌、模糊图……）。点 下一张 跳过即可。
- 浅色模式下，由于叠加了浅色遮罩，壁纸看起来比深色模式更淡。如果某张图上辅助文字不好读，点 下一张，或者调低「图片不透明度」。
- 纯色表面通过 dsh 的 ARIA/data- 属性识别。如果新版 dsh 新增了其他纯色背景组件，这些组件可能会变透明，直到插件更新为止。
- 翻译跟随 dsh 0.2.0-rc.2。新版 dsh 可能新增字符串，在翻译完成前，这些字符串会显示英文。

开发

npm install
npm run typecheck && npm test && npm run build

用单独的 dsh 配置档试跑（数据放在 ./.dev-dsh，不碰 ~/.dsh）：

PORT=3180 npm run dev:dsh

或者用从源码 checkout 构建的 dsh 运行：

DSH_CHECKOUT=/đường/dẫn/deepseek-harness PORT=3080 npm run dev:dsh

命令会打印带 ?token=… 的 URL。请打开这个 URL，因为 dsh web 必须有 token 才能访问。

lib/（构建产物）随源码一起提交，这样可以直接从 GitHub 安装，不用跑构建脚本（pnpm 会拦截来自 git 的依赖脚本）。改完 src/ 后，跑 npm run build 并连同 lib/ 一起提交；如果 lib/ 过期，CI 会报错。

dsh 出新版时更新翻译

node scripts/extract-en.mjs /đường/dẫn/deepseek-harness # 抓取全部英文字符串 → upstream/en-<version>.json
node scripts/vi-locales.mjs sync # 为新 namespace 建文件，重新生成 index.ts
node scripts/vi-locales.mjs check # 列出缺失 / 多余 / placeholder 错误的 key

翻译放在 src/client/locales/vi/<namespace>.json，每个 namespace 一个文件。请保留所有 {placeholder}，并按术语表翻译。

结构

src/index.ts host 部分（只负责让 dsh 加载插件） src/client/index.ts 把下面各部分挂到 dsh web src/client/locale/ 注册 vi 语言 + 58 本词典 src/client/locales/vi/ 翻译（JSON，每个 namespace 一个文件） src/client/theme/ 3 套配色 × 浅色/深色 → token --dsw-alias- src/client/backdrop/ Wikimedia、图片轮换、缓存、玻璃层、署名 src/client/settings/ Settings 里的「Giao diện Việt」一行 scripts/ 抓取上游字符串、检查翻译、试跑 dsh

许可证

MIT。构建配置（tsdown.client.ts、web-platform.ts）改编自 NoNameLeGo/dsh-catppuccin-theme（MIT）。
壁纸版权归 Wikimedia Commons 上各图片作者所有，遵循图片上标注的许可证。

DeepSeek Harness 插件：完整越南语界面（2,615 条文案）、三套越南配色（Lacquer、Ha Long mist、Hoi An silk；浅色 + 深色），以及来自 Wikimedia Commons 的轮播越南风景背景，每张照片都带署名，并支持离线缓存。无论照片像素如何，正文都能保持 WCAG AA 对比度（照片可见度 ≤ 40 时，次要文字同样达标）。需要 dsh ≥ 0.2.0-rc.1。

dsh plugin --profile web add dsh-vietnam