Hướng dẫn kết nối DeepSeek Harness (dsh)

DeepSeek Harness là framework chạy Agent mã nguồn mở của DeepSeek (lệnh dsh), với triết lý cốt lõi "mọi thứ đều là plugin": model, công cụ, phiên làm việc... đều do plugin cung cấp. Nó hỗ trợ kết nối mọi gateway thông qua "Custom model API" -- trong mô tả nhóm GPT-Azure của NextHub, DSH đã được liệt kê là công cụ bên thứ ba tương thích.

Các bước kết nối

1. Cài đặt và khởi động

Bạn cần cài đặt Node.js (khuyến dùng phiên bản LTS chính thức mới nhất). Dùng npx để khởi động Web UI trực tiếp, hoặc cài toàn cục rồi khởi động:

npx @deepseek-ai/dsh web

npm install -g @deepseek-ai/dsh
dsh web

Sau khi khởi động, trình duyệt sẽ tự mở giao diện quản lý cục bộ.

2. Thêm provider tùy chỉnh (kênh Claude)

Vào Cài đặt → Model, nhấn Thêm provider, chuyển thẻ sang Custom model API, rồi điền theo bảng sau:

Trường	Nội dung điền	Ghi chú
Provider ID	nexthub	viết thường, không đổi tên được sau khi tạo
Base URL	https://api.nexthub.cc	giao thức Anthropic điền dạng thuần, không kèm /v1
Giao thức API	Anthropic Messages	endpoint tương ứng với giao thức Anthropic Messages
Thông tin xác thực (API Key)	ApiKey NextHub của bạn	nhóm Claude
Model	claude-opus-5-5, v.v.	ít nhất một; có thể nhấn "Fetch available models" để tự động lấy

Sau khi lưu, chọn model vừa thêm trong danh sách model của hộp thoại là dùng được.

3. Kết nối kênh GPT (tùy chọn)

Một provider chỉ dùng một giao thức, nếu cần GPT thì tạo thêm một provider: Provider ID điền nexthub-gpt, Giao thức API chọn OpenAI Chat Completions (hoặc OpenAI Responses), Base URL điền https://api.nexthub.cc/v1 (có /v1), API Key dùng khóa (API) của nhóm GPT-Azure / GPT-Pro, model điền gpt-5.6, gpt-6-astra, v.v.

4. Xác minh

Chọn model của NextHub trong hộp thoại và gửi một tin, nếu phản hồi bình thường là đã kết nối thành công.

Cách dùng file cấu hình (tùy chọn)

Các cấu hình trên cuối cùng được ghi vào $DSH_HOME/profiles/web/cordis.patch.yml (DSH_HOME mặc định là ~/.dsh), bạn cũng có thể sửa trực tiếp file này:

- id: llm-pi-ai
  config:
    providers:
      nexthub:
        apiKeyEnv: NEXTHUB_API_KEY
        api: anthropic-messages
        baseURL: https://api.nexthub.cc
        models:
          - id: claude-opus-5-5
          - id: claude-fable-5

apiKeyEnv điền tên biến môi trường (bản thân khóa sẽ được đọc từ biến môi trường đó); khóa lưu trong giao diện thì được lưu tại $DSH_HOME/.credentials.yaml. Sau khi sửa không cần khởi động lại, yêu cầu tiếp theo sẽ có hiệu lực.

Model thị giác cần khai báo loại đầu vào

Các model nhập thủ công mặc định được coi là chỉ có văn bản thuần. Để gửi ảnh cho model, cần tick Image trong Input types ở Model options của model (tương ứng cấu hình input: [text, image]), nếu không việc gửi ảnh sẽ bị từ chối trước khi gửi.