Codewhale

Codewhale là tác nhân lập trình mã nguồn mở dành cho terminal, được xây dựng bằng Rust và được cải thiện công khai cùng những người sử dụng nó.

English · 简体中文 · 日本語 · Bahasa Indonesia · 한국어 · Español · Português · Русский · Українська · Français · Deutsch · 繁體中文 · हिन्दी · Türkçe · Italiano · Polski · العربية · Català

Cài đặt

npm install -g codewhale
codewhale

Trong lần chạy đầu tiên, Codewhale sẽ giúp bạn kết nối với nhà cung cấp hoặc tiếp tục làm việc ngoại tuyến. Codewhale cũng hỗ trợ Cargo, Docker, Nix, Scoop, các gói dựng sẵn, Android/Termux và bản sao CNB. Xem hướng dẫn cài đặt.

Mỗi shell chỉ cần một lệnh để bật tính năng hoàn thành bằng phím Tab — codewhale completion bash|zsh|fish|powershell|elvish. Xem tính năng hoàn thành của shell.

Sử dụng

Hãy trò chuyện với Codewhale như khi bạn trao đổi với một đồng đội:

Fix the failing tests and explain what changed.

Hoặc chạy tác vụ mà không cần mở TUI:

codewhale exec "fix the failing tests and explain what changed"

Codewhale có thể đọc kho mã nguồn, chỉnh sửa tệp, chạy lệnh, kiểm tra kết quả và tiếp tục làm việc hướng đến mục tiêu. Bạn quyết định mức quyền truy cập dành cho nó.

Vì sao chọn Codewhale

• Dùng mô hình bạn muốn. Kết nối với nhà cung cấp được lưu trữ hoặc với mô hình cục bộ thông qua Ollama, vLLM hay SGLang. Chuyển nhà cung cấp và mô hình bằng /model.
• Luôn nắm quyền kiểm soát. Plan chỉ cho phép đọc. Ask, Auto-Review và Full Access hiển thị rõ cách hoạt động của việc phê duyệt. /undo hoàn tác lượt gần nhất, còn /restore đưa không gian làm việc về một ảnh chụp trước đó.
• Sắp xếp công việc dài hạn. Lưu phiên, đặt /goal lâu dài, xem lại quy trình trước khi chạy và phối hợp các tác nhân mà không đưa chỉ dẫn nội bộ của chúng vào bản ghi hội thoại của bạn.
• Mở rộng tác nhân bạn đang có. Kết nối máy chủ MCP và kỹ năng, cấu hình hook, đồng thời lưu vai trò tác nhân dưới dạng các tệp dễ đọc trong dự án hoặc phần cài đặt cá nhân.

Chạy /help trong TUI để xem các lệnh và phím tắt.

An toàn

Codewhale chạy trên máy của bạn với quyền truy cập do bạn cấp. Chế độ phê duyệt và quy tắc kho mã nguồn giới hạn những gì tác nhân được phép làm; cơ chế sandbox tùy chọn của hệ điều hành tạo thêm một ranh giới thực thi vững chắc hơn ở nơi được hỗ trợ. Giá mô hình chưa xác định sẽ vẫn được ghi là chưa xác định thay vì bị báo là miễn phí.

Đọc thứ tự cấp quyền để biết chính xác các lớp chính sách và cấu hình để biết các cài đặt cục bộ.

Tài liệu

• Nhà cung cấp và mô hình cục bộ
• Nhóm tác nhân
• MCP, hook và cấu hình
• Ứng dụng web cục bộ
• Toàn bộ tài liệu

Tham gia cộng đồng

Codewhale trở nên tốt hơn khi mọi người sử dụng, phản hồi những điểm chưa ổn và cùng khắc phục. Nếu thiếu một nhà cung cấp, quy trình còn bất tiện hoặc giao diện terminal cản trở công việc, hãy mở issue. Nếu bạn biết cách cải thiện, hãy mở pull request. Chúng tôi chào đón những đóng góp đầu tiên và người đóng góp luôn được ghi nhận cho phần việc đã được hợp nhất.

Tham gia Discord, hoặc thêm Hunter trên WeChat (hunterbown) và đề nghị tham gia nhóm Whale Brothers.

Lịch sử dự án

Codewhale bắt đầu với tên deepseek-tui và vẫn duy trì khả năng tương thích với cấu hình cùng phiên làm việc của dự án đó. Hiện nay Codewhale không phụ thuộc vào nhà cung cấp nào, được duy trì độc lập và không liên kết với bất kỳ nhà cung cấp mô hình nào.

Cảm ơn mọi người đóng góp và các cộng đồng mã nguồn mở đã giúp dự án phát triển. Xem danh sách người đóng góp.

Giấy phép

MIT. Các phần được điều chỉnh từ những dự án nguồn mở khác được ghi trong thông báo của bên thứ ba.