Cara Menginstal DeepSeek Harness (dsh): Aplikasi Desktop, npx Satu Baris, Build dari Sumber, dan Plugin

DeepSeek Harness (dsh) — runtime agen open-source yang dirilis DeepSeek pada 13 Agustus 2026 — mendapatkan klien desktop resmi pada 24 September 2026. Ini adalah aplikasi terpaket untuk Windows dan macOS Apple-silicon, diterbitkan dari host unduhan milik DeepSeek sendiri dengan runtime harness yang dibundel di dalamnya: tanpa pemasangan Node.js, tanpa npx, tanpa terminal. Baris perintah belum hilang — npx @deepseek-ai/dsh web masih menjadi rute tercepat di Linux, yang tidak dicakup oleh build desktop. Dua hal yang perlu diketahui sebelum Anda memulai: dsh bukan model — ini adalah lapisan harness yang menghubungkan model seperti DeepSeek V4 Flash 0731 atau DeepSeek V4 Pro 0813 ke alat, file, dan terminal — dan setiap kanalnya masih merupakan pratinjau pengembang, jadi perkirakan perubahan yang memutus kompatibilitas di antara rilis. Panduan ini mencakup aplikasi desktop, one-liner npx, build dari sumber, mode headless, plugin, MCP, dan kekurangan yang sebenarnya.

Apa itu Deep​Seek Harness — dan apa yang bukan

Formula internal Deep​Seek, yang dikonfirmasi oleh peneliti senior Chen Deli, adalah Model + Harness = Agent. Model adalah otak; harness adalah segala sesuatu yang mengubahnya menjadi sesuatu yang menyelesaikan pekerjaan: manajemen konteks dan memori, pemanggilan alat, perencanaan tugas, membaca dan menulis file, eksekusi terminal, umpan balik kesalahan, dan memutuskan kapan suatu tugas selesai. Deep​Seek Harness adalah lapisan tersebut, dirilis sebagai sumber terbuka di bawah lisensi MIT pada 13 Agustus 2026 — di hari yang sama ketika build DeepSeek V4 Pro 0813 tiba di Deep​Seek API.

Dua fakta mendefinisikan pengalaman instalasi. Pertama, arsitekturnya adalah "semuanya adalah plugin," yang dibangun di atas Cordis, sebuah wadah plugin TypeScript — jadi yang Anda instal adalah inti kecil plus sekumpulan plugin yang menyediakan adapter model, tools, sesi, dan UI. Kedua, kanal npm saat ini adalah 0.1.5-rc.3 pada latest dan 0.1.7-rc.2 pada next, keduanya release candidate yang oleh proyek itu sendiri ditandai sebagai pratinjau pengembang: README memperingatkan, dengan huruf kapital, bahwa perubahan yang merusak kompatibilitas akan datang. Popularitasnya nyata — 50.000 bintang GitHub dalam 12 jam pertamanya dan 235.000 pada akhir September 2026 — tetapi bintang mengukur minat, bukan stabilitas. Rencanakan instalasi Anda seperti Anda merencanakan pratinjau: cepat untuk dicoba, murah untuk dibuang.

Sebelum Anda mulai: persyaratan sistem yang sebenarnya

Untuk instalasi baris perintah, satu-satunya persyaratan wajib adalah Node.js. Proyek ini menargetkan rentang engine ^22.19.0 || >=24.0.0 — dalam istilah sederhana, Node 22.19 atau lebih baru, atau Node 24.x apa pun. Cek versi Anda dengan node --version Jika Anda menggunakan Node yang lebih lama, instalasi npx akan gagal atau berperilaku tidak semestinya, bukan mengalami degradasi yang terkendali. Aplikasi desktop di bawah ini adalah pengecualian: aplikasi ini menyertakan Node.js sendiri, jadi tidak memerlukan Node.js sama sekali.

Segala sesuatu yang lain lebih ringan daripada yang diasumsikan oleh kelompok model-first:

• Kunci API model. dsh menjalankan model asli; ia memerlukan kunci untuk API Deep​Seek atau penyedia apa pun yang kompatibel dengan Open​AI yang Anda konfigurasikan. Anda dapat menambahkannya di UI web setelah peluncuran pertama.

• pnpm — hanya untuk build dari sumber. Instal sekali dengan npm install -g pnpm.

• ~1 GB ruang disk kosong untuk paket npm, workspace, dan log sesi, ditambah apa pun yang dibutuhkan model lokal (dsh sendiri tidak menjalankan bobot). Penginstal desktop lebih berat — 288 MB untuk .exe Windows, image disk 368 MB di macOS — karena membawa runtime tersebut di dalamnya.

• OS: rute npm berfungsi di Windows, macOS, dan Linux. Aplikasi desktop lebih terbatas — hanya Windows x64 dan macOS dengan Apple silicon, tanpa build untuk Intel-Mac dan tanpa target Linux. SDK Python bahkan lebih terbatas lagi (Linux x64/arm64, macOS 14+ arm64 — tanpa Windows native), yang dibahas di bawah ini.

Anda tidak memerlukan GPU. Harness hanya mengorkestrasi; model berjalan dari jarak jauh melalui API.

Metode 1 — aplikasi desktop resmi (Windows dan macOS)

Pada 24 September 2026, DeepSeek menerbitkan build desktop terpaket pertama dari DeepSeek Harness. Ini adalah shell Electron di sekitar Web UI yang sama dengan runtime dsh yang dibundel di dalamnya, jadi tidak ada yang perlu dipasang terlebih dahulu dan tidak ada yang perlu dijalankan secara manual: tidak ada Node.js, tidak ada npx, tidak ada terminal, dan tidak ada tab browser yang dibiarkan terbuka di 127.0.0.1:3080. Sumbernya berada di repositori publik di bawah apps/desktop sebagai paket @deepseek-ai/dsh-desktop, artefaknya disajikan dari host unduhan produksi milik DeepSeek sendiri di download.deepseek.com/dsh-desk/, dan aplikasi mengikuti versi harness secara persis — build saat ini adalah 0.1.7-rc.2.

Apa yang disajikan host tersebut pada 25 September 2026:

• Windows — deepseek-harness-0.1.7-rc.2-win-x64.exe, sebuah installer 288 MB, dengan file .blockmap di sampingnya untuk pembaruan delta.

• macOS — deepseek-harness-0.1.7-rc.2-mac-arm64.dmg, image disk 368 MB, atau build yang sama dalam bentuk .zip 373 MB. Hanya untuk Apple silicon.

• Versi — 0.1.7-rc.2, dengan tanggal rilis 24 September 2026, sesuai dengan versi harness pada tag next npm.

• Hilang — tidak ada build Intel-Mac (feed pembaruan mac-x64 mengembalikan 404) dan tidak ada target Linux dalam bentuk apa pun.

Setiap target juga menerbitkan feed pembaruan di bawah download.deepseek.com/dsh-desk/feeds/, yang field releaseDate-nya merupakan tanggal build. Memeriksa file tersebut adalah cara tercepat untuk mengetahui apakah ada build yang lebih baru tanpa harus menunggu aplikasi menawarkannya.

Mengapa klien resmi adalah hal yang berbeda dari wrapper komunitas. Ia merupakan pihak pertama dan memperbarui sendiri, ia membawa runtime di dalam installer alih-alih mengambilnya saat peluncuran pertama, dan ia tidak menyajikan UI dari 3080 milik profil web: shell memuat aplikasi melalui skema internal dsh-app:// dan berbicara dengan proses host privat di portnya sendiri, secara default 19387. Ia juga berperilaku seperti aplikasi desktop — menutup jendela tetap membiarkan tugas yang berjalan tetap hidup (Windows menyimpan ikon tray), keluar akan bertanya lebih dulu saat ada pekerjaan yang sedang berjalan, dan catatan rilis 0.1.7-rc.2 menambahkan onboarding saat pertama kali dijalankan yang memperkenalkan kredit yang tersedia dan memisahkan tugas yang didanai akun dari tugas API-key, sehingga Anda dapat masuk dengan akun Deep​Seek alih-alih menempelkan kunci.

Dua catatan, karena klien ini dirilis secara diam-diam, bukan diumumkan. README repositori masih hanya mendokumentasikan npx dan build dari sumber, dan halaman proyek di www.deepseek.com/harness sama sekali tidak memuat tautan unduhan — binari dan feed pembaruannya aktif di host milik DeepSeek sendiri, yang kami verifikasi pada 25 September 2026, tetapi tidak ada catatan rilis di mana pun yang menjelaskannya. Dan kami belum menjalankan installer-nya, jadi panduan ini tidak mengambil sikap soal status penandatanganan atau notarisasi binari yang diterbitkan; pipeline pengemasan di repositori memang mencakup langkah penandatanganan kode Windows dan notarisasi Apple, dan hanya itu yang bisa dikatakan dari luar.

Salah satu konsekuensi dari build desktop yang mengikuti versi harness: saat ini build tersebut lebih baru daripada instalasi command-line default. Tag latest npm masih menunjuk ke 0.1.5-rc.3 sementara setiap artefak desktop adalah 0.1.7-rc.2. Jika Anda menginginkan harness terbaru pada platform yang tidak dicakup oleh aplikasi desktop, instal tag tersebut secara eksplisit — npx @deepseek-ai/dsh@next web — alih-alih mengandalkan default.

Metode 2 — one-liner npx (semua platform, termasuk Linux)

Panduan memulai resmi hanyalah satu perintah, dan itu benar-benar satu perintah:

npx @deepseek-ai/dsh web

npx fetches the @deepseek-ai/dsh package (npm's latest tag currently resolves to 0.1.5-rc.3, not the newest harness), installs it into npm's cache, and starts the Web UI profile. Watch the output for the line that tells you it's listening — by default that is http://127.0.0.1:3080. Open it in your browser. Note the 127.0.0.1 loopback address: the UI binds to localhost only, which is the right default for a tool that can read and write files in your workspace — it also means you won't casually expose it on your network.

Peluncuran pertama memiliki tepat dua langkah pengaturan:

• Tambahkan kunci model. Pengaturan → Model → masukkan kunci API Anda. Kunci disimpan di $DSH_HOME/.credentials.yaml dan tidak ditampilkan dalam teks biasa setelahnya. Pada instalasi standar DSH_HOME secara default adalah ~/.dsh.

• Pilih ruang kerja. Tambahkan direktori proyek tempat dsh diizinkan bekerja. Input tetap terkunci hingga kedua langkah selesai.

Lalu kirim tugas pertama — smoke test yang baik adalah "Ringkas repositori ini dan identifikasi paket-paket utamanya." Jika ringkasannya kembali dan panggilan alat muncul di run trace, instalasi Anda berfungsi.

Metode 3 — bangun dari sumber

Lebih suka menjalankan dari repositori? Jalur resminya adalah:

git clone https://github.com/deepseek-ai/deepseek-harness.git

cd deepseek-harness

pnpm install

pnpm run build

pnpm dsh web

Anda memerlukan pnpm untuk ini (kontributor mengunci pnpm 11.7.0). Pilih build sumber jika Anda ingin menjalankan versi terbaru dari main daripada kandidat rilis yang diterbitkan, jika Anda berencana membaca atau memodifikasi harness, atau jika Anda ingin membuat preset kustom dari apps/cli/config/agent-presets/ direktori repositori. Untuk yang lainnya, rute npx adalah perangkat lunak yang sama dengan lebih sedikit formalitas — build sumber tidak membuka fitur yang tidak dimiliki paket npm.

Tiga profil: web, headless, dan tui

dsh hadir sebagai tiga profil run, dan profil mana yang Anda gunakan bergantung pada di mana pekerjaan tersebut terjadi:

• web (default) — antarmuka browser lengkap pada port 3080. Ini yang npx @deepseek-ai/dsh web jalankan, dan ini adalah profil yang paling sering dipasang pertama kali oleh kebanyakan orang.

• headless — satu tugas, lalu keluar. dsh --profile headless "run the test suite and report failures" memulai sesi, menjalankan tugas, menulis hasilnya, dan berhenti. Runtime headless secara eksplisit adalah proses satu tugas: Anda tidak dapat menyuntikkan tindak lanjut di tengah proses, dan koreksi adalah proses baru terhadap workspace yang sama. Ini adalah profil yang dipasang ke skrip dan CI.

• tui — UI terminal untuk sesi berbasis keyboard: dsh --profile tui.

Ketiganya berbagi konfigurasi yang sama (~/.dsh/profiles/<name>/) dan sistem plugin yang sama, sehingga memindahkan tugas dari antarmuka web ke headless hanyalah pergantian perintah, bukan instalasi ulang.

Menambahkan plugin

Manajemen plugin adalah perintah CLI kelas satu, bukan urusan edit-in-place:

npx @deepseek-ai/dsh plugin --profile web add <source>

Sumbernya bisa berupa nama paket npm, repositori GitHub (github:user/repo), sebuah tarball, atau folder lokal. Instalasi pertama yang paling berguna adalah pasar plugin resmi, yang mengubah penemuan plugin menjadi UI:

npx @deepseek-ai/dsh plugin --profile web add dshmarket

Lalu mulai ulang layanan web dan buka Settings → Plugin Market untuk menjelajah dan menginstal sekali klik dari katalog. Dua aturan yang sering menjebak orang: bundel plugin terpasang saat profil dimulai, jadi plugin yang baru ditambahkan memerlukan mulai ulang dari dsh web; dan hanya npm install memang tidak mendaftarkan plugin ke dalam profil — Anda harus menggunakan dsh plugin. Ekosistemnya masih muda tetapi tidak kosong: daftar awesome-dsh-plugin yang dikelola komunitas sudah mengkatalogkan ratusan plugin lintas kategori seperti UI, skill, alat, penyedia, dan notifikasi.

MCP, empat prasetel, dan pemutaran ulang lintasan.

Ada tiga fitur yang penting setelah Anda melewati instalasi dasar:

MCP. dsh berbicara dengan Model Context Protocol melalui @deepseek-ai/dsh-mcp-client plugin bawaan. Saat ini, hal itu dikonfigurasi dalam file, bukan di UI: Anda mengedit ~/.dsh/profiles/web/cordis.patch.yml (atau patch khusus proyek) dan mendeklarasikan transport setiap server — stdio untuk perintah lokal seperti npx @playwright/mcp@latest, streamable-http untuk URL jarak jauh. Ini berfungsi, tetapi ini adalah bagian yang paling kurang dipoles dalam pratinjau; perkirakan ketidakstabilan sesekali dan tidak ada GUI untuk mengaktifkan/menonaktifkan server.

Preset. dsh memuat salah satu dari empat preset agen per sesi, dan masing-masing merupakan trade-off yang berbeda:

• Standard — perangkat alat lengkap: pengeditan file, shell, pengambilan file dan web, keterampilan, perencanaan, subagen, alur kerja. Default harian.

• PTC (Pemanggilan Alat secara Programatik) — Standar plus SDK Code Mode yang memungkinkan model menulis program TypeScript untuk mengatur panggilan alat multi-putaran. Lebih kuat, lebih banyak efek samping.

• Minimal — hanya bash dan editor file, tidak ada yang lain. Dibuat untuk benchmarking model dan reproduksi minimal; mode yang dirujuk oleh dokumentasi DeepSeek V4 Flash API ketika mereka mengungkapkan bahwa skor agen mereka sendiri berjalan pada "Deep​Seek Harness minimal mode."

• Creation — playground runtime: memeriksa dan memuat plugin Cordis di memori, bereksperimen, dan memantapkan kombinasi yang berfungsi menjadi preset baru.

Pemutaran ulang Trajectory. Setiap run menulis log sesi yang hanya dapat ditambahkan (append-only) — prompt sistem, penalaran, panggilan alat beserta hasilnya, penjadwalan subagen. Tampilan Trajectory memungkinkan Anda memeriksa berdasarkan sumber, melanjutkan, mem-fork, mencari, dan memutar ulang sebuah run. Itulah debugger untuk kerja agen: ketika tugas gagal, Anda tidak perlu menjalankan ulang dan berharap; Anda memutar ulang lintasan yang gagal, mem-fork-nya pada langkah yang salah, dan menguji perbaikan tanpa membuang yang asli.

Opsi SDK Python

Jika Anda lebih suka menjalankan harness dari Python daripada dari peramban, ada SDK resmi: pip install deepseek-harness-sdk. SDK ini menyertakan runtime dsh (pip wheel membawa runtime Node, jadi tidak perlu instal Node terpisah), dan penggunaannya adalah context manager: buat sebuah Deep​SeekHarness instance, panggil run("task"). Ini mewarisi variabel lingkungan standar seperti DEEPSEEK_API_KEY dan DEEPSEEK_BASE_URL, sehingga pergantian penyedia hanyalah perubahan konfigurasi. Kelemahannya: SDK ini membutuhkan Python 3.10+ dan hanya mendukung Linux x64/arm64 dan macOS 14+ arm64 — tidak ada wheel Windows asli, yang merupakan celah nyata jika host Anda adalah Windows. Di Windows, tetap gunakan rute npm.

Menunjuk dsh ke model yang Anda bayar

dsh memerlukan kunci API model, dan ia sengaja agnostik terhadap penyedia: Settings → Models menerima penyedia kustom dengan base URL yang kompatibel dengan Open​AI (di settings.yaml yaitu api: openai-completions, baseURL, dan daftar models). Defaultnya adalah API Deep​Seek sendiri; penyedia kustom adalah tempat gateway routing menjadi berguna.

OrcaRouter is an Open​AI-compatible endpoint that passes Deep​Seek's list price through with zero markup — https://api.orcarouter.ai/v1. The models dsh will actually call are all on it: DeepSeek V4 Flash 0731 (deepseek/deepseek-v4-flash-0731, $0.22 per million input tokens and $0.66 per million output), DeepSeek V4 Pro 0813 (deepseek/deepseek-v4-pro-0813, $0.66/$1.98) and DeepSeek V4.1 Flash (deepseek/deepseek-v4.1-flash, $0.15/$0.60), the model Deep​Seek's own rate card bills as deepseek-flash. Every rate doubles inside Deep​Seek's peak windows, 01:00-04:00 and 06:00-10:00 UTC on weekdays; the router passes that surcharge through rather than hiding it, and automatic failover moves a request to another provider if one wobbles. Figures checked against both rate cards on September 25, 2026. For dsh, the practical win is that you can keep the cheap tier for the bulk of everyday agent tasks and switch the same harness to V4 Pro for the hard passes — one key, one base URL, and the swap is a model name in the settings, not a reinstall.

Untuk memperjelas batasan: OrcaRouter menghosting model yang dipanggil dsh; ia tidak menghosting dsh itu sendiri, dan juga tidak menyertakan klien desktop — itu berasal dari host unduhan Deep​Seek sendiri. dsh adalah runtime agen lokal, dan Anda menjalankannya di mesin Anda sendiri.

Di mana panduan ini salah untuk Anda — masalah jujur dengan pratinjau

Tutorial instalasi yang hanya memberi tahu Anda apa yang harus diketik baru melakukan setengah pekerjaan. Inilah yang keliru dari pratinjau hari ini, agar Anda tidak menemukannya pada pukul 2 pagi:

• Perubahan yang merusak adalah janji, bukan peringatan. Anda berada di kandidat rilis — 0.1.5-rc.3 jika Anda menggunakan default npm, 0.1.7-rc.2 jika Anda memasang aplikasi desktop atau tag next. Kunci konfigurasi, API plugin, dan format preset semuanya bisa berubah tanpa pemberitahuan. Anggap ~/.dsh sebagai status yang bisa dibuang — biaya dari pembaruan yang buruk adalah instalasi ulang, dan itu dapat diterima pada tahap ini hanya karena setiap jalur instalasi di sini adalah unduhan atau satu perintah.

• Anda tidak perlu dsh untuk menggunakan model Deep​Seek sebagai agen. Jika tujuan Anda hanya DeepSeek V4 Flash atau DeepSeek V4 Pro di dalam agen saat ini, endpoint kompatibel Anthro​pic milik Deep​Seek sudah berfungsi di Claude Code dan alat agen lain tanpa perangkat lunak baru. dsh adalah opsi pihak pertama, bukan prasyarat. Lewati pemasangan ini sampai Anda secara khusus menginginkan harness asli.

• MCP dikonfigurasi melalui file dan terkadang tidak stabil. Tidak ada GUI, tidak ada sakelar mulai/berhenti per-server, dan laporan langsung menggambarkan kegagalan intermiten. Sisihkan waktu untuk debugging YAML jika alur kerja Anda bergantung pada server MCP.

• Kepercayaan pada plugin adalah keputusan keamanan. Plugin pihak ketiga berjalan di dalam proses inti harness, dan tidak ada verifikasi tanda tangan atau sumber saat instalasi. Hanya instal plugin yang sudah kamu baca atau yang berasal dari sumber yang kamu percaya, dan uji di ruang kerja sekali pakai sebelum mengarahkannya ke pekerjaan nyata. Profil sandbox danger-full-access dapat memodifikasi file apa pun yang terlihat — gunakan hanya untuk checkout sekali pakai.

• Bug yang diketahui ada di pratinjau. Loop bash yang menggantung adalah mode kegagalan yang terdokumentasi (hentikan dan coba lagi), dan perilaku pada sesi yang berjalan lama masih belum stabil.

• Build desktop tidak resmi tidak lagi memiliki peran. Hingga 24 September 2026, satu-satunya aplikasi desktop dsh yang bisa dipasang dengan sekali klik adalah wrapper komunitas tanpa tanda tangan, dan pilihannya hanya antara itu dan command line. Klien resmi menghilangkan dilema itu: buatan pihak pertama, runtime sudah dibundel, memperbarui sendiri. Tidak ada jalur migrasi yang sesungguhnya antara kedua jenis shell tersebut — keduanya membungkus harness yang sama — jadi copot yang satu dan pasang yang lain, lalu pertahankan direktori workspace yang sama.

• Jika Anda membutuhkan stabilitas produksi, tunggu rilis non-rc. Harness ini kuat tetapi belum matang. Untuk stack agen produksi, harness yang matang dan teruji — atau rute endpoint yang kompatibel dengan Anthro​pic — adalah pilihan yang dapat dipertahankan sampai dsh mencapai tag stabil.

Intinya

Menginstal DeepSeek Harness kini menjadi dua pekerjaan berbeda tergantung platform Anda. Di Windows atau Mac dengan chip Apple silicon, unduh 0.1.7-rc.2 dari host milik DeepSeek sendiri dan selesai — tanpa Node.js, tanpa terminal, dan versi harness terbaru di kanal mana pun. Di tempat lain, masih tetap satu perintah di Node 22.19+: npx @deepseek-ai/dsh@next web, lalu tambahkan kunci model dan sebuah workspace dan kirim tugas uji. Gunakan headless untuk skrip, build sumber hanya jika Anda ingin memodifikasi atau melacak main, dan anggap MCP sebagai pekerjaan yang masih berlangsung. Catatan jujurnya tidak berubah: setiap kanal ini adalah kandidat rilis 0.x dan akan merusak berbagai hal dalam perjalanan menuju stabil — pertukaran yang wajar jika Anda ingin melihat ke arah mana DeepSeek membawa lapisan agen. Model yang dijalankannya — DeepSeek V4 Flash 0731, DeepSeek V4 Pro 0813 dan DeepSeek V4.1 Flash — tersedia hari ini dengan harga daftar melalui OrcaRouter, siap menggerakkan harness di sisi lain instalasi.