Skip to content

Graphs that teach > graphs that impress. Turn any code into an interactive knowledge graph you can explore, search, and ask questions about. Works with Claude Code, Codex, Cursor, Copilot, Gemini CLI, and more.

feat(dashboard): add Vietnamese (vi) locale

rgb-vgxe3590a2e92fc
diff --git a/README.md b/README.md
index 5474b0e4..a2ffb1fc 100644
--- a/README.md
+++ b/README.md
@@ -129,7 +129,7 @@ A multi-agent pipeline scans your project, extracts every file, function, class,
# Generate Chinese content (知识图节点描述和 Dashboard UI)
/understand --language zh
-# Supported languages: en (default), zh, zh-TW, ja, ko, ru
+# Supported languages: en (default), zh, zh-TW, ja, ko, ru, vi
```
On the **first run** in a project — when you don't pass `--language` and no language is stored yet — `/understand` detects the language you're conversing in. If it isn't English, it asks you to confirm (or override) before generating; English conversations are unaffected. Your choice is saved to `.ua/config.json` and reused on every later run.
diff --git a/READMEs/README.es-ES.md b/READMEs/README.es-ES.md
index b2ea9e78..1e9e2866 100644
--- a/READMEs/README.es-ES.md
+++ b/READMEs/README.es-ES.md
@@ -128,7 +128,7 @@ Un pipeline multi-agente escanea tu proyecto, extrae cada archivo, función, cla
# Genera contenido en el idioma preferido (descripciones de nodos y UI del dashboard)
/understand --language en
-# Idiomas soportados: en (default), zh, zh-TW, ja, ko, ru
+# Idiomas soportados: en (default), zh, zh-TW, ja, ko, ru, vi
```
El parámetro `--language` afecta:
diff --git a/READMEs/README.ja-JP.md b/READMEs/README.ja-JP.md
index 9a06a7d9..2d3e4fa6 100644
--- a/READMEs/README.ja-JP.md
+++ b/READMEs/README.ja-JP.md
@@ -129,7 +129,7 @@ Understand Anything は [Claude Code Plugin](https://code.claude.com/docs/en/plu
# 日本語でコンテンツを生成(ナレッジグラフのノード説明とダッシュボードUI)
/understand --language ja
-# サポート言語:en(デフォルト)、zh、zh-TW、ja、ko、ru
+# サポート言語:en(デフォルト)、zh、zh-TW、ja、ko、ru、vi
```
プロジェクトでの**初回実行時**に `--language` を指定せず、保存済みの言語設定もない場合、`/understand` は会話で使われている言語を検出します。英語以外が検出された場合は、生成前にその言語を使用するか、別の言語へ変更するかを確認します。英語での会話には影響しません。選択結果は `.ua/config.json` に保存され、以降の実行でも再利用されます。
diff --git a/READMEs/README.ko-KR.md b/READMEs/README.ko-KR.md
index b6b79114..9bdaab9e 100644
--- a/READMEs/README.ko-KR.md
+++ b/READMEs/README.ko-KR.md
@@ -128,7 +128,7 @@ Understand Anything은 [Claude Code Plugin](https://code.claude.com/docs/en/plug
# 한국어로 내용 생성 (지식 그래프 노드 설명과 대시보드 UI)
/understand --language ko
-# 지원 언어: en(기본값), zh, zh-TW, ja, ko, ru
+# 지원 언어: en(기본값), zh, zh-TW, ja, ko, ru, vi
```
`--language` 매개변수는 다음에 영향합니다:
diff --git a/READMEs/README.ru-RU.md b/READMEs/README.ru-RU.md
index d48043ec..0789123d 100644
--- a/READMEs/README.ru-RU.md
+++ b/READMEs/README.ru-RU.md
@@ -129,7 +129,7 @@ Understand Anything — это [плагин для Claude Code](https://code.cl
# Генерация контента на русском (описания узлов графа знаний и UI панели)
/understand --language ru
-# Поддерживаемые языки: en (по умолчанию), zh, zh-TW, ja, ko, ru
+# Поддерживаемые языки: en (по умолчанию), zh, zh-TW, ja, ko, ru, vi
```
Параметр `--language` влияет на:
diff --git a/READMEs/README.tr-TR.md b/READMEs/README.tr-TR.md
index c62af3d5..587131ee 100644
--- a/READMEs/README.tr-TR.md
+++ b/READMEs/README.tr-TR.md
@@ -129,7 +129,7 @@ Alan görünümüne geçin ve kodunuzun gerçek iş süreçleriyle nasıl eşle
# İstediğiniz dilde içerik oluştur (düğüm açıklamaları ve dashboard UI)
/understand --language en
-# Desteklenen diller: en (varsayılan), zh, zh-TW, ja, ko, ru
+# Desteklenen diller: en (varsayılan), zh, zh-TW, ja, ko, ru, vi
```
`--language` parametresi şunları etkiler:
diff --git a/READMEs/README.zh-CN.md b/READMEs/README.zh-CN.md
index 4b7be15d..a4c1c928 100644
--- a/READMEs/README.zh-CN.md
+++ b/READMEs/README.zh-CN.md
@@ -128,7 +128,7 @@ Understand Anything 是一个 [Claude Code Plugin](https://code.claude.com/docs/
# 生成中文内容(知识图节点描述和 Dashboard UI)
/understand --language zh
-# 支持的语言:en(默认)、zh、zh-TW、ja、ko、ru
+# 支持的语言:en(默认)、zh、zh-TW、ja、ko、ru、vi
```
`--language` 参数会影响:
diff --git a/READMEs/README.zh-TW.md b/READMEs/README.zh-TW.md
index 1dc4eb2b..35d24522 100644
--- a/READMEs/README.zh-TW.md
+++ b/READMEs/README.zh-TW.md
@@ -128,7 +128,7 @@ Understand Anything 是一個 [Claude Code Plugin](https://code.claude.com/docs/
# 產生繁體中文內容(知識圖節點描述和 Dashboard UI)
/understand --language zh-TW
-# 支援的語言:en(預設)、zh、zh-TW、ja、ko、ru
+# 支援的語言:en(預設)、zh、zh-TW、ja、ko、ru、vi
```
`--language` 參數會影響:
diff --git a/understand-anything-plugin/packages/dashboard/src/__tests__/locales.test.ts b/understand-anything-plugin/packages/dashboard/src/__tests__/locales.test.ts
new file mode 100644
index 00000000..5d057271
--- /dev/null
+++ b/understand-anything-plugin/packages/dashboard/src/__tests__/locales.test.ts
@@ -0,0 +1,44 @@
+import { describe, expect, it } from "vitest";
+import { getLocale, locales, resolveLocaleKey } from "../locales";
+
+function keyShape(value: unknown): string[] {
+ if (Array.isArray(value)) {
+ return value.flatMap((item, index) => keyShape(item).map((key) => `${index}.${key}`));
+ }
+ if (value !== null && typeof value === "object") {
+ return Object.keys(value as Record<string, unknown>)
+ .sort()
+ .flatMap((key) => keyShape((value as Record<string, unknown>)[key]).map((child) => `${key}.${child}`));
+ }
+ return [];
+}
+
+describe("resolveLocaleKey", () => {
+ it("resolves Vietnamese codes and friendly names", () => {
+ expect(resolveLocaleKey("vi")).toBe("vi");
+ expect(resolveLocaleKey("vi-VN")).toBe("vi");
+ expect(resolveLocaleKey("vi_vn")).toBe("vi");
+ expect(resolveLocaleKey("vietnamese")).toBe("vi");
+ expect(resolveLocaleKey("Vietnamese")).toBe("vi");
+ });
+
+ it("falls back to English for unknown languages", () => {
+ expect(resolveLocaleKey("xx")).toBe("en");
+ expect(resolveLocaleKey(undefined)).toBe("en");
+ });
+});
+
+describe("locales", () => {
+ it("exposes a Vietnamese locale with the English key shape", () => {
+ expect(keyShape(locales.vi)).toEqual(keyShape(locales.en));
+ expect(locales.vi.onboarding.steps).toHaveLength(locales.en.onboarding.steps.length);
+ });
+
+ it("lists every locale in the record", () => {
+ expect(Object.keys(locales).sort()).toEqual(["en", "ja", "ko", "ru", "vi", "zh", "zh-TW"]);
+ });
+
+ it("returns the Vietnamese locale via getLocale", () => {
+ expect(getLocale("vi")).toBe(locales.vi);
+ });
+});
diff --git a/understand-anything-plugin/packages/dashboard/src/locales/index.ts b/understand-anything-plugin/packages/dashboard/src/locales/index.ts
index 27f022ca..80aa2c63 100644
--- a/understand-anything-plugin/packages/dashboard/src/locales/index.ts
+++ b/understand-anything-plugin/packages/dashboard/src/locales/index.ts
@@ -4,8 +4,9 @@ import zhTW from "./zh-TW";
import ja from "./ja";
import ko from "./ko";
import ru from "./ru";
+import vi from "./vi";
-export type LocaleKey = "en" | "zh" | "zh-TW" | "ja" | "ko" | "ru";
+export type LocaleKey = "en" | "zh" | "zh-TW" | "ja" | "ko" | "ru" | "vi";
export type Locale = typeof en;
export const locales: Record<LocaleKey, Locale> = {
@@ -15,6 +16,7 @@ export const locales: Record<LocaleKey, Locale> = {
ja,
ko,
ru,
+ vi,
};
export function getLocale(key: LocaleKey): Locale {
@@ -29,7 +31,8 @@ export function resolveLocaleKey(lang: string | undefined): LocaleKey {
if (normalized === "ja" || normalized === "japanese") return "ja";
if (normalized === "ko" || normalized === "korean") return "ko";
if (normalized === "ru" || normalized === "russian" || normalized === "ru-ru") return "ru";
+ if (normalized === "vi" || normalized === "vietnamese" || normalized === "vi-vn") return "vi";
return "en";
}
-export { en, zh, zhTW as "zh-TW", ja, ko, ru };
+export { en, zh, zhTW as "zh-TW", ja, ko, ru, vi };
diff --git a/understand-anything-plugin/packages/dashboard/src/locales/vi.ts b/understand-anything-plugin/packages/dashboard/src/locales/vi.ts
new file mode 100644
index 00000000..5c85f35e
--- /dev/null
+++ b/understand-anything-plugin/packages/dashboard/src/locales/vi.ts
@@ -0,0 +1,310 @@
+export const vi = {
+ common: {
+ loading: "Đang tải dự án...",
+ computingGraphLayout: "Đang tính bố cục đồ thị...",
+ forceLayoutFallback: "Không thể dùng bố cục lực; đang hiển thị lưới dự phòng.",
+ noGraphLoaded: "Chưa tải đồ thị",
+ selectNode: "Chọn một node để xem chi tiết",
+ back: "Quay lại",
+ focus: "Tập trung",
+ unfocus: "Bỏ tập trung",
+ openCode: "Mở mã nguồn",
+ file: "Tệp",
+ tags: "Thẻ",
+ connections: "Kết nối",
+ filter: "Bộ lọc",
+ resetAll: "Đặt lại tất cả",
+ analyzed: "Đã phân tích",
+ startGuidedTour: "Bắt đầu tham quan có hướng dẫn",
+ truncated: "(đã rút gọn)",
+ preview: "Xem trước",
+ doubleClickToOpen: "nhấp đúp để mở",
+ appName: "Understand Anything",
+ pressKeyboard: "Nhấn ? để xem phím tắt",
+ path: "Đường dẫn",
+ theme: "Giao diện",
+ },
+ projectOverview: {
+ nodes: "Node",
+ edges: "Cạnh",
+ layers: "Tầng",
+ types: "Loại",
+ fileTypes: "Loại tệp",
+ code: "Mã",
+ config: "Cấu hình",
+ docs: "Tài liệu",
+ infra: "Hạ tầng",
+ data: "Dữ liệu",
+ domain: "Nghiệp vụ",
+ knowledge: "Tri thức",
+ languages: "Ngôn ngữ",
+ frameworks: "Framework",
+ nodeTypeDistribution: "Phân bố loại node",
+ complexityDistribution: "Phân bố độ phức tạp",
+ simple: "Đơn giản",
+ moderate: "Trung bình",
+ complex: "Phức tạp",
+ mostConnectedNodes: "Node có nhiều kết nối nhất",
+ avgConnectionsPerNode: "Số kết nối trung bình mỗi node",
+ },
+ nodeInfo: {
+ definedInThisFile: "Được định nghĩa trong tệp này",
+ languageConcepts: "Khái niệm ngôn ngữ",
+ category: "Danh mục",
+ wikilinks: "Liên kết wiki",
+ backlinks: "Liên kết ngược",
+ entities: "Thực thể",
+ businessRules: "Quy tắc nghiệp vụ",
+ crossDomain: "Liên miền",
+ flows: "Luồng",
+ entryPoint: "Điểm vào",
+ steps: "Bước",
+ implementation: "Triển khai",
+ },
+ fileExplorer: {
+ analyzedFiles: "Tệp đã phân tích",
+ filesFromGraph: "tệp từ đồ thị tri thức hiện tại",
+ noFilePathsFound: "Không tìm thấy đường dẫn tệp.",
+ },
+ filterPanel: {
+ nodeTypes: "Loại node",
+ complexity: "Độ phức tạp",
+ layers: "Tầng",
+ edgeCategories: "Nhóm cạnh",
+ },
+ personaSelector: {
+ overview: "Tổng quan",
+ overviewDesc: "Góc nhìn kiến trúc tổng thể",
+ learn: "Học",
+ learnDesc: "Bảng điều khiển đầy đủ với hướng dẫn học",
+ deepDive: "Chuyên sâu",
+ deepDiveDesc: "Tập trung vào mã nguồn",
+ },
+ sidebar: {
+ info: "Thông tin",
+ files: "Tệp",
+ },
+ mobile: {
+ graph: "Đồ thị",
+ info: "Thông tin",
+ files: "Tệp",
+ },
+ drawer: {
+ controls: "Điều khiển",
+ dashboard: "Bảng điều khiển",
+ role: "Vai trò",
+ view: "Chế độ xem",
+ diffOverlay: "Lớp phủ diff",
+ nodeTypes: "Loại node",
+ layers: "Tầng",
+ tools: "Công cụ",
+ path: "Đường dẫn",
+ help: "Trợ giúp",
+ structural: "Cấu trúc",
+ domain: "Nghiệp vụ",
+ },
+ domainView: {
+ backToDomains: "Quay lại các miền nghiệp vụ",
+ },
+ detailLevel: {
+ filesTitle: "Chỉ tệp — phụ thuộc cấp kiến trúc (nhanh)",
+ classesTitle: "Tệp + Lớp — cấu trúc mã với kế thừa",
+ files: "Tệp",
+ classes: "+Lớp",
+ fnTitle: "Bật/tắt node hàm (có thể làm chậm hiển thị)",
+ fn: "fn",
+ },
+ nodeTypeLabels: {
+ all: "Tất cả",
+ code: "Mã",
+ config: "Cấu hình",
+ docs: "Tài liệu",
+ infra: "Hạ tầng",
+ data: "Dữ liệu",
+ domain: "Nghiệp vụ",
+ knowledge: "Tri thức",
+ },
+ tokenGate: {
+ validating: "Đang xác thực...",
+ continue: "Tiếp tục",
+ },
+ diffToggle: {
+ hideOverlay: "Ẩn lớp phủ diff",
+ showOverlay: "Hiện lớp phủ diff",
+ noData: "Chưa có dữ liệu diff",
+ changed: "Đã thay đổi",
+ affected: "Bị ảnh hưởng",
+ },
+ learnPanel: {
+ finish: "Hoàn tất",
+ next: "Tiếp",
+ prev: "Trước",
+ noTour: "Không có tham quan nào",
+ noTourHint: "Tạo tham quan từ đồ thị tri thức để có hướng dẫn từng bước",
+ projectTour: "Tham quan dự án",
+ steps: "bước",
+ stepsTitle: "Các bước",
+ guidedWalkthrough: "Hướng dẫn từng bước khám phá codebase",
+ startTour: "Bắt đầu tham quan",
+ tour: "Tham quan",
+ exitTour: "Thoát tham quan",
+ },
+ layer: {
+ defaultName: "Tầng",
+ label: "tầng",
+ },
+ breadcrumb: {
+ projectOverview: "Tổng quan dự án",
+ project: "Dự án",
+ escBack: "Nhấn Esc để quay lại",
+ },
+ warningBanner: {
+ dropped: "Đã loại bỏ",
+ fatal: "Nghiêm trọng",
+ },
+ themePicker: {
+ changeTheme: "Đổi giao diện",
+ theme: "Giao diện",
+ accentColor: "Màu nhấn",
+ headingFont: "Phông tiêu đề",
+ serif: "Serif",
+ sans: "Sans",
+ mono: "Mono",
+ },
+ codeViewer: {
+ fullFile: "Toàn bộ tệp",
+ lines: "Dòng",
+ linesLabel: "dòng",
+ noFile: "Chưa chọn tệp",
+ loading: "Đang tải mã nguồn...",
+ openLarger: "Mở trình xem mã lớn hơn",
+ closeExpanded: "Đóng trình xem mã mở rộng",
+ closeViewer: "Đóng trình xem mã",
+ sourceUnavailable: "Không có mã nguồn",
+ rendered: "Đã kết xuất",
+ source: "Mã nguồn",
+ },
+ customNode: {
+ tested: "Đã kiểm thử",
+ hasTests: "Có kiểm thử",
+ },
+ ariaLabels: {
+ openMenu: "Mở menu",
+ closeMenu: "Đóng menu",
+ settings: "Cài đặt",
+ hideSearch: "Ẩn tìm kiếm",
+ showSearch: "Hiện tìm kiếm",
+ },
+ nodeTypeFilter: {
+ hide: "Ẩn",
+ show: "Hiện",
+ nodesLabel: "node",
+ },
+ keyboardShortcuts: {
+ showHelp: "Xem phím tắt",
+ general: "Chung",
+ navigation: "Điều hướng",
+ tour: "Tham quan",
+ view: "Chế độ xem",
+ focusSearch: "Tập trung vào thanh tìm kiếm",
+ nextStep: "Bước tham quan tiếp theo",
+ prevStep: "Bước tham quan trước",
+ toggleDiff: "Bật/tắt chế độ diff",
+ toggleFilter: "Bật/tắt bảng bộ lọc",
+ toggleExport: "Bật/tắt menu xuất",
+ openPathFinder: "Mở tìm đường dẫn",
+ title: "Phím tắt",
+ toggleHint: "Nhấn ? bất cứ lúc nào để bật/tắt trợ giúp này",
+ closeHint: "Nhấn ESC để đóng",
+ escapeDesc: "Đóng bảng và hộp thoại / quay lại tổng quan",
+ },
+ search: {
+ placeholder: "Tìm node theo tên, tóm tắt hoặc thẻ...",
+ fuzzy: "Fuzzy",
+ semantic: "Ngữ nghĩa",
+ result: "kết quả",
+ },
+ export: {
+ label: "Xuất",
+ title: "Xuất đồ thị (E)",
+ asPNG: "Xuất dạng PNG",
+ asSVG: "Xuất dạng SVG",
+ asJSON: "Xuất dạng JSON",
+ },
+ edgeLabels: {
+ imports: { forward: "nhập từ", backward: "được nhập bởi" },
+ exports: { forward: "xuất tới", backward: "được xuất bởi" },
+ contains: { forward: "chứa", backward: "nằm trong" },
+ inherits: { forward: "kế thừa từ", backward: "được kế thừa bởi" },
+ implements: { forward: "triển khai", backward: "được triển khai bởi" },
+ calls: { forward: "gọi", backward: "được gọi bởi" },
+ subscribes: { forward: "đăng ký", backward: "được đăng ký bởi" },
+ publishes: { forward: "phát tới", backward: "được tiêu thụ bởi" },
+ middleware: { forward: "middleware cho", backward: "dùng middleware" },
+ reads_from: { forward: "đọc từ", backward: "được đọc bởi" },
+ writes_to: { forward: "ghi tới", backward: "được ghi bởi" },
+ transforms: { forward: "biến đổi", backward: "được biến đổi bởi" },
+ validates: { forward: "xác thực", backward: "được xác thực bởi" },
+ depends_on: { forward: "phụ thuộc vào", backward: "được phụ thuộc bởi" },
+ tested_by: { forward: "được kiểm thử bởi", backward: "kiểm thử" },
+ configures: { forward: "cấu hình", backward: "được cấu hình bởi" },
+ related: { forward: "liên quan tới", backward: "liên quan tới" },
+ similar_to: { forward: "tương tự", backward: "tương tự" },
+ deploys: { forward: "triển khai", backward: "được triển khai bởi" },
+ serves: { forward: "phục vụ", backward: "được phục vụ bởi" },
+ migrates: { forward: "di trú", backward: "được di trú bởi" },
+ documents: { forward: "ghi lại", backward: "được ghi lại bởi" },
+ provisions: { forward: "cấp phát", backward: "được cấp phát bởi" },
+ routes: { forward: "định tuyến tới", backward: "được định tuyến từ" },
+ defines_schema: { forward: "định nghĩa schema cho", backward: "schema được định nghĩa bởi" },
+ triggers: { forward: "kích hoạt", backward: "được kích hoạt bởi" },
+ contains_flow: { forward: "chứa luồng", backward: "thuộc luồng" },
+ flow_step: { forward: "bước của luồng", backward: "bước thuộc" },
+ cross_domain: { forward: "liên miền tới", backward: "liên miền từ" },
+ cites: { forward: "trích dẫn", backward: "được trích dẫn bởi" },
+ contradicts: { forward: "mâu thuẫn với", backward: "bị mâu thuẫn bởi" },
+ builds_on: { forward: "dựa trên", backward: "được dựa trên bởi" },
+ exemplifies: { forward: "minh họa cho", backward: "được minh họa bởi" },
+ categorized_under: { forward: "được phân loại dưới", backward: "phân loại" },
+ authored_by: { forward: "được tạo bởi", backward: "tạo ra" },
+ },
+ pathFinder: {
+ title: "Tìm đường dẫn giữa các node (P)",
+ },
+ onboarding: {
+ header: "UNDERSTAND-ANYTHING · BẮT ĐẦU",
+ skipForever: "Không hiển thị lại",
+ prev: "Trước",
+ next: "Tiếp",
+ finish: "Bắt đầu khám phá",
+ steps: [
+ {
+ title: "Chào mừng đến với đồ thị tri thức",
+ body: "Những điểm và đường bạn thấy là các thực thể và quan hệ mà Understand-Anything trích xuất từ dự án này. Một node có thể là tệp, lớp hoặc hàm trong mã nguồn — hoặc một khái niệm, thực thể hay luận điểm từ wiki tri thức.",
+ hint: "Năm bước để nắm các thao tác cốt lõi",
+ },
+ {
+ title: "Ba chế độ xem ở trên cùng",
+ body: "Tổng quan hiển thị bức tranh lớn (bố cục lực). Học đi theo lộ trình học định sẵn. Chuyên sâu hiển thị thống kê theo loại và độ phức tạp. Mỗi chế độ trả lời một câu hỏi khác nhau.",
+ hint: "Xác định bạn đang hỏi gì trước khi chuyển chế độ",
+ },
+ {
+ title: "Tìm kiếm + nhấp vào một node",
+ body: "Ô tìm kiếm ở trên khớp mờ theo tên / tóm tắt / thẻ của node. Nhấp vào bất kỳ node nào để mở bảng bên phải với tóm tắt, các node lân cận và Mở bài viết.",
+ hint: "Tìm kiếm sẽ căn giữa và làm nổi bật; nhấp vào node sẽ làm nổi bật các cạnh của nó",
+ },
+ {
+ title: "Chuyển tầng + Tham quan dự án",
+ body: "Các tab tầng cạnh Tất cả lọc đồ thị theo một danh mục, lấy từ index.md. Tham quan dự án ở bên phải dẫn bạn qua trình tự định sẵn của dự án.",
+ hint: "Dùng Tầng khi các node quá dày đặc; bắt đầu Tham quan khi bạn chưa biết điểm vào",
+ },
+ {
+ title: "Nhiều tính năng ẩn khác",
+ body: "Thanh trên cùng còn có Bộ lọc (theo loại / độ phức tạp), Xuất (xuất đồ thị), Đường dẫn (tìm đường đi giữa hai node) và Giao diện. Nhấn Shift + ? để xem toàn bộ phím tắt.",
+ hint: "Mở chúng khi cần — không cần nhớ hết ngay",
+ },
+ ],
+ },
+};
+
+export default vi;
diff --git a/understand-anything-plugin/skills/understand/SKILL.md b/understand-anything-plugin/skills/understand/SKILL.md
index cd22733c..778b800c 100644
--- a/understand-anything-plugin/skills/understand/SKILL.md
+++ b/understand-anything-plugin/skills/understand/SKILL.md
@@ -148,7 +148,7 @@ Determine whether to run a full analysis or incremental update.
3.6. **Language configuration:**
- Parse `$ARGUMENTS` for `--language <lang>` flag. If found, extract the language code.
- **Language code normalization:** Map friendly names to ISO codes:
- - `chinese` → `zh`, `japanese` → `ja`, `korean` → `ko`, `english` → `en`, `spanish` → `es`, `french` → `fr`, `german` → `de`, `portuguese` → `pt`, `russian` → `ru`, `arabic` → `ar`, etc.
+ - `chinese` → `zh`, `japanese` → `ja`, `korean` → `ko`, `english` → `en`, `spanish` → `es`, `french` → `fr`, `german` → `de`, `portuguese` → `pt`, `russian` → `ru`, `vietnamese` → `vi`, `arabic` → `ar`, etc.
- Locale variants: `zh-TW`, `zh-HK`, `zh-CN`, `pt-BR`, etc. are preserved as-is.
- If `--language` is NOT specified:
- **Stored preference wins.** If `$UA_DIR/config.json` has an `outputLanguage` field, set `$OUTPUT_LANGUAGE` to it and skip the rest.
diff --git a/understand-anything-plugin/skills/understand/locales/vi.md b/understand-anything-plugin/skills/understand/locales/vi.md
new file mode 100644
index 00000000..a77f7874
--- /dev/null
+++ b/understand-anything-plugin/skills/understand/locales/vi.md
@@ -0,0 +1,49 @@
+# Hướng dẫn xuất nội dung tiếng Việt (Vietnamese)
+
+Tệp này cung cấp hướng dẫn dành riêng cho tiếng Việt khi tạo nội dung đồ thị tri thức.
+
+## Quy ước đặt thẻ
+
+Dùng thẻ tiếng Việt hoặc thuật ngữ kỹ thuật tiếng Anh phổ biến:
+
+| Mẫu | Thẻ gợi ý |
+|---------|---------|
+| Tệp điểm vào | `điểm-vào`, `barrel`, `exports` hoặc `entry-point` |
+| Hàm tiện ích | `tiện-ích`, `helpers`, `utility` |
+| Trình xử lý API | `api-handler`, `controller`, `endpoint` |
+| Mô hình dữ liệu | `mô-hình-dữ-liệu`, `entity`, `schema` hoặc `data-model` |
+| Tệp kiểm thử | `kiểm-thử`, `unit-test`, `test` |
+| Tệp cấu hình | `cấu-hình`, `build-system`, `configuration` |
+| Hạ tầng | `hạ-tầng`, `deployment`, `infrastructure` |
+| Tài liệu | `tài-liệu`, `guide`, `documentation` |
+
+**Chiến lược kết hợp:** giữ nguyên tiếng Anh cho thuật ngữ kỹ thuật phổ biến (`middleware`, `api-handler`...); có thể dùng tiếng Việt cho các thẻ mang tính mô tả.
+
+## Phong cách tóm tắt
+
+Viết tóm tắt 1-2 câu bằng tiếng Việt:
+- Mô tả **mục đích** và **vai trò** của tệp
+- Dùng câu chủ động ("Cung cấp...", "Xử lý...", "Quản lý...")
+- Tránh lặp lại tên tệp
+
+**Ví dụ:**
+- Tốt: "Cung cấp các hàm tiện ích định dạng ngày và làm sạch chuỗi được dùng trong toàn bộ tầng API."
+- Chưa tốt: "Tệp utils chứa các hàm tiện ích."
+
+## Thuật ngữ kỹ thuật
+
+Giữ nguyên tiếng Anh cho các thuật ngữ sau (khi không có bản dịch chuẩn):
+- `middleware`, `hook`, `barrel`, `entry-point`
+- `ORM`, `REST API`, `CI/CD`, `CRUD`
+- `singleton`, `factory`, `observer`
+- `interceptor`, `guard`
+
+## Tên tầng
+
+Dùng tên tầng tiếng Việt:
+- `Tầng API`, `Tầng dịch vụ`, `Tầng dữ liệu`, `Tầng giao diện`
+- `Hạ tầng`, `Cấu hình`, `Tài liệu`
+- `Tầng tiện ích`, `Tầng middleware`, `Tầng kiểm thử`
+
+Hoặc giữ nguyên tiếng Anh (theo quy ước của nhóm):
+- `API Layer`, `Service Layer`, `Data Layer`