| 1 | <!-- source: README.md sha256:a87c9f323f35 --> |
| 2 | # Codewhale |
| 3 | |
| 4 | Một coding agent mã nguồn mở cho terminal của bạn — mang theo model của riêng bạn. |
| 5 | |
| 6 | Codewhale khởi đầu là một trải nghiệm gốc (native) cho DeepSeek. Từ đó, nó đã |
| 7 | phát triển thành một dự án do cộng đồng dẫn dắt: một coding harness hợp với một |
| 8 | cộng đồng quốc tế đang lớn dần và hỗ trợ càng nhiều model cùng provider càng |
| 9 | tốt — model mở trước tiên, hosted hay local, không cái nào được ưu ái hơn cái |
| 10 | nào. |
| 11 | |
| 12 | Đưa cho nó một provider, một model và một nhiệm vụ. Nó đọc code của bạn, sửa |
| 13 | file, chạy lệnh, kiểm tra công việc của mình, rồi dừng lại khi nhiệm vụ hoàn |
| 14 | thành hoặc cần đến bạn. Đổi model giữa chừng bằng `/model`. Làm việc tương tác |
| 15 | trong TUI, hoặc chạy `codewhale exec` trong script và CI. Viết bằng Rust, giấy |
| 16 | phép MIT, và chạy trên máy của bạn. |
| 17 | |
| 18 | Chúng tôi luôn tìm kiếm người đóng góp và cách cải thiện. Nếu một model hay |
| 19 | provider bạn dùng còn thiếu, hoặc có gì đó hỏng, báo cho chúng tôi biết là một |
| 20 | trong những điều hữu ích nhất bạn có thể làm — xem [Đóng góp](#đóng-góp). |
| 21 | |
| 22 | [English](README.md) · [简体中文](README.zh-CN.md) · [日本語](README.ja-JP.md) · [한국어](README.ko-KR.md) · [Español](README.es-419.md) · [Português](README.pt-BR.md) · [Русский](README.ru.md) · [Українська](README.uk.md) · [Bahasa Indonesia](README.id.md) · [codewhale.net](https://codewhale.net/) · [Docs](docs) · [Changelog](CHANGELOG.md) · [Discord](https://discord.gg/37gfS3ksug) |
| 23 | |
| 24 | [](https://github.com/Hmbown/CodeWhale/actions/workflows/ci.yml) |
| 25 | [](https://crates.io/crates/codewhale-cli) |
| 26 | [](https://www.npmjs.com/package/codewhale) |
| 27 | [](https://discord.gg/37gfS3ksug) |
| 28 | |
| 29 |  |
| 30 | |
| 31 | ## Cài đặt |
| 32 | |
| 33 | ```bash |
| 34 | npm install -g codewhale |
| 35 | ``` |
| 36 | |
| 37 | Cargo, Docker, Nix, Scoop, archive dựng sẵn, Android/Termux, và một mirror CNB |
| 38 | cho người dùng không truy cập được GitHub đều được hướng dẫn trong |
| 39 | [docs/INSTALL.md](docs/INSTALL.md). Chuyển từ `deepseek-tui` sang? Cấu hình và |
| 40 | session của bạn được giữ nguyên — xem [docs/REBRAND.md](docs/REBRAND.md). |
| 41 | |
| 42 | ## Sử dụng |
| 43 | |
| 44 | ```bash |
| 45 | codewhale auth set --provider deepseek # or export ANTHROPIC_API_KEY, etc. |
| 46 | codewhale # open the TUI |
| 47 | codewhale exec "fix the failing test" # headless |
| 48 | codewhale web # local browser client on 127.0.0.1 |
| 49 | ``` |
| 50 | |
| 51 | |
| 52 | Trong TUI: `/model` đổi provider và model cùng lúc, `/fleet` chạy một đội |
| 53 | worker, `/undo` hoàn tác lượt gần nhất, và `/restore <N>` đưa workspace về một |
| 54 | ảnh chụp trước đó (`/restore` không tham số chỉ liệt kê chúng). Khi vùng soạn |
| 55 | thảo trống, `Tab` chuyển vòng qua Plan / Act / Operate; khi vùng soạn thảo có |
| 56 | chữ, `Tab` lại hoàn tất lệnh slash và nhắc `@`. `Shift+Tab` chuyển vòng qua tư |
| 57 | thế quyền Ask / Auto-Review / Full Access bất cứ lúc nào. `!` chạy một lệnh |
| 58 | shell qua đường phê duyệt bình thường. |
| 59 | |
| 60 | ## Tính năng |
| 61 | |
| 62 | - **Model nào cũng được, provider nào cũng được.** DeepSeek, Claude, GPT, Kimi, |
| 63 | GLM, hơn 30 provider, và vLLM, SGLang hay Ollama của riêng bạn — không cần |
| 64 | key — đều chạy qua một runtime và một bộ công cụ. Ngân sách ngữ cảnh và giá |
| 65 | lấy từ route thật; giá chưa rõ hiển thị là chưa rõ, chứ không phải $0. |
| 66 | - **Chỉ đọc cho tới khi bạn cho phép thêm.** Chế độ Plan không đổi file, và mọi |
| 67 | lệnh rủi ro đều qua phê duyệt. Khi một sandbox của hệ điều hành thực sự bọc |
| 68 | lệnh, Codewhale nói rõ điều đó: Seatbelt trên macOS khi khả dụng, bubblewrap |
| 69 | tùy chọn trên Linux. `constitution.json` của repo được biên dịch thành các |
| 70 | chốt chặn ghi mà ngay cả Full Access cũng không thể bỏ qua. |
| 71 | - **Công việc bạn có thể tiếp tục.** Fleet ghi lại từng bước vào sổ cái chỉ ghi |
| 72 | thêm, nên `fleet resume` tiếp tục từ chỗ bạn dừng. |
| 73 | |
| 74 | ## Tìm hiểu thêm |
| 75 | |
| 76 | - [docs/PROVIDERS.md](docs/PROVIDERS.md) — mọi route provider: dịch vụ, |
| 77 | gateway và cục bộ |
| 78 | - [docs/FLEET.md](docs/FLEET.md) — fleet, sổ cái và resume |
| 79 | - [docs/WORKFLOW_EXPERIMENTAL_SEARCH.md](docs/WORKFLOW_EXPERIMENTAL_SEARCH.md) — tìm kiếm thử nghiệm trong Workflow, đã đóng băng và trung lập với provider |
| 80 | - [docs/CONFIGURATION.md](docs/CONFIGURATION.md) — `config.toml`, hook và |
| 81 | constitution |
| 82 | - [docs/AUTHORIZATION_ORDER.md](docs/AUTHORIZATION_ORDER.md) — cách các chế độ, |
| 83 | hook, quy tắc quyền, mức an toàn tối thiểu, luật của repo, quy trình phê duyệt |
| 84 | và sandbox phối hợp với nhau |
| 85 | - [docs/HOOKS.md](docs/HOOKS.md) — mười một sự kiện hook trong vòng đời TUI, |
| 86 | payload của chúng và ba sự kiện có thể điều hướng một lượt (`codewhale exec` |
| 87 | và các lệnh con CLI không kích hoạt hook) |
| 88 | - [docs/WEB.md](docs/WEB.md) — trình duyệt nhúng chỉ chạy trên loopback và |
| 89 | ranh giới xác thực dùng một lần |
| 90 | |
| 91 | Mọi thứ còn lại — chế độ, phím tắt, chi tiết sandbox, MCP, runtime API, kiến |
| 92 | trúc — nằm trong [docs](docs) và trên [codewhale.net](https://codewhale.net/). |
| 93 | |
| 94 | ## Đóng góp |
| 95 | |
| 96 | Issue, PR, các bước tái hiện lỗi, log và yêu cầu tính năng đều là công việc |
| 97 | thực sự của dự án ở đây, và những đóng góp đầu tiên luôn được chào đón. Khi một |
| 98 | PR không thể merge nguyên trạng, maintainer sẽ harvest phần dùng được và tác |
| 99 | giả vẫn được ghi công — trong commit, trong changelog và trong |
| 100 | [docs/CONTRIBUTORS.md](docs/CONTRIBUTORS.md). |
| 101 | |
| 102 | - [Issue đang mở](https://github.com/Hmbown/CodeWhale/issues) — những đóng góp |
| 103 | đầu tiên phù hợp nằm ở đây |
| 104 | - [CONTRIBUTING.md](CONTRIBUTING.md) — thiết lập môi trường dev và quy trình PR |
| 105 | - [docs/CONTRIBUTORS.md](docs/CONTRIBUTORS.md) — tất cả những người đã góp |
| 106 | phần định hình dự án |
| 107 | - [Buy me a coffee](https://www.buymeacoffee.com/hmbown) |
| 108 | |
| 109 | Cảm ơn [DeepSeek](https://github.com/deepseek-ai) vì các model và sự hỗ trợ đã |
| 110 | khởi đầu dự án, [DataWhale](https://github.com/datawhalechina) 🐋 vì đã chào |
| 111 | đón chúng tôi vào đại gia đình Whale Brother, và |
| 112 | [OpenWarp](https://github.com/zerx-lab/warp) cùng |
| 113 | [Open Design](https://github.com/nexu-io/open-design) vì đã hợp tác xây dựng |
| 114 | trải nghiệm agent trên terminal. |
| 115 | |
| 116 | ## Giấy phép |
| 117 | |
| 118 | [MIT](LICENSE). Dự án cộng đồng độc lập; không trực thuộc bất kỳ nhà cung cấp |
| 119 | model nào. |
| 120 | |
| 121 | [](https://www.star-history.com/?repos=Hmbown%2FCodeWhale&type=date) |
| 122 |