Aplikasi Desktop DeepSeek Harness: Apa yang Sebenarnya Dipasang Installer di Komputer Anda

Aplikasi desktop DeepSeek Harness adalah cangkang Electron yang membungkus antarmuka web yang sama seperti yang Anda dapatkan dari npx @deepseek-ai/dsh web, dan tersedia sebagai tiga penginstal khusus platform untuk harness yang saat ini berada pada versi 0.2.1-rc.2. Deskripsi itu terdengar meremehkan, dan bukan itu maksudnya. Membungkus antarmuka yang berfungsi dalam kontainer desktop adalah pekerjaan satu akhir pekan; membungkusnya dalam kontainer yang memiliki direktori runtime sendiri, menjaga tugas Anda tetap hidup saat Anda menutup jendela, memperbarui dirinya sendiri pada kanal tanpa rilis stabil, dan mempertahankan sesi Anda di setiap operasi tersebut adalah bagian yang memakan waktu berbulan-bulan, dan itulah bagian yang layak dibaca. Jika Anda ingin menjalankan DeepSeek-V4.1-Flash melalui harness yang hidup di jendela alih-alih terminal, inilah build tersebut, dan pertanyaan-pertanyaan menariknya semuanya tentang apa yang terjadi di sekitar jendela.

Ada dua hal yang perlu disampaikan sebelum masuk ke detail. Pertama, artikel ini menggantikan panduan kami sebelumnya yang menyatakan bahwa tidak ada aplikasi desktop — panduan itu benar ketika ditulis pada Agustus 2026, dan sekarang sudah salah. Kedua, ini adalah pratinjau publik, masih diberi label demikian di situs DeepSeek sendiri, dan paketnya memiliki kekurangan yang memang tersirat dari label tersebut. Installer-nya berfungsi. Distribusi di sekitarnya lebih tipis daripada yang Anda duga.

Apa sebenarnya build desktop itu

Aplikasi desktop adalah lapisan Electron tipis yang tugasnya memulai proses Host dan mengarahkan jendela ke proses tersebut. Jendela itu tidak menata antarmuka obrolan sendiri: jendela memuat entri Web terpaket yang dibundel di dalam aplikasi pada dsh-app://app/, dan dialog pembaruan yang akan Anda lihat berasal dari origin kedua yang dibundel di dsh-app://shell/. Proses Node anak diluncurkan dalam mode RunAsNode Electron untuk memulai runner profil bersama, dan shell meneruskan HTTP ke Web Host yang terautentikasi, menghilangkan header transfer-encoding, connection dan keep-alive saat diteruskan. Respons bundel plugin ditandai no-store, detail kecil dengan konsekuensi yang terlihat: ubah plugin dan pemuatan ulang berikutnya akan menunjukkan perubahan tersebut.

Karena URL-nya adalah dsh-app:// bukan localhost, tidak ada port tetap yang perlu diingat dan tidak ada tabrakan port yang perlu diatasi. Host desktop mendengarkan pada port yang ditetapkan OS secara default. Jika Anda memerlukan port tertentu, Anda dapat mengaturnya melalui webserver.config.port override, tetapi nilai default sengaja bukan konstanta, dan Host mengikat 127.0.0.1. Ini penting jika Anda telah mengikuti instruksi lama: angka 19387 yang beredar dalam panduan pemasangan Agustus bukanlah port desktop, dan menganggapnya sebagai port desktop akan membuat Anda mencari layanan yang tidak ada di sana.

Penyematan versi lebih ketat daripada yang terlihat sekilas. Electron dan @deepseek-ai/dsh selalu membawa versi yang persis sama — bukan rentang, bukan major yang kompatibel — sehingga peningkatan ke harness adalah rilis desktop, dan tidak ada kombinasi yang didukung antara dsh baru dan jendela lama. Proses Electron mengambil kunci satu-instans yang berlaku seumur proses dan secara eksklusif memiliki $DSH_HOME/profiles/desktop. Eksklusivitas itu nyata: CLI tidak dapat mem-boot profil tersebut, dan instalasi npm dari dsh tidak dapat mengubahnya. Yang sama-sama dimiliki oleh kedua instalasi adalah state yang penting bagi Anda — sesi, pengaturan, kredensial, ruang kerja, dan penyimpanan, semuanya di bawah $DSH_HOME. Yang tidak sama-sama dimiliki adalah paket yang dapat dieksekusi, aktivasi plugin, lockfile, atau node_modules, itulah sebabnya memasang plugin ke profil desktop bukan operasi yang sama dengan memasangnya ke profil CLI.

Tiga installer, satu saluran pembaruan, tanpa rilis stabil

Ada tiga penginstal dan ketiganya merespons. Berkas eksekusi Windows 64-bit berukuran 289.385.456 byte dan disajikan dengan HTTP 200. Image disk Apple Silicon berukuran 264.990.950 byte, juga 200. Image disk Mac Intel berukuran 289.480.824 byte, juga 200. Ketiganya terakhir diubah pada 17 Oktober 2026. Hanya dua di antaranya yang ditautkan dari halaman unduh. Build Intel aktif, dapat dijangkau, dan tidak ada tautan yang mengarah ke sana di mana pun di deepseek.com/en/harness/ — jika Anda menggunakan Mac Intel dan mengikuti halaman tersebut, Anda wajar menyimpulkan bahwa tidak ada build untuk Anda.

Build Intel juga tertinggal satu versi. Feed pembaruannya mencantumkan 0.2.1-rc.1; feed Windows dan Apple-silicon sama-sama mencantumkan 0.2.1-rc.2. Satu kandidat rilis bukanlah selisih fitur yang besar, tetapi itu adalah sinyal nyata tentang target mana yang dibangun lebih dulu dan mana yang diverifikasi terakhir, dan justru hal semacam itulah yang ingin Anda ketahui sebelum Anda menyerahkan sesi kerja Anda ke suatu platform.

Kanal pembaruan adalah titik ketika kisah distribusi mulai tipis. Feed-nya per target, di bawah /dsh-desk/feeds/<target>/ pada host yang sama. Windows x64 mengarah ke nightly.yml; kedua target macOS mengarah ke nightly-mac.yml. Mintalah latest.yml atau latest-mac.yml kepada salah satu dari ketiganya dan Anda akan mendapat 404 — tidak ada kanal stabil, tidak ada kanal beta, dan tidak ada cara untuk keluar dari satu-satunya kanal yang ada. Catatan penerbitan DeepSeek sendiri mengonfirmasi pengaturan ini, bukan membantahnya: setiap rilis menerbitkan feed nightly, dan hanya rilis stabil yang menerbitkan latest feed yang menunjuk ke artefak yang sama. "Nightly" dalam konteks ini adalah nama kanal, bukan irama build — feed Windows dan Apple-silicon keduanya menyajikan build 0.2.1-rc.2 yang sama, bertanggal 17 Oktober, dengan paket Windows bertanda waktu 09:22 UTC dan paket Apple-silicon 09:57 UTC. Jadi Anda mendapatkan mesin pembaruan otomatis, polling dengan jitter, backoff hingga batas satu jam, dan tidak ada cara untuk meminta apa pun selain yang saat ini ada di kanal pratinjau.

GitHub menyampaikan hal yang sama dari sudut pandang berbeda. deepseek-ai/deepseek-harness — repositori dengan 256.559 bintang dan 30.921 fork saat dibaca pada 21 Oktober 2026 — memiliki 31 rilis pada tanggal yang sama, semuanya ditandai sebagai pra-rilis, dan tidak satu pun memiliki aset biner terlampir. Tidak ada yang dapat diunduh di halaman Releases. Jika Anda ingin build, Anda mendapatkannya dari download.deepseek.com atau dari npm, di mana @deepseek-ai/dsh saat ini mengarahkan latest ke 0.2.1-rc.2. Repositori ini adalah sumber kebenaran untuk changelog dan jalan buntu bagi artefak, yang cukup tidak biasa sehingga layak dinyatakan terus terang, karena naluri saat melihat 31 rilis adalah mengharapkan penginstal di salah satunya.

Apa yang ditulis penginstal, dan apa yang menolak disentuhnya

Penginstal Windows adalah paket NSIS native, bukan pembungkus untuk MSI, dan perilakunya seperti itu. Anda mendapatkan palet terang, gelap, dan otomatis — yang dapat dipilih saat instalasi dengan /THEME=light, /THEME=dark atau /THEME=auto — direktori tujuan yang dapat diedit, dan cakupan instalasi yang dibatasi hanya untuk pengguna saat ini. Akar drive ditolak sebagai tujuan, dan tujuan yang tidak kosong hanya diterima jika sudah merupakan instalasi terdaftar, yang merupakan cara penginstal menolak menimpa folder yang tidak terkait. Saat pembaruan, jalur senyap menunggu hingga sepuluh detik agar aplikasi yang berjalan keluar lalu berhenti dengan kode keluar 2 jika aplikasi masih berjalan. Itu adalah kegagalan yang jujur, bukan instalasi yang rusak, dan akan muncul dalam penerapan berskrip apa pun yang tidak menutup aplikasi terlebih dahulu.

Uninstaller ini menetapkan batas yang sering keliru ditetapkan oleh sebagian besar uninstaller. Uninstaller ini menghapus direktori userData Electron, direktori produk di bawah %APPDATA%, dan cache pembaruan di bawah %LOCALAPPDATA%. Uninstaller ini tidak menyentuh home harness — ~/.dsh, atau ke mana pun DSH_HOME mengarah — yang menyimpan sesi, pengaturan, kredensial, dan plugin Anda. Meneruskan --updated atau /KEEP_APP_DATA juga mempertahankan data Electron. Jadi, menghapus lalu memasang ulang adalah cara yang didukung untuk memperbaiki jendela yang rusak tanpa kehilangan pekerjaan Anda, dan itu adalah keputusan desain yang disengaja, bukan kebetulan.

Runtime bawaan perlu diketahui karena ukurannya besar dan berada di luar direktori aplikasi. Python dengan numpy, pandas, python-docx, python-pptx, openpyxl, Pillow, lxml, dan XlsxWriter, ditambah Node dan pnpm, diinstal di bawah $DSH_HOME/dsh-runtimes/dsh-primary-runtime — biasanya ~/.dsh/... di kedua platform — saat pertama kali sebuah workspace menyatakan bahwa ia membutuhkannya. Itulah sebabnya penggunaan disk setelah seminggu digunakan bukanlah penggunaan disk setelah instalasi, dan mengapa penghapusan instalasi yang mempertahankan $DSH_HOME juga mempertahankan beberapa ratus megabita runtime.

Setelan dibaca sekali saat startup dari desktop/settings.json di dalam direktori userData Electron, yang di Windows berarti %APPDATA%\@deepseek-ai\dsh-desktop\desktop\settings.json dan di macOS berarti ~/Library/Application Support/@deepseek-ai/dsh-desktop/desktop/settings.json. DSH_HOME tidak memindahkan file ini — sebuah hal yang perlu ditandai, karena inilah satu-satunya bagian konfigurasi yang tidak mengikuti variabel yang diikuti oleh semua hal lainnya. Setelan pembaruan dalam file tersebut menggunakan milidetik: intervalMs default-nya 600.000, dan maxBackoffMs default-nya 3.600.000 dan harus minimal intervalMs. Jitter default-nya 0,2, dibatasi ke rentang nol hingga satu, dan ditetapkan minimal satu detik namun tidak pernah melebihi batas backoff. Batas waktu tidak aktif per koneksi sebesar 60.000 milidetik berlaku untuk lalu lintas HTTP pembaruan, meskipun unduhan yang aktif tidak memiliki tenggat waktu total — koneksi lambat tidak akan terputus di tengah unduhan.

Menutup jendela tidak menutup aplikasi

Di kedua platform, menutup jendela akan menyembunyikannya. Di macOS, itu adalah Command-W; di Windows, itu tombol tutup, Alt-F4, atau Close dari taskbar. Windows meminta konfirmasi sebelum penyembunyian pertama dan menulis sebuah background-close-confirmed flag di direktori userData Electron sehingga hanya bertanya sekali, bukan setiap kali. Windows juga mempertahankan ikon tray selama seluruh proses berjalan. macOS sama sekali tidak menyertakan ikon menu bar, yang membuat status tersembunyi benar-benar tak terlihat di sana — aplikasi sedang berjalan, tugas-tugas sedang berjalan, dan tidak ada apa pun di layar yang menandakannya sampai Anda membukanya kembali dengan dsh://open atau tray, tergantung platformnya.

Apa yang bertahan saat disembunyikan adalah bagian yang berguna. Tugas yang sedang berjalan tetap berjalan, dan saat jendela ditampilkan lagi, jendela itu menampilkan dokumen yang sama dengan sesi yang sama, draf yang sama, dan posisi gulir yang sama. Ini adalah perilaku yang berbeda dari tab browser yang Anda tutup dan buka kembali, dan inilah alasan build desktop layak dimiliki jika pekerjaan Anda melibatkan tugas agen yang berjalan lama: Anda dapat menutup jendela dan membiarkan tugas selesai.

Keluar adalah tindakan terpisah dengan logikanya sendiri. Sebelum keluar, shell memeriksa Host untuk agen yang berjalan termasuk subagen dan agen yang menunggu persetujuan, pesan yang mengantre, pekerjaan yang sedang berjalan atau sedang dihentikan, dan pengingat terjadwal yang telah diaktifkan. Jika tidak ada satu pun dari hal tersebut, shell akan keluar secara senyap. Jika ada, Anda akan mendapatkan dialog konfirmasi bawaan berjudul Keluar dari DeepSeek Harness? dengan salah satu dari tiga penjelasan tergantung pada apa yang ditemukannya: tugas akan diinterupsi, tugas terjadwal tidak akan berjalan, atau keduanya. Host yang tidak pernah mencapai status siap tidak mungkin sudah memulai tugas apa pun, jadi keluar dalam keadaan itu akan berlanjut tanpa bertanya. Perbedaan antara "tutup" dan "keluar" adalah inti dari desain ini, dan itu berlaku di kedua platform meskipun hanya salah satunya yang menampilkan ikon permanen kepada Anda.

Perintah dsh, dan urutan yang penting

Penginstal dapat menempatkan dsh di PATH Anda, yang memungkinkan Anda menjalankan CLI terhadap home harness yang sama dengan yang digunakan aplikasi desktop. Kontrolnya adalah Kelola Perintah dsh…, dan terletak tepat di bawah Periksa Pembaruan… di menu, dengan tiga tindakan: Instal, Perbaiki, dan Hapus. Di macOS, ini menulis peluncur di /usr/local/bin/dsh dan akan meminta otorisasi administrator saat diperlukan; di Windows, ini mendaftarkan perintah tersebut di PATH pengguna saat ini.

Ada dua aturan urutan yang mudah terlewat dan menjengkelkan saat baru diketahui belakangan. Yang pertama: jalankan Remove sebelum menghapus instalasi aplikasi desktop, karena uninstaller tidak menghapus dsh beserta registrasinya. Jika Anda menghapus instalasi terlebih dahulu, Anda akan dibiarkan dengan PATH sebagai entri yang menunjuk ke binari yang sudah tidak ada. Yang kedua: jika Anda memindahkan aplikasi ke lokasi lain, gunakan Repair di macOS atau Install dari lokasi baru di Windows, alih-alih menganggap registrasi akan mengikuti aplikasi.

Manajemen plugin untuk profil desktop memiliki kendala tersendiri. Karena Electron secara eksklusif memiliki $DSH_HOME/profiles/desktop saat berjalan, memasang ke profil tersebut bukanlah sesuatu yang dilakukan saat aplikasi terbuka. Urutan yang didukung adalah menjalankan aplikasi desktop sekali, menutupnya, lalu menjalankan dsh plugin --profile desktop add <package> dari baris perintah. Paket tersebut akan masuk ke profil desktop dan aktif saat Anda membuka jendela berikutnya.

Apa yang sudah disampaikan kemasan kepadamu belum selesai

Bagian keterbatasan yang diketahui di README itu luar biasa terbuka, dan dua entrinya adalah yang pertama-tama akan memengaruhi Anda.

• Masuk ke akun tidak terhubung. Tombol Masuk dinonaktifkan. Sebagai gantinya, saat pertama kali dijalankan akan terbuka jendela sambutan berukuran 600 x 700 dengan formulir kunci API; Simpan dan lanjutkan akan menulis kunci ke penyimpanan kredensial pengembangan, dan Siapkan nanti membuka ruang kerja sebenarnya tanpa menyimpan kunci. Menekan Masuk di tempat tombol itu muncul akan membuka halaman platform yang dikonfigurasi di browser sistem Anda, dengan Host yang menangani pertukaran PKCE dan callback loopback sementara — infrastrukturnya sudah ada, tetapi pengikatan akunnya belum. Dalam praktiknya, bersiaplah untuk membawa kunci.

• Penandatanganan rilis dan notarisasi tercantum sebagai memerlukan lingkungan rilis produksi. Itu adalah README yang berhati-hati, dan di situlah pengukuran lebih berguna daripada sebuah kalimat. Executable Windows yang dipublikasikan membawa tanda tangan Authenticode yang valid dengan rantai validasi diperluas: GlobalSign Root CA–R3, turun melalui GlobalSign Code Signing Root R45 dan GlobalSign GCC R45 EV CodeSigning CA 2020, hingga sertifikat leaf yang diterbitkan untuk Hangzhou DeepSeek Artificial Intelligence Co., Ltd. dengan yurisdiksi tercantum sebagai CN / Zhejiang / Hangzhou, dan kategori bisnis organisasi swasta. Stempel waktu RFC-3161 pada tanda tangan tersebut terbaca 2026-10-17T09:22:04Z, yang cocok dengan tanggal rilis di feed pembaruan Windows dalam selisih satu menit, dan digest SHA-512 dari file yang diunduh cocok byte demi byte dengan hash yang dipublikasikan di feed tersebut. Jadi di Windows binary tersebut ditandatangani, diberi stempel waktu, dan cocok-hash hari ini, apa pun yang dikatakan README tentang proses yang belum sepenuhnya diproduksi. Sisi macOS adalah pertanyaan berbeda dan kami tidak memverifikasi notarisasi di sana; jangan membaca hasil Windows secara lintas.

Laporan crash, dan satu detail yang perlu diketahui

Laporan crash ditulis sebagai crash-<UTC time>-<source>.log, ke dalam ~/Library/Logs/DeepSeek Harness di macOS atau direktori logs di bawah jalur userData Electron di Windows, dan sepuluh laporan terbaru disimpan. Jumlah retensi itu cukup kecil sehingga berdampak: jika terjadi masalah berulang kali dan Anda tidak memeriksanya selama beberapa hari, log yang seharusnya menjelaskan kegagalan pertama sudah hilang. Salin direktori tersebut jika Anda sedang men-debug masalah yang intermiten.

Jalur pemulihan untuk konfigurasi yang rusak sama spesifiknya. Shell mengganti nama cordis.patch.yml menjadi cordis.patch.yml.bak-<timestamp> tanpa mengurainya, sehingga file tersebut dipertahankan alih-alih diperbaiki, dan aplikasi dimulai dari default. Jika Anda telah mengedit file itu secara manual, .bak adalah tempat hasil edit Anda, dan file itu masih dapat dibaca.

Bagaimana posisi saran sebelumnya soal "tidak ada aplikasi desktop" dengan adanya hal ini?

Kami menerbitkan panduan pada Agustus 2026 bahwa harness tidak memiliki aplikasi desktop dan pengguna Windows harus menjalankan build terminal — itu akurat saat itu dan sekarang sudah usang. Build terminal masih berfungsi dan tetap menjadi pilihan yang tepat untuk server, container, atau apa pun yang dijalankan lewat skrip. Yang berubah adalah build desktop bukan pembungkus mainan: ia memiliki profil terpisah, menjaga tugas tetap hidup saat jendela ditutup, memperbarui dirinya sendiri, dan berbagi status dengan CLI ke arah yang membantu Anda. Jika Anda menunda build desktop karena artikel sebelumnya mengatakan build itu tidak ada, alasan itu sudah tidak berlaku.

Langkah-langkah instalasi itu sendiri sudah dibahas dalam panduan instalasi kami dan sengaja tidak diulang di sini. Yang tidak dapat diberitahukan oleh panduan tersebut adalah penginstal mana dari ketiga penginstal yang tidak memiliki tautan di halaman unduhan, target mana yang tertinggal satu rilis, bahwa tidak ada kanal pembaruan stabil yang dapat dipilih, dan bahwa biner Windows ditandatangani meskipun README menyatakan bahwa penandatanganan adalah bagian dari rilis mendatang. Itulah fakta-fakta yang menentukan apakah build desktop adalah hal yang tepat untuk dipasang, dan itulah alasan halaman ini ada secara terpisah.

Jika Anda lebih suka tidak menginstal apa pun

Memasang harness untuk menjangkau satu model berarti terlalu banyak cakupan untuk pekerjaan yang sedikit, dan aplikasi desktop ini adalah pratinjau dengan satu saluran pembaruan serta build Intel yang tidak ditautkan siapa pun. Jika yang sebenarnya Anda inginkan adalah DeepSeek-V4.1-Flash — model yang menjadi default harness, model yang sama yang dukungannya ditambahkan dalam catatan 0.2.1-rc.2 — endpoint API dapat melakukannya tanpa installer, tanpa direktori profil, dan tanpa ikon tray yang harus Anda ingat sedang berjalan.

Perbandingan yang perlu dilakukan bukanlah aplikasi desktop versus API secara abstrak. Melainkan apakah pekerjaan tersebut membutuhkan agen yang dapat menjaga ruang kerja tetap terbuka melewati jendela yang tertutup, menjalankan skrip di mesin Anda, dan menjaga sesi tetap hidup selama berjam-jam — dalam hal ini masalah pengemasan di atas layak ditoleransi, dan build desktop adalah satu-satunya cara untuk mendapatkan perilaku tersebut — atau apakah pekerjaan tersebut berupa aliran permintaan ke model yang sudah disajikan di tempat lain. Untuk kasus kedua, direktori model adalah jalur yang lebih singkat, dan tidak ada apa pun dalam artikel ini yang mengubahnya.