@local/dsh-locale-vi
为 DeepSeek Harness Web GUI 添加越南语（vi）支持，包括已安装软件包的标题和描述。
插件会安装到这里；不确定时保持 web。
npx -y @deepseek-ai/dsh plugin --profile web add github:dinhdev666/dsh-vi-pack#46cc1a6b5c4174238e23bd47fcc605d080a98e5fLocale Vi 以 @local/dsh-locale-vi 发布，当前版本为 1.1.0。Plugin Hub 会校验它的 manifest，并保存精确安装来源，便于复现安装结果。
Gói ngôn ngữ tiếng Việt cho giao diện web DeepSeek Harness (DSH): thêm Tiếng Việt (vi) vào
Settings → General → Language và dịch giao diện bằng bộ từ điển phủ toàn bộ namespace locale
mà Harness phát hành.
locale/en.json của từng
gói nên không nằm trong namespace nào; gói ngôn ngữ bổ sung bản dịch trong vi-meta/ và phủ lên
ctx.locale.resolveText.en: khóa nào chưa dịch sẽ hiển thị tiếng Anh, giao diện không bao giờ lộ khóa thô.@local/dsh-locale-vi, nửa browser đăng ký ngôn ngữ qua ctx.locale.addLanguage,
từng namespace qua ctx.locale.register(ns, 'vi', dict), và tên/mô tả gói qua lớp phủ
ctx.locale.resolveText; nửa host là no-op.| Đường dẫn | Nội dung |
|---|---|
extract/ | Dữ liệu trích xuất từ DSH chỉ dùng cho pipeline: en/<namespace>.json (nguồn chuẩn), manifest.json, meta.json (tên/mô tả gói), dicts-v2.json, summary-v2.txt, validation.txt |
extract/reference/ | Bản dump bundle gốc của DSH để tham chiếu khi bảo trì (README.md của thư mục này giải thích nguồn gốc); không sinh tự động, không script nào đọc |
vi-packs/ | Bản dịch tiếng Việt — 63 tệp JSON cùng tên, cùng thứ tự khóa với extract/en/ |
vi-meta/ | Bản dịch tên và mô tả gói — packages-*.json khóa theo tên gói, đối chiếu extract/meta.json |
plugin/ | Plugin đóng gói để cài vào DSH: client.js (sinh tự động), index.js (host no-op), cordis.patch.yml, locale/*.json, icon.svg |
package.json | Manifest cài đặt ở gọc repository — mặt cài đặt của địa chỉ Git thuần: khai báo dsh.bundle trỏ vào plugin/cordis.patch.yml và exports trỏ vào plugin/; giữ đồng bộ tên, version, mô tả với plugin/package.json |
tools/ | Toàn bộ pipeline: trích xuất, dựng dataset, build, kiểm tra, audit, test |
tools/lib/ | Helper dùng chung của tools/: gốc repo và đọc/ghi JSON (repo.mjs), regex placeholder & CJK (text.mjs), dữ liệu vi-meta (meta.mjs), đọc app.asar (asar.mjs), thư mục bundle và hai manifest (bundle.mjs) |
GUIDE.md | Quy tắc dịch, định dạng, glossary thuật ngữ thống nhất |
AGENTS.md | Quy ước cho agent lập trình làm việc trong repo này |
CONTRIBUTING.md | Hướng dẫn đóng góp |
LICENSE | Giấy phép MIT |
Trong giao diện web DSH, mở Plugins → Add plugin và dán địa chỉ repository:
https://github.com/dinhdev666/dsh-vi-pack
DSH chạy pnpm add với địa chỉ đó, nên package.json ở gọc repository chính là thứ được đọc:
nó khai báo dsh.bundle (trỏ vào plugin/cordis.patch.yml) và exports (trỏ vào plugin/), nên
DSH cài được đúng một bundle, tự thêm vào danh sách bundle của profile và kích hoạt nó. Sau khi cài,
tải lại trang (Cmd/Ctrl+R), mở Settings → General → Language và chọn Tiếng Việt.
Muốn nâng cấp sau khi có bản mới: gỡ bundle trong Plugin Manager rồi cài lại.
Cài bằng địa chỉ repository thuần sẽ tải cả repository (kèm
extract/,vi-packs/,tools/). Nếu chỉ muốn phần cài gọn, dùng spec trỏ thẳng vào thư mục bundle:https://github.com/dinhdev666/dsh-vi-pack#path:/plugin— thư mụcplugin/có manifest riêng (plugin/package.json) nên cài được như một bundle độc lập.
Plugin được nạp như một bundle local của DSH profile (ví dụ profile desktop tại
~/.dsh/profiles/desktop, trên Windows là %USERPROFILE%\.dsh\profiles\desktop).
Khai báo dependency trỏ tới thư mục plugin trong package.json của profile. Dùng đường dẫn
tương đối (tính từ thư mục profile) để cấu hình chạy được trên cả macOS và Windows:
"dependencies": {
"@local/dsh-locale-vi": "link:../../../dev/dsh-vi-pack/plugin"
}
Ví dụ trên ứng với repo clone tại ~/dev/dsh-vi-pack; chỉnh lại cho khớp vị trí thật của bạn.
Trên Windows, nếu repo và profile nằm ở hai ổ đĩa khác nhau thì buộc phải dùng đường dẫn tuyệt
đối (ví dụ link:<đường-dẫn-tuyệt-đối-tới-repo>/plugin).
Thêm bundle vào danh sách profile:
"dsh": {
"profile": {
"bundles": [
"@local/dsh-locale-vi"
]
}
}
Khởi động lại DSH, mở Settings → General → Language và chọn Tiếng Việt.
Muốn cố định ngôn ngữ, đặt trong cordis.patch.yml của profile:
- id: locale
name: "@deepseek-ai/dsh-client-locale"
config:
preference: vi
DSH đã cài (app.asar)
├─ tools/extract-dicts.mjs ──► extract/dicts-v2.json, extract/summary-v2.txt
│ └─ tools/prepare-dataset.mjs ──► extract/en/*.json, extract/manifest.json
│ └─ [dịch tay] ──► vi-packs/*.json ─────────────┐
└─ tools/extract-meta.mjs ──► extract/meta.json │
└─ [dịch tay] ──► vi-meta/packages-*.json ──────────┤
└─ tools/build-client.mjs ──► plugin/client.js
└─ tools/validate-*.mjs / audit-vi.mjs / test-client.mjs
Chỉ cần chạy lại các bước trích xuất khi DSH cập nhật từ điển gốc:
node tools/extract-dicts.mjs # đọc locale từ bundle DSH đã cài (cần Electron-as-node để mở app.asar)
node tools/prepare-dataset.mjs # tách extract/en/*.json + manifest.json
node tools/extract-meta.mjs # đọc tên/mô tả gói vào extract/meta.json (chạy bằng node thường)
Các lệnh dùng hằng ngày (chạy từ thư mục gốc repo):
node tools/validate-vi.mjs # toàn bộ 63 namespace
node tools/validate-vi.mjs chat conversation # chỉ định namespace
node tools/validate-meta.mjs # toàn bộ 216 tiêu đề + 29 mô tả gói
node tools/validate-meta.mjs --partial # báo phần còn thiếu, không tính là lỗi
node tools/audit-vi.mjs # soát tiếng Anh sót, glossary, khoảng trắng
node tools/build-client.mjs # sinh lại plugin/client.js
node tools/test-client.mjs # smoke test bundle với locale service giả lập
build-client.mjs từ chối build khi thiếu namespace, thiếu/thừa khóa, giá trị rỗng, placeholder lệch
so với bản tiếng Anh, hoặc khi một gói đang có trong DSH chưa có tên/mô tả tiếng Việt.
test-client.mjs nạp plugin/client.js trong node:vm, kiểm tra số namespace, số khóa từng
namespace, ngôn ngữ dự phòng, lớp phủ tên/mô tả gói và việc dọn dẹp effect.
validate-vi.mjs — lỗi cứng: key parity, placeholder, ký tự CJK, khoảng trắng thừa, giá trị
trùng tiếng Anh; cảnh báo: thứ tự khóa, số dòng, marker Markdown, độ dài.validate-meta.mjs — lỗi cứng: gói trong DSH chưa có tên/mô tả, khóa lạ hoặc trùng, ký tự CJK,
và hai gói dùng chung một chuỗi tiếng Anh nhưng dịch khác nhau.audit-vi.mjs — soát mềm: cụm tiếng Anh còn sót, lệch glossary, lỗi khoảng trắng, chuỗi ASCII
không dấu đáng ngờ.Trạng thái hiện tại: 63/63 namespace dịch đủ 2.901 khóa; 216/216 tiêu đề và 29/29 mô tả gói đã dịch;
validate-vi, validate-meta, test-client và build-client đều qua.
plugin/client.js — tệp này sinh từ vi-packs/*.json và vi-meta/packages-*.json
qua build-client.mjs.extract-meta.mjs rồi cập nhật vi-meta/ (validator sẽ báo gói thiếu).tools/*.mjs tự suy ra gốc repo từ vị trí script (qua tools/lib/repo.mjs) nên clone ở đâu cũng
chạy được và chạy được từ mọi thư mục; helper dùng chung nằm ở tools/lib/, các script chỉ giữ
logic riêng. Riêng extract-dicts.mjs và extract-meta.mjs cần bản DSH đã cài: hai script tự dò
bản cài mặc định trên Windows/macOS (code trong tools/lib/asar.mjs), nếu DSH nằm chỗ khác thì đặt
biến môi trường DSH_APP_ASAR trỏ tới app.asar.JSON, Markdown, MCP, tổ hợp phím, tên model…) được giữ
nguyên tiếng Anh theo quy ước trong GUIDE.md.Bản dịch phủ toàn bộ chuỗi đi qua hệ thống ngôn ngữ của DSH. Một vài chỗ nằm ngoài hệ thống đó nên
vẫn hiển thị tiếng Anh, kể cả khi chọn tiếng Việt — bản zh của DSH cũng vậy:
SKILL.md và mô tả kỹ năng do từng gói/gói kỹ năng tự cung cấp: đây là nội dung của
plugin, không phải chuỗi giao diện.Loading plugins…, Failed to load plugins) vẽ trước khi ngôn ngữ
được nạp.Phát hành theo MIT License © 2026 Phạm Văn Định.