Logo Spartan AI Spartan AI Panduan DeepSeek Harness
ENID
Konsultasi gratis
Windows · macOS · LinuxNode.js 22.19+/24+Open source MIT

Cara install DeepSeek Harness di Windows, macOS, dan Linux

Dua jalur pemasangan: jalankan langsung dengan npx (paling cepat, tidak mengubah sistem Anda), atau pasang dari source dengan pnpm bila Anda ingin mengembangkan plugin atau mengunci versi tertentu. Keduanya dijelaskan langkah demi langkah di bawah.

Cara tercepatAda masalah? Lihat solusi
Persiapan

Prasyarat dan kompatibilitas

Yang perlu tersedia sebelum memasang
KomponenVersi / catatanWajib?
Node.js^22.19.0 atau >= 24.0.0Wajib
pnpm11.28.5 (hanya untuk pemasangan dari source)Untuk build source
GitVersi terbaruUntuk clone repositori
Python3.10 atau lebih baruHanya bila memakai SDK Python
Sistem operasiLinux x64/arm64, macOS 14+ (arm64), Windows x64Wajib
API key modelDari platform DeepSeek atau provider lainUntuk memanggil model
Cek versi Node.js Anda

Jalankan node -v. Bila hasilnya di bawah 22.19, perbarui Node.js lebih dulu (disarankan memakai versi LTS terbaru). Node.js juga menyertakan npx yang dibutuhkan pada cara pertama.

Cara 1

Cara tercepat: jalankan dengan npx

  1. Buka terminal di folder proyek

    Di Windows gunakan PowerShell; di macOS/Linux gunakan Terminal. Folder tempat Anda menjalankan perintah menjadi folder kerja bawaan agen.

  2. Jalankan antarmuka web DeepSeek Harness

    Perintah berikut mengunduh paket resmi, menjalankan server lokal, dan membuka browser secara otomatis.

  3. Pilih folder kerja dan model

    Di antarmuka web, klik Choose workspace bila ingin folder lain, lalu isi API key pada Settings → Models.

powershell / bash
# jalankan antarmuka web (browser terbuka otomatis)
npx @deepseek-ai/dsh web

# tanpa membuka browser (mis. di server)
npx @deepseek-ai/dsh web --no-open

# ganti port bila 3080 sudah dipakai
npx @deepseek-ai/dsh web --port 8080

Alamat bawaan antarmuka web adalah http://127.0.0.1:3080.

hasil yang diharapkan
PS C:\proyek> npx @deepseek-ai/dsh web
→ mengunduh @deepseek-ai/dsh…
→ profil 'web' dimuat
→ server berjalan di http://127.0.0.1:3080
→ membuka browser…
Cara 2

Pasang dari source (untuk pengembang plugin)

  1. Clone repositori resmi

    Repositori DeepSeek Harness tersedia di GitHub pada organisasi deepseek-ai.

  2. Pasang dependensi dan build

    Gunakan pnpm sesuai versi yang didukung agar kunci dependensi tetap konsisten.

  3. Jalankan dari hasil build

    Perintah pnpm dsh menjalankan versi lokal, sehingga perubahan plugin Anda langsung teruji.

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

Butuh pnpm 11.28.5 dan Node.js sesuai prasyarat di atas.

Menambah paket plugin

Untuk memasang paket plugin ke sebuah profil, gunakan perintah plugin dengan argumen pnpm. Ini menjaga profil tetap konsisten dan tidak mengacaukan dependensi global.

plugin
dsh plugin --profile web add @nama/plugin-anda

Contoh format; sesuaikan nama profil dan paket dengan kebutuhan Anda.

Profil

Memilih profil yang sesuai

Profil adalah kumpulan plugin dan pengaturan yang dimuat bersama. Dengan profil, satu pemasangan DeepSeek Harness dapat dipakai untuk beberapa tujuan tanpa saling mengganggu: antarmuka web untuk pekerjaan harian, mode headless untuk otomasi, dan mode SDK untuk dipanggil dari kode.

Profil yang tersedia
ProfilKegunaanContoh
webAntarmuka web lokal untuk pemakaian harian.dsh web
headlessMenjalankan tugas tanpa antarmuka — cocok untuk skrip dan CI.dsh --profile headless "tugas"
sdk / sdk-minimalUntuk dipanggil dari aplikasi Anda (termasuk Python SDK).dsh --profile sdk
acpIntegrasi editor/agen yang mendukung protokol ACP.dsh --profile acp
desktopNama profil yang disediakan untuk aplikasi desktop.Dipakai otomatis oleh aplikasi desktop.
flag berguna
dsh --version                  # cek versi
dsh --help                     # daftar perintah
dsh --dump-config              # lihat konfigurasi aktif
dsh --dump-default-config      # lihat konfigurasi bawaan
dsh --dump-config-schema       # skema konfigurasi
dsh --patch berkas.yml         # tambahkan penambalan konfigurasi

Argumen setelah flag launcher diteruskan ke aplikasi, misalnya --port.

Model

Mengatur API key dan model

  1. Buka pengaturan model

    Di antarmuka web atau aplikasi desktop, buka Settings → Models.

  2. Tempelkan API key

    Kunci disimpan pada berkas kredensial lokal di dalam direktori $DSH_HOME (bawaan ~/.dsh) dan hanya bisa ditulis, tidak dibaca ulang oleh aplikasi lain. Tidak perlu memulai ulang untuk mengaktifkannya.

  3. Tambahkan provider lain bila perlu

    Gunakan Add model provider untuk provider pihak ketiga atau gateway sendiri. Tiga protokol yang didukung: openai-completions, openai-responses, dan anthropic-messages.

Struktur folder konfigurasi DeepSeek Harness
LokasiIsi
$DSH_HOME (bawaan ~/.dsh)Pusat pengaturan pengguna.
settings.yamlPreferensi umum aplikasi.
.credentials.yamlKunci API (tulis saja).
profiles/<nama>/cordis.patch.ymlPenambalan konfigurasi untuk profil tersebut.
skills/Skill yang berlaku untuk semua proyek.
sessions/Riwayat sesi.
Jaga kerahasiaan kunci

Jangan menempelkan API key ke dalam berkas proyek, skrip contoh, atau tangkapan layar. Bila kunci pernah bocor, cabut dan buat ulang di dasbor provider.

Model lokal

Menjalankan model lokal dengan Ollama

Bila data tidak boleh keluar dari komputer atau jaringan Anda, DeepSeek Harness dapat dijalankan bersama model lokal melalui integrasi Ollama. Cocok untuk eksplorasi, pengujian alur kerja, atau pekerjaan dengan data internal.

bash / powershell
# jalankan DeepSeek Harness melalui Ollama
ollama launch dsh

# pilih model tertentu
ollama launch dsh -- --model nama-model-anda

Konfigurasi integrasi ini disimpan terpisah oleh Ollama dan tidak mengubah pengaturan DeepSeek Harness Anda.

Perlu diingat: model lokal yang berjalan di komputer biasa biasanya kurang mampu mengikuti instruksi panjang dibanding model cloud. Untuk tugas berlapis (workflow, subagent), model cloud masih lebih andal.

Verifikasi

Memastikan instalasi berhasil

  • node -v menampilkan versi 22.19 ke atas (atau 24+).
  • dsh --version menampilkan versi DeepSeek Harness.
  • Antarmuka web terbuka di http://127.0.0.1:3080.
  • Folder kerja menampilkan berkas proyek Anda.
  • Settings → Models menunjukkan model yang aktif, dan tugas percobaan berhasil dijalankan.
verifikasi cepat
PS C:\> dsh --version
dsh 0.x.y (developer preview)
PS C:\> dsh web
→ profil 'web' dimuat
→ http://127.0.0.1:3080
tugas percobaan pertama
Sebutkan lima berkas terbesar di folder ini beserta ukurannya, dan jangan ubah apa pun.

Tugas baca-saja seperti ini aman dijalankan pada mode sandbox paling ketat.

Kendala

Masalah instalasi yang sering terjadi

Gejala, penyebab, dan solusi
GejalaPenyebabSolusi
npx tidak dikenali.Node.js belum terpasang atau terminal belum dimuat ulang.Pasang Node.js versi LTS, lalu buka terminal baru.
Galat versi Node terlalu lama.Versi di bawah 22.19.Perbarui Node.js ke 22.19+ atau 24+.
Port 3080 sudah dipakai.Aplikasi lain memakai port yang sama.Jalankan dengan --port 8080 atau port lain yang bebas.
Browser tidak terbuka otomatis.Mode server atau lingkungan tanpa desktop.Buka alamat yang tertulis di terminal secara manual.
Panggilan model ditolak.API key belum diisi atau salah.Isi ulang pada Settings → Models dan pastikan kuota tersedia.
pnpm install gagal.Versi pnpm tidak sesuai atau cache rusak.Pakai pnpm 11.28.5 dan bersihkan cache pnpm bila perlu.
Lanjut ke panduan pemakaianMinta bantuan gratis

Butuh bantuan menerapkan DeepSeek Harness?

Konsultasi gratis dengan Andi untuk memilih cara pakai, menyiapkan alur kerja, atau mengevaluasi keamanan sebelum dipakai di tim Anda.

Telepon +62 897-6003-363 WhatsApp Halaman kontak
Hubungi Andi — +62 897-6003-363
Telepon Andi WhatsApp