DeepSeek-TUI: Nâng Tầm Trải Nghiệm Lập Trình AI Ngay Trong Terminal Của Bạn

Bạn đã từng cảm thấy khó chịu khi phải liên tục chuyển đổi giữa các cửa sổ trình duyệt hoặc ứng dụng GUI khi sử dụng các công cụ lập trình AI? Sự gián đoạn này không chỉ làm mất tập trung mà còn phá vỡ quy trình làm việc liền mạch của bạn. DeepSeek-TUI ra đời để giải quyết vấn đề đó, mang đến một trợ lý lập trình DeepSeek AI mạnh mẽ, tích hợp trực tiếp vào môi trường terminal quen thuộc của bạn.

Bài viết này sẽ đưa bạn đi sâu vào DeepSeek-TUI, khám phá những khả năng tuyệt vời của nó, và hướng dẫn chi tiết cách để bạn có thể bắt đầu sử dụng công cụ đột phá này ngay lập tức. Hãy sẵn sàng để tối ưu hóa quy trình làm việc của mình!

DeepSeek-TUI là gì? Giải pháp lập trình AI tích hợp Terminal

DeepSeek-TUI là một giao diện người dùng terminal (TUI) mã nguồn mở, được thiết kế để kết nối với các mô hình ngôn ngữ của DeepSeek, hoạt động như một “agent” (tác nhân) hỗ trợ lập trình thông minh. Được xây dựng bằng ngôn ngữ Rust – nổi tiếng về hiệu suất và độ an toàn – và có thể cài đặt dễ dàng thông qua npm, DeepSeek-TUI cho phép bạn bắt đầu mà không cần phải thiết lập một công cụ Rust phức tạp.

Điều cốt lõi cần hiểu là DeepSeek-TUI không chỉ là một giao diện trò chuyện đơn thuần. Nó là một **tác nhân thông minh** – nghĩa là nó có khả năng thực hiện các hành động thay mặt bạn. Điều này bao gồm chỉnh sửa tệp, chạy các lệnh shell, thực hiện các commit Git, tìm kiếm thông tin trên web, và thậm chí tương tác với các dịch vụ bên ngoài thông qua các máy chủ MCP (Model Context Protocol).

Toàn bộ quá trình diễn ra bên trong terminal của bạn. Không cần mở tab trình duyệt mới, không cần ứng dụng Electron nặng nề. Quy trình làm việc hiện có của bạn sẽ không bị gián đoạn, cho phép bạn duy trì sự tập trung tối đa vào công việc.

Ba Chế Độ Hoạt Động Của DeepSeek-TUI: Linh hoạt và An toàn

DeepSeek-TUI mang đến ba chế độ hoạt động chính, bạn có thể chuyển đổi giữa chúng một cách dễ dàng bằng phím `Tab` hoặc `Shift+Tab`, tùy thuộc vào mức độ kiểm soát và tự động hóa bạn mong muốn:

  1. Chế độ Plan (Lập kế hoạch)

    Trước khi tác nhân thực hiện bất kỳ thay đổi nào, nó sẽ hiển thị cho bạn một kế hoạch chi tiết về các bước sẽ thực hiện. Bạn có thể xem xét và phê duyệt kế hoạch này trước khi mọi thứ diễn ra. Chế độ này cực kỳ hữu ích cho các tác vụ phức tạp, không quen thuộc hoặc tiềm ẩn rủi ro, đảm bảo bạn luôn có quyền kiểm soát cuối cùng.

  2. Chế độ Agent (Tác nhân)

    Đây là chế độ mặc định. Trong chế độ này, tác nhân hoạt động tương tác, sử dụng các công cụ từng bước và sẽ yêu cầu bạn phê duyệt đối với các hành động nhạy cảm, chẳng hạn như chạy các lệnh shell. Chế độ này cân bằng giữa khả năng tự động hóa và sự an toàn, lý tưởng cho hầu hết các tình huống phát triển.

  3. Chế độ YOLO (You Only Live Once)

    Chế độ YOLO sẽ tự động phê duyệt tất cả các hành động sử dụng công cụ mà không cần xác nhận. Chế độ này phù hợp cho các môi trường biệt lập, đáng tin cậy, nơi bạn muốn tác nhân hoạt động hoàn toàn tự chủ mà không có bất kỳ lời nhắc xác nhận nào. Bạn có thể đặt chế độ mặc định này trong tệp cấu hình hoặc khởi động trực tiếp vào YOLO với lệnh `deepseek-tui –yolo`.

Sự linh hoạt trong các chế độ này cho phép DeepSeek-TUI thích ứng với nhiều kịch bản làm việc khác nhau, từ việc phát triển an toàn trong môi trường sản xuất đến thử nghiệm nhanh chóng trong môi trường sandbox.

Hướng Dẫn Cài Đặt DeepSeek-TUI Chi Tiết Từng Bước

Để bắt đầu với DeepSeek-TUI, bạn chỉ cần thực hiện theo các bước đơn giản dưới đây.

Yêu cầu tiên quyết

Bạn chỉ cần cài đặt Node.js. Đây là yêu cầu duy nhất nếu bạn chọn cài đặt qua npm.

Bước 1: Cài đặt qua npm

Cách nhanh nhất và dễ nhất để cài đặt DeepSeek-TUI trên macOS, Linux và Windows là sử dụng npm:

npm install -g deepseek-tui

Bước 2: Lấy khóa API DeepSeek

DeepSeek-TUI yêu cầu khóa API để tương tác với các mô hình của DeepSeek.

  1. Truy cập platform.deepseek.com.
  2. Tạo một tài khoản (nếu bạn chưa có).
  3. Truy cập bảng điều khiển của bạn và tạo một khóa API mới.

Điểm đáng chú ý là DeepSeek có mức giá API thấp hơn đáng kể so với nhiều nhà cung cấp khác, khiến công cụ này trở nên cực kỳ hiệu quả về chi phí ngay cả khi sử dụng thường xuyên.

Bước 3: Thiết lập khóa API của bạn

Bạn có hai lựa chọn để thiết lập khóa API:

  1. Tùy chọn A: Đăng nhập tương tác (Khuyên dùng cho lần thiết lập đầu tiên)
    Chạy lệnh sau trong terminal của bạn:

    deepseek-tui login

    Lệnh này sẽ nhắc bạn nhập khóa API và lưu trữ nó vào tệp

    ~/.deepseek/config.toml

    .

  2. Tùy chọn B: Biến môi trường (Hữu ích cho CI/CD hoặc tập lệnh)
    Bạn có thể thiết lập khóa API thông qua biến môi trường khi khởi chạy DeepSeek-TUI:

    DEEPSEEK_API_KEY="your_key_here" deepseek-tui

Bước 4: Khởi chạy DeepSeek-TUI

Sau khi khóa API được thiết lập, bạn có thể khởi chạy DeepSeek-TUI:

deepseek-tui

Nếu bạn khởi chạy lần đầu mà chưa cấu hình khóa API, nó sẽ tự động nhắc bạn nhập một khóa.

Xác minh thiết lập của bạn

Để đảm bảo mọi thứ đã được cài đặt và cấu hình chính xác, bạn có thể chạy lệnh chẩn đoán:

deepseek-tui doctor

Lệnh này sẽ kiểm tra sự hiện diện của khóa API, cấu hình mô hình, trạng thái MCP, khả năng sử dụng công cụ shell và kết nối API. Nếu có bất kỳ vấn đề nào, nó sẽ chỉ cho bạn biết chính xác điều gì đang sai.

Các Phương Pháp Cài Đặt Thay Thế

Nếu bạn là nhà phát triển Rust hoặc thích cài đặt từ mã nguồn, DeepSeek-TUI cũng cung cấp các tùy chọn này:

Qua cargo (yêu cầu Rust 1.85 trở lên)

cargo install deepseek-tui --locked
cargo install deepseek-tui-cli --locked

Xây dựng từ mã nguồn

git clone https://github.com/Hmbown/DeepSeek-TUI.git
cd DeepSeek-TUI
cargo install --path crates/tui --locked

Cách Sử Dụng Cơ Bản DeepSeek-TUI

Sau khi DeepSeek-TUI đang chạy, bạn sẽ tương tác với tác nhân thông qua giao diện TUI. Dưới đây là các lệnh và phím tắt hữu ích nhất để nắm vững:

Lệnh khởi chạy từ Terminal

  • Để khởi động TUI tương tác:

    deepseek-tui
  • Để gửi một lời nhắc (prompt) một lần mà không cần giao diện người dùng tương tác:

    deepseek-tui -p "explain this codebase"
  • Để khởi động trong chế độ YOLO (tự động phê duyệt):

    deepseek-tui --yolo
  • Để liệt kê các mô hình DeepSeek có sẵn:

    deepseek-tui models
  • Để chạy DeepSeek-TUI như một máy chủ API HTTP/SSE:

    deepseek-tui serve --http

Trong giao diện TUI

  • `F1`: Mở màn hình trợ giúp.
  • `Ctrl+K`: Mở bảng lệnh (command palette).
  • `Esc`: Thoát khỏi hành động hiện tại hoặc trở về màn hình trước.
  • `Tab` / `Shift+Tab`: Chuyển đổi giữa các chế độ Plan, Agent và YOLO.
  • `/config`: Mở trình chỉnh sửa cấu hình tương tác.
  • `/compact`: Nén thủ công lịch sử phiên khi ngữ cảnh trở nên quá dài.
  • Để thêm các tệp cục bộ làm ngữ cảnh, gõ
    @path/to/file

    vào trình soạn thảo.

  • Để đính kèm hình ảnh từ clipboard, sử dụng
    Ctrl+V

    .

Cấu Hình DeepSeek-TUI: Tùy chỉnh Mạnh Mẽ

Tệp cấu hình của DeepSeek-TUI nằm tại

~/.deepseek/config.toml

. Một cấu hình cơ bản sẽ trông như sau:

api_key = "your_deepseek_api_key"
default_text_model = "deepseek-v4-pro"

Profiles (Hồ sơ)

Nếu bạn làm việc với nhiều nhà cung cấp hoặc nhiều khóa API, tính năng profile cho phép bạn dễ dàng chuyển đổi giữa chúng:

api_key = "personal_key"
default_text_model = "deepseek-v4-pro"

[profiles.work]
api_key = "work_key"
base_url = "https://api.deepseek.com"

Bạn có thể chuyển đổi profile khi khởi chạy:

deepseek-tui --profile work

hoặc

DEEPSEEK_PROFILE=work deepseek-tui

Các biến môi trường chính

DeepSeek-TUI hỗ trợ một số biến môi trường để tùy chỉnh hành vi mà không cần sửa tệp cấu hình:

| Biến | Mục đích |
| :——————————- | :——————————————————————– |
| `DEEPSEEK_API_KEY` | Khóa API của bạn. |
| `DEEPSEEK_MODEL` | Ghi đè mô hình mặc định cho một lần chạy. |
| `DEEPSEEK_BASE_URL` | Trỏ đến một endpoint tùy chỉnh. |
| `DEEPSEEK_PROFILE` | Chọn một profile đã đặt tên. |
| `DEEPSEEK_SANDBOX_MODE` | Kiểm soát quyền truy cập tệp: `read-only`, `workspace-write`, `danger-full-access`. |
| `DEEPSEEK_APPROVAL_POLICY` | Hành vi phê duyệt công cụ: `on-request`, `untrusted`, `never`. |

Các nhà cung cấp được hỗ trợ

Ngoài API riêng của DeepSeek, bạn có thể trỏ công cụ này tới các nhà cung cấp khác lưu trữ mô hình DeepSeek:

  • `deepseek`: Mặc định, sử dụng `https://api.deepseek.com`.
  • `nvidia-nim`: Các endpoint NIM được lưu trữ bởi NVIDIA.
  • `fireworks`: Fireworks AI.
  • `sglang`: Tự lưu trữ, mặc định là `http://localhost:30000/v1`.
  • `openrouter`: OpenRouter.
  • `novita`: Novita AI.

Bạn có thể thiết lập nhà cung cấp trong tệp cấu hình hoặc thông qua biến môi trường `DEEPSEEK_PROVIDER`.

Tích Hợp Máy Chủ MCP: Mở Rộng Khả Năng Của Agent

MCP (Model Context Protocol) cho phép bạn kết nối các công cụ và dịch vụ bên ngoài vào tác nhân của DeepSeek-TUI. DeepSeek-TUI đọc cấu hình MCP từ tệp

~/.deepseek/mcp.json

.

Để tạo thư mục MCP cơ bản:

deepseek-tui mcp init

Sau khi được cấu hình, bất kỳ máy chủ MCP nào được liệt kê trong tệp đó sẽ trở thành một công cụ mà tác nhân có thể gọi. Đây là cách bạn có thể kết nối cơ sở dữ liệu, API tùy chỉnh hoặc các hệ thống bên ngoài khác vào bộ công cụ của tác nhân.

Cờ Tính Năng (Feature Flags): Kiểm Soát Từng Chức Năng

Bạn có thể bật hoặc tắt từng khả năng riêng lẻ của DeepSeek-TUI thông qua cấu hình:

[features]
shell_tool = true
subagents = true
web_search = true
apply_patch = true
mcp = true

Hoặc ghi đè cho một phiên làm việc cụ thể:

deepseek-tui --enable web_search
deepseek-tui --disable subagents

Để xem trạng thái hiện tại của tất cả các cờ tính năng:

deepseek-tui features list

Các Mô Hình Hiện Tại Được Hỗ Trợ

DeepSeek-TUI mặc định sử dụng mô hình `deepseek-v4-pro`. Cả hai mô hình công khai hiện tại đều có cửa sổ ngữ cảnh 1M và hỗ trợ chế độ “thinking”:

  • `deepseek-v4-pro`: Mô hình đầy đủ khả năng, là mặc định.
  • `deepseek-v4-flash`: Phiên bản nhanh hơn, nhẹ hơn.

Các tên gọi cũ `deepseek-chat` và `deepseek-reasoner` vẫn hoạt động nhưng được ánh xạ tới `deepseek-v4-flash`. Chạy

deepseek-tui models

để xem các ID mô hình trực tiếp từ endpoint đã cấu hình của bạn.

Mẹo Thực Tế Để Tối Ưu Hóa Việc Sử Dụng DeepSeek-TUI

Để tận dụng tối đa DeepSeek-TUI và đảm bảo quy trình làm việc hiệu quả, hãy ghi nhớ những mẹo sau:

  • Sử dụng chế độ Plan cho mọi tác vụ liên quan đến môi trường sản xuất. Chế độ này yêu cầu bước xem xét trước khi tác nhân bắt đầu sửa đổi tệp. Dành vài giây đọc kế hoạch sẽ giúp bạn tránh được những lỗi không mong muốn.
  • Chạy lệnh `doctor` sau mỗi lần thay đổi cấu hình. Việc này giúp phát hiện sớm các lỗi cấu hình trước khi bạn thực sự cần công cụ hoạt động.
  • Sử dụng tham chiếu `@file` một cách tự do. Càng cung cấp nhiều ngữ cảnh cho tác nhân ngay từ đầu, bạn càng ít cần các vòng làm rõ sau này.
  • Đặt `sandbox_mode = “workspace-write”` cho quá trình phát triển thông thường. Điều này hạn chế tác nhân chỉ trong thư mục dự án của bạn, đây là một mặc định hợp lý và an toàn. Chỉ sử dụng `danger-full-access` khi bạn thực sự cần quyền truy cập rộng hơn.
  • Kiểm tra `deepseek-tui –no-alt-screen` nếu bạn muốn cuộn ngược (scrollback). Theo mặc định, TUI sử dụng một màn hình thay thế. Chạy với `–no-alt-screen` sẽ giữ đầu ra trong bộ đệm terminal thông thường của bạn để bạn có thể cuộn qua nó.

Liên Kết Hữu Ích

Để tìm hiểu thêm và đóng góp vào dự án, bạn có thể truy cập kho mã nguồn chính thức:

* Repository: github.com/Hmbown/DeepSeek-TUI

DeepSeek-TUI không chỉ là một công cụ, mà là một trải nghiệm lập trình hoàn toàn mới, giúp bạn làm việc hiệu quả hơn, liền mạch hơn và mạnh mẽ hơn ngay trong môi trường terminal quen thuộc. Hãy thử và cảm nhận sự khác biệt!

Chỉ mục