DeepSeek Harness

Skorzystaj z tego przewodnika, aby uruchomić open-source'owy DeepSeek Harness z modelami udostępnianymi przez Felo API Platform. Zalecana ścieżka wykorzystuje wbudowany adapter deepseek-official. Możesz też dodać Felo jako osobnego, niestandardowego dostawcę zgodnego z OpenAI w interfejsie Web UI.

DeepSeek Harness jest obecnie wersją zapoznawczą dla deweloperów i może wprowadzać zmiany łamiące zgodność. Sprawdź notatki o wydaniach w repozytorium źródłowym, jeśli jakaś opcja lub ekran różni się od opisanego w tym przewodniku.

Zanim zaczniesz

Potrzebujesz Node.js i jednego klucza Felo API Platform. Trzymaj klucz poza systemem kontroli wersji.

export FELO_API_KEY="YOUR_API_KEY"

W przykładach używany jest deepseek-v4-flash. Przed wybraniem innego identyfikatora modelu sprawdź Modele i ceny.

Zalecana konfiguracja: wbudowany adapter DeepSeek

DeepSeek Harness odczytuje poświadczenie wbudowanego adaptera ze zmiennej DEEPSEEK_API_KEY, a jego endpoint ze zmiennej 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

Otwórz http://127.0.0.1:3080, a następnie:

1. Dodaj lub wybierz obszar roboczy projektu.
2. Otwórz Settings → Models.
3. Wybierz dostawcę deepseek-official i model deepseek-v4-flash.
4. Rozpocznij nową sesję i wyślij małe zadanie dotyczące repozytorium.

Nie dopisuj /chat/completions do bazowego adresu URL. Wbudowany adapter sam wysyła żądania do {DEEPSEEK_BASE_URL}/chat/completions.

Utrwalanie wartości środowiskowych

DeepSeek Harness może odczytać plik .env z katalogu, w którym go uruchamiasz. Dodaj następujące wartości do nieśledzonego pliku .env, jeśli nie chcesz eksportować ich przy każdej sesji:

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

Nie zatwierdzaj tego pliku w repozytorium. Możesz też użyć plików poświadczeń i ustawień harnessu w $DSH_HOME, gdy potrzebujesz konfiguracji na poziomie użytkownika.

Alternatywna konfiguracja: niestandardowy dostawca zgodny z OpenAI

Użyj tej ścieżki, jeśli chcesz, aby Felo występował jako osobny dostawca, zamiast zastępować wbudowane połączenie z DeepSeek.

1. Uruchom Web UI poleceniem npx @deepseek-ai/dsh web.
2. Otwórz Settings → Models.
3. Wybierz Add custom provider.
4. Wprowadź poniższe wartości i zapisz dostawcę.

Jeśli wykrywanie modeli nie działa, dodaj identyfikator modelu ręcznie. Akcja Get available models u dostawcy zależy od trasy GET /models zgodnej z OpenAI i nie jest wymagana do konfiguracji ręcznej.

Weryfikacja konfiguracji

Rozpocznij nową sesję i zapytaj:

Summarize this repository and identify its main packages.

Konfiguracja jest gotowa, gdy sesja zakończy się z wybranym modelem deepseek-v4-flash i nie pojawi się błąd uwierzytelniania ani nieznanego modelu.

Aby wykonać nieinteraktywny test dymny z zalecanym adapterem, uruchom w docelowym obszarze roboczym:

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

Uwaga o wyszukiwaniu w sieci

Ta konfiguracja kieruje żądania modeli przez Felo. Wbudowany dostawca web_search w DeepSeek Harness ma odrębne wymagania dotyczące endpointu, mimo że jego domyślna zmienna poświadczeń to również DEEPSEEK_API_KEY. Nie kieruj DEEPSEEK_SEARCH_BASE_URL na Felo, chyba że używasz wyraźnie zgodnego endpointu wyszukiwania. Używaj API Chat lub innych Felo Skills osobno, gdy Twój przepływ pracy wymaga wyszukiwania Felo.

Rozwiązywanie problemów

Następne kroki

• Repozytorium DeepSeek Harness
• Dokumentacja API LLM
• Dokumentacja API Chat
• Felo Skills dla agentów AI