Persediaan Alat AI

DeepSeek Harness

Sambungkan DeepSeek Harness ke Felo melalui penyesuai DeepSeek asli atau penyedia serasi OpenAI tersuai.

Gunakan panduan ini untuk menjalankan DeepSeek Harness sumber terbuka dengan model yang dilayani oleh Felo API Platform. Laluan yang disyorkan menggunakan semula penyesuai deepseek-official terbina dalam harness. Anda juga boleh menambahkan Felo sebagai penyedia serasi OpenAI tersuai yang berasingan dalam UI Web.

DeepSeek Harness pada masa ini ialah pratonton pembangun dan mungkin memperkenalkan perubahan yang memecahkan keserasian. Semak nota keluaran huluan apabila pilihan atau skrin berbeza daripada panduan ini.

Sebelum Anda Bermula

Anda memerlukan Node.js dan satu kunci Felo API Platform. Jauhkan kunci daripada kawalan sumber.

export FELO_API_KEY="YOUR_API_KEY"

Contoh menggunakan deepseek-v4-flash. Semak Model dan Harga sebelum memilih ID model lain.

Persediaan Disyorkan: Penyesuai DeepSeek Terbina Dalam

DeepSeek Harness membaca kelayakan penyesuai terbina dalam daripada DEEPSEEK_API_KEY dan endpointnya daripada 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

Buka http://127.0.0.1:3080, kemudian:

Tambah atau pilih ruang kerja projek anda.
Buka Settings → Models.
Pilih penyedia deepseek-official dan model deepseek-v4-flash.
Mulakan sesi baharu dan hantar tugasan repositori kecil.

Jangan tambahkan /chat/completions pada URL asas. Penyesuai terbina dalam menghantar permintaan ke {DEEPSEEK_BASE_URL}/chat/completions sendiri.

Kekalkan nilai persekitaran

DeepSeek Harness boleh membaca fail .env daripada direktori tempat anda memulakannya. Tambahkan nilai berikut pada fail .env yang tidak dijejaki jika anda tidak mahu mengeksportnya untuk setiap sesi:

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

Jangan commit fail ini. Anda juga boleh menggunakan fail kelayakan dan tetapan harness di bawah $DSH_HOME apabila anda memerlukan konfigurasi peringkat pengguna.

Persediaan Alternatif: Penyedia Serasi OpenAI Tersuai

Gunakan laluan ini apabila anda mahu Felo muncul sebagai penyedia berasingan dan bukannya menggantikan sambungan DeepSeek terbina dalam.

Mulakan UI Web dengan npx @deepseek-ai/dsh web.
Buka Settings → Models.
Pilih Add custom provider.
Masukkan nilai berikut dan simpan penyedia.

Medan	Nilai
ID penyedia	`felo`
Nama paparan	`Felo API Platform`
URL asas	`https://openapi.felo.ai/api/v1`
Protokol API	Chat Completions serasi OpenAI (`openai-completions`)
Kunci API	Kunci API Felo anda
ID model	`deepseek-v4-flash`

Jika penemuan model gagal, tambahkan ID model secara manual. Tindakan Get available models penyedia bergantung pada laluan GET /models serasi OpenAI dan tidak diperlukan untuk konfigurasi manual.

Sahkan Persediaan

Mulakan sesi baharu dan tanya:

Summarize this repository and identify its main packages.

Persediaan sudah sedia apabila sesi selesai dengan deepseek-v4-flash dipilih dan tiada ralat pengesahan atau model tidak diketahui muncul.

Untuk ujian asap bukan interaktif dengan penyesuai yang disyorkan, jalankan dari ruang kerja sasaran:

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

Nota Carian Web

Persediaan ini menghalakan permintaan model melalui Felo. Penyedia web_search terbina dalam DeepSeek Harness mempunyai keperluan endpoint berasingan walaupun pembolehubah kelayakan lalainya juga DEEPSEEK_API_KEY. Jangan halakan DEEPSEEK_SEARCH_BASE_URL ke Felo melainkan anda menggunakan endpoint carian yang serasi secara eksplisit. Gunakan Chat API Felo atau Felo Skills lain secara berasingan apabila aliran kerja anda memerlukan carian Felo.

Penyelesaian Masalah

Isu	Apa yang perlu disemak
`MISSING_CREDENTIAL` atau 401	Sahkan `DEEPSEEK_API_KEY` mengandungi kunci Felo dalam proses yang memulakan `dsh`
URL permintaan mengandungi laluan dua kali	Gunakan `https://openapi.felo.ai/api/v1`, bukan URL yang berakhir dengan `/chat/completions`
`UNKNOWN_MODEL`	Pilih atau tambahkan `deepseek-v4-flash` secara manual, atau gunakan ID model Felo lain yang diterbitkan
Felo tidak disenaraikan secara berasingan	Gunakan persediaan penyedia tersuai; laluan yang disyorkan mengekalkan ID penyedia `deepseek-official`
Tetapan diubah tetapi sesi lama berkelakuan berbeza	Mulakan sesi baharu supaya ia menggunakan penyedia dan laluan model yang baru dipilih
Pengesahan carian web gagal	Konfigurasikan penyedia carian harness secara berasingan; tetapan endpoint model tidak mengkonfigurasi carian web