feat: add Vietnamese (vi) localization support
This commit is contained in:
LeHaiDang
@@ -4,6 +4,8 @@
|
|||||||
|
|
||||||
[English README](README.md)
|
[English README](README.md)
|
||||||
[简体中文 README](README.zh-CN.md)
|
[简体中文 README](README.zh-CN.md)
|
||||||
|
[Tiếng Việt README](README.vi.md)
|
||||||
|
|
||||||
|
|
||||||
## インストール
|
## インストール
|
||||||
|
|
||||||
|
|||||||
@@ -4,6 +4,8 @@
|
|||||||
|
|
||||||
[简体中文 README](README.zh-CN.md)
|
[简体中文 README](README.zh-CN.md)
|
||||||
[日本語 README](README.ja-JP.md)
|
[日本語 README](README.ja-JP.md)
|
||||||
|
[Tiếng Việt README](README.vi.md)
|
||||||
|
|
||||||
|
|
||||||
## Install
|
## Install
|
||||||
|
|
||||||
|
|||||||
+593
@@ -0,0 +1,593 @@
|
|||||||
|
# 🐳 CodeWhale
|
||||||
|
|
||||||
|
> **Agent lập trình gốc terminal dành cho DeepSeek V4. Chương trình chạy từ lệnh `codewhale`, hỗ trợ stream các khối suy nghĩ (reasoning blocks), chỉnh sửa workspace cục bộ thông qua các lớp phê duyệt, và đi kèm chế độ tự động để tự chọn mô hình cũng như mức độ suy nghĩ phù hợp cho mỗi lượt.**
|
||||||
|
|
||||||
|
[English README](README.md)
|
||||||
|
[简体中文 README](README.zh-CN.md)
|
||||||
|
[日本語 README](README.ja-JP.md)
|
||||||
|
|
||||||
|
## Cài đặt
|
||||||
|
|
||||||
|
`codewhale` được cài đặt dưới dạng một cặp binary tự chạy bằng Rust đồng bộ với nhau:
|
||||||
|
Lệnh điều phối `codewhale` (dispatcher) và môi trường chạy giao diện `codewhale-tui` (runtime) do nó khởi chạy để thực hiện các phiên làm việc tương tác. Các trình quản lý gói như npm, Homebrew, và Docker sẽ tự động cài đặt cả hai cho bạn; đối với Cargo hoặc cài đặt thủ công, bạn phải đặt cả hai tệp binary này trong cùng một thư mục (thông thường là một thư mục nằm trong biến môi trường `PATH` của bạn). Gói npm chỉ là một trình cài đặt/bao bọc (wrapper) cho các tệp binary phát hành này; agent không chạy trên môi trường Node.js.
|
||||||
|
|
||||||
|
```bash
|
||||||
|
# 1. npm — dễ nhất nếu bạn đã cài đặt Node. Gói này sẽ tự động tải các
|
||||||
|
# binary Rust dựng sẵn tương ứng từ GitHub Releases.
|
||||||
|
npm install -g codewhale
|
||||||
|
|
||||||
|
# 2. Cargo — không cần Node. Yêu cầu phiên bản Rust từ 1.88 trở lên (các crate sử dụng
|
||||||
|
# phiên bản Rust edition 2024; các toolchain cũ hơn sẽ báo lỗi "feature `edition2024` is
|
||||||
|
# required"). Hãy chạy lệnh `rustup update` trước, hoặc sử dụng các cách cài đặt không qua Cargo ở dưới.
|
||||||
|
cargo install codewhale-cli --locked # cài đặt `codewhale` (điểm truy cập CLI chính)
|
||||||
|
cargo install codewhale-tui --locked # cài đặt `codewhale-tui` (giao diện TUI)
|
||||||
|
|
||||||
|
# 3. Homebrew — trình quản lý gói dành cho macOS.
|
||||||
|
# Tên tap/formula là tên cũ (legacy); nó sẽ cài đặt cả codewhale và codewhale-tui.
|
||||||
|
brew tap Hmbown/deepseek-tui
|
||||||
|
brew install deepseek-tui
|
||||||
|
|
||||||
|
# 4. Tải xuống trực tiếp — các gói lưu trữ theo nền tảng từ GitHub Releases.
|
||||||
|
# https://github.com/Hmbown/CodeWhale/releases
|
||||||
|
# Gói nén bao gồm cả codewhale và codewhale-tui cùng một tập lệnh cài đặt.
|
||||||
|
# Các binary riêng lẻ cũng được đính kèm cho các tập lệnh; hãy giữ cặp này ở cùng một nơi.
|
||||||
|
|
||||||
|
# 5. Docker — hình ảnh phát hành dựng sẵn.
|
||||||
|
docker volume create codewhale-home
|
||||||
|
docker run --rm -it \
|
||||||
|
-e DEEPSEEK_API_KEY="$DEEPSEEK_API_KEY" \
|
||||||
|
-v codewhale-home:/home/codewhale/.codewhale \
|
||||||
|
-v "$PWD:/workspace" \
|
||||||
|
-w /workspace \
|
||||||
|
ghcr.io/hmbown/codewhale:latest
|
||||||
|
```
|
||||||
|
|
||||||
|
> Tại Trung Quốc đại lục, bạn có thể tăng tốc độ tải qua npm bằng tham số
|
||||||
|
> `--registry=https://registry.npmmirror.com`, hoặc sử dụng
|
||||||
|
> [Cargo mirror](#china--cai-dat-than-thien-qua-mirror) bên dưới.
|
||||||
|
>
|
||||||
|
> An toàn tải xuống: Các binary phát hành chính thức chỉ nằm tại
|
||||||
|
> `https://github.com/Hmbown/CodeWhale/releases`. Nếu tải thủ công,
|
||||||
|
> vui lòng xác minh mã băm SHA-256 manifest và tránh các kho lưu trữ giả mạo hoặc các
|
||||||
|
> trang web mirror trên kết quả tìm kiếm. Xem [an toàn tải xuống và mã xác thực](docs/INSTALL.md#2-download-safety-and-checksums).
|
||||||
|
|
||||||
|
Đã cài đặt từ trước? Sử dụng lệnh cập nhật tương ứng với cách bạn đã cài đặt:
|
||||||
|
|
||||||
|
```bash
|
||||||
|
codewhale update # trình cập nhật binary phát hành trực tiếp
|
||||||
|
npm install -g codewhale@latest # thông qua trình bao bọc npm
|
||||||
|
brew update && brew upgrade deepseek-tui
|
||||||
|
cargo install codewhale-cli --locked --force
|
||||||
|
cargo install codewhale-tui --locked --force
|
||||||
|
```
|
||||||
|
|
||||||
|
[](https://github.com/Hmbown/CodeWhale/actions/workflows/ci.yml)
|
||||||
|
[](https://www.npmjs.com/package/codewhale)
|
||||||
|
[](https://crates.io/crates/codewhale-cli)
|
||||||
|
[Mục lục dự án DeepWiki](https://deepwiki.com/Hmbown/CodeWhale)
|
||||||
|
|
||||||
|
|
||||||
|
|
||||||
|
---
|
||||||
|
|
||||||
|
## CodeWhale là gì?
|
||||||
|
|
||||||
|
Mô hình AI chỉ trả lời câu hỏi. Agent hoàn thành một nhiệm vụ. Sự khác biệt nằm ở
|
||||||
|
**khung ràng buộc (harness)** — một hệ thống các quy tắc, bằng chứng và phản hồi giúp giữ cho
|
||||||
|
mô hình đi đúng hướng thay vì bị trôi lệch mục tiêu.
|
||||||
|
|
||||||
|
CodeWhale chính là khung ràng buộc đó, được xây dựng xung quanh DeepSeek V4 và được dẫn dắt bởi ba ý tưởng chính:
|
||||||
|
|
||||||
|
| Nguyên tắc | Cách thức hoạt động |
|
||||||
|
|---|---|
|
||||||
|
| **Bắt đầu với sự tin tưởng** | Mỗi lượt bắt đầu bằng chữ "A" — tìm kiếm khả năng trước khi khẳng định chắc chắn, chú trọng chất lượng trước sự tiện lợi |
|
||||||
|
| **Thẩm quyền rõ ràng** | Một bản Hiến pháp bằng văn bản với chín cấp bậc thẩm quyền. Ý định của người dùng quan trọng hơn các hướng dẫn cũ kỹ. Sự xác minh quan trọng hơn sự tự tin. |
|
||||||
|
| **Cải tiến đệ quy** | V4 đã tham gia viết nên một phần của khung ràng buộc này. Khi khung ràng buộc tốt lên, V4 hoạt động hiệu quả hơn — và giúp cải tiến khung ràng buộc hơn nữa. Mỗi lượt chạy mới đều bắt đầu mạnh mẽ hơn. |
|
||||||
|
|
||||||
|
Dự án này là mã nguồn mở, hoạt động trực tiếp trên terminal và được đóng gói thành một cặp binary Rust đồng bộ là `codewhale` / `codewhale-tui`.
|
||||||
|
|
||||||
|
## Khung Ràng Buộc Hoạt Động Thế Nào?
|
||||||
|
|
||||||
|
Các mô hình dạng Agent phải xử lý lượng thông tin xung đột rất lớn trên quy mô lớn: ý định của người dùng, quy tắc dự án, cấu hình mặc định của hệ thống, đầu ra của công cụ và bộ nhớ cũ đều cạnh tranh thẩm quyền trong một lượt chạy duy nhất. LLM hoạt động như một thẩm phán cần có thẩm quyền rõ ràng — nguồn thông tin nào sẽ thắng thế khi xảy ra xung đột?
|
||||||
|
|
||||||
|
CodeWhale giải quyết vấn đề này bằng một bản **Hiến pháp** (`prompts/base.md`). Đây là một hệ thống phân cấp luật chính thức — Điều VII xếp hạng chín nguồn thông tin từ các điều khoản của chính Hiến pháp xuống đến thông tin bàn giao từ phiên làm việc trước. Tin nhắn hiện tại của người dùng có thẩm quyền cao hơn các hướng dẫn dự án cũ kỹ. Đầu ra trực tiếp từ công cụ có thẩm quyền cao hơn các giả định. Việc xác minh thực tế có thẩm quyền cao hơn sự tự tin của mô hình. Mô hình kế thừa một chuỗi thẩm quyền rõ ràng qua từng lượt và không bao giờ phải đoán xem nên làm theo chỉ thị nào.
|
||||||
|
|
||||||
|
Có bảy điều khoản đứng đầu hệ thống phân cấp này, định nghĩa danh tính, nghĩa vụ và quyền hạn của mô hình: yêu cầu xác minh (Điều V — mọi hành động phải để lại bằng chứng thực tế, không bao giờ tuyên bố thành công dựa trên niềm tin mơ hồ), di sản điều phối (Điều VI — giữ cho workspace dễ đọc để trí tuệ tiếp theo có thể tiếp quản), và điều khoản ưu tiên sự thật (Điều II — không có quy tắc cấp dưới nào được phép ghi đè lên nó).
|
||||||
|
|
||||||
|
Bộ nhớ đệm tiền tố (prefix caching) của DeepSeek V4 làm cho điều này trở nên khả thi và thực tế. Bản Hiến pháp rất dài và chi tiết, nhưng một khi đã được cache, nó sẽ tốn ít hơn khoảng 100 lần chi phí cho mỗi lượt so với một lần đọc mới hoàn toàn. Mô hình tham chiếu nó một cách đệ quy — xem qua, quét và truy vấn thông qua các phiên RLM — truy cập lại thông tin theo nhu cầu thay vì chỉ dựa trên một lượt ghi nhớ duy nhất. Nó hoạt động giống như một bài kiểm tra mở sách hơn là kiểm tra đóng sách.
|
||||||
|
|
||||||
|
Bởi vì cấu trúc thẩm quyền là tường minh, các lỗi và thất bại không bao giờ bị che giấu. Các mã thoát (exit codes) khác không, lỗi kiểu dữ liệu từ rust-analyzer trả về giữa các lượt, từ chối của sandbox — tất cả đều được đưa ngược lại như các vectơ sửa lỗi. Mô hình sử dụng chính sự chệch hướng của mình để tự sửa sai.
|
||||||
|
|
||||||
|
Ba chế độ kiểm soát không gian hành động: **Plan** là chế độ chỉ đọc. **Agent** chặn các thao tác can thiệp thay đổi file đằng sau quyền phê duyệt của người dùng. **YOLO** tự động phê duyệt tất cả các công cụ trong các workspace đáng tin cậy. Chế độ Sandbox hoạt động trên macOS Seatbelt; Linux Landlock đã được phát hiện nhưng chưa được áp dụng bắt buộc; chế độ sandboxing trên Windows hiện chưa được hỗ trợ.
|
||||||
|
|
||||||
|
**Fin** — một cuộc gọi Flash giá rẻ và tắt chức năng suy nghĩ — xử lý việc tự động định tuyến mô hình cho mỗi lượt. Tham số mặc định là `--model auto`.
|
||||||
|
|
||||||
|
Mỗi lượt chạy đều ghi lại một ảnh chụp nhanh side-git bên ngoài thư mục `.git` của repo. Các lệnh `/restore` và `revert_turn` giúp khôi phục nhanh workspace về trạng thái trước đó.
|
||||||
|
|
||||||
|
Các sub-agent chạy đồng thời (tối đa 20). Lệnh `agent_open` trả về kết quả ngay lập tức; kết quả trả về nội tuyến dưới dạng các sentinel hoàn thành kèm theo bản tóm tắt. Nhật ký chi tiết của sub-agent được lưu trữ và truy cập thông qua `agent_eval`. Xem chi tiết tại [docs/SUBAGENTS.md](docs/SUBAGENTS.md).
|
||||||
|
|
||||||
|
Các tính năng khác của hệ thống bao gồm: chẩn đoán lỗi LSP sau mỗi lần chỉnh sửa file (rust-analyzer, pyright, typescript-language-server, gopls, clangd), các phiên làm việc RLM để phân tích hàng loạt, giao thức MCP, API runtime HTTP/SSE, hàng đợi tác vụ liên tục, adapter ACP cho trình soạn thảo Zed, xuất kết quả định dạng SWE-bench và theo dõi chi phí trực tiếp với bảng phân tích chi tiết lượt hit/miss cache.
|
||||||
|
|
||||||
|
---
|
||||||
|
|
||||||
|
## Khung Kết Nối (Harness)
|
||||||
|
|
||||||
|
`codewhale` (CLI điều phối) → `codewhale-tui` (binary giao diện) → giao diện ratatui ↔ công cụ bất đồng bộ ↔ máy khách streaming tương thích với OpenAI. Các lượt gọi công cụ được định tuyến qua một registry có phân loại (shell, thao tác file, git, web, sub-agent, MCP, RLM) và kết quả được truyền trực tuyến trở lại transcript. Công cụ quản lý trạng thái phiên làm việc, theo dõi lượt chạy, hàng đợi tác vụ bền bỉ và một phân hệ LSP cung cấp thông tin chẩn đoán sau khi chỉnh sửa vào ngữ cảnh của mô hình trước bước suy nghĩ tiếp theo.
|
||||||
|
|
||||||
|
Xem tài liệu [docs/ARCHITECTURE.md](docs/ARCHITECTURE.md) để biết chi tiết toàn bộ luồng hoạt động.
|
||||||
|
|
||||||
|
### Sub-agents: Khởi chạy Tác vụ Nền Đồng thời
|
||||||
|
|
||||||
|
CodeWhale có thể điều phối nhiều sub-agent chạy song song — hoạt động giống như một hàng đợi tác vụ đồng thời:
|
||||||
|
|
||||||
|
- **Khởi chạy không chặn:** Lệnh `agent_open` trả về ngay lập tức. Sub-agent con có một ngữ cảnh độc lập mới và hệ thống đăng ký công cụ riêng để chạy tự chủ. Agent cha vẫn tiếp tục làm việc bình thường.
|
||||||
|
- **Thực thi dưới nền:** Các sub-agent chạy đồng thời (giới hạn mặc định: 10, có thể cấu hình lên đến 20). Hệ thống tự quản lý pool tài nguyên này mà không cần vòng lặp thăm dò (polling loop).
|
||||||
|
- **Thông báo hoàn thành:** Khi một sub-agent hoàn thành, hệ thống sẽ chèn một khóa sentinel `<codewhale:subagent.done>` vào transcript của agent cha. Một bản tóm tắt thân thiện với con người — bao gồm phát hiện của sub-agent con, các file đã thay đổi và các rủi ro có thể xảy ra — nằm ngay dòng phía trên khóa sentinel. Mô hình cha sẽ đọc tóm tắt đó và tích hợp kết quả thu được mà không cần phải thực hiện thêm bất kỳ lệnh gọi công cụ nào khác.
|
||||||
|
- **Truy xuất kết quả có giới hạn:** Nhật ký chi tiết của agent con nằm dưới dạng một `transcript_handle` có thể truy cập qua `agent_eval`. Khi bản tóm tắt là chưa đủ, agent cha có thể gọi `handle_read` để đọc một phần, các dòng cụ thể hoặc lọc qua JSONPath — giúp ngữ cảnh của agent cha luôn tinh gọn mà không làm mất đi các chi tiết quan trọng.
|
||||||
|
|
||||||
|
Xem thêm tài liệu [docs/SUBAGENTS.md](docs/SUBAGENTS.md) để tham khảo thông tin đầy đủ về sub-agent.
|
||||||
|
|
||||||
|
---
|
||||||
|
|
||||||
|
## Khởi động nhanh
|
||||||
|
|
||||||
|
```bash
|
||||||
|
npm install -g codewhale
|
||||||
|
codewhale --version
|
||||||
|
codewhale --model auto
|
||||||
|
```
|
||||||
|
|
||||||
|
Cặp binary dựng sẵn và gói nén nền tảng được phát hành cho các kiến trúc **Linux x64**, **Linux ARM64** (từ v0.8.8 trở lên), **macOS x64**, **macOS ARM64**, và **Windows x64**. Đối với các mục tiêu khác (musl, riscv64, FreeBSD, v.v.), xem phần [Cài đặt từ nguồn](#install-from-source) hoặc tài liệu [docs/INSTALL.md](docs/INSTALL.md).
|
||||||
|
|
||||||
|
Trong lần chạy đầu tiên, bạn sẽ được nhắc nhập [API key của DeepSeek](https://platform.deepseek.com/api_keys). Khóa này được lưu vào tệp cấu hình `~/.codewhale/config.toml` (tương thích cả tệp cũ `~/.deepseek/config.toml`) để nó hoạt động từ bất kỳ thư mục nào mà không cần nhắc thông tin đăng nhập của hệ điều hành.
|
||||||
|
|
||||||
|
Bạn cũng có thể thiết lập trước:
|
||||||
|
|
||||||
|
```bash
|
||||||
|
codewhale auth set --provider deepseek # lưu vào ~/.codewhale/config.toml
|
||||||
|
codewhale auth status # hiển thị nguồn thông tin đăng nhập đang hoạt động
|
||||||
|
|
||||||
|
export DEEPSEEK_API_KEY="YOUR_KEY" # cách thiết lập qua biến môi trường thay thế; sử dụng ~/.zshenv cho terminal không tương tác
|
||||||
|
codewhale
|
||||||
|
|
||||||
|
codewhale doctor # kiểm tra và xác minh thiết lập
|
||||||
|
```
|
||||||
|
|
||||||
|
Nếu lệnh `codewhale doctor` báo lỗi API key bị từ chối đến từ biến môi trường `DEEPSEEK_API_KEY`, hãy xóa cấu hình xuất biến môi trường cũ trong tệp khởi chạy shell của bạn, mở một shell mới hoặc chạy lệnh `codewhale auth set --provider deepseek`. Sử dụng `codewhale auth status` để xem trạng thái của cấu hình, keyring hệ thống và biến môi trường mà không hiển thị trực tiếp khóa API. Các khóa lưu trong file cấu hình sẽ được ưu tiên cao hơn keyring và môi trường để dễ dàng thay đổi khi cần.
|
||||||
|
|
||||||
|
> Để thay đổi hoặc xóa khóa đã lưu: `codewhale auth clear --provider deepseek`.
|
||||||
|
|
||||||
|
### Tencent Cloud / CNB Remote-First Path
|
||||||
|
|
||||||
|
Đối với không gian làm việc luôn trực tuyến mà bạn có thể điều khiển từ điện thoại, hãy sử dụng đường dẫn gốc của Tencent: CNB mirror/source, Tencent Lighthouse HK, cầu kết nối dài hạn Feishu/Lark, và EdgeOne tùy chọn cho một cổng HTTPS công cộng có kiểm soát. API runtime luôn được giới hạn chạy tại localhost; EdgeOne không được sử dụng để hiển thị công khai đường dẫn `/v1/*`.
|
||||||
|
|
||||||
|
Bắt đầu với tài liệu [docs/TENCENT_CLOUD_REMOTE_FIRST.md](docs/TENCENT_CLOUD_REMOTE_FIRST.md), sau đó xem thêm tài liệu [docs/TENCENT_LIGHTHOUSE_HK.md](docs/TENCENT_LIGHTHOUSE_HK.md) để biết các vận hành máy chủ.
|
||||||
|
|
||||||
|
### Chế độ Tự động (Auto Mode)
|
||||||
|
|
||||||
|
Sử dụng `codewhale --model auto` hoặc gõ lệnh `/model auto` khi bạn muốn hệ thống tự động quyết định sức mạnh của mô hình và cấp độ suy nghĩ cần thiết cho mỗi lượt.
|
||||||
|
|
||||||
|
Chế độ tự động điều khiển hai cài đặt cùng nhau:
|
||||||
|
|
||||||
|
- Mô hình: `deepseek-v4-flash` hoặc `deepseek-v4-pro`
|
||||||
|
- Cấp độ suy nghĩ: `off`, `high`, hoặc `max`
|
||||||
|
|
||||||
|
Trước khi lượt gửi chính thức được thực hiện, ứng dụng sẽ thực hiện một cuộc gọi định tuyến nhỏ thông qua mô hình `deepseek-v4-flash` tắt chế độ suy nghĩ. Trình định tuyến đó sẽ đánh giá yêu cầu mới nhất và ngữ cảnh gần đây, từ đó chọn mô hình cụ thể và cấp độ suy nghĩ phù hợp cho lượt gọi thực tế. Các lượt tương tác ngắn/đơn giản sẽ được chạy trên mô hình Flash tắt suy nghĩ; các công việc lập trình phức tạp, gỡ lỗi, phát hành, kiến trúc phần mềm, kiểm tra bảo mật hoặc các tác vụ nhiều bước mơ hồ sẽ được đẩy lên mô hình Pro với cấp độ suy nghĩ cao hơn.
|
||||||
|
|
||||||
|
Cơ chế `auto` hoạt động hoàn toàn cục bộ trên máy của bạn. API ở máy chủ upstream không bao giờ nhận được chuỗi `model: "auto"`; nó luôn nhận được mô hình cụ thể và cấu hình suy nghĩ đã được chọn cho lượt chạy đó. Giao diện TUI hiển thị tuyến đường định tuyến được chọn và bộ theo dõi chi phí sẽ tính tiền cho mô hình thực tế đã chạy. Nếu cuộc gọi định tuyến thất bại hoặc trả về câu trả lời không hợp lệ, ứng dụng sẽ chuyển sang thuật toán phỏng đoán cục bộ. Các sub-agent con sẽ kế thừa chế độ tự động này trừ khi bạn chỉ định rõ một mô hình cho chúng.
|
||||||
|
|
||||||
|
Hãy chỉ định mô hình hoặc cấp độ suy nghĩ cố định nếu bạn muốn chạy benchmark lặp lại nhất quán, kiểm soát nghiêm ngặt chi phí trần hoặc có cấu hình ánh xạ nhà cung cấp/mô hình tùy chỉnh cụ thể.
|
||||||
|
|
||||||
|
### Linux ARM64 (Raspberry Pi, Asahi, Graviton, HarmonyOS PC)
|
||||||
|
|
||||||
|
Lệnh cài đặt `npm i -g codewhale` hoạt động trên môi trường Linux ARM64 nền glibc từ phiên bản v0.8.8 trở đi. Bạn cũng có thể tải trực tiếp các tệp binary dựng sẵn từ [trang phát hành Releases](https://github.com/Hmbown/CodeWhale/releases) và đặt chúng cạnh nhau trong một thư mục thuộc biến `PATH`.
|
||||||
|
|
||||||
|
### Cài đặt thân thiện qua Mirror (Tại Trung Quốc)
|
||||||
|
|
||||||
|
Nếu việc tải xuống từ GitHub hoặc npm bị chậm từ Trung Quốc đại lục, bạn hãy sử dụng mirror registry cho Cargo:
|
||||||
|
|
||||||
|
```toml
|
||||||
|
# ~/.cargo/config.toml
|
||||||
|
[source.crates-io]
|
||||||
|
replace-with = "tuna"
|
||||||
|
|
||||||
|
[source.tuna]
|
||||||
|
registry = "sparse+https://mirrors.tuna.tsinghua.edu.cn/crates.io-index/"
|
||||||
|
```
|
||||||
|
|
||||||
|
Sau đó cài đặt cả hai binary (trình điều phối sẽ ủy quyền cho TUI tại thời điểm chạy):
|
||||||
|
|
||||||
|
```bash
|
||||||
|
cargo install codewhale-cli --locked # cung cấp lệnh `codewhale`
|
||||||
|
cargo install codewhale-tui --locked # cung cấp giao diện `codewhale-tui`
|
||||||
|
codewhale --version
|
||||||
|
```
|
||||||
|
|
||||||
|
Các binary dựng sẵn cũng có thể được tải từ [GitHub Releases](https://github.com/Hmbown/CodeWhale/releases). Thiết lập biến `DEEPSEEK_TUI_RELEASE_BASE_URL` để sử dụng mirror tải các tệp tài nguyên phát hành.
|
||||||
|
|
||||||
|
### Windows (Scoop)
|
||||||
|
|
||||||
|
[Scoop](https://scoop.sh) là một trình quản lý gói phổ biến trên Windows. Gói `codewhale` đã được liệt kê trong bucket chính của Scoop, tuy nhiên gói cài đặt này hoạt động độc lập và đôi khi cập nhật chậm hơn các bản phát hành chính thức trên GitHub/npm/Cargo. Chạy lệnh `scoop update` trước, sau đó xác minh phiên bản đã cài bằng `codewhale --version`:
|
||||||
|
|
||||||
|
```bash
|
||||||
|
scoop update
|
||||||
|
scoop install codewhale
|
||||||
|
codewhale --version
|
||||||
|
```
|
||||||
|
|
||||||
|
Vui lòng sử dụng phương pháp npm hoặc tải trực tiếp từ GitHub Releases nếu bạn muốn trải nghiệm phiên bản mới nhất trước khi Scoop cập nhật.
|
||||||
|
|
||||||
|
<details id="install-from-source">
|
||||||
|
<summary>Cài đặt từ mã nguồn</summary>
|
||||||
|
|
||||||
|
Cách này hoạt động trên bất kỳ kiến trúc mục tiêu Tier-1 nào được Rust hỗ trợ — bao gồm cả musl, riscv64, FreeBSD và các bản phân phối ARM64 Linux cũ.
|
||||||
|
|
||||||
|
```bash
|
||||||
|
# Các thư viện phụ thuộc để build trên Linux (Debian/Ubuntu/RHEL):
|
||||||
|
# sudo apt-get install -y build-essential pkg-config libdbus-1-dev
|
||||||
|
# sudo dnf install -y gcc make pkgconf-pkg-config dbus-devel
|
||||||
|
|
||||||
|
git clone https://github.com/Hmbown/CodeWhale.git
|
||||||
|
cd CodeWhale
|
||||||
|
|
||||||
|
cargo install --path crates/cli --locked # yêu cầu Rust 1.88+; cung cấp `codewhale`
|
||||||
|
cargo install --path crates/tui --locked # cung cấp giao diện `codewhale-tui`
|
||||||
|
```
|
||||||
|
|
||||||
|
Cả hai tệp binary đều bắt buộc phải cài đặt. Xem hướng dẫn biên dịch chéo và ghi chú riêng theo nền tảng tại: [docs/INSTALL.md](docs/INSTALL.md).
|
||||||
|
|
||||||
|
</details>
|
||||||
|
|
||||||
|
### Các Nhà Cung Cấp API Khác
|
||||||
|
|
||||||
|
Để xem danh sách đầy đủ tất cả các nhà cung cấp được hỗ trợ chính thức, bao gồm mã định danh mô hình, biến xác thực, URL cơ sở và ranh giới tính năng, xem thêm tài liệu [docs/PROVIDERS.md](docs/PROVIDERS.md).
|
||||||
|
|
||||||
|
```bash
|
||||||
|
# NVIDIA NIM
|
||||||
|
codewhale auth set --provider nvidia-nim --api-key "YOUR_NVIDIA_API_KEY"
|
||||||
|
codewhale --provider nvidia-nim
|
||||||
|
|
||||||
|
# AtlasCloud
|
||||||
|
codewhale auth set --provider atlascloud --api-key "YOUR_ATLASCLOUD_API_KEY"
|
||||||
|
codewhale --provider atlascloud
|
||||||
|
|
||||||
|
# Wanjie Ark
|
||||||
|
codewhale auth set --provider wanjie-ark --api-key "YOUR_WANJIE_API_KEY"
|
||||||
|
codewhale --provider wanjie-ark --model deepseek-reasoner
|
||||||
|
|
||||||
|
# OpenRouter
|
||||||
|
codewhale auth set --provider openrouter --api-key "YOUR_OPENROUTER_API_KEY"
|
||||||
|
codewhale --provider openrouter --model deepseek/deepseek-v4-pro
|
||||||
|
|
||||||
|
# Novita
|
||||||
|
codewhale auth set --provider novita --api-key "YOUR_NOVITA_API_KEY"
|
||||||
|
codewhale --provider novita --model deepseek/deepseek-v4-pro
|
||||||
|
|
||||||
|
# Fireworks
|
||||||
|
codewhale auth set --provider fireworks --api-key "YOUR_FIREWORKS_API_KEY"
|
||||||
|
codewhale --provider fireworks --model deepseek-v4-pro
|
||||||
|
|
||||||
|
# Các endpoint tương thích định dạng OpenAI chung
|
||||||
|
codewhale auth set --provider openai --api-key "YOUR_OPENAI_COMPATIBLE_API_KEY"
|
||||||
|
OPENAI_BASE_URL="https://openai-compatible.example/v4" codewhale --provider openai --model glm-5
|
||||||
|
|
||||||
|
# Tự host bằng SGLang
|
||||||
|
SGLANG_BASE_URL="http://localhost:30000/v1" codewhale --provider sglang --model deepseek-v4-flash
|
||||||
|
|
||||||
|
# Tự host bằng vLLM
|
||||||
|
VLLM_BASE_URL="http://localhost:8000/v1" codewhale --provider vllm --model deepseek-v4-flash
|
||||||
|
# Sử dụng vLLM qua kết nối HTTP trong mạng LAN đáng tin cậy
|
||||||
|
DEEPSEEK_ALLOW_INSECURE_HTTP=1 VLLM_BASE_URL="http://192.168.0.110:8000/v1" codewhale --provider vllm --model deepseek-v4-flash
|
||||||
|
|
||||||
|
# Tự host bằng Ollama
|
||||||
|
ollama pull codewhale-coder:1.3b
|
||||||
|
codewhale --provider ollama --model codewhale-coder:1.3b
|
||||||
|
```
|
||||||
|
|
||||||
|
Bên trong giao diện TUI, lệnh `/provider` mở bảng chọn nhà cung cấp và `/model` mở bảng chọn mô hình/cấp độ suy nghĩ cục bộ. Lệnh `/provider openrouter` và `/model <id>` chuyển đổi trực tiếp, trong khi lệnh `/models` sẽ truy vấn trực tiếp và hiển thị danh sách các mô hình API trực tuyến từ nhà cung cấp (nếu nhà cung cấp hỗ trợ tính năng liệt kê mô hình).
|
||||||
|
|
||||||
|
---
|
||||||
|
|
||||||
|
## Nhật ký thay đổi (Release Notes)
|
||||||
|
|
||||||
|
Chi tiết thay đổi giữa các phiên bản được cập nhật tại [CHANGELOG.md](CHANGELOG.md). File README này chỉ tập trung vào các đường dẫn cài đặt hiện tại, quy trình làm việc cốt lõi, thiết lập nhà cung cấp API, giao diện và các điểm mở rộng tính năng của dự án.
|
||||||
|
|
||||||
|
---
|
||||||
|
|
||||||
|
## Cách sử dụng
|
||||||
|
|
||||||
|
```bash
|
||||||
|
codewhale # giao diện tương tác TUI chính
|
||||||
|
codewhale "explain this function" # thực thi prompt nhanh một lượt
|
||||||
|
codewhale exec --auto --output-format stream-json "fix this bug" # truyền phát luồng dữ liệu NDJSON backend
|
||||||
|
codewhale exec --resume <SESSION_ID> "follow up" # tiếp tục phiên làm việc không tương tác cũ
|
||||||
|
codewhale --model deepseek-v4-flash "summarize" # ghi đè mô hình chạy chỉ định
|
||||||
|
codewhale --model auto "fix this bug" # tự động chọn mô hình và cấp độ suy nghĩ thích hợp
|
||||||
|
codewhale --yolo # tự động phê duyệt chạy các công cụ
|
||||||
|
codewhale auth set --provider deepseek # lưu trữ API key
|
||||||
|
codewhale doctor # tự động kiểm tra cài đặt và kết nối mạng
|
||||||
|
codewhale doctor --json # trả về chuẩn đoán định dạng máy đọc được
|
||||||
|
codewhale setup --status # chỉ đọc trạng thái thiết lập hiện tại
|
||||||
|
codewhale setup --tools --plugins # tạo sẵn cấu trúc thư mục tool/plugin
|
||||||
|
codewhale models # liệt kê các mô hình khả dụng trực tuyến
|
||||||
|
codewhale sessions # liệt kê các phiên làm việc đã lưu
|
||||||
|
codewhale resume --last # tiếp tục phiên làm việc gần nhất trong thư mục này
|
||||||
|
codewhale resume <SESSION_ID> # tiếp tục một phiên làm việc cụ thể theo mã UUID
|
||||||
|
codewhale fork <SESSION_ID> # tạo một nhánh (fork) phiên làm việc đã lưu sang đường dẫn mới
|
||||||
|
codewhale serve --http # khởi chạy máy chủ API định dạng HTTP/SSE
|
||||||
|
codewhale serve --acp # khởi chạy adapter ACP qua stdio cho trình soạn thảo Zed/agent tùy chỉnh
|
||||||
|
codewhale run pr <N> # tải PR về và nạp sẵn vào prompt đánh giá
|
||||||
|
codewhale mcp list # liệt kê các máy chủ MCP đã cấu hình
|
||||||
|
codewhale mcp validate # kiểm tra cấu hình và kết nối máy chủ MCP
|
||||||
|
codewhale mcp-server # khởi chạy máy chủ MCP điều phối qua cổng stdio
|
||||||
|
codewhale update # kiểm tra và cài đặt phiên bản binary mới nhất
|
||||||
|
```
|
||||||
|
|
||||||
|
### Tạo nhánh phiên làm việc (Branching)
|
||||||
|
|
||||||
|
Các phiên làm việc được lưu có thể được phân nhánh một cách có chủ đích. Lệnh `codewhale fork <SESSION_ID>` sao chép toàn bộ phiên làm việc cũ sang một phiên mới song song, lưu trữ mã ID của phiên cha trong siêu dữ liệu (metadata) và mở phiên fork đó ra để bạn có thể thử nghiệm hướng phát triển mới mà không làm ảnh hưởng đến lịch sử phiên làm việc gốc. Trình chọn phiên làm việc và danh sách `codewhale sessions` sẽ đánh dấu rõ ràng các phiên được fork kèm theo mã ID của phiên cha.
|
||||||
|
|
||||||
|
Bên trong giao diện TUI, bạn có thể nhấn phím `Esc` hai lần (`Esc-Esc`) để quay ngược lại transcript và đưa prompt cũ về lại phần soạn thảo để chỉnh sửa lại nội dung. Các lệnh `/restore` và `revert_turn` là công cụ khôi phục workspace độc lập: chúng khôi phục lại các tệp tin dựa trên ảnh chụp nhanh side-git nhưng không làm thay đổi hay ghi đè lịch sử trò chuyện của phiên làm việc.
|
||||||
|
|
||||||
|
Các hình ảnh Docker được phát hành lên GHCR cho các bản dựng phát hành chính thức:
|
||||||
|
|
||||||
|
```bash
|
||||||
|
docker volume create codewhale-home
|
||||||
|
|
||||||
|
docker run --rm -it \
|
||||||
|
-e DEEPSEEK_API_KEY="$DEEPSEEK_API_KEY" \
|
||||||
|
-v codewhale-home:/home/codewhale/.codewhale \
|
||||||
|
-v "$PWD:/workspace" \
|
||||||
|
-w /workspace \
|
||||||
|
ghcr.io/hmbown/codewhale:latest
|
||||||
|
```
|
||||||
|
|
||||||
|
Xem tài liệu [docs/DOCKER.md](docs/DOCKER.md) để biết thêm thông tin về thẻ phiên bản (pinned tags), cách tự dựng image cục bộ, lưu ý quyền sở hữu volume và cách sử dụng cho pipeline không tương tác.
|
||||||
|
|
||||||
|
### Zed / ACP
|
||||||
|
|
||||||
|
DeepSeek có thể chạy dưới dạng một máy chủ Agent Client Protocol (ACP) cục bộ cho các trình soạn thảo mã nguồn hỗ trợ giao tiếp ACP qua cổng stdio. Trong trình soạn thảo Zed, bạn hãy thêm cấu hình máy chủ agent tùy chỉnh sau:
|
||||||
|
|
||||||
|
```json
|
||||||
|
{
|
||||||
|
"agent_servers": {
|
||||||
|
"DeepSeek": {
|
||||||
|
"type": "custom",
|
||||||
|
"command": "codewhale",
|
||||||
|
"args": ["serve", "--acp"],
|
||||||
|
"env": {}
|
||||||
|
}
|
||||||
|
}
|
||||||
|
}
|
||||||
|
```
|
||||||
|
|
||||||
|
Phân hệ ACP ban đầu hỗ trợ khởi tạo phiên làm việc mới và nhận phản hồi prompt qua cấu hình và API key hiện tại của DeepSeek. Tính năng chỉnh sửa tích hợp công cụ và phát lại checkpoint hiện chưa được hỗ trợ qua giao diện ACP.
|
||||||
|
|
||||||
|
Adapter do cộng đồng phát triển: [acp-codewhale-adapter](https://github.com/rockeverm3m/acp-codewhale-adapter) hỗ trợ cầu nối lệnh `codewhale exec --auto` với `cc-connect` cho người dùng cần quy trình làm việc ACP có tích hợp công cụ bên ngoài trình soạn thảo Zed.
|
||||||
|
|
||||||
|
### Phím Tắt Tiêu Biểu
|
||||||
|
|
||||||
|
| Phím | Hành động |
|
||||||
|
|---|---|
|
||||||
|
| `Tab` | Hoàn thành gợi ý lệnh `/` hoặc các nhãn tệp `@`; khi đang chạy, xếp tin nhắn nháp vào hàng đợi chạy tiếp theo; hoặc chuyển đổi qua lại giữa các chế độ |
|
||||||
|
| `Shift+Tab` | Thay đổi nhanh cấp độ suy nghĩ: off → high → max |
|
||||||
|
| `F1` | Mở màn hình trợ giúp phím tắt có thanh tìm kiếm |
|
||||||
|
| `Esc` | Quay lại / đóng cửa sổ popup |
|
||||||
|
| `Ctrl+K` | Mở bảng lệnh nhanh (Command palette) |
|
||||||
|
| `Ctrl+R` | Tiếp tục một phiên làm việc cũ |
|
||||||
|
| `Alt+R` | Tìm kiếm lịch sử prompt cũ để khôi phục tin nháp đã xóa |
|
||||||
|
| `Ctrl+S` | Cất tin nháp hiện tại vào bộ nhớ tạm (dùng `/stash list`, `/stash pop` để lấy lại) |
|
||||||
|
| `@path` | Đính kèm ngữ cảnh file hoặc thư mục trực tiếp tại trình soạn thảo văn bản |
|
||||||
|
| `↑` (tại đầu composer) | Chọn hàng tệp tin đính kèm để xóa |
|
||||||
|
|
||||||
|
Xem danh sách phím tắt đầy đủ tại: [docs/KEYBINDINGS.md](docs/KEYBINDINGS.md).
|
||||||
|
|
||||||
|
---
|
||||||
|
|
||||||
|
## Chế độ hoạt động (Modes)
|
||||||
|
|
||||||
|
| Chế độ | Hành vi hoạt động |
|
||||||
|
| --- | --- |
|
||||||
|
| **Plan** 🔍 | Chế độ khảo sát chỉ đọc — mô hình tìm hiểu cấu trúc và đề xuất kế hoạch hành động cụ thể trước khi sửa đổi file; các cuộc khảo sát nhiều bước sử dụng công cụ `checklist_write` |
|
||||||
|
| **Agent** 🤖 | Chế độ tương tác mặc định — thực thi tác vụ nhiều bước có kiểm soát đằng sau các cổng phê duyệt; các tác vụ lớn sẽ được theo dõi qua `checklist_write` |
|
||||||
|
| **YOLO** ⚡ | Tự động phê duyệt tất cả các lệnh gọi công cụ trong các workspace tin cậy; các tác vụ nhiều bước vẫn duy trì checklist hiển thị trực quan |
|
||||||
|
|
||||||
|
---
|
||||||
|
|
||||||
|
## Cấu hình
|
||||||
|
|
||||||
|
Cấu hình của người dùng lưu tại: `~/.codewhale/config.toml` (tự động fallback về tệp cũ `~/.deepseek/config.toml` nếu có). Cấu hình riêng của dự án ghi đè tại: `<workspace>/.codewhale/config.toml` (hoặc `<workspace>/.deepseek/config.toml`) (lưu ý các trường sau bị cấm ghi đè ở cấp dự án: `api_key`, `base_url`, `provider`, `mcp_config_path`). Tham khảo tệp [config.example.toml](config.example.toml) để xem đầy đủ tất cả cấu hình mẫu.
|
||||||
|
|
||||||
|
Các biến môi trường chính:
|
||||||
|
|
||||||
|
| Biến môi trường | Mục đích sử dụng |
|
||||||
|
|---|---|
|
||||||
|
| `DEEPSEEK_API_KEY` | Khóa API key chính |
|
||||||
|
| `DEEPSEEK_BASE_URL` | Địa chỉ URL cơ sở của máy chủ API |
|
||||||
|
| `DEEPSEEK_HTTP_HEADERS` | Các header tùy chỉnh gửi kèm yêu cầu API, ví dụ `X-Model-Provider-Id=your-model-provider` |
|
||||||
|
| `DEEPSEEK_MODEL` | Mô hình mặc định |
|
||||||
|
| `DEEPSEEK_STREAM_IDLE_TIMEOUT_SECS` | Thời gian chờ tối đa khi stream bị rảnh (giây), mặc định là `300`, giới hạn trong khoảng `1..=3600` |
|
||||||
|
| `CODEWHALE_PROVIDER` / `DEEPSEEK_PROVIDER` | Các nhà cung cấp: `deepseek` (mặc định), `nvidia-nim`, `openai`, `atlascloud`, `wanjie-ark`, `openrouter`, `novita`, `fireworks`, `moonshot`, `sglang`, `vllm`, `ollama` |
|
||||||
|
| `DEEPSEEK_PROFILE` | Tên cấu hình profile sử dụng |
|
||||||
|
| `DEEPSEEK_MEMORY` | Thiết lập là `on` để kích hoạt tính năng tự ghi nhớ thông tin người dùng |
|
||||||
|
| `DEEPSEEK_ALLOW_INSECURE_HTTP=1` | Cho phép sử dụng các đường dẫn API dạng `http://` không mã hóa trong các mạng LAN tin cậy |
|
||||||
|
| `NVIDIA_API_KEY` / `OPENAI_API_KEY` / `ATLASCLOUD_API_KEY` / `WANJIE_ARK_API_KEY` / `OPENROUTER_API_KEY` / `NOVITA_API_KEY` / `FIREWORKS_API_KEY` / `MOONSHOT_API_KEY` / `KIMI_API_KEY` / `SGLANG_API_KEY` / `VLLM_API_KEY` / `OLLAMA_API_KEY` | Thông tin đăng nhập theo từng nhà cung cấp tương ứng |
|
||||||
|
| `OPENAI_BASE_URL` / `OPENAI_MODEL` | Điểm cuối (endpoint) và mã mô hình cho nhà cung cấp tương thích định dạng OpenAI chung |
|
||||||
|
| `ATLASCLOUD_BASE_URL` / `ATLASCLOUD_MODEL` | Endpoint và mô hình ghi đè cho AtlasCloud |
|
||||||
|
| `WANJIE_ARK_BASE_URL` / `WANJIE_ARK_MODEL` | Endpoint và mô hình ghi đè cho Wanjie Ark |
|
||||||
|
| `OPENROUTER_BASE_URL` | Endpoint ghi đè cho OpenRouter |
|
||||||
|
| `NOVITA_BASE_URL` | Endpoint ghi đè cho Novita |
|
||||||
|
| `FIREWORKS_BASE_URL` | Endpoint ghi đè cho Fireworks |
|
||||||
|
| `SGLANG_BASE_URL` | Endpoint cho máy chủ SGLang tự host |
|
||||||
|
| `SGLANG_MODEL` | Mã mô hình cho máy chủ SGLang tự host |
|
||||||
|
| `VLLM_BASE_URL` | Endpoint cho máy chủ vLLM tự host |
|
||||||
|
| `VLLM_MODEL` | Mã mô hình cho máy chủ vLLM tự host |
|
||||||
|
| `OLLAMA_BASE_URL` | Endpoint cho máy chủ Ollama tự host |
|
||||||
|
| `OLLAMA_MODEL` | Thẻ mô hình (model tag) cho máy chủ Ollama tự host |
|
||||||
|
| `NO_ANIMATIONS=1` | Bắt buộc chạy ở chế độ hỗ trợ khả năng tiếp cận (Accessibility mode), tắt hiệu ứng khi khởi động |
|
||||||
|
| `SSL_CERT_FILE` | Đường dẫn file CA bundle tùy chỉnh khi sử dụng proxy nội bộ doanh nghiệp |
|
||||||
|
|
||||||
|
Thiết lập thuộc tính `locale` trong file `settings.toml`, sử dụng lệnh `/config locale vi`, hoặc dựa vào cài đặt biến `LC_ALL`/`LANG` của hệ điều hành để lựa chọn ngôn ngữ cho giao diện TUI và ngôn ngữ nhắc nhở gửi kèm tới các mô hình V4. Tin nhắn mới nhất của người dùng vẫn có mức độ ưu tiên cao nhất để mô hình tự động chọn ngôn ngữ phản hồi tương ứng, do đó các câu hỏi bằng Tiếng Việt của người dùng vẫn sẽ luôn nhận được câu trả lời bằng Tiếng Việt ngay cả khi hệ điều hành đang thiết lập giao diện hiển thị mặc định bằng tiếng Anh. Xem tài liệu hướng dẫn cấu hình tại [docs/CONFIGURATION.md](docs/CONFIGURATION.md) và [docs/MCP.md](docs/MCP.md).
|
||||||
|
|
||||||
|
---
|
||||||
|
|
||||||
|
## Mô hình & Giá cả
|
||||||
|
|
||||||
|
| Mô hình | Ngữ cảnh | Đầu vào (Hit Cache) | Đầu vào (Miss Cache) | Đầu ra |
|
||||||
|
|---|---|---|---|---|
|
||||||
|
| `deepseek-v4-pro` | 1M | $0.003625 / 1M | $0.435 / 1M | $0.87 / 1M |
|
||||||
|
| `deepseek-v4-flash` | 1M | $0.0028 / 1M | $0.14 / 1M | $0.28 / 1M |
|
||||||
|
|
||||||
|
Nền tảng DeepSeek mặc định sử dụng đường dẫn `https://api.deepseek.com/beta` để bạn có thể trải nghiệm các tính năng API beta mà không cần thiết lập cấu hình phức tạp. Thiết lập thuộc tính `base_url = "https://api.deepseek.com"` nếu muốn tắt tính năng này.
|
||||||
|
|
||||||
|
Các tên định danh cũ `deepseek-chat` / `deepseek-reasoner` sẽ được tự động ánh xạ đến `deepseek-v4-flash` và sẽ chính thức dừng hoạt động sau ngày 24 tháng 7 năm 2026. Các biến thể NVIDIA NIM sẽ áp dụng theo điều khoản tài khoản NVIDIA của bạn.
|
||||||
|
|
||||||
|
> [!Note]
|
||||||
|
> Trang cấu trúc giá của DeepSeek hiện đã cập nhật bảng giá trên của dòng V4 Pro làm mức giá cố định vĩnh viễn: Chương trình khuyến mãi giảm giá 75% trước đó đã được chính thức tích hợp thẳng vào giá cơ sở từ sau khi thời hạn khuyến mãi kết thúc vào lúc 15:59 UTC ngày 31 tháng 5 năm 2026. Trình tính toán chi phí trên giao diện TUI của CodeWhale đã cập nhật các giá trị mới này, do đó bạn không cần thực hiện thêm thay đổi nào. Để theo dõi các thay đổi giá trong tương lai, vui lòng tham khảo [trang giá chính thức của DeepSeek](https://api-docs.deepseek.com/zh-cn/quick_start/pricing).
|
||||||
|
|
||||||
|
---
|
||||||
|
|
||||||
|
## Chia Sẻ Skill Tự Viết
|
||||||
|
|
||||||
|
CodeWhale sẽ tự động quét và tìm kiếm các skill được định nghĩa từ các thư mục của dự án (`.agents/skills` → `skills` → `.opencode/skills` → `.claude/skills` → `.cursor/skills`) và các thư mục cấu hình toàn cục (`~/.agents/skills` → `~/.claude/skills` → `~/.codewhale/skills` → `~/.deepseek/skills`). Mỗi skill là một thư mục chứa một tệp tin `SKILL.md`:
|
||||||
|
|
||||||
|
```text
|
||||||
|
~/.agents/skills/my-skill/
|
||||||
|
└── SKILL.md
|
||||||
|
```
|
||||||
|
|
||||||
|
Yêu cầu định nghĩa phần Frontmatter ở đầu file:
|
||||||
|
|
||||||
|
```markdown
|
||||||
|
---
|
||||||
|
name: my-skill
|
||||||
|
description: Sử dụng skill này khi bạn muốn DeepSeek tuân thủ theo quy trình làm việc tùy chỉnh của tôi.
|
||||||
|
---
|
||||||
|
|
||||||
|
# My Skill
|
||||||
|
Các hướng dẫn chi tiết dành cho agent được viết tại đây.
|
||||||
|
```
|
||||||
|
|
||||||
|
Các lệnh tương tác: `/skills` (liệt kê), `/skill <name>` (kích hoạt), `/skill new` (tạo khung mẫu), `/skill install github:<owner>/<repo>` (cài đặt từ cộng đồng GitHub), `/skill update` / `uninstall` / `trust` để quản lý. Cài đặt các skill từ cộng đồng GitHub không yêu cầu chạy thêm bất kỳ dịch vụ nền nào. Các skill sau khi cài đặt sẽ hiển thị trong phần ngữ cảnh phiên làm việc mà mô hình AI có thể đọc được; agent có thể tự chọn skill phù hợp qua công cụ `load_skill` khi nhiệm vụ của bạn khớp với phần mô tả của skill.
|
||||||
|
|
||||||
|
Trong lần chạy đầu tiên, chương trình cũng tự động cài đặt sẵn một số skill hệ thống cho các quy trình phổ biến:
|
||||||
|
`skill-creator`, `delegate`, `v4-best-practices`, `plugin-creator`, `skill-installer`, `mcp-builder`, `documents`, `presentations`, `spreadsheets`, `pdf`, và `feishu`. Các skill này nằm trong thư mục `~/.codewhale/skills` (hoặc thư mục cũ `~/.deepseek/skills`) và được quản lý phiên bản để các bản nâng cấp mới được cài đặt tự động mà không làm ảnh hưởng đến các skill do người dùng tự chủ động xóa trước đó.
|
||||||
|
|
||||||
|
---
|
||||||
|
|
||||||
|
## Tài liệu hướng dẫn
|
||||||
|
|
||||||
|
| Tài liệu | Chủ đề chi tiết |
|
||||||
|
|---|---|
|
||||||
|
| [ARCHITECTURE.md](docs/ARCHITECTURE.md) | Cấu trúc bên trong của cơ sở mã nguồn |
|
||||||
|
| [CONFIGURATION.md](docs/CONFIGURATION.md) | Hướng dẫn cấu hình chi tiết và đầy đủ nhất |
|
||||||
|
| [MODES.md](docs/MODES.md) | Các chế độ hoạt động: Plan / Agent / YOLO |
|
||||||
|
| [MCP.md](docs/MCP.md) | Tích hợp giao thức Model Context Protocol |
|
||||||
|
| [RUNTIME_API.md](docs/RUNTIME_API.md) | Hướng dẫn sử dụng máy chủ API HTTP/SSE |
|
||||||
|
| [INSTALL.md](docs/INSTALL.md) | Hướng dẫn cài đặt riêng theo từng nền tảng |
|
||||||
|
| [DOCKER.md](docs/DOCKER.md) | Sử dụng Docker image trên GHCR, volume lưu trữ |
|
||||||
|
| [CNB_MIRROR.md](docs/CNB_MIRROR.md) | CNB mirror và các lưu ý cài đặt tại Trung Quốc |
|
||||||
|
| [TENCENT_CLOUD_REMOTE_FIRST.md](docs/TENCENT_CLOUD_REMOTE_FIRST.md) | Hướng dẫn kết nối Tencent/CNB/Lighthouse/Feishu từ xa |
|
||||||
|
| [TENCENT_LIGHTHOUSE_HK.md](docs/TENCENT_LIGHTHOUSE_HK.md) | Thiết lập máy chủ Lighthouse Hồng Kông |
|
||||||
|
| [MEMORY.md](docs/MEMORY.md) | Hướng dẫn tính năng tự ghi nhớ thông tin người dùng |
|
||||||
|
| [SUBAGENTS.md](docs/SUBAGENTS.md) | Phân loại vai trò và vòng đời của các sub-agent con |
|
||||||
|
| [KEYBINDINGS.md](docs/KEYBINDINGS.md) | Danh sách phím tắt đầy đủ |
|
||||||
|
| [RELEASE_RUNBOOK.md](docs/RELEASE_RUNBOOK.md) | Quy trình đóng gói và phát hành phiên bản mới |
|
||||||
|
| [LOCALIZATION.md](docs/LOCALIZATION.md) | Ma trận đa ngôn ngữ giao diện & cách chuyển đổi |
|
||||||
|
| [OPERATIONS_RUNBOOK.md](docs/OPERATIONS_RUNBOOK.md) | Vận hành và phục hồi hệ thống |
|
||||||
|
|
||||||
|
Lịch sử cập nhật chi tiết: [CHANGELOG.md](CHANGELOG.md).
|
||||||
|
|
||||||
|
---
|
||||||
|
|
||||||
|
## Lời cảm ơn
|
||||||
|
|
||||||
|
- **[DeepSeek](https://github.com/deepseek-ai)** — Xin chân thành cảm ơn sự hỗ trợ và các mô hình AI mạnh mẽ giúp tiếp sức cho mọi tương tác trong dự án. 感谢 DeepSeek 提供模型与支持，让每一次交互成为可能。
|
||||||
|
- **[DataWhale](https://github.com/datawhalechina)** 🐋 — Xin cảm ơn sự hỗ trợ nhiệt tình và đã chào đón chúng tôi gia nhập gia đình lớn "Whale Brother". 感谢 DataWhale 的支持，并欢迎 chúng tôi gia nhập “鲸兄弟”大家庭。
|
||||||
|
- **[OpenWarp](https://github.com/zerx-lab/warp)** — Cảm ơn vì đã ưu tiên hỗ trợ codewhale và hợp tác để mang lại trải nghiệm agent terminal tốt hơn.
|
||||||
|
- **[Open Design](https://github.com/nexu-io/open-design)** — Cảm ơn vì sự hỗ trợ và hợp tác xung quanh quy trình làm việc chú trọng thiết kế của agent.
|
||||||
|
|
||||||
|
Dự án này được phát triển và vận hành trơn tru với sự đóng góp của cộng đồng các nhà phát triển ngày càng lớn mạnh:
|
||||||
|
|
||||||
|
- **[merchloubna70-dot](https://github.com/merchloubna70-dot)** — Đóng góp 28 PR bao gồm tính năng mới, sửa lỗi và dựng sẵn extension cho VS Code (#645–#681)
|
||||||
|
- **[WyxBUPT-22](https://github.com/WyxBUPT-22)** — Xây dựng trình kết xuất Markdown hỗ trợ bảng biểu, chữ đậm/nghiêng và đường kẻ ngang (#579)
|
||||||
|
- **[loongmiaow-pixel](https://github.com/loongmiaow-pixel)** — Tài liệu cài đặt cho Windows và Trung Quốc (#578)
|
||||||
|
- **[20bytes](https://github.com/20bytes)** — Cải tiến tài liệu tính năng tự ghi nhớ và giao diện trợ giúp (#569)
|
||||||
|
- **[staryxchen](https://github.com/staryxchen)** — Kiểm tra độ tương thích của thư viện glibc trước khi chạy (#556)
|
||||||
|
- **[Vishnu1837](https://github.com/Vishnu1837)** — Tối ưu hóa tính tương thích glibc và tự phục hồi trạng thái terminal khi nhận tín hiệu SIGINT/SIGTERM (#565, #1586)
|
||||||
|
- **[shentoumengxin](https://github.com/shentoumengxin)** — Kiểm tra hợp lệ ranh giới thư mục làm việc `cwd` của Shell (#524)
|
||||||
|
- **[toi500](https://github.com/toi500)** — Báo cáo và sửa lỗi dán văn bản trên hệ điều hành Windows
|
||||||
|
- **[xsstomy](https://github.com/xsstomy)** — Báo cáo lỗi vẽ lại màn hình khi khởi động terminal
|
||||||
|
- **Melody0709** — Báo cáo lỗi kích hoạt phím Enter với tiền tố lệnh gạch chéo
|
||||||
|
- **[lloydzhou](https://github.com/lloydzhou)** và **[jeoor](https://github.com/jeoor)** — Báo cáo lỗi chi phí nén dữ liệu; lloydzhou cũng đóng góp ngữ cảnh môi trường xác định (#813, #922) và ổn định bộ nhớ đệm KV prefix-cache (#1080)
|
||||||
|
- **[Agent-Skill-007](https://github.com/Agent-Skill-007)** — Tinh chỉnh diễn đạt rõ ràng cho file giới thiệu README (#685)
|
||||||
|
- **[woyxiang](https://github.com/woyxiang)** — Tài liệu hướng dẫn cài đặt qua Scoop trên Windows (#696)
|
||||||
|
- **[wangfeng](mailto:wangfengcsu@qq.com)** — Cập nhật thông tin giá cả và chương trình khuyến mãi (#692)
|
||||||
|
- **[zichen0116](https://github.com/zichen0116)** — Xây dựng tài liệu quy tắc ứng xử cộng đồng CODE_OF_CONDUCT.md (#686)
|
||||||
|
- **[dfwqdyl-ui](https://github.com/dfwqdyl-ui)** — Báo cáo tính tương thích chữ hoa/thường của ID mô hình (#729)
|
||||||
|
- **[Oliver-ZPLiu](https://github.com/Oliver-ZPLiu)** — Báo cáo lỗi trạng thái `working...` bị kẹt, cơ chế dự phòng khay nhớ tạm (clipboard) trên Windows, sửa lỗi phiên kết nối HTTP dạng MCP Streamable, và tự động hóa brew tap (#738, #850, #1643, #1631)
|
||||||
|
- **[reidliu41](https://github.com/reidliu41)** — Ý tưởng gợi ý tiếp tục phiên, lưu trữ độ tin cậy workspace, hỗ trợ nhà cung cấp Ollama, hoàn thiện stream khối suy nghĩ, tăng cường cache cho CI, xử lý wrap dòng stream, và hoàn thành tính năng autocomplete cho DeepSeek (#863, #870, #921, #1078, #1603, #1628, #1601)
|
||||||
|
- **[xieshutao](https://github.com/xieshutao)** — Cơ chế dự phòng skill dạng Markdown thuần (#869)
|
||||||
|
- **[GK012](https://github.com/GK012)** — Cơ chế dự phòng lệnh `--version` của wrapper npm (#885)
|
||||||
|
- **[y0sif](https://github.com/y0sif)** — Xử lý đánh thức vòng lặp agent cha sau khi các sub-agent con hoàn thành tác vụ (#901)
|
||||||
|
- **[mac119](https://github.com/mac119)** và **[leo119](https://github.com/leo119)** — Viết tài liệu hướng dẫn cho lệnh `codewhale update` (#838, #917)
|
||||||
|
- **[dumbjack](https://github.com/dumbjack)** / **浩淼的mac** — Tăng cường bảo mật chống mã độc qua lệnh shell byte rỗng (#706, #918)
|
||||||
|
- **macworkers** — Cải tiến xác nhận rẽ nhánh (fork) kèm mã phiên làm việc mới (#600, #919)
|
||||||
|
- **zero** và **[zerx-lab](https://github.com/zerx-lab)** — Cấu hình điều kiện nhận thông báo và làm phong phú nội dung thông báo qua OSC 9 (#820, #920)
|
||||||
|
- **[chnjames](https://github.com/chnjames)** — Gợi ý hoàn thành @mentions từ cache, cải tiến phục hồi file cấu hình lỗi, và hiển thị chuẩn UTF-8 cho Shell trên Windows (#849, #927, #982, #1018)
|
||||||
|
- **[angziii](https://github.com/angziii)** — Bảo mật cấu hình, dọn dẹp tài nguyên bất đồng bộ, tăng cường bảo mật Docker và vá lỗi an toàn thực thi lệnh (#822, #824, #827, #831, #833, #835, #837)
|
||||||
|
- **[elowen53](https://github.com/elowen53)** — Giải mã UTF-8 và bổ sung các ca kiểm thử xác định (#825, #840)
|
||||||
|
- **[wdw8276](https://github.com/wdw8276)** — Bổ sung lệnh `/rename` để đổi tên tiêu đề phiên làm việc tùy chỉnh (#836)
|
||||||
|
- **[banqii](https://github.com/banqii)** — Hỗ trợ đường dẫn tìm kiếm skill dạng `.cursor/skills` (#817)
|
||||||
|
- **[junskyeed](https://github.com/junskyeed)** — Tính toán động giá trị `max_tokens` cho các yêu cầu API (#826)
|
||||||
|
- **Hafeez Pizofreude** — Triển khai cơ chế chống tấn công SSRF trong công cụ `fetch_url` và biểu đồ lịch sử Star History.
|
||||||
|
- **Unic (YuniqueUnic)** — Xây dựng giao diện cấu hình tự động dựa trên schema (cả TUI và web).
|
||||||
|
- **Jason** — Tăng cường bảo mật an toàn mạng chống tấn công giả mạo yêu cầu từ phía máy chủ (SSRF).
|
||||||
|
- **[axobase001](https://github.com/axobase001)** — Dọn dẹp snapshot mồ côi, bổ sung bộ bảo vệ khi cài npm, sửa lỗi đo lường phiên làm việc, xóa cache phạm vi mô hình, hỗ trợ các liên kết tượng trưng (symlinks) cho skill, hướng dẫn cơ chế thoát lỗi cài đặt npm mirror, và duy trì cấu hình proxy cho các tác vụ con (#975, #1032, #1047, #1049, #1052, #1019, #1051, #1056, #1608)
|
||||||
|
- **[MengZ-super](https://github.com/MengZ-super)** — Xây dựng nền tảng cho lệnh `/theme` và giải nén dữ liệu nén dạng gzip/brotli cho kết nối SSE (#1057, #1061)
|
||||||
|
- **[DI-HUO-MING-YI](https://github.com/DI-HUO-MING-YI)** — Vá lỗi bảo mật sandbox chỉ đọc trong chế độ Plan (#1077)
|
||||||
|
- **[bevis-wong](https://github.com/bevis-wong)** — Cung cấp ca tái hiện chính xác lỗi tự động gửi tin khi dán văn bản kèm ký tự xuống dòng (#1073)
|
||||||
|
- **[Duducoco](https://github.com/Duducoco)** và **[AlphaGogoo](https://github.com/AlphaGogoo)** — Xây dựng thanh menu gạch chéo cho skill và sửa lỗi bao phủ lệnh `/skills` (#1068, #1083)
|
||||||
|
- **[ArronAI007](https://github.com/ArronAI007)** — Sửa lỗi hiển thị tài nguyên artifact khi thay đổi kích thước cửa sổ trên macOS Terminal.app và ConHost (#993)
|
||||||
|
- **[THINKER-ONLY](https://github.com/THINKER-ONLY)** — Duy trì mã mô hình tùy chỉnh cho OpenRouter và endpoint riêng (#1066)
|
||||||
|
- **[Jefsky](https://github.com/Jefsky)** — Báo cáo sửa lỗi địa chỉ endpoint chính thức của DeepSeek (#1079, #1084)
|
||||||
|
- **[wlon](https://github.com/wlon)** — Chẩn đoán và ưu tiên lựa chọn khóa xác thực cho nhà cung cấp NVIDIA NIM (#1081)
|
||||||
|
- **[Horace Liu](https://github.com/liuhq)** — Đóng gói hỗ trợ Nix package và viết tài liệu hướng dẫn cài đặt (#1173)
|
||||||
|
- **[jieshu666](https://github.com/jieshu666)** — Giảm thiểu hiện tượng nhấp nháy màn hình khi vẽ lại giao diện TUI (#1563)
|
||||||
|
- **[gordonlu](https://github.com/gordonlu)** — Sửa lỗi nhận dạng phím Enter / mã nhập CSI-u trên Windows (#1612)
|
||||||
|
- **[mdrkrg](https://github.com/mdrkrg)** — Vá lỗi sập ứng dụng trong lần chạy đầu tiên khi thiếu khóa API (#1598)
|
||||||
|
- **[Aitensa](https://github.com/Aitensa)** — Xử lý tự động xuống dòng CJK cho các khối diff và kết quả đầu ra trang giấy (#1622)
|
||||||
|
- **[qiyan233](https://github.com/qiyan233)** — Đảm bảo tương thích với các bí danh cũ của nhà cung cấp DeepSeek Trung Quốc (#1645)
|
||||||
|
- **[zlh124](https://github.com/zlh124)** — Báo cáo khởi động không đầu WSL2 và sửa lỗi khay nhớ tạm (#1772, #1773)
|
||||||
|
- **[aboimpinto](https://github.com/aboimpinto)** — Sửa lỗi ghi nhật ký màn hình phụ trên Windows, hoàn thiện phím Home/End tại bộ soạn thảo và theo dõi log runtime (#1774, #1776, #1748, #1749, #1782, #1783)
|
||||||
|
- **[LeoLin990405](https://github.com/LeoLin990405)** — Bổ sung cơ chế truyền thẳng mô hình qua provider, phát lại luồng suy nghĩ, tối ưu lượt chạy chỉ suy nghĩ, và sửa lỗi trích dẫn trên Windows (#1740, #1743, #1742, #1744)
|
||||||
|
- **[nightt5879](https://github.com/nightt5879)** — Khắc phục lỗi khôi phục giao diện nhắc nhở khi bấm phím Ctrl+C (#1764)
|
||||||
|
- **[donglovejava](https://github.com/donglovejava)** — Hợp nhất kéo thả dán tệp `@file`, vá lỗi sập chữ CJK, thu thập phản hồi người dùng, định tuyến RLM, và thử lại khi `edit_file` bị kẹt (#2154–#2168)
|
||||||
|
- **[encyc](https://github.com/encyc)** — Hiển thị chi tiết số lượng token tiêu thụ ở chân trang và lệnh `/status` (#2152)
|
||||||
|
- **[saieswar237](https://github.com/saieswar237)** — Bổ sung tài liệu hướng dẫn về quy trình review code (#2178)
|
||||||
|
- **[sximelon](https://github.com/sximelon)** — Chặn sự kiện tự gửi tin khi dán văn bản và tách phân hệ quản lý phím bấm (#2174, #2042)
|
||||||
|
- **[nanookclaw](https://github.com/nanookclaw)** — Bổ sung hiển thị nhà cung cấp tìm kiếm trong kết quả của lệnh doctor (#2135)
|
||||||
|
- **[Sskift](https://github.com/Sskift)** — Ngăn chặn việc ghi đè biến môi trường mặc định trên CLI (#2119)
|
||||||
|
- **[xin1104](https://github.com/xin1104)** — Tạo brew formula cài binary codewhale độc lập (#2105)
|
||||||
|
- **[mrluanma](https://github.com/mrluanma)** — Bổ sung nhà cung cấp dịch vụ tìm kiếm Metaso (#2059)
|
||||||
|
- **[Lellansin](https://github.com/Lellansin)** — Bỏ qua việc gộp cấu hình tại thư mục home người dùng (#2055)
|
||||||
|
- **[zhuangbiaowei](https://github.com/zhuangbiaowei)** — Cập nhật các kênh phát hành chính thức của sản phẩm (#2145)
|
||||||
|
|
||||||
|
---
|
||||||
|
|
||||||
|
## Đóng góp cho dự án
|
||||||
|
|
||||||
|
Xem tài liệu hướng dẫn đóng góp tại [CONTRIBUTING.md](CONTRIBUTING.md). Chúng tôi luôn hoan nghênh các yêu cầu kéo Pull Requests — vui lòng xem danh sách các [vấn đề mở (open issues)](https://github.com/Hmbown/CodeWhale/issues) để bắt đầu đóng góp những phần việc đầu tiên.
|
||||||
|
|
||||||
|
Ủng hộ nhà phát triển: [Buy me a coffee](https://www.buymeacoffee.com/hmbown).
|
||||||
|
|
||||||
|
> [!Note]
|
||||||
|
> *Dự án này độc lập và không trực thuộc công ty DeepSeek Inc.*
|
||||||
|
|
||||||
|
## Bản quyền
|
||||||
|
|
||||||
|
[MIT](LICENSE)
|
||||||
|
|
||||||
|
## Biểu đồ Star History
|
||||||
|
|
||||||
|
[](https://www.star-history.com/?repos=Hmbown%2FCodeWhale&type=date&logscale=&legend=top-left)
|
||||||
@@ -4,6 +4,8 @@
|
|||||||
|
|
||||||
[English README](README.md)
|
[English README](README.md)
|
||||||
[日本語 README](README.ja-JP.md)
|
[日本語 README](README.ja-JP.md)
|
||||||
|
[Tiếng Việt README](README.vi.md)
|
||||||
|
|
||||||
|
|
||||||
## 安装
|
## 安装
|
||||||
|
|
||||||
|
|||||||
@@ -101,6 +101,7 @@ pub fn change(app: &mut App, version: Option<&str>) -> CommandResult {
|
|||||||
Locale::Ja => "Japanese (日本語)",
|
Locale::Ja => "Japanese (日本語)",
|
||||||
Locale::PtBr => "Brazilian Portuguese (Português)",
|
Locale::PtBr => "Brazilian Portuguese (Português)",
|
||||||
Locale::Es419 => "Latin American Spanish (Español latinoamericano)",
|
Locale::Es419 => "Latin American Spanish (Español latinoamericano)",
|
||||||
|
Locale::Vi => "Vietnamese (Tiếng Việt)",
|
||||||
// Fallback — should never reach here since we check En above.
|
// Fallback — should never reach here since we check En above.
|
||||||
Locale::En => "English",
|
Locale::En => "English",
|
||||||
};
|
};
|
||||||
|
|||||||
@@ -93,6 +93,7 @@ fn show_single_setting(app: &App, key: &str) -> CommandResult {
|
|||||||
crate::localization::Locale::Ja => "ja",
|
crate::localization::Locale::Ja => "ja",
|
||||||
crate::localization::Locale::PtBr => "pt-BR",
|
crate::localization::Locale::PtBr => "pt-BR",
|
||||||
crate::localization::Locale::Es419 => "es-419",
|
crate::localization::Locale::Es419 => "es-419",
|
||||||
|
crate::localization::Locale::Vi => "vi",
|
||||||
}
|
}
|
||||||
}
|
}
|
||||||
fn density_display(d: crate::tui::app::ComposerDensity) -> &'static str {
|
fn density_display(d: crate::tui::app::ComposerDensity) -> &'static str {
|
||||||
|
|||||||
@@ -39,6 +39,7 @@ pub enum Locale {
|
|||||||
ZhHant,
|
ZhHant,
|
||||||
PtBr,
|
PtBr,
|
||||||
Es419,
|
Es419,
|
||||||
|
Vi,
|
||||||
}
|
}
|
||||||
|
|
||||||
impl Locale {
|
impl Locale {
|
||||||
@@ -50,6 +51,7 @@ impl Locale {
|
|||||||
Self::ZhHant => "zh-Hant",
|
Self::ZhHant => "zh-Hant",
|
||||||
Self::PtBr => "pt-BR",
|
Self::PtBr => "pt-BR",
|
||||||
Self::Es419 => "es-419",
|
Self::Es419 => "es-419",
|
||||||
|
Self::Vi => "vi",
|
||||||
}
|
}
|
||||||
}
|
}
|
||||||
|
|
||||||
@@ -61,6 +63,7 @@ impl Locale {
|
|||||||
Self::ZhHant => "Traditional Chinese (繁體中文)",
|
Self::ZhHant => "Traditional Chinese (繁體中文)",
|
||||||
Self::PtBr => "Brazilian Portuguese (Português do Brasil)",
|
Self::PtBr => "Brazilian Portuguese (Português do Brasil)",
|
||||||
Self::Es419 => "Latin American Spanish (Español latinoamericano)",
|
Self::Es419 => "Latin American Spanish (Español latinoamericano)",
|
||||||
|
Self::Vi => "Vietnamese (Tiếng Việt)",
|
||||||
}
|
}
|
||||||
}
|
}
|
||||||
|
|
||||||
@@ -115,6 +118,14 @@ impl Locale {
|
|||||||
fallback: "en",
|
fallback: "en",
|
||||||
coverage: LocaleCoverage::V076Core,
|
coverage: LocaleCoverage::V076Core,
|
||||||
},
|
},
|
||||||
|
Self::Vi => LocaleSpec {
|
||||||
|
tag: "vi",
|
||||||
|
display_name: "Vietnamese",
|
||||||
|
script: "Latin",
|
||||||
|
direction: TextDirection::Ltr,
|
||||||
|
fallback: "en",
|
||||||
|
coverage: LocaleCoverage::V076Core,
|
||||||
|
},
|
||||||
}
|
}
|
||||||
}
|
}
|
||||||
|
|
||||||
@@ -127,6 +138,7 @@ impl Locale {
|
|||||||
Self::ZhHant,
|
Self::ZhHant,
|
||||||
Self::PtBr,
|
Self::PtBr,
|
||||||
Self::Es419,
|
Self::Es419,
|
||||||
|
Self::Vi,
|
||||||
]
|
]
|
||||||
}
|
}
|
||||||
}
|
}
|
||||||
@@ -165,14 +177,6 @@ pub const PLANNED_QA_LOCALES: &[LocaleSpec] = &[
|
|||||||
fallback: "en",
|
fallback: "en",
|
||||||
coverage: LocaleCoverage::PlannedQa,
|
coverage: LocaleCoverage::PlannedQa,
|
||||||
},
|
},
|
||||||
LocaleSpec {
|
|
||||||
tag: "vi",
|
|
||||||
display_name: "Vietnamese",
|
|
||||||
script: "Latin",
|
|
||||||
direction: TextDirection::Ltr,
|
|
||||||
fallback: "en",
|
|
||||||
coverage: LocaleCoverage::PlannedQa,
|
|
||||||
},
|
|
||||||
LocaleSpec {
|
LocaleSpec {
|
||||||
tag: "sw",
|
tag: "sw",
|
||||||
display_name: "Swahili",
|
display_name: "Swahili",
|
||||||
@@ -756,6 +760,7 @@ pub fn thinking_translation_placeholder(locale: Locale) -> &'static str {
|
|||||||
Locale::ZhHant => "正在思考，完成後翻譯為繁體中文...",
|
Locale::ZhHant => "正在思考，完成後翻譯為繁體中文...",
|
||||||
Locale::PtBr => "Pensando; traduzindo ao concluir...",
|
Locale::PtBr => "Pensando; traduzindo ao concluir...",
|
||||||
Locale::Es419 => "Pensando; traduciendo al finalizar...",
|
Locale::Es419 => "Pensando; traduciendo al finalizar...",
|
||||||
|
Locale::Vi => "Đang suy nghĩ; sẽ dịch sau khi hoàn thành...",
|
||||||
}
|
}
|
||||||
}
|
}
|
||||||
|
|
||||||
@@ -767,6 +772,7 @@ pub fn thinking_translation_in_progress(locale: Locale) -> &'static str {
|
|||||||
Locale::ZhHant => "正在翻譯思考內容...",
|
Locale::ZhHant => "正在翻譯思考內容...",
|
||||||
Locale::PtBr => "Traduzindo o conteúdo de raciocínio...",
|
Locale::PtBr => "Traduzindo o conteúdo de raciocínio...",
|
||||||
Locale::Es419 => "Traduciendo el contenido de razonamiento...",
|
Locale::Es419 => "Traduciendo el contenido de razonamiento...",
|
||||||
|
Locale::Vi => "Đang dịch nội dung suy nghĩ...",
|
||||||
}
|
}
|
||||||
}
|
}
|
||||||
|
|
||||||
@@ -778,6 +784,7 @@ pub fn thinking_translation_complete(locale: Locale) -> &'static str {
|
|||||||
Locale::ZhHant => "思考內容翻譯完成",
|
Locale::ZhHant => "思考內容翻譯完成",
|
||||||
Locale::PtBr => "Tradução do raciocínio concluída",
|
Locale::PtBr => "Tradução do raciocínio concluída",
|
||||||
Locale::Es419 => "Traducción del razonamiento completada",
|
Locale::Es419 => "Traducción del razonamiento completada",
|
||||||
|
Locale::Vi => "Đã dịch xong nội dung suy nghĩ",
|
||||||
}
|
}
|
||||||
}
|
}
|
||||||
|
|
||||||
@@ -789,6 +796,7 @@ pub fn thinking_translation_failed(locale: Locale) -> &'static str {
|
|||||||
Locale::ZhHant => "思考內容翻譯失敗",
|
Locale::ZhHant => "思考內容翻譯失敗",
|
||||||
Locale::PtBr => "Falha ao traduzir o raciocínio",
|
Locale::PtBr => "Falha ao traduzir o raciocínio",
|
||||||
Locale::Es419 => "Falló la traducción del razonamiento",
|
Locale::Es419 => "Falló la traducción del razonamiento",
|
||||||
|
Locale::Vi => "Dịch nội dung suy nghĩ thất bại",
|
||||||
}
|
}
|
||||||
}
|
}
|
||||||
|
|
||||||
@@ -800,6 +808,7 @@ pub fn hidden_translation_failed(locale: Locale) -> &'static str {
|
|||||||
Locale::ZhHant => "翻譯失敗，原文已隱藏。",
|
Locale::ZhHant => "翻譯失敗，原文已隱藏。",
|
||||||
Locale::PtBr => "A tradução falhou; o texto original está oculto.",
|
Locale::PtBr => "A tradução falhou; o texto original está oculto.",
|
||||||
Locale::Es419 => "La traducción falló; el texto original está oculto.",
|
Locale::Es419 => "La traducción falló; el texto original está oculto.",
|
||||||
|
Locale::Vi => "Dịch thất bại; văn bản gốc đã bị ẩn.",
|
||||||
}
|
}
|
||||||
}
|
}
|
||||||
|
|
||||||
@@ -909,6 +918,9 @@ fn parse_locale(value: &str) -> Option<Locale> {
|
|||||||
if value.starts_with("es") {
|
if value.starts_with("es") {
|
||||||
return Some(Locale::Es419);
|
return Some(Locale::Es419);
|
||||||
}
|
}
|
||||||
|
if value.starts_with("vi") {
|
||||||
|
return Some(Locale::Vi);
|
||||||
|
}
|
||||||
None
|
None
|
||||||
}
|
}
|
||||||
|
|
||||||
@@ -1307,9 +1319,364 @@ fn translation(locale: Locale, id: MessageId) -> Option<&'static str> {
|
|||||||
Locale::ZhHant => traditional_chinese(id),
|
Locale::ZhHant => traditional_chinese(id),
|
||||||
Locale::PtBr => portuguese_brazil(id),
|
Locale::PtBr => portuguese_brazil(id),
|
||||||
Locale::Es419 => spanish_latin_america(id),
|
Locale::Es419 => spanish_latin_america(id),
|
||||||
|
Locale::Vi => vietnamese(id),
|
||||||
}
|
}
|
||||||
}
|
}
|
||||||
|
|
||||||
|
fn vietnamese(id: MessageId) -> Option<&'static str> {
|
||||||
|
Some(match id {
|
||||||
|
MessageId::ComposerPlaceholder => "Nhập nhiệm vụ hoặc sử dụng /.",
|
||||||
|
MessageId::HistorySearchPlaceholder => "Tìm kiếm lịch sử câu lệnh...",
|
||||||
|
MessageId::HistorySearchTitle => "Tìm kiếm lịch sử",
|
||||||
|
MessageId::HistoryHintMove => "Lên/Xuống để di chuyển",
|
||||||
|
MessageId::HistoryHintAccept => "Enter để chấp nhận",
|
||||||
|
MessageId::HistoryHintRestore => "Esc để khôi phục",
|
||||||
|
MessageId::HistoryNoMatches => " Không tìm thấy kết quả",
|
||||||
|
MessageId::ConfigTitle => "Cấu hình phiên làm việc",
|
||||||
|
MessageId::ConfigModalTitle => " Cấu hình ",
|
||||||
|
MessageId::ConfigSearchPlaceholder => "Nhập để lọc kết quả",
|
||||||
|
MessageId::ConfigNoSettings => " Không có cài đặt nào khả dụng.",
|
||||||
|
MessageId::ConfigNoMatchesPrefix => " Không có cài đặt nào khớp với ",
|
||||||
|
MessageId::ConfigFilteredSettings => " Cài đặt đã lọc",
|
||||||
|
MessageId::ConfigShowing => " Đang hiển thị",
|
||||||
|
MessageId::ConfigFooterDefault => {
|
||||||
|
" gõ=lọc, Lên/Xuống=chọn, Enter/e=sửa, Esc/q=đóng "
|
||||||
|
}
|
||||||
|
MessageId::ConfigFooterScrollable => {
|
||||||
|
" gõ=lọc, Lên/Xuống=chọn, Enter/e=sửa, PgUp/PgDn=cuộn, Esc/q=đóng "
|
||||||
|
}
|
||||||
|
MessageId::ConfigFooterFiltered => {
|
||||||
|
" gõ=lọc, Backspace=xóa, Ctrl+U/Esc=xóa sạch, Enter=sửa "
|
||||||
|
}
|
||||||
|
MessageId::HelpTitle => "Trợ giúp",
|
||||||
|
MessageId::HelpFilterPlaceholder => "Nhập để lọc",
|
||||||
|
MessageId::HelpFilterPrefix => "Bộ lọc: ",
|
||||||
|
MessageId::HelpNoMatches => " Không tìm thấy kết quả.",
|
||||||
|
MessageId::HelpSlashCommands => "Các lệnh bắt đầu bằng dấu gạch chéo (/)",
|
||||||
|
MessageId::HelpKeybindings => "Phím tắt",
|
||||||
|
MessageId::HelpFooterTypeFilter => " nhập để lọc ",
|
||||||
|
MessageId::HelpFooterMove => " Lên/Xuống để di chuyển ",
|
||||||
|
MessageId::HelpFooterJump => " PgUp/PgDn để nhảy trang ",
|
||||||
|
MessageId::HelpFooterClose => " Esc để đóng ",
|
||||||
|
MessageId::CmdAnchorDescription => {
|
||||||
|
"Ghim một dữ kiện không bị ảnh hưởng khi nén (tự động đưa vào ngữ cảnh)"
|
||||||
|
}
|
||||||
|
MessageId::CmdAttachDescription => {
|
||||||
|
"Đính kèm hình ảnh/video; sử dụng @path cho tệp văn bản hoặc thư mục"
|
||||||
|
}
|
||||||
|
MessageId::CmdCacheDescription => {
|
||||||
|
"Hiển thị thống kê hit/miss của bộ nhớ đệm tiền tố DeepSeek trong N lượt gần nhất"
|
||||||
|
}
|
||||||
|
MessageId::CmdChangeDescription => "Hiển thị thông tin nhật ký thay đổi mới nhất",
|
||||||
|
MessageId::CmdChangeHeader => "Nhật Ký Thay Đổi Mới Nhất",
|
||||||
|
MessageId::CmdChangeTranslationQueued => {
|
||||||
|
"Ghi chú phát hành bằng tiếng Anh hiển thị bên dưới. Bản dịch sẽ được yêu cầu tiếp theo; nếu nhà cung cấp không khả dụng, văn bản tiếng Anh này sẽ được dùng làm dự phòng."
|
||||||
|
}
|
||||||
|
MessageId::CmdChangeTranslationUnavailable => {
|
||||||
|
"Ghi chú phát hành bằng tiếng Anh hiển thị bên dưới. Bản dịch không khả dụng vì phiên hiện tại không có mã khóa API hoặc đang ngoại tuyến."
|
||||||
|
}
|
||||||
|
MessageId::CmdChangePreviousVersion => {
|
||||||
|
"Phiên bản trước: {version} — chạy `/change {version}` để xem"
|
||||||
|
}
|
||||||
|
MessageId::CmdBalanceDescription => "Kiểm tra số dư tài khoản của nhà cung cấp dịch vụ đang hoạt động",
|
||||||
|
MessageId::CmdClearDescription => "Xóa lịch sử trò chuyện",
|
||||||
|
MessageId::CmdCompactDescription => {
|
||||||
|
"Kích hoạt nén ngữ cảnh để giải phóng không gian (cũ; v0.6.6 ưu tiên khởi động lại chu kỳ)"
|
||||||
|
}
|
||||||
|
MessageId::CmdConfigDescription => "Mở trình chỉnh sửa cấu hình tương tác",
|
||||||
|
MessageId::CmdContextDescription => "Mở trình kiểm tra ngữ cảnh phiên thu gọn",
|
||||||
|
MessageId::CmdCostDescription => "Hiển thị chi tiết chi phí của phiên làm việc",
|
||||||
|
MessageId::CmdCycleDescription => "Hiển thị báo cáo chuyển tiếp cho một chu kỳ cụ thể",
|
||||||
|
MessageId::CmdCyclesDescription => "Liệt kê các lần bàn giao chu kỳ checkpoint-restart trong phiên này",
|
||||||
|
MessageId::CmdDiffDescription => "Hiển thị các thay đổi của tệp kể từ khi bắt đầu phiên",
|
||||||
|
MessageId::CmdEditDescription => "Chỉnh sửa và gửi lại tin nhắn gần nhất",
|
||||||
|
MessageId::CmdExitDescription => "Thoát ứng dụng",
|
||||||
|
MessageId::CmdExportDescription => "Xuất cuộc trò chuyện sang định dạng Markdown",
|
||||||
|
MessageId::CmdFeedbackDescription => "Tạo một URL để gửi phản hồi trên GitHub",
|
||||||
|
MessageId::CmdHelpDescription => "Hiển thị thông tin trợ giúp",
|
||||||
|
MessageId::CmdHomeDescription => "Hiển thị bảng điều khiển trang chủ với số liệu thống kê và hành động nhanh",
|
||||||
|
MessageId::CmdHooksDescription => "Liệt kê các lifecycle hook đã cấu hình (chỉ đọc)",
|
||||||
|
MessageId::CmdAgentDescription => {
|
||||||
|
"Mở một phiên sub-agent nền: /agent [0-3] <nhiệm_vụ>"
|
||||||
|
}
|
||||||
|
MessageId::CmdGoalDescription => "Đặt mục tiêu cho phiên với giới hạn token tùy chọn",
|
||||||
|
MessageId::CmdInitDescription => "Tạo tệp AGENTS.md cho dự án",
|
||||||
|
MessageId::CmdLspDescription => "Bật hoặc tắt tính năng chẩn đoán LSP",
|
||||||
|
MessageId::CmdShareDescription => "Xuất phiên hiện tại thành một liên kết web có thể chia sẻ",
|
||||||
|
MessageId::CmdJobsDescription => "Kiểm tra và kiểm soát các lệnh chạy ngầm",
|
||||||
|
MessageId::CmdLinksDescription => "Hiển thị các liên kết đến bảng điều khiển và tài liệu của DeepSeek",
|
||||||
|
MessageId::CmdLoadDescription => "Tải phiên làm việc từ tệp",
|
||||||
|
MessageId::CmdLogoutDescription => "Xóa khóa API và quay lại bước thiết lập",
|
||||||
|
MessageId::CmdMcpDescription => "Mở hoặc quản lý các máy chủ MCP",
|
||||||
|
MessageId::CmdMemoryDescription => "Kiểm tra hoặc quản lý tệp bộ nhớ người dùng liên tục",
|
||||||
|
MessageId::CmdModeDescription => {
|
||||||
|
"Chuyển đổi chế độ hoặc mở bảng chọn: /mode [agent|plan|yolo|1|2|3]"
|
||||||
|
}
|
||||||
|
MessageId::CmdModelDescription => "Chuyển đổi hoặc xem mô hình AI hiện tại",
|
||||||
|
MessageId::CmdModelsDescription => "Liệt kê các mô hình khả dụng từ API",
|
||||||
|
MessageId::CmdNetworkDescription => "Quản lý các quy tắc cho phép và từ chối mạng",
|
||||||
|
MessageId::CmdNoteDescription => "Thêm, liệt kê, sửa hoặc xóa ghi chú trong không gian làm việc",
|
||||||
|
MessageId::CmdThemeDescription => "Chuyển đổi giao diện hoặc mở bảng chọn giao diện",
|
||||||
|
MessageId::CmdProviderDescription => {
|
||||||
|
"Chuyển đổi hoặc xem backend LLM đang hoạt động (codewhale | nvidia-nim | ollama)"
|
||||||
|
}
|
||||||
|
MessageId::CmdQueueDescription => "Xem hoặc chỉnh sửa các tin nhắn đang chờ xử lý",
|
||||||
|
MessageId::CmdRecallDescription => "Tìm kiếm kho lưu trữ chu kỳ trước (BM25 trên văn bản tin nhắn)",
|
||||||
|
MessageId::CmdRelayDescription => "Tạo một phiên tiếp sức (接力) cho một luồng mới",
|
||||||
|
MessageId::CmdRenameDescription => "Đổi tên phiên làm việc hiện tại",
|
||||||
|
MessageId::CmdRestoreDescription => {
|
||||||
|
"Khôi phục không gian làm việc về bản chụp trước/sau lượt. Nếu không có đối số, hiển thị các bản chụp gần đây."
|
||||||
|
}
|
||||||
|
MessageId::CmdRetryDescription => "Thử lại yêu cầu gần nhất",
|
||||||
|
MessageId::CmdReviewDescription => "Chạy một quy trình xem xét mã nguồn có cấu trúc trên tệp, diff hoặc PR",
|
||||||
|
MessageId::CmdRlmDescription => "Mở một ngữ cảnh RLM liên tục: /rlm [0-3] <tệp_hoặc_văn_bản>",
|
||||||
|
MessageId::CmdSaveDescription => "Lưu phiên làm việc vào tệp",
|
||||||
|
MessageId::CmdForkDescription => "Rẽ nhánh (fork) cuộc hội thoại hiện tại thành một phiên song song",
|
||||||
|
MessageId::CmdNewDescription => "Bắt đầu một phiên lưu mới",
|
||||||
|
MessageId::CmdSessionsDescription => "Mở bảng chọn lịch sử phiên làm việc",
|
||||||
|
MessageId::CmdSettingsDescription => "Hiển thị các cài đặt liên tục",
|
||||||
|
MessageId::CmdSkillDescription => {
|
||||||
|
"Kích hoạt một kỹ năng, hoặc cài đặt/cập nhật/gỡ bỏ/tin cậy một kỹ năng cộng đồng"
|
||||||
|
}
|
||||||
|
MessageId::CmdSkillsDescription => {
|
||||||
|
"Liệt kê các kỹ năng cục bộ (lọc bằng `/skills <tiền_tố>`; --remote để duyệt kho lưu trữ được kiểm duyệt)"
|
||||||
|
}
|
||||||
|
MessageId::CmdStashDescription => {
|
||||||
|
"Tạm cất hoặc khôi phục bản nháp (Ctrl+S để cất, /stash list/pop để xem/lấy ra)"
|
||||||
|
}
|
||||||
|
MessageId::CmdStatusDescription => "Hiển thị trạng thái thời gian chạy của phiên",
|
||||||
|
MessageId::CmdStatuslineDescription => "Cấu hình các mục hiển thị ở thanh trạng thái dưới cùng",
|
||||||
|
MessageId::CmdSubagentsDescription => "Liệt kê trạng thái của các sub-agent",
|
||||||
|
MessageId::CmdSwarmDescription => {
|
||||||
|
"Khởi chạy chế độ đa agent (sequential | mixture | distill | deliberate)"
|
||||||
|
}
|
||||||
|
MessageId::CmdSystemDescription => "Hiển thị prompt hệ thống hiện tại",
|
||||||
|
MessageId::CmdTaskDescription => "Quản lý các nhiệm vụ chạy ngầm",
|
||||||
|
MessageId::CmdTokensDescription => "Hiển thị lượng token đã sử dụng cho phiên",
|
||||||
|
MessageId::CmdTranslateDescription => "Bật/Tắt chế độ dịch đầu ra sang ngôn ngữ hệ thống hiện tại",
|
||||||
|
MessageId::CmdTranslateOff => "Đã tắt chế độ dịch đầu ra (hiển thị câu trả lời gốc của mô hình)",
|
||||||
|
MessageId::CmdTranslateOn => {
|
||||||
|
"Đã bật chế độ dịch đầu ra: câu trả lời của mô hình sẽ được hiển thị bằng tiếng Việt"
|
||||||
|
}
|
||||||
|
MessageId::TranslationInProgress => "Đang dịch câu trả lời của trợ lý...",
|
||||||
|
MessageId::TranslationComplete => "Đã dịch xong",
|
||||||
|
MessageId::TranslationFailed => "Dịch thất bại",
|
||||||
|
MessageId::CmdTrustDescription => {
|
||||||
|
"Quản lý quyền tin cậy không gian làm việc và danh sách trắng theo đường dẫn (`/trust add <path>`, `/trust list`, `/trust on|off`)"
|
||||||
|
}
|
||||||
|
MessageId::CmdWorkspaceDescription => "Hiển thị hoặc chuyển đổi không gian làm việc hiện tại",
|
||||||
|
MessageId::CmdUndoDescription => "Xóa cặp tin nhắn gần nhất",
|
||||||
|
MessageId::CmdVerboseDescription => "Bật/Tắt chế độ hiển thị đầy đủ quá trình suy nghĩ trực tiếp",
|
||||||
|
MessageId::CmdCacheAdvice => {
|
||||||
|
"Tỷ lệ hit/miss trên ~70% sau lượt thứ ba cho thấy tiền tố bộ nhớ đệm ổn định; \nthấp hơn mức đó trong các phiên dài cho thấy có sự biến động tiền tố cần kiểm tra (#263)."
|
||||||
|
}
|
||||||
|
MessageId::CmdCacheFootnote => {
|
||||||
|
"* miss được suy ra từ đầu vào − hit khi nhà cung cấp không báo cáo rõ ràng.\n"
|
||||||
|
}
|
||||||
|
MessageId::CmdCacheHeader => {
|
||||||
|
"Thông tin cache — {count} lượt gần nhất trong tổng số {total} lượt (mô hình: {model})\n"
|
||||||
|
}
|
||||||
|
MessageId::CmdCacheNoData => {
|
||||||
|
"Lịch sử bộ nhớ đệm: chưa có lượt nào được ghi nhận.\n\n\
|
||||||
|
DeepSeek cung cấp `prompt_cache_hit_tokens` / `prompt_cache_miss_tokens` \
|
||||||
|
trên mỗi lượt API mà mô hình hỗ trợ (dòng V4). Hãy chạy một lượt \
|
||||||
|
và thử lại lệnh /cache."
|
||||||
|
}
|
||||||
|
MessageId::CmdCacheTotals => {
|
||||||
|
"Σ vào: {sum_in} Σ hit: {sum_hit} Σ miss: {sum_miss} tỷ lệ hit trung bình: {avg}\n"
|
||||||
|
}
|
||||||
|
MessageId::CmdCostReport => {
|
||||||
|
"Chi Phí Phiên Làm Việc:\n\
|
||||||
|
─────────────────────────────\n\
|
||||||
|
Tổng chi tiêu ước tính: {cost}\n\n\
|
||||||
|
Các ước tính chi phí mang tính xấp xỉ và sử dụng dữ liệu viễn trắc từ nhà cung cấp nếu có.\n\n\
|
||||||
|
Bảng Giá API DeepSeek:\n\
|
||||||
|
─────────────────────────────\n\
|
||||||
|
Thông tin chi tiết về giá chưa được cấu hình trong CLI này."
|
||||||
|
}
|
||||||
|
MessageId::CmdTokensCacheBoth => "{hit} hit / {miss} miss",
|
||||||
|
MessageId::CmdTokensCacheHitOnly => "{hit} hit / không báo cáo miss",
|
||||||
|
MessageId::CmdTokensCacheMissOnly => "không báo cáo hit / {miss} miss",
|
||||||
|
MessageId::CmdTokensContextUnknownWindow => "~{estimated} / không rõ cửa sổ ngữ cảnh",
|
||||||
|
MessageId::CmdTokensContextWithWindow => "~{used} / {window} ({percent}%)",
|
||||||
|
MessageId::FooterAgentSingular => "1 tác nhân",
|
||||||
|
MessageId::FooterAgentsPlural => "{count} tác nhân",
|
||||||
|
MessageId::FooterPressCtrlCAgain => "Nhấn Ctrl+C một lần nữa để thoát",
|
||||||
|
MessageId::FooterWorking => "đang xử lý",
|
||||||
|
MessageId::HelpSectionActions => "Hành động",
|
||||||
|
MessageId::HelpSectionClipboard => "Bộ nhớ tạm",
|
||||||
|
MessageId::HelpSectionEditing => "Chỉnh sửa đầu vào",
|
||||||
|
MessageId::HelpSectionHelp => "Trợ giúp",
|
||||||
|
MessageId::HelpSectionModes => "Chế độ",
|
||||||
|
MessageId::HelpSectionNavigation => "Điều hướng",
|
||||||
|
MessageId::HelpSectionSessions => "Phiên",
|
||||||
|
MessageId::CmdTokensNotReported => "không được báo cáo",
|
||||||
|
MessageId::CmdTokensReport => {
|
||||||
|
"Lượng Token Sử Dụng:\n\
|
||||||
|
─────────────────────────────\n\
|
||||||
|
Ngữ cảnh hoạt động: {active}\n\
|
||||||
|
Đầu vào API gần nhất: {input} (viễn trắc theo lượt; có thể đếm lặp lại tiền tố qua các vòng công cụ)\n\
|
||||||
|
Đầu ra API gần nhất: {output}\n\
|
||||||
|
Hit/miss bộ nhớ đệm: {cache} (chỉ dành cho viễn trắc/chi phí)\n\
|
||||||
|
Token tích lũy: {total} (dữ liệu viễn trắc sử dụng của phiên)\n\
|
||||||
|
Chi phí phiên xấp xỉ: {cost}\n\
|
||||||
|
Tin nhắn API: {api_messages}\n\
|
||||||
|
Tin nhắn trò chuyện: {chat_messages}\n\
|
||||||
|
Mô hình: {model}"
|
||||||
|
}
|
||||||
|
MessageId::KbScrollTranscript => {
|
||||||
|
"Cuộn bản ghi trò chuyện, điều hướng lịch sử nhập hoặc chọn tệp đính kèm"
|
||||||
|
}
|
||||||
|
MessageId::KbNavigateHistory => "Điều hướng lịch sử nhập",
|
||||||
|
MessageId::KbBrowseHistory => "Duyệt lịch sử cuộc trò chuyện",
|
||||||
|
MessageId::KbScrollTranscriptAlt => "Cuộn bản ghi trò chuyện",
|
||||||
|
MessageId::KbScrollPage => "Cuộn bản ghi trò chuyện theo trang",
|
||||||
|
MessageId::KbJumpTopBottom => "Nhảy lên đầu / xuống cuối bản ghi trò chuyện",
|
||||||
|
MessageId::KbJumpTopBottomEmpty => "Nhảy lên đầu / xuống cuối (khi khung nhập trống)",
|
||||||
|
MessageId::KbJumpToolBlocks => "Nhảy giữa các khối đầu ra của công cụ",
|
||||||
|
MessageId::KbMoveCursor => "Di chuyển con trỏ trong khung soạn thảo",
|
||||||
|
MessageId::KbJumpLineStartEnd => "Nhảy về đầu / cuối dòng",
|
||||||
|
MessageId::KbDeleteChar => {
|
||||||
|
"Xóa ký tự trước / sau con trỏ, hoặc xóa tệp đính kèm đã chọn"
|
||||||
|
}
|
||||||
|
MessageId::KbClearDraft => "Xóa bản nháp hiện tại",
|
||||||
|
MessageId::KbStashDraft => "Tạm cất bản nháp hiện tại (dùng `/stash pop` để khôi phục)",
|
||||||
|
MessageId::KbSearchHistory => "Tìm kiếm lịch sử câu lệnh và khôi phục các bản nháp cục bộ",
|
||||||
|
MessageId::KbInsertNewline => "Chèn một dòng mới trong khung soạn thảo",
|
||||||
|
MessageId::KbSendDraft => "Gửi bản nháp hiện tại",
|
||||||
|
MessageId::KbCloseMenu => "Đóng menu, hủy yêu cầu, hủy bản nháp hoặc xóa sạch đầu vào",
|
||||||
|
MessageId::KbCancelOrExit => "Hủy yêu cầu, hoặc thoát khi rảnh",
|
||||||
|
MessageId::KbShellControls => "Mở các điều khiển shell cho một lệnh đang chạy ở tiền cảnh",
|
||||||
|
MessageId::KbExitEmpty => "Thoát khi khung nhập trống",
|
||||||
|
MessageId::KbCommandPalette => "Mở bảng lệnh (command palette)",
|
||||||
|
MessageId::KbFuzzyFilePicker => "Mở trình tìm file nhanh (fuzzy) (chèn @path khi nhấn Enter)",
|
||||||
|
MessageId::KbCompactInspector => "Mở trình kiểm tra ngữ cảnh phiên thu gọn",
|
||||||
|
MessageId::KbLastMessagePager => "Mở trang xem cho tin nhắn cuối cùng (khi khung nhập trống)",
|
||||||
|
MessageId::KbSelectedDetails => {
|
||||||
|
"Mở chi tiết cho công cụ hoặc tin nhắn được chọn (khi khung nhập trống)"
|
||||||
|
}
|
||||||
|
MessageId::KbToolDetailsPager => "Mở trang xem chi tiết công cụ",
|
||||||
|
MessageId::KbThinkingPager => "Mở Chi Tiết Hoạt Động (Activity Detail)",
|
||||||
|
MessageId::KbLiveTranscript => "Mở lớp phủ bản ghi trực tiếp (tự động cuộn theo đuôi)",
|
||||||
|
MessageId::KbBacktrackMessage => {
|
||||||
|
"Quay lại tin nhắn trước đó của người dùng (nhấn Trái/Phải để chuyển bước, Enter để lùi lại)"
|
||||||
|
}
|
||||||
|
MessageId::KbCompleteCycleModes => {
|
||||||
|
"Hoàn thành /command, xếp hàng theo dõi lượt đang chạy, chuyển đổi chế độ; Shift+Tab để chuyển đổi mức độ suy luận"
|
||||||
|
}
|
||||||
|
MessageId::KbJumpPlanAgentYolo => "Nhảy trực tiếp sang chế độ Plan / Agent / YOLO",
|
||||||
|
MessageId::KbAltJumpPlanAgentYolo => "Phím tắt thay thế để nhảy sang chế độ Plan / Agent / YOLO",
|
||||||
|
MessageId::KbFocusSidebar => {
|
||||||
|
"Focus vào thanh bên Work / Tasks / Agents / Context / Auto; Ctrl+Alt+0 để ẩn"
|
||||||
|
}
|
||||||
|
MessageId::KbTogglePlanAgent => "Chuyển đổi giữa chế độ Plan và Agent",
|
||||||
|
MessageId::KbSessionPicker => "Mở bảng chọn phiên làm việc",
|
||||||
|
MessageId::KbPasteAttach => "Dán văn bản hoặc đính kèm hình ảnh từ bộ nhớ tạm",
|
||||||
|
MessageId::KbCopySelection => "Sao chép vùng chọn hiện tại (Cmd+C trên macOS)",
|
||||||
|
MessageId::KbContextMenu => {
|
||||||
|
"Mở các hành động ngữ cảnh cho dán, vùng chọn, chi tiết tin nhắn, ngữ cảnh và trợ giúp"
|
||||||
|
}
|
||||||
|
MessageId::KbAttachPath => "Thêm một tệp văn bản cục bộ hoặc thư mục vào ngữ cảnh",
|
||||||
|
MessageId::KbHelpOverlay => "Mở lớp phủ trợ giúp này (khi khung nhập trống)",
|
||||||
|
MessageId::KbToggleHelp => "Bật/Tắt lớp phủ trợ giúp",
|
||||||
|
MessageId::KbToggleHelpSlash => "Bật/Tắt lớp phủ trợ giúp",
|
||||||
|
MessageId::HelpUsageLabel => "Sử dụng:",
|
||||||
|
MessageId::HelpAliasesLabel => "Bí danh:",
|
||||||
|
MessageId::SettingsTitle => "Cài đặt:",
|
||||||
|
MessageId::SettingsConfigFile => "Tệp cấu hình:",
|
||||||
|
MessageId::ClearConversation => "Đã xóa cuộc trò chuyện",
|
||||||
|
MessageId::ClearConversationBusy => {
|
||||||
|
"Đã xóa cuộc trò chuyện (trạng thái plan đang bận; chạy lại /clear nếu cần)"
|
||||||
|
}
|
||||||
|
MessageId::ModelChanged => "Đã thay đổi mô hình: {old} \u{2192} {new}",
|
||||||
|
MessageId::LinksTitle => "Liên kết DeepSeek:",
|
||||||
|
MessageId::LinksDashboard => "Bảng điều khiển:",
|
||||||
|
MessageId::LinksDocs => "Tài liệu:",
|
||||||
|
MessageId::LinksTip => "Mẹo: Mã khóa API có sẵn trong bảng điều khiển console.",
|
||||||
|
MessageId::SubagentsFetching => "Đang lấy trạng thái của các sub-agent...",
|
||||||
|
MessageId::HelpUnknownCommand => "Lệnh không xác định: {topic}",
|
||||||
|
MessageId::HomeDashboardTitle => "Bảng Điều Khiển Trang Chủ codewhale",
|
||||||
|
MessageId::HomeModel => "Mô hình:",
|
||||||
|
MessageId::HomeMode => "Chế độ:",
|
||||||
|
MessageId::HomeWorkspace => "Không gian làm việc:",
|
||||||
|
MessageId::HomeHistory => "Lịch sử:",
|
||||||
|
MessageId::HomeTokens => "Token:",
|
||||||
|
MessageId::HomeQueued => "Trong hàng đợi:",
|
||||||
|
MessageId::HomeSubagents => "Sub-agent:",
|
||||||
|
MessageId::HomeSkill => "Kỹ năng:",
|
||||||
|
MessageId::HomeQuickActions => "Hành động nhanh",
|
||||||
|
MessageId::HomeQuickLinks => "/links - Các liên kết đến Dashboard & API",
|
||||||
|
MessageId::HomeQuickSkills => "/skills - Liệt kê các kỹ năng khả dụng",
|
||||||
|
MessageId::HomeQuickConfig => "/config - Mở trình chỉnh sửa cấu hình tương tác",
|
||||||
|
MessageId::HomeQuickSettings => "/settings - Hiển thị các cài đặt liên tục",
|
||||||
|
MessageId::HomeQuickModel => "/model - Xem hoặc chuyển đổi mô hình",
|
||||||
|
MessageId::HomeQuickSubagents => "/subagents - Liệt kê trạng thái sub-agent",
|
||||||
|
MessageId::HomeQuickTaskList => "/task list - Hiển thị hàng đợi nhiệm vụ ngầm",
|
||||||
|
MessageId::HomeQuickHelp => "/help - Hiển thị trợ giúp",
|
||||||
|
MessageId::HomeModeTips => "Mẹo về Chế độ",
|
||||||
|
MessageId::HomeAgentModeTip => "Chế độ Agent - Sử dụng công cụ cho các nhiệm vụ tự chủ",
|
||||||
|
MessageId::HomeAgentModeReviewTip => " Sử dụng Ctrl+X để xem xét ở chế độ Plan trước khi thực thi",
|
||||||
|
MessageId::HomeAgentModeYoloTip => " Nhập /mode yolo để bật toàn quyền truy cập công cụ",
|
||||||
|
MessageId::HomeYoloModeTip => "Chế độ YOLO - Toàn quyền truy cập công cụ, không cần phê duyệt",
|
||||||
|
MessageId::HomeYoloModeCaution => " Hãy cẩn thận với các thao tác mang tính phá hủy!",
|
||||||
|
MessageId::HomePlanModeTip => "Chế độ Plan - Thiết kế trước khi triển khai",
|
||||||
|
MessageId::HomePlanModeChecklistTip => " Sử dụng /mode plan để tạo danh sách kiểm tra có cấu trúc",
|
||||||
|
MessageId::HomeGoalModeTip => "Theo dõi mục tiêu - Dùng /goal <mục_tiêu> để đặt mục tiêu làm việc",
|
||||||
|
// Onboarding — language picker.
|
||||||
|
MessageId::OnboardLanguageTitle => "Chọn ngôn ngữ của bạn",
|
||||||
|
MessageId::OnboardLanguageBlurb => {
|
||||||
|
"Chọn ngôn ngữ hiển thị. Bạn có thể thay đổi bất kỳ lúc nào bằng lệnh `/settings set locale <tag>`."
|
||||||
|
}
|
||||||
|
MessageId::OnboardLanguageFooter => {
|
||||||
|
"Nhấn phím từ 1-6 để chọn, hoặc Enter để giữ cài đặt hiện tại"
|
||||||
|
}
|
||||||
|
// Onboarding — API key entry.
|
||||||
|
MessageId::OnboardApiKeyTitle => "Kết nối khóa API DeepSeek của bạn",
|
||||||
|
MessageId::OnboardApiKeyStep1 => {
|
||||||
|
"Bước 1. Truy cập https://platform.deepseek.com/api_keys và tạo một khóa."
|
||||||
|
}
|
||||||
|
MessageId::OnboardApiKeyStep2 => "Bước 2. Dán khóa vào bên dưới và nhấn Enter.",
|
||||||
|
MessageId::OnboardApiKeySavedHint => {
|
||||||
|
"Được lưu vào ~/.deepseek/config.toml để có thể hoạt động từ mọi thư mục."
|
||||||
|
}
|
||||||
|
MessageId::OnboardApiKeyFormatHint => {
|
||||||
|
"Dán chính xác toàn bộ khóa (không chứa khoảng trắng hoặc xuống dòng)."
|
||||||
|
}
|
||||||
|
MessageId::OnboardApiKeyPlaceholder => "(dán khóa vào đây)",
|
||||||
|
MessageId::OnboardApiKeyLabel => "Khóa: ",
|
||||||
|
MessageId::OnboardApiKeyFooter => "Nhấn Enter để lưu, Esc để quay lại.",
|
||||||
|
// Onboarding — workspace trust.
|
||||||
|
MessageId::OnboardTrustTitle => "Tin cậy không gian làm việc",
|
||||||
|
MessageId::OnboardTrustQuestion => "Bạn có tin cậy nội dung của thư mục này không?",
|
||||||
|
MessageId::OnboardTrustLocationPrefix => "Bạn đang ở ",
|
||||||
|
MessageId::OnboardTrustRiskHint => {
|
||||||
|
"Làm việc với các nội dung không tin cậy sẽ tăng nguy cơ bị tấn công prompt injection."
|
||||||
|
}
|
||||||
|
MessageId::OnboardTrustEffectHint => {
|
||||||
|
"Tin cậy thư mục này sẽ lưu lại vào cấu hình toàn cục và bật chế độ không gian làm việc tin cậy."
|
||||||
|
}
|
||||||
|
MessageId::OnboardTrustFooterPrefix => "Nhấn ",
|
||||||
|
MessageId::OnboardTrustFooterMiddle => " để tin cậy và tiếp tục, ",
|
||||||
|
MessageId::OnboardTrustFooterSuffix => " để thoát",
|
||||||
|
// Onboarding — final tips.
|
||||||
|
MessageId::OnboardTipsTitle => "Bắt đầu đơn giản",
|
||||||
|
MessageId::OnboardTipsLine1 => {
|
||||||
|
"Viết nhiệm vụ bằng ngôn ngữ tự nhiên. Sử dụng /help hoặc Ctrl+K khi bạn muốn dùng lệnh."
|
||||||
|
}
|
||||||
|
MessageId::OnboardTipsLine2 => {
|
||||||
|
"Khung nhập văn bản bên dưới hỗ trợ viết nhiều dòng: Enter để gửi, Alt+Enter hoặc Ctrl+J để xuống dòng."
|
||||||
|
}
|
||||||
|
MessageId::OnboardTipsLine3 => {
|
||||||
|
"Chỉ chuyển đổi chế độ khi tính chất công việc thay đổi: Plan để lập kế hoạch trước khi làm, Agent để tự động thực hiện, YOLO khi bạn muốn tự động phê duyệt."
|
||||||
|
}
|
||||||
|
MessageId::OnboardTipsLine4 => {
|
||||||
|
"Ctrl+R để khôi phục lại các phiên làm việc trước đó, và Esc để thoát khỏi bản nháp hoặc lớp phủ hiện tại."
|
||||||
|
}
|
||||||
|
MessageId::OnboardTipsFooterEnter => "Nhấn Enter",
|
||||||
|
MessageId::OnboardTipsFooterAction => " để mở không gian làm việc",
|
||||||
|
})
|
||||||
|
}
|
||||||
|
|
||||||
fn traditional_chinese(id: MessageId) -> Option<&'static str> {
|
fn traditional_chinese(id: MessageId) -> Option<&'static str> {
|
||||||
Some(match id {
|
Some(match id {
|
||||||
MessageId::CmdRelayDescription => "為新執行緒建立會話接力摘要",
|
MessageId::CmdRelayDescription => "為新執行緒建立會話接力摘要",
|
||||||
|
|||||||
@@ -106,6 +106,8 @@ fn translation_target_language_for_tag(locale_tag: &str) -> &'static str {
|
|||||||
"Simplified Chinese (简体中文)"
|
"Simplified Chinese (简体中文)"
|
||||||
} else if normalized.starts_with("pt") {
|
} else if normalized.starts_with("pt") {
|
||||||
"Brazilian Portuguese (Português do Brasil)"
|
"Brazilian Portuguese (Português do Brasil)"
|
||||||
|
} else if normalized.starts_with("vi") {
|
||||||
|
"Vietnamese (Tiếng Việt)"
|
||||||
} else {
|
} else {
|
||||||
"English"
|
"English"
|
||||||
}
|
}
|
||||||
@@ -343,6 +345,7 @@ pub(crate) fn locale_reinforcement_preamble(locale_tag: &str) -> Option<&'static
|
|||||||
"zh-Hans" | "zh-CN" | "zh" => Some(LOCALE_PREAMBLE_ZH_HANS),
|
"zh-Hans" | "zh-CN" | "zh" => Some(LOCALE_PREAMBLE_ZH_HANS),
|
||||||
"ja" | "ja-JP" => Some(LOCALE_PREAMBLE_JA),
|
"ja" | "ja-JP" => Some(LOCALE_PREAMBLE_JA),
|
||||||
"pt-BR" | "pt" => Some(LOCALE_PREAMBLE_PT_BR),
|
"pt-BR" | "pt" => Some(LOCALE_PREAMBLE_PT_BR),
|
||||||
|
"vi" | "vi-VN" => Some(LOCALE_PREAMBLE_VI),
|
||||||
_ => None,
|
_ => None,
|
||||||
}
|
}
|
||||||
}
|
}
|
||||||
@@ -368,6 +371,7 @@ pub(crate) fn locale_reinforcement_closer(locale_tag: &str) -> Option<&'static s
|
|||||||
"zh-Hans" | "zh-CN" | "zh" => Some(LOCALE_CLOSER_ZH_HANS),
|
"zh-Hans" | "zh-CN" | "zh" => Some(LOCALE_CLOSER_ZH_HANS),
|
||||||
"ja" | "ja-JP" => Some(LOCALE_CLOSER_JA),
|
"ja" | "ja-JP" => Some(LOCALE_CLOSER_JA),
|
||||||
"pt-BR" | "pt" => Some(LOCALE_CLOSER_PT_BR),
|
"pt-BR" | "pt" => Some(LOCALE_CLOSER_PT_BR),
|
||||||
|
"vi" | "vi-VN" => Some(LOCALE_CLOSER_VI),
|
||||||
_ => None,
|
_ => None,
|
||||||
}
|
}
|
||||||
}
|
}
|
||||||
@@ -435,6 +439,24 @@ idioma. A menos que o usuário peça explicitamente a troca (por exemplo, \
|
|||||||
\"think in English\"), continue pensando e respondendo em português do \
|
\"think in English\"), continue pensando e respondendo em português do \
|
||||||
Brasil.";
|
Brasil.";
|
||||||
|
|
||||||
|
const LOCALE_PREAMBLE_VI: &str = "## Yêu cầu ngôn ngữ\n\n\
|
||||||
|
Bạn đang chạy trong codewhale. Cho dù ngữ cảnh tác vụ (mã nguồn, nhật ký lỗi, tên tệp) \
|
||||||
|
là tiếng Anh, cho dù phần còn lại của system prompt là tiếng Anh, bạn đều phải sử dụng \
|
||||||
|
tiếng Việt cho phần `reasoning_content` (suy nghĩ nội bộ) và câu trả lời cuối cùng. Các từ \
|
||||||
|
mã nguồn, đường dẫn tệp, tên công cụ (ví dụ `read_file`, `exec_shell`), biến môi trường, \
|
||||||
|
tham số dòng lệnh và URL giữ nguyên dạng gốc —— chỉ các văn bản giải thích bằng ngôn ngữ \
|
||||||
|
tự nhiên mới được chuyển sang tiếng Việt.\n\n\
|
||||||
|
Nếu người dùng chuyển sang ngôn ngữ khác trong phiên làm việc, hãy chuyển theo từ lượt tiếp theo. \
|
||||||
|
Nếu người dùng yêu cầu rõ ràng (ví dụ \"think in English\"), hãy ghi đè quy tắc này.";
|
||||||
|
|
||||||
|
const LOCALE_CLOSER_VI: &str = "## Nhắc nhở ngôn ngữ một lần nữa\n\n\
|
||||||
|
**Quan trọng: phần `reasoning_content` (suy nghĩ nội bộ) và phản hồi cuối cùng của bạn phải được viết bằng tiếng Việt.** \
|
||||||
|
Dù bạn có đọc bao nhiêu mã nguồn tiếng Anh, nhật ký lỗi hay tài liệu trong phiên làm việc này, và dù ngữ cảnh \
|
||||||
|
dự án có là tiếng Anh, quá trình suy nghĩ của bạn cũng không được chuyển sang tiếng Anh. Đây là yêu cầu cứng \
|
||||||
|
ở cấp phiên làm việc —— ngôn ngữ của người dùng quyết định ngôn ngữ của bạn, không phụ thuộc vào nội dung tiếng Anh \
|
||||||
|
tích lũy trong ngữ cảnh. Trừ khi người dùng yêu cầu rõ ràng việc chuyển đổi (ví dụ \"think in English\"), \
|
||||||
|
hãy tiếp tục suy nghĩ và trả lời bằng tiếng Việt.";
|
||||||
|
|
||||||
/// Personality overlays — voice and tone.
|
/// Personality overlays — voice and tone.
|
||||||
pub const CALM_PERSONALITY: &str = include_str!("prompts/personalities/calm.md");
|
pub const CALM_PERSONALITY: &str = include_str!("prompts/personalities/calm.md");
|
||||||
pub const PLAYFUL_PERSONALITY: &str = include_str!("prompts/personalities/playful.md");
|
pub const PLAYFUL_PERSONALITY: &str = include_str!("prompts/personalities/playful.md");
|
||||||
|
|||||||
@@ -23,6 +23,8 @@ These locales are supported by `locale` in `settings.toml` and by `LANG` / `LC_A
|
|||||||
| `ja` | Japanese | Jpan | LTR | `en` | v0.7.6 must-have | Core TUI chrome | Covers composer placeholder/history search, help chrome, and `/config` chrome. |
|
| `ja` | Japanese | Jpan | LTR | `en` | v0.7.6 must-have | Core TUI chrome | Covers composer placeholder/history search, help chrome, and `/config` chrome. |
|
||||||
| `zh-Hans` | Chinese Simplified | Hans | LTR | `en` | v0.7.6 must-have | Core TUI chrome | `zh`, `zh-CN`, and `zh-Hans` resolve here. Traditional Chinese is not shipped. |
|
| `zh-Hans` | Chinese Simplified | Hans | LTR | `en` | v0.7.6 must-have | Core TUI chrome | `zh`, `zh-CN`, and `zh-Hans` resolve here. Traditional Chinese is not shipped. |
|
||||||
| `pt-BR` | Portuguese (Brazil) | Latin | LTR | `en` | v0.7.6 must-have | Core TUI chrome | `pt` and `pt-PT` currently fall back to Brazilian Portuguese; European Portuguese is not separately shipped. |
|
| `pt-BR` | Portuguese (Brazil) | Latin | LTR | `en` | v0.7.6 must-have | Core TUI chrome | `pt` and `pt-PT` currently fall back to Brazilian Portuguese; European Portuguese is not separately shipped. |
|
||||||
|
| `es-419` | Spanish (Latin America) | Latin | LTR | `en` | v0.7.6 must-have | Core TUI chrome | `es` and regional variants resolve here. |
|
||||||
|
| `vi` | Vietnamese | Latin | LTR | `en` | v0.7.6 must-have | Core TUI chrome | Fully translated UI chrome, automated width tested. |
|
||||||
|
|
||||||
Selection:
|
Selection:
|
||||||
|
|
||||||
@@ -31,6 +33,8 @@ locale = "auto" # default; checks LC_ALL, LC_MESSAGES, then LANG
|
|||||||
locale = "ja"
|
locale = "ja"
|
||||||
locale = "zh-Hans"
|
locale = "zh-Hans"
|
||||||
locale = "pt-BR"
|
locale = "pt-BR"
|
||||||
|
locale = "es-419"
|
||||||
|
locale = "vi"
|
||||||
```
|
```
|
||||||
|
|
||||||
Fallback:
|
Fallback:
|
||||||
@@ -52,12 +56,10 @@ These are not claimed as shipped translations in v0.7.6 unless a later change ad
|
|||||||
| `hi` | Hindi | Deva | LTR | Follow-up | Planned | `en` | Automated renderer sample only; native review preferred before shipping | Combining marks, cursor width, truncation |
|
| `hi` | Hindi | Deva | LTR | Follow-up | Planned | `en` | Automated renderer sample only; native review preferred before shipping | Combining marks, cursor width, truncation |
|
||||||
| `bn` | Bengali | Beng | LTR | Follow-up | Planned | `en` | Matrix only; native review required before shipping | Combining marks, line wrapping |
|
| `bn` | Bengali | Beng | LTR | Follow-up | Planned | `en` | Matrix only; native review required before shipping | Combining marks, line wrapping |
|
||||||
| `id` | Indonesian | Latin | LTR | Follow-up | Planned | `en` | Matrix only; automated narrow-width snapshots and reviewer pass required | Longer labels than English |
|
| `id` | Indonesian | Latin | LTR | Follow-up | Planned | `en` | Matrix only; automated narrow-width snapshots and reviewer pass required | Longer labels than English |
|
||||||
| `vi` | Vietnamese | Latin | LTR | Follow-up | Planned | `en` | Matrix only; automated width snapshots and reviewer pass required | Diacritics and wrapped labels |
|
|
||||||
| `sw` | Swahili | Latin | LTR | Follow-up | Planned | `en` | Matrix only; native or fluent review required before shipping | Translation quality, longer command descriptions |
|
| `sw` | Swahili | Latin | LTR | Follow-up | Planned | `en` | Matrix only; native or fluent review required before shipping | Translation quality, longer command descriptions |
|
||||||
| `ha` | Hausa | Latin | LTR | Follow-up | Planned | `en` | Matrix only; native or fluent review required before shipping | Diacritics and terminology |
|
| `ha` | Hausa | Latin | LTR | Follow-up | Planned | `en` | Matrix only; native or fluent review required before shipping | Diacritics and terminology |
|
||||||
| `yo` | Yoruba | Latin | LTR | Follow-up | Planned | `en` | Matrix only; native or fluent review required before shipping | Tone marks and terminology |
|
| `yo` | Yoruba | Latin | LTR | Follow-up | Planned | `en` | Matrix only; native or fluent review required before shipping | Tone marks and terminology |
|
||||||
| `fil` | Filipino/Tagalog | Latin | LTR | Follow-up | Planned | `en` | Matrix only; source strings required before shipping | Terminology consistency |
|
| `fil` | Filipino/Tagalog | Latin | LTR | Follow-up | Planned | `en` | Matrix only; source strings required before shipping | Terminology consistency |
|
||||||
| `es-419` | Spanish (Latin America) | Latin | LTR | Follow-up | Planned | `en` | Matrix only; reviewer pass required before shipping | Regional terminology |
|
|
||||||
| `fr` | French | Latin | LTR | Follow-up | Planned | `en` | Matrix only; reviewer pass required before shipping | African locale terminology varies |
|
| `fr` | French | Latin | LTR | Follow-up | Planned | `en` | Matrix only; reviewer pass required before shipping | African locale terminology varies |
|
||||||
|
|
||||||
## Message Coverage
|
## Message Coverage
|
||||||
|
|||||||
Reference in New Issue
Block a user