DeepSeek Harness di Windows: Tanpa Aplikasi Desktop, Tidak Masalah — Cara Resmi untuk Menjalankannya

There is no official DeepSeek Harness desktop app for Windows, and you do not need one. DeepSeek Harness (dsh) — the open-source agent runtime DeepSeek released under an MIT license on 2026-08-13 — is a Node.js tool that runs a local web server you open in your browser, with a headless CLI for the terminal as the alternative. On Windows the whole setup is two commands: install Node.js 22.19 or newer (Node 24 LTS is the safer pick), then run npx @deepseek-ai/dsh web and open http://127.0.0.1:3080. Every "DeepSeek Harness Desktop" repository on GitHub is an unofficial community wrapper around that same two-command setup — useful to some people, but not required. It is also the harness DeepSeek uses to produce the agentic coding results it reports for DeepSeek V4 Pro and DeepSeek V4 Flash, which is why the two models keep showing up in any conversation about it.

Jika Anda mencari "deepseek harness windows", Anda mungkin sedang melihat-lihat halaman berisi repositori wrapper tersebut dan bertanya-tanya mana yang harus dipasang. Artikel ini menjawab pertanyaan sebenarnya di balik pencarian tersebut: apa sebenarnya DeepSeek Harness itu, cara resmi menjalankannya di Windows saat ini, alternatif terminal, dan catatan jujur tentang menjalankan alat yang masih tahap pratinjau. Ini adalah artikel panduan, bukan pengumuman peluncuran — peluncuran dan jejak kebocorannya dibahas dalam tulisan terpisah.

Apa itu DeepSeek Harness (dan apa yang bukan)

DeepSeek Harness bukanlah model, dan ia tidak melakukan benchmark terhadap model. Ia adalah runtime agen: lapisan yang menghubungkan model dengan alat, file, shell, dan internet — membaca kode Anda, merencanakan perubahan, menjalankan perintah, dan melakukan iterasi hingga tugas selesai. Arsitekturnya dinyatakan dalam tagline-nya: "Semuanya adalah Plugin." Model, alat, keterampilan, sesi, sandbox, loop agen itu sendiri, dan bahkan UI web adalah plugin yang disusun saat startup, dibangun di atas meta-framework Cordis — kernel yang sama di balik ekosistem chatbot Koishi. Deployment default menyertakan lebih dari 150 plugin.

Ini juga jelas merupakan pratinjau. dsh berada di versi 0.1.0-rc.6, README menyebutnya pratinjau pengembang, dan memperingatkan dengan huruf kapital bahwa "AKAN ADA PERUBAHAN YANG MELANGGAR KOMPATIBILITAS." Semua itu tidak memperlambat adopsi: proyek ini mencapai sekitar 50.000 bintang GitHub dalam 12 jam pertama setelah dipublikasikan pada 2026-08-13, dan berada di sekitar 126.000 per 2026-08-16 — rilisan sumber terbuka tercepat yang pernah dirilis DeepSeek.

Jawaban singkatnya: jalur resmi Windows adalah dua perintah.

README resmi DeepSeek memberikan cara menjalankan di Windows dalam satu baris: instal Node.js, lalu jalankan npx @deepseek-ai/dsh web. Secara konkret, langkah-langkahnya adalah:

• Instal Node.js 22.19+ atau Node 24. Rilis dsh saat ini memerlukan Node 22.19 atau lebih baru; Node 24 LTS adalah pilihan yang lebih aman di Windows, dan alasannya sederhana — versi Node yang lebih baru menyertakan dekompresi zstd asli, yang digunakan dsh untuk membaca log sesi terkompresinya. Periksa instalasi Anda dengan node --version di PowerShell atau cmd.

• Run the harness. Either run it on the spot with npx @deepseek-ai/dsh web, or install it once with npm install -g @deepseek-ai/dsh and then run dsh web from any folder afterwards. The first run prints the URL and starts the Web UI at http://127.0.0.1:3080.

• Buka alamat tersebut di browser Anda. Web UI adalah aplikasi web lokal — oleh karena itu tidak ada aplikasi desktop; browser adalah aplikasi desktopnya.

• Tambahkan kunci model satu kali. Di antarmuka web, buka Pengaturan → Model, tempel kunci API DeepSeek, lalu simpan. Perubahan langsung berlaku, tanpa perlu memulai ulang server. dsh menggunakan folder tempat Anda memulainya sebagai lokasi sistem file default, dan langkah Pilih workspace pada UI memungkinkan Anda mengarahkannya ke direktori proyek mana pun.

Itulah seluruh jalur resmi. Jika sebuah mesin sudah memiliki Node 22+ terinstal, waktu dari "tidak ada" hingga "agen berjalan" kurang dari satu menit.

Mengapa setiap repo "DeepSeek Harness Desktop" adalah wrapper

Hasil halaman-1 untuk kueri ini semuanya adalah pembungkus desktop komunitas — cangkang Electron, Tauri, dan WebView2 yang menggabungkan runtime Node dan meluncurkan UI Web resmi di dalam jendela berbingkai. Mereka bukan produk DeepSeek, dan tidak menambahkan kemampuan harness; mereka menambahkan peluncur. Kesamaan yang mereka miliki:

Mereka cukup diluncurkan dengan klik ganda dan sepenuhnya menghindari baris perintah, yang merupakan nilai jual utama mereka.

• Mereka tidak ditandatangani, sehingga Windows SmartScreen akan memperingatkan saat instalasi — "Info selengkapnya → Jalankan tetap" adalah bagian dari alurnya.

Mereka mengikuti proyek resmi dengan kecepatan berbeda: sebagian mengunci 0.1.0-rc.5, sebagian 0.1.0-rc.6, sebagian mengikuti master, sehingga versi wrapper dan harness menyimpang seiring waktu.

• Mereka menyimpan data lokal yang sama yang selalu digunakan dsh di ~/.dsh, jadi beralih antara wrapper dan CLI resmi tidak mereset sesi Anda.

Kapan sebuah wrapper sepadan? Ketika "klik dua kali ikon, lihat tray, tidak pernah menyentuh terminal" menjadi faktor penentu, dan Anda menerima bahwa pihak ketiga kini menjadi lapisan pembaruan dan keamanan di depan alat tahap pratinjau. Kapan tidak sepadan? Jalur resminya adalah dua perintah dan satu tab browser — jika Anda sudah memiliki Node, wrapper hanya memberi Anda peluncur yang mungkin tidak Anda butuhkan, dan menambah permukaan pemeliharaan sendiri sebagai gantinya.

Rute terminal: plugin CLI headless dan TUI

Jika peramban bukan tempat Anda bekerja, dsh juga punya cerita terminal, terbagi menjadi dua mode.

Headless adalah profil noninteraktif: dsh --profile headless "summarize this repository" menjalankan satu tugas tanpa antarmuka, mencetak hasilnya, lalu keluar — mode yang ramah CI. Di Windows, ini juga mode yang sebaiknya digunakan oleh skrip dan tugas terjadwal, karena tidak memerlukan tampilan atau sesi yang masuk.

TUI adalah antarmuka terminal interaktif bergaya Claude Code, dirilis sebagai bundel plugin komunitas, bukan disertakan dalam paket inti. Paket seperti dsh-tui diinstal ke dalam profil dengan dsh plugin --profile tui add <package> dan dijalankan dengan dsh --profile tui; setidaknya satu menyertakan peluncur .cmd Windows. Hal yang perlu diketahui sebelum Anda mencoba: TUI memerlukan terminal sungguhan untuk masukan dan keluaran — jika pengaturan Anda menggunakan pipe atau redirect, dsh akan menolak dan memberi tahu Anda untuk menggunakan headless sebagai gantinya.

Empat preset: yang mana untuk pekerjaan yang mana

dsh menyertakan empat preset agen bawaan, dan itu bukanlah tangga kesulitan — melainkan empat permukaan alat yang berbeda. Anda menetapkan default-nya di ~/.dsh/settings.yaml di bawah agent-presets.default.

• Standar adalah default: agen harian lengkap — pengeditan file, shell, pencarian file dan web, keterampilan, subagen, dan perencanaan. Inilah yang sebaiknya menjadi titik awal bagi sebagian besar pengguna Windows.

• PTC (juga disebut Mode Kode) mempertahankan semua fitur Standard tetapi mengubah cara alat-alat diekspos: alih-alih rangkaian panjang panggilan alat yang terisolasi, model menulis program TypeScript yang menyusun operasi multi-langkah — loop, filter, cabang kondisional. Untuk alur kerja yang kompleks, berulang, atau multi-langkah.

• Minimalsengaja mengurangi agen menjadi dua alat — shell persisten dan editor file — dan ditujukan untuk evaluasi dan benchmarking, bukan pekerjaan sehari-hari. Ini adalah preset yang digunakan untuk skor agentic DeepSeek sendiri.

• Creation (Cordis) digunakan untuk membuat preset kustom: termasuk inspeksi runtime, eksperimen plugin dalam memori, dan panduan pembuatan preset. Untuk mengutak-atik harness itu sendiri.

MCP dan replay lintasan: mengapa ini layak dijalankan

Dua fitur membenarkan penggunaan dsh dibandingkan klien obrolan biasa. Pertama, klien Model Context Protocol (MCP) sudah tertanam — perintah /mcp dan tab Settings MCP menghubungkan server MCP eksternal ke dalam harness, sehingga alat yang sama yang digunakan agen lain Anda terhubung ke dsh. Kedua, setiap proses dijalankan ditulis ke log sesi yang hanya dapat ditambahkan (append-only), dan tampilan Trajectory memungkinkan Anda memeriksa proses berdasarkan sumber, melanjutkannya, membuat cabang (fork), mencarinya, dan memutarnya ulang. Itulah perbedaan antara men-debug agen dengan menatap jawaban akhirnya dan melangkah melalui alasan mengapa agen tersebut melakukan setiap panggilan.

Ketika jalur resmi adalah jawaban yang salah

• Anda memerlukan instalasi sekali klik, tanpa terminal.Tidak ada penginstal resmi. Jika klik dua kali adalah syarat mutlak, Anda menggunakan wrapper komunitas — yang tidak ditandatangani, jadi pertimbangkan kemudahannya dibandingkan cakupan pemeliharaan pihak ketiga.

• Komputer Windows Anda sudah lama atau terkunci. dsh membutuhkan Node 22.19+ (atau Node 24). Pada mesin terkelola, ini berarti instalasi runtime dan mungkin persetujuan yang tidak Anda miliki.

• Ini adalah pratinjau, dan ia dapat rusak. 0.1.0-rc.6 hadir dengan peringatan bahwa akan ada perubahan yang merusak; di antara build rc, plugin dan profil dapat berhenti berfungsi. Kunci versi Anda untuk apa pun yang menggunakan skrip.

• Tagihan model menjadi tanggungan Anda. dsh gratis; setiap tugas menghabiskan token pada kunci apa pun yang Anda konfigurasikan. Loop agen membaca ulang file dan mencoba lagi, dan model yang verbose pada tugas yang sulit dapat menghabiskan anggaran yang mengejutkan dalam satu sore. Di sinilah pilihan model, bukan pilihan harness, yang mendominasi biaya.

• Langganan flat mungkin mengungguli perutean per-token. Jika Anda berada di dalam paket satu lab di bawah batasnya, langganan flat sering kali lebih murah daripada jalur per-token mana pun. Perutean menang jika Anda mencampur model atau ingin failover — bukan secara default.

Rutekan model di belakang harness.

Jalur asli adalah API milik DeepSeek: tempel kunci di Settings → Models dan selesai. Tetapi dsh juga menerima base URL yang kompatibel dengan OpenAI — atur DEEPSEEK_BASE_URL di lingkungan atau konfigurasikan penyedia LLM di settings.yaml — yang berarti model di balik harness dapat diganti tanpa menyentuh harness. Anda dapat menjalankan DeepSeek V4 Pro untuk refactor yang sulit dan DeepSeek V4 Flash untuk edit mekanis murah, pada instalasi dsh lokal yang sama.

Itu adalah lapisan yang ditempati OrcaRouter. Satu base URL yang kompatibel dengan OpenAI, 200+ model, tanpa biaya tambahan — harga daftar penyedia diteruskan apa adanya — dan failover otomatis saat penyedia membatasi kecepatan atau mengalami penurunan kinerja. Arahkan dsh ke sana dan harness tetap berada di mesin Anda sementara katalog model menjadi keputusan perutean, bukan pembelian. Dua catatan jujur: kami tidak menghosting dsh — ia berjalan secara lokal di mesin Windows Anda, dan kami hanyalah lapisan akses model jika Anda menginginkan model di luar API DeepSeek sendiri. Dan untuk satu model berat yang berada di dalam batas rencananya, langganan flat sering kali merupakan pilihan yang lebih murah terlepas dari router.

Versi singkatnya

DeepSeek Harness di Windows adalah pengaturan dua perintah, bukan instalasi dari toko aplikasi: Node 22.19+ (atau Node 24), lalu npx @deepseek-ai/dsh web, kemudian browser Anda di http://127.0.0.1:3080. Repositori "desktop" GitHub adalah pembungkus tidak resmi di sekitar server lokal yang sama. Untuk terminal, headless menjalankan tugas sekali jalan untuk CI, dan plugin TUI memberikan antarmuka bergaya Claude Code. Empat prasetel — Standard, PTC, Minimal, Creation — menentukan permukaan alat, dan MCP plus pemutaran ulang lintasan membuatnya benar-benar berguna. Ini gratis, sumber terbuka, dan masih tahap pratinjau: kunci versinya, pantau tagihan model, dan rute model secara terpisah dari harness.