DeepSeek Harness

Dùng hướng dẫn này để chạy DeepSeek Harness mã nguồn mở với các mô hình do Felo API Platform phục vụ. Đường đi được khuyến nghị tận dụng bộ điều hợp deepseek-official có sẵn của harness. Bạn cũng có thể thêm Felo như một nhà cung cấp tùy chỉnh tương thích OpenAI riêng trong Web UI.

DeepSeek Harness hiện là bản xem trước dành cho nhà phát triển và có thể đưa vào các thay đổi phá vỡ tương thích. Hãy kiểm tra ghi chú phát hành thượng nguồn của nó khi một tùy chọn hoặc màn hình khác với hướng dẫn này.

Trước khi bắt đầu

Bạn cần Node.js và một khóa Felo API Platform. Giữ khóa ngoài hệ thống quản lý mã nguồn.

export FELO_API_KEY="YOUR_API_KEY"

Các ví dụ dùng deepseek-v4-flash. Hãy kiểm tra Mô hình và giá trước khi chọn một model ID khác.

Thiết lập đề xuất: Bộ điều hợp DeepSeek tích hợp

DeepSeek Harness đọc thông tin xác thực của bộ điều hợp tích hợp từ DEEPSEEK_API_KEY và endpoint của nó từ DEEPSEEK_BASE_URL.

export DEEPSEEK_API_KEY="$FELO_API_KEY"
export DEEPSEEK_BASE_URL="https://openapi.felo.ai/api/v1"
npx @deepseek-ai/dsh web

Mở http://127.0.0.1:3080, sau đó:

1. Thêm hoặc chọn workspace dự án của bạn.
2. Mở Settings → Models.
3. Chọn nhà cung cấp deepseek-official và mô hình deepseek-v4-flash.
4. Bắt đầu một phiên mới và gửi một tác vụ nhỏ trên kho lưu trữ.

Không nối thêm /chat/completions vào base URL. Bộ điều hợp tích hợp tự gửi yêu cầu đến {DEEPSEEK_BASE_URL}/chat/completions.

Lưu bền các giá trị môi trường

DeepSeek Harness có thể đọc tệp .env từ thư mục bạn khởi chạy nó. Hãy thêm các giá trị sau vào một tệp .env không được theo dõi nếu bạn không muốn xuất chúng cho mọi phiên:

DEEPSEEK_API_KEY=YOUR_API_KEY
DEEPSEEK_BASE_URL=https://openapi.felo.ai/api/v1

Không commit tệp này. Bạn cũng có thể dùng các tệp thông tin xác thực và cài đặt của harness trong $DSH_HOME khi cần cấu hình cấp người dùng.

Thiết lập thay thế: Nhà cung cấp tùy chỉnh tương thích OpenAI

Dùng đường đi này khi bạn muốn Felo xuất hiện như một nhà cung cấp riêng thay vì ghi đè kết nối DeepSeek tích hợp.

1. Khởi chạy Web UI bằng npx @deepseek-ai/dsh web.
2. Mở Settings → Models.
3. Chọn Add custom provider.
4. Nhập các giá trị sau và lưu nhà cung cấp.

Nếu việc khám phá mô hình thất bại, hãy thêm model ID thủ công. Hành động Get available models của nhà cung cấp phụ thuộc vào một tuyến GET /models tương thích OpenAI và không bắt buộc để cấu hình thủ công.

Xác minh thiết lập

Bắt đầu một phiên mới và hỏi:

Summarize this repository and identify its main packages.

Thiết lập đã sẵn sàng khi phiên hoàn tất với deepseek-v4-flash được chọn và không xuất hiện lỗi xác thực hay lỗi mô hình không xác định.

Để kiểm tra nhanh không tương tác với bộ điều hợp được khuyến nghị, hãy chạy từ workspace đích:

npx @deepseek-ai/dsh --profile headless "List the top-level files in this workspace."

Lưu ý về tìm kiếm web

Thiết lập này định tuyến các yêu cầu mô hình qua Felo. Nhà cung cấp web_search tích hợp của DeepSeek Harness có các yêu cầu endpoint riêng dù biến thông tin xác thực mặc định của nó cũng là DEEPSEEK_API_KEY. Không trỏ DEEPSEEK_SEARCH_BASE_URL vào Felo trừ khi bạn đang dùng một endpoint tìm kiếm tương thích được chỉ định rõ. Hãy dùng Chat API của Felo hoặc các Felo Skill khác một cách riêng biệt khi quy trình của bạn cần tìm kiếm của Felo.

Khắc phục sự cố

Các bước tiếp theo

• Kho lưu trữ DeepSeek Harness
• Tham chiếu LLM API
• Tham chiếu Chat API
• Felo Skills cho AI Agent