DeepSeek Harness Kết nối B.AI API – Hướng dẫn cấu hình chính thức

DeepSeek Harness là một ứng dụng không gian làm việc AI mã nguồn mở được chú ý, hiện đang trong giai đoạn xem trước dành cho nhà phát triển. Nó không chỉ có thể hoạt động sâu trong không gian làm việc cục bộ để hỗ trợ phân tích mã và tệp tin, mà còn mang lại cho nhà phát triển sự linh hoạt tuyệt vời thông qua cơ chế Nhà cung cấp tùy chỉnh (Custom Provider) mở. Trong khi đó, B.AI, với tư cách là cơ sở hạ tầng AI tiên tiến, đã xây dựng một nền tảng dịch vụ mô hình lớn full-stack tích hợp tính khả dụng cao và độ trễ thấp, cam kết xây dựng cho các nhà phát triển và doanh nghiệp một mạng lưới sức mạnh tính toán thông minh mạnh mẽ, ổn định và cực kỳ linh hoạt.

Hướng dẫn này sẽ trình bày chi tiết cho bạn cách khởi động DeepSeek Harness từ đầu trong môi trường Windows, macOS và Linux, đồng thời tích hợp thành công nó với API B.AI. Theo dõi hướng dẫn này, bạn sẽ kết nối được vòng lặp gọi đầy đủ từ không gian làm việc cục bộ đến mô hình lớn, giải phóng hoàn toàn tiềm năng sản xuất và đổi mới do AI thúc đẩy.

Chuỗi gọi cuối cùng được triển khai: DeepSeek Harness → API B.AI → Mô hình do B.AI cung cấp

1. Chuẩn bị môi trường

DeepSeek Harness được khởi chạy thông qua lệnh npx có sẵn trong Node.js. Vui lòng đảm bảo hệ thống của bạn đã cài đặt phiên bản Node.js LTS hiện có.

Địa chỉ tải xuống chính thức: https://nodejs.org/en/download

• Windows

Có thể tải trực tiếp tệp cài đặt .msi, hoặc tìm kiếm PowerShell trong menu Bắt đầu, mở nó lên và chạy lệnh cài đặt WinGet.

winget --version
winget install --id OpenJS.NodeJS.LTS -e --source winget

• macOS

Trên trang tải xuống chính thức của Node.js, chọn macOS Installer, tải tệp .pkg và tiến hành cài đặt theo hướng dẫn. Sau khi cài đặt kết thúc, nhấn Command + Space để mở Tìm kiếm Spotlight, nhập Terminal và vào cửa sổ đầu cuối.

• Linux 

Vui lòng chọn bản phân phối Linux và kiến trúc hệ thống bạn đang sử dụng trên trang tải xuống chính thức của Node.js, đồng thời cài đặt phiên bản LTS theo lệnh trình quản lý gói được cung cấp trên trang. Vì các lệnh cài đặt khác nhau giữa các bản phân phối như Ubuntu, Debian, Fedora, v.v., nên khuyến nghị sử dụng lệnh được tạo động trên trang chính thức để đảm bảo quá trình cài đặt diễn ra suôn sẻ và chính xác.

Sau khi cài đặt kết thúc, hãy đóng tất cả các cửa sổ đầu cuối đang mở và mở lại một cửa sổ đầu cuối mới (người dùng Windows vui lòng sử dụng PowerShell, người dùng macOS sử dụng Terminal, người dùng Linux sử dụng cửa sổ đầu cuối hệ thống).

Trên cả ba hệ thống, hãy chạy cùng một nhóm lệnh kiểm tra như sau:

node -v
npm -v
npx -v

Cả ba lệnh đều trả về số phiên bản nghĩa là môi trường đã sẵn sàng.

Node.js v24.19.0
npm 11.17.0
npx 11.17.0

Nếu bạn chuẩn bị xây dựng và chạy dự án từ mã nguồn GitHub, bạn sẽ cần môi trường Git. Trước tiên, hãy chạy lệnh git --version trong cửa sổ đầu cuối để kiểm tra xem nó đã được cài đặt chưa. Nếu chưa, hãy thực hiện lệnh sau tùy theo hệ điều hành của bạn:

Windows 

winget install --id Git.Git -e --source winget

macOS 

xcode-select --install

Ubuntu hoặc Debian 

sudo apt update
sudo apt install git

Lưu ý: Nếu bạn chỉ có kế hoạch sử dụng phương thức npx để trải nghiệm nhanh và cấu hình B.AI, bạn có thể bỏ qua Git trực tiếp.

2.  Khởi động DeepSeek Harness bằng npx (Khuyến nghị)

Đối với các nhà phát triển sử dụng thông thường và cấu hình API B.AI, khuyến nghị khởi động trực tiếp bằng npx.

Chạy lệnh sau trong cửa sổ đầu cuối (tương thích trên cả ba hệ thống):

npx @deepseek-ai/dsh web

Lưu ý khi chạy lần đầu: Hệ thống sẽ hỏi có tải xuống các gói phần mềm cần thiết hay không, nhập y và nhấn Enter để xác nhận.

Need to install the following packages
@deepseek-ai/dsh@...
Ok to proceed? (y)

Nếu cảnh báo phụ thuộc không dùng nữa xuất hiện trong quá trình khởi động, đây là hiện tượng bình thường, không cần can thiệp.

npm warn deprecated node-domexception@1.0.0

Khi cửa sổ đầu cuối xuất ra địa chỉ cục bộ, điều đó có nghĩa là dịch vụ Web của DeepSeek Harness đã khởi động thành công.

dsh web: http://127.0.0.1:3080

Giữ cửa sổ đầu cuối mở, sau đó nhập địa chỉ sau vào thanh địa chỉ trình duyệt:

http://127.0.0.1:3080

Địa chỉ này chỉ có thể truy cập từ máy cục bộ. Nếu bạn đóng cửa sổ đầu cuối hoặc nhấn Ctrl+C trong cửa sổ đó, dịch vụ cục bộ sẽ dừng theo. Nếu trình duyệt không thể mở 127.0.0.1:3080, trước tiên hãy kiểm tra xem cửa sổ đầu cuối có còn đang chạy hay không và xác nhận rằng địa chỉ dsh web nói trên đã được xuất ra trong cửa sổ đầu cuối hay chưa. Nếu cần, hãy chạy lại lệnh khởi động.

npx @deepseek-ai/dsh web

3. Phương thức xây dựng từ mã nguồn (Nâng cao)

Nếu bạn có kế hoạch phát triển plugin, sửa đổi mã nguồn hoặc tham gia phát triển dự án, bạn cũng có thể lấy mã nguồn từ kho lưu trữ GitHub chính thức.

Kho lưu trữ chính thức: https://github.com/deepseek-ai/deepseek-harness

Xin lưu ý rằng GitHub cung cấp mã nguồn dự án; sau khi tải xuống, bạn phải hoàn tất việc cài đặt phụ thuộc và xây dựng dự án thông qua cửa sổ đầu cuối, không thể chạy trực tiếp bằng cách nhấp đúp vào tệp. Bạn có thể lấy và chạy mã nguồn theo hai cách sau:

Cách 1: Tải xuống gói ZIP mã nguồn. Trên trang kho lưu trữ, nhấp vào nút Code màu xanh lá cây và chọn Download ZIP. Sau khi tải xuống và giải nén, mở cửa sổ đầu cuối, sử dụng lệnh cd để vào thư mục dự án đã giải nén và chạy lần lượt các lệnh sau:

npm install -g pnpm
pnpm install
pnpm run build
pnpm dsh web

Cách 2: Sử dụng Git Clone. Khuyến nghị trước tiên chạy git --version để kiểm tra xem môi trường Git có tồn tại hay không. Nếu chưa cài đặt, vui lòng tham khảo phần «Chuẩn bị môi trường» ở trên để hoàn tất việc cài đặt Git tương ứng cho hệ thống của bạn. Sau khi xác nhận môi trường chính xác, hãy mở lại cửa sổ đầu cuối và chạy các lệnh sau:

git clone https://github.com/deepseek-ai/deepseek-harness.git
cd deepseek-harness
npm install -g pnpm
pnpm install
pnpm run build
pnpm dsh web

Dù sử dụng cách ZIP hay Git, sau khi xây dựng và khởi động thành công, địa chỉ truy cập cũng là http://127.0.0.1:3080.

4. Cấu hình Nhà cung cấp tùy chỉnh B.AI

Bước 1: Bỏ qua cấu hình mặc định chính thức

Khi vào DeepSeek Harness lần đầu, hệ thống sẽ bật lên cửa sổ nhập API Key của mô hình chính thức. Vui lòng nhấp vào «Cấu hình sau» (稍后配置). Nếu điền Key của B.AI vào đây, hệ thống sẽ không thể nhận dạng chính xác.

Bước 2: Vào trang cấu hình tùy chỉnh

Nhấp vào «Cài đặt» (设置) ở góc dưới bên trái trang, chọn «Mô hình» (模型) trong menu bên trái và nhấp vào «Thêm nhà cung cấp tùy chỉnh» (添加自定义提供方) ở bên phải. Lưu ý: Tại thời điểm này, việc Nhà cung cấp chính thức hiển thị chấm đỏ là trạng thái bình thường và không ảnh hưởng đến các thao tác tiếp theo.

Bước 3: Điền thông tin giao diện B.AI

Sau khi mở nhà cung cấp tùy chỉnh, hãy điền theo nội dung bên dưới.

Provider ID bai
Tên hiển thị B.AI
Địa chỉ API https://api.b.ai/v1
Giao thức API openai-completions
API Key Khóa API hợp lệ được tạo từ bảng điều khiển B.AI

Bước 4: Lấy danh mục mô hình và hoàn tất việc tạo Nhà cung cấp

Sau khi điền xong thông tin cơ bản, vui lòng cuộn xuống khu vực «Danh mục mô hình» (模型目录). Hệ thống cung cấp hai cách thêm: nhấp vào «Thêm mô hình» (添加模型) để nhập thủ công ID mô hình hoặc nhấp vào «Lấy mô hình khả dụng» (获取可用模型) ở góc trên bên phải.

Thao tác được khuyến nghị: Trước tiên, hãy nhấp vào «Lấy mô hình khả dụng» (获取可用模型). Cho phép DeepSeek Harness trực tiếp yêu cầu danh mục mô hình khả dụng của tài khoản hiện tại từ B.AI. Nếu danh sách mô hình trả về bình thường, điều đó chứng minh rằng API Key B.AI, https://api.b.ai/v1, giao thức openai-completions cũng như giao diện danh mục mô hình đã được kết nối thành công.

Lưu ý khi chọn và thêm mô hình:

• Trong danh sách trả về, hãy chọn các mô hình DeepSeek hiện khả dụng của B.AI (ví dụ có thể thấy deepseek-v4-flash hoặc deepseek-v4-pro, xin lưu ý: các mô hình khả dụng cụ thể sẽ thay đổi động theo quyền tài khoản và thời gian, vui lòng dựa trên kết quả trả về thực tế).
• Không sửa đổi ID mô hình: ID mô hình phải hoàn toàn khớp với danh mục thực tế do B.AI trả về. Vui lòng không tự ý thay đổi bất kỳ chữ hoa/chữ thường, dấu gạch nối hoặc số phiên bản nào, nếu không rất dễ gây ra lỗi model not found trong các l