dsh-locale-vi

Gói ngôn ngữ tiếng Việt có kiểm soát cho giao diện Web của DeepSeek Harness.

Phạm vi

• Thêm Tiếng Việt vào Cài đặt → Chung → Ngôn ngữ.
• Bao phủ 30 namespace chính thức của DSH 0.1.1-rc.2 và catalog tùy chọn dsh-market của [email protected].
• Có 1.090 khóa được khóa bằng type-contract, hash key-set và placeholder audit.
• Lưu locale.preference: vi trong $DSH_HOME/settings.yaml, tự nhận diện trình duyệt vi-* khi chưa có lựa chọn rõ ràng.
• Chỉ thay văn bản UI. Plugin không thay system prompt, Tool description, reasoning, câu trả lời hoặc session log.

Cài đặt

Plugin chỉ hỗ trợ chính xác DeepSeek Harness 0.1.1-rc.2.

dsh plugin --profile web add dsh-locale-vi

Khi phát triển từ checkout cục bộ, nên cài bản tarball đã build thay vì source:

pnpm install
pnpm check
pnpm pack
dsh plugin --profile web add .\dsh-locale-vi-0.1.0.tgz

Sau khi cài, khởi động lại dsh web và chọn Tiếng Việt trong Cài đặt.

Phát triển

Yêu cầu Node.js >=22.19.0 và pnpm 11.17.0.

pnpm install
pnpm typecheck
pnpm audit:locales
pnpm test
pnpm build
pnpm pack:check

pnpm check chạy toàn bộ gate trên. Package xuất sẵn Host ESM và client ModuleLoader bundle; người dùng không phải cho phép script prepare.

An toàn và gỡ cài đặt

DSH rc.2 chưa có extension point công khai để thêm LocaleId. Plugin vì thế cô lập một adapter tương thích có kiểm tra version/shape. Khi version không khớp, adapter không kích hoạt và UI chính thức zh/en vẫn hoạt động.

Hot-unload sẽ tự chuyển vi về en. Khi gỡ lúc DSH đã dừng, chạy bước chuẩn bị sau để đổi đúng một trường trong settings.yaml bằng ghi file nguyên tử, rồi gỡ package:

$dshHome = if ($env:DSH_HOME) { $env:DSH_HOME } else { Join-Path $env:USERPROFILE '.dsh' }
$profileDir = Join-Path $dshHome 'profiles\web'
pnpm --dir $profileDir exec dsh-locale-vi prepare-remove
dsh plugin --profile web remove dsh-locale-vi

Sau đó khởi động lại DSH.

Xem COMPATIBILITY.md để biết contract và giới hạn chi tiết.

Giấy phép

MIT