DeepSeek Harness di VPS Tetap Privat via Tunnel SSH
Pasang DeepSeek Harness di Linux VPS, kunci versi npm, pahami kemampuan plugin, dan akses UI web port 3080 melalui tunnel SSH tanpa membuka port publik.
Apa itu DeepSeek Harness
DeepSeek Harness (dsh) adalah runtime agen Node.js yang dapat dijalankan pada VPS (virtual private server). Cara yang aman untuk menjalankannya adalah dengan mengikatnya ke 127.0.0.1, lalu mengaksesnya dari browser melalui tunnel SSH (secure shell). Harness ini menyediakan UI web (user interface) pada port 3080, bukan berjalan di terminal. Pada rilis 0.1.0-rc.6 yang digunakan dalam panduan ini, server web tersebut tidak meminta password sendiri. Karena itu, port 3080 yang dipublikasikan dapat memberikan akses agen kepada siapa pun yang menemukannya. Agen tersebut dapat membaca file dan menjalankan perintah sebagai pengguna Linux Anda. Rilis yang lebih baru, mulai dari 0.2.0-rc.2 hingga 0.2.2-rc.2 pada 11 November 2026, yaitu rilis terbaru yang dicantumkan GitHub pada 12 November 2026, menampilkan URL saat startup yang berisi token baru untuk proses tersebut dan menukarnya dengan cookie sesi. Namun, rilis-rilis tersebut tetap mendengarkan pada loopback secara default dan tetap menolak untuk mengikat semua interface.
DeepSeek menerbitkannya di bawah lisensi MIT sebagai package npm @deepseek-ai/dsh. Proyek ini menyatakan bahwa dirinya merupakan developer preview dan bahwa perubahan yang dapat memutus kompatibilitas memang diharapkan. Versi yang dikunci di bawah ini adalah rilis Agustus 2026. Pada 12 November 2026, tag latest di npm menunjuk ke 0.2.2-rc.1. GitHub mencantumkan prerelease yang lebih baru, yaitu 0.2.2-rc.2, dengan tag dsh-v0.2.2-rc.2 dan tanggal rilis 11 November 2026. Periksa repositori tersebut sebelum menyalin apa pun ke server yang penting.
Satu gagasan mendasari seluruh desainnya: semuanya adalah plugin. Adapter model, registri tool, log sesi, sandbox, scheduler, dan loop agen itu sendiri merupakan plugin yang dimuat ke dalam satu context bersama. Setiap komponen tersebut dapat diganti. Tidak ada core istimewa yang hanya dihias oleh plugin. Inilah yang membuat harness ini layak dicoba, sekaligus menjadi sumber satu-satunya risiko yang nyata. Apakah kompromi tersebut tepat bergantung pada pembanding yang Anda gunakan. Perbandingan dengan Claude Code dan Omnigent menempatkan desain yang seluruhnya berbasis plugin ini di samping dua pendekatan lain dalam hal keterikatan pada model, lisensi, dan seberapa banyak resource VPS yang dibutuhkan masing-masing.
Harness bukan model
Harness menjalankan loop agen. Penalaran berlangsung di model di tempat lain. Karena itu, tidak ada yang berfungsi sampai Anda memberikan API (application programming interface) key atau alamat endpoint model yang Anda host sendiri. Semua hal dalam posting ini merupakan konfigurasi harness, bukan perilaku model. Batas antara keduanya perlu dipahami dengan jelas sebelum Anda menghabiskan waktu untuk menelusuri sisi asal suatu masalah.
Anda mengonfigurasinya di UI melalui Settings, lalu Models. DeepSeek memiliki kartunya sendiri. Pada rilis saat ini, tombol "Add model provider" di bawah kartu tersebut membuka dua mode. "Third-party model provider" mencakup provider yang katalognya disediakan oleh harness, seperti OpenAI dan Anthropic. Anda cukup menempelkan key, lalu katalog menyediakan endpoint dan daftar model. "Custom model API" adalah opsi yang lebih fleksibel. Opsi ini memerlukan provider ID dengan huruf kecil, nama tampilan, base URL, protokol API, kredensial, dan setidaknya satu model. Pemilih protokol menyediakan OpenAI Chat Completions, OpenAI Responses, Anthropic Messages, dan Gemini API. Dengan demikian, Anda dapat mengonfigurasi gateway atau server lokal yang menggunakan salah satu protokol tersebut. Endpoint dengan perbedaan format request memerlukan pengaturan kompatibilitas. Provider kustom juga dapat meminta endpoint OpenAI-compatible GET /models untuk mengisi daftar model secara otomatis.
Dengan cara ini, Anda dapat mengarahkan harness ke model pada VPS yang sama. Ollama menyediakan API yang kompatibel dengan OpenAI di http://127.0.0.1:11434/v1/. Kolom API key menerima string apa pun, secara konvensional ollama, karena client bergaya OpenAI memerlukan nilai, sedangkan Ollama mengabaikannya. Dokumentasi Ollama juga menjelaskan ollama launch dsh. Perintah ini memasang @deepseek-ai/dsh jika belum tersedia dan menjalankannya dengan model Ollama. Karena itu, periksa versi yang dipasang sebelum mengandalkan pin di bawah ini. Pertanyaan yang lebih sulit adalah apakah model yang cukup kecil untuk dijalankan pada VPS Anda mampu mengoperasikan agen dengan baik. Perbedaan antara Ollama dan vLLM sebagai server model lokal menentukan seberapa besar RAM yang diperlukan.
Key yang diketik di UI hanya dapat ditulis, bukan dibaca kembali. Harness menyimpannya di $DSH_HOME/.credentials.yaml. Pengaturan hanya menyimpan referensi kredensial, yang pada rilis saat ini ditulis ke file patch profil aktif, $DSH_HOME/profiles/<profile>/cordis.patch.yml (profil tersebut adalah web untuk dsh web). $DSH_HOME secara default bernilai ~/.dsh. Perlakukan file kredensial sebagai file kata sandi, karena memang demikian. Siapa pun yang dapat membacanya dapat menggunakan anggaran API Anda. Jika Anda ingin mengedit file tersebut secara langsung, bukan melalui Settings, panduan file konfigurasi dsh, key, dan endpoint model menjelaskan fungsi setiap key serta data yang keluar dari server Anda pada setiap mode.
Hal yang perlu disiapkan sebelum instalasi
- VPS yang menjalankan Ubuntu 24.04 atau Linux versi terbaru lainnya, dengan akses SSH
- Node.js 24.9 atau yang lebih baru, karena branch utama proyek dan
0.2.2-alpha.2kini mendeklarasikan>=24.9.0, dan pengujian CI-nya menggunakan Node 24 dengan pemeriksaan kompatibilitas pada Node 24.9 dan Node 26, tanpa job Node 22; rilis bertag hingga0.2.1-rc.4masih mencantumkan Node 22.19 sebagai versi yang dapat digunakan, tetapi versi tersebut bukan lagi batas minimum yang digunakan proyek untuk build - Akun pengguna biasa, bukan
root, karena agent menjalankan perintah shell sebagai pengguna yang memulai proses pnpmpada PATH jika Anda berencana memasang plugin, karena perintah plugin menjalankan proses tersebut melalui shell- Port 3080 ditutup pada firewall Anda dan firewall jaringan terpisah milik provider
Paket nodejs bawaan Ubuntu 24.04 lebih lama daripada yang diperlukan harness. Karena itu, pada rilis tersebut, instal Node dari NodeSource atau nvm, bukan menggunakan apt install nodejs. Repositori resmi Ubuntu 26.10 mencantumkan Node 24.19.0, yang memenuhi persyaratan minimum Node 24.9. Jika VPS masih baru, perkuat SSH sebelum melakukan hal lain selama sepuluh menit. Tunnel yang akan Anda andalkan hanya seaman server SSH di belakangnya.
Pasang DeepSeek Harness pada VPS dengan versi yang ditetapkan
node --version
npx @deepseek-ai/dsh@0.1.0-rc.6 webnpx mengunduh paket dan menjalankan biner dsh. web adalah alias untuk --profile web, yang menjalankan aplikasi browser, lalu proses tersebut mencetak alamat tempatnya menerima koneksi. Nilai defaultnya adalah http://127.0.0.1:3080. Angka tersebut merupakan keputusan pengikatan, bukan sekadar nilai default kosmetik. alasan dsh mencetak alamat loopback menjelaskan respons yang dapat dan tidak dapat diberikan harness sebelum Anda mencoba mengaksesnya dari laptop.
Tetapkan versinya. npx @deepseek-ai/dsh web akan menentukan apa pun yang ditunjuk oleh tag latest saat perintah dijalankan. Namun, jika proyek tempat Anda menjalankan perintah tersebut sudah memiliki salinan yang terpasang, npx akan menggunakan salinan itu secara diam-diam. Apa pun kondisinya, Anda tidak memilih versinya, sementara proyek tersebut sudah merilis beberapa kandidat rilis dan menyatakan bahwa perubahan yang menyebabkan ketidakcocokan akan datang. 0.1.0-rc.6 adalah versi Agustus 2026 yang ditetapkan di sini. Pada 12 November 2026, latest menunjuk ke 0.2.2-rc.1, yaitu rilis yang mencetak URL startup bertoken. GitHub mencantumkan prerelease yang lebih baru, yaitu 0.2.2-rc.2. Karena itu, berpindah ke versi lain merupakan jenis upgrade yang harus dilakukan secara sengaja setelah membaca repositori. Versi yang ditetapkan membuat sistem yang Anda siapkan hari ini berperilaku sama pada bulan berikutnya. Dengan demikian, upgrade menjadi keputusan yang Anda ambil, bukan kejadian tidak sengaja yang baru Anda sadari. Jika perintah dengan versi yang ditetapkan tetap menjalankan build yang salah atau sama sekali menolak untuk diinstal, kesalahan instalasi dan versi dsh yang umum menjelaskan cara menghapus cache npx dan memeriksa npm yang dibundel bersama Node Anda.
Untuk penggunaan harian, instal sekali agar versi tidak ditentukan ulang setiap kali dijalankan.
npm install -g @deepseek-ai/dsh@0.1.0-rc.6
dsh --profile web --helpBaris kedua tersebut perlu dijalankan karena launcher dan aplikasi web memiliki kumpulan flag yang terpisah. dsh --help menampilkan opsi milik launcher. dsh --profile web --help menampilkan flag yang diterima aplikasi web. Di situlah --port, --host, dan --trusted-host yang dapat diulang berada.
Sekarang, pastikan port tempat aplikasi menerima koneksi.
ss -tlnp | grep 3080Kolom alamat lokal seharusnya berisi 127.0.0.1:3080. Jika berisi 0.0.0.0:3080, UI menerima koneksi pada semua interface. Dalam kondisi ini, hanya firewall yang menjadi penghalang antara UI dan Internet. Hentikan proses tersebut sebelum melakukan hal lain.
Mengapa port 3080 tidak boleh dipublikasikan
Web server di 0.1.0-rc.6 tidak memiliki lapisan autentikasi. Konfigurasinya mengekspos host dan port untuk listening. Hanya itu permukaannya. Kontrol akses untuk deployment non-loopback merupakan pengaturan trusted host terpisah. Pengaturan tersebut bukan halaman login.
Rilis yang lebih baru menambahkan autentikasi. Mulai 0.2.0-rc.2, saat startup aplikasi mencetak URL yang berisi token baru untuk proses tersebut. Browser yang membuka URL itu menerima cookie sesi bertanda tangan, lalu dialihkan ke alamat yang sama tanpa token. Filter Host/Origin di depan rute /api hanya menerima loopback, alamat bind milik listener, dan authority yang Anda tetapkan dengan --trusted-host. Token tersebut merupakan kredensial yang sebenarnya. Namun, dokumentasi proyek sendiri memperingatkan bahwa URL yang dicetak adalah kredensial yang hanya boleh dibagikan kepada pengguna yang dituju. Dokumentasi itu juga memperingatkan bahwa HTTP biasa mengirimkannya tanpa enkripsi. Sejak 0.2.1-alpha.2, aplikasi web juga dapat melakukan bind ke satu alamat lokal tertentu dan menyediakan HTTPS sendiri dengan --tls-cert dan --tls-key. Ini mengatasi masalah teks biasa, bukan masalah eksposur. Langkah ini membuat port yang terekspos lebih sulit disalahgunakan. Namun, port tersebut tetap tidak boleh dipublikasikan.
Sekarang perhatikan apa yang berada di balik port itu. Agent mengedit file di workspace dan menjalankan perintah shell. Kredensial provider Anda juga tersimpan di disk di dekatnya. Jadi, pada rilis yang dipatok, port 3080 yang terbuka sama dengan shell jarak jauh dengan antarmuka chat. Shell itu berjalan sebagai pengguna yang menjalankannya dan memiliki API key Anda. Tidak diperlukan exploit untuk memanfaatkannya. Penyerang hanya memerlukan nomor port. Pada rilis yang menggunakan launch token, mereka juga memerlukan token tersebut. Token itu sudah dapat mereka peroleh jika mereka dapat membaca terminal, log service, atau trafik Anda yang tidak terenkripsi.
CLI (command line interface) juga menunjukkan hal yang sama. Mulai 0.1.0-rc.6, CLI sengaja tidak mendukung --host 0.0.0.0 dan keluar dengan usage error alih-alih melakukan startup. 0.2.2-alpha.2 yang lebih baru juga tetap menolaknya saat startup. Penolakan ini merupakan fitur. Jangan mencari patch untuk menghapusnya.
Ada 2 deployment lain yang masuk akal ketika tunnel tidak sesuai. Tempatkan server di jaringan overlay privat agar server hanya memiliki alamat yang dapat dirutekan oleh perangkat Anda sendiri. Inilah yang disediakan oleh control server Headscale yang di-host sendiri. Atau, tempatkan reverse proxy di depannya untuk mengautentikasi request sebelum mencapai port 3080, misalnya server single sign-on Authentik yang menjalankan forward auth. Reverse proxy tanpa autentikasi di depannya bukan kontrol keamanan. Itu hanya URL yang lebih panjang.
Mengakses antarmuka web melalui tunnel SSH
Jalankan perintah ini di laptop Anda, bukan di server.
ssh -N -L 3080:127.0.0.1:3080 you@your-server-L membuka port 3080 di laptop Anda dan meneruskan setiap koneksi yang masuk ke port tersebut melalui sesi SSH terenkripsi. Bagian 127.0.0.1:3080 diproses di server, sehingga koneksi tiba di harness dari loopback, sama seperti jika Anda sedang menggunakan mesin tersebut secara langsung. -N berarti jangan memulai shell jarak jauh, karena Anda hanya memerlukan penerusan port.
Selanjutnya, buka http://127.0.0.1:3080 di browser lokal Anda. Pada rilis yang menggunakan launch token, buka URL startup lengkap yang dicetak server, termasuk tokennya. Jika harness dijalankan melalui SSH, baris startup tetap dicetak, tetapi browser tidak akan dibuka secara otomatis. Jika port 3080 sudah digunakan di laptop Anda, ubah angka di sisi kiri: ssh -N -L 3180:127.0.0.1:3080 you@your-server, lalu buka http://127.0.0.1:3180. Ubah port pada URL yang menggunakan token dengan cara yang sama. Angka di sisi kiri adalah port lokal, sedangkan angka di sisi kanan adalah port milik server. Jadi, hanya angka di sisi kiri yang diubah.
Simpan perintah tersebut di ~/.ssh/config dan jangan mengetiknya lagi.
Host dsh
HostName 203.0.113.10
User deploy
IdentityFile ~/.ssh/id_ed25519
LocalForward 3080 127.0.0.1:3080Setelah itu, ssh -N dsh memulai tunnel. Jika browser melaporkan bahwa koneksi ditolak, biasanya tunnel sudah aktif tetapi tidak ada proses yang listening di sisi tujuan. SSH meneruskan port tersebut terlepas dari apakah harness sedang berjalan. Periksa server menggunakan perintah ss di atas.
Pertahankan harness tetap berjalan setelah Anda logout
Perintah npx berhenti bersama shell Anda. Service systemd pengguna tetap berjalan dan menjalankan kembali harness setelah crash atau reboot. Unit ini sengaja dibuat minimal. Jika Anda ingin harness berjalan dengan account tersendiri yang dikunci, versinya ditetapkan di dalam unit, dan log-nya dapat dicari, penyiapan systemd headless untuk dsh membahasnya secara lengkap.
loginctl enable-linger $USER
mkdir -p ~/.config/systemd/user
command -v dshenable-linger penting karena service pengguna biasanya berhenti ketika sesi terakhir Anda berakhir. Tanpa opsi tersebut, harness berhenti segera setelah Anda menutup tunnel. Ambil path absolut yang dicetak oleh command -v dsh dan masukkan path tersebut ke dalam unit. systemd tidak mencari PATH yang dibangun oleh login shell Anda.
[Unit]
Description=DeepSeek Harness web UI
After=network-online.target
[Service]
Type=simple
WorkingDirectory=%h/projects/site
ExecStart=/usr/local/bin/dsh web
Restart=on-failure
RestartSec=5
[Install]
WantedBy=default.targetWorkingDirectory bukan sekadar kosmetik. Proses dsh menggunakan direktori pemanggilnya sebagai lokasi filesystem default. Karena itu, service yang dimulai di lokasi yang salah akan mengarahkan agent ke folder yang salah. Namun, direktori tersebut hanya merupakan default. Web UI yang baru dibuka belum memiliki workspace yang dipilih sampai Anda menambahkannya melalui Choose workspace. Panduan proyek meminta Anda menambahkan direktori tempat Anda menjalankan dsh. Panduan tersebut tidak mencantumkan penanda versi, dan teks yang sama sudah ada di 0.1.0-rc.7. Jadi, teks tersebut juga diharapkan tersedia pada release yang ditetapkan versinya. Atur direktori unit ke project, lalu pilih workspace tersebut di UI.
systemctl --user daemon-reload
systemctl --user enable --now dsh
systemctl --user status dshUnit yang menolak untuk start hampir selalu disebabkan oleh path ExecStart yang salah atau versi Node yang ditolak oleh binary. journalctl --user -u dsh -n 50 menyebutkan penyebabnya. Pada release yang memiliki launch token, journal juga menjadi tempat URL startup yang memuat token dicatat, dan setiap restart mencetak URL baru. Pola yang sama berlaku untuk mempertahankan coding agent apa pun agar tetap berjalan di VPS, dan mode kegagalannya identik.
Plugin dapat melakukan apa saja
Plugin adalah modul yang menambahkan layanan, event bertipe, dan efek yang dapat dibatalkan ke context bersama. Extension point berikut perlu dibaca dengan saksama:
- mendaftarkan model provider pada
ctx.llm - menambahkan tool yang dapat digunakan model pada
ctx.tools - menyediakan backend shell di balik
ctx.shell - menyediakan akses filesystem atau policy di balik
ctx.fs - mendaftarkan command untuk pengguna pada
ctx.commands - menjalankan pekerjaan background melalui
ctx.jobs - membungkus proses yang dijalankan dengan backend
ctx.sandbox - mencegat request dan pemanggilan tool melalui event
agent/*dantools/* - memperluas state session yang persisten
- mengendalikan UI melalui
ctx.agents
Baca daftar tersebut seperti seorang penyerang. Plugin dapat menyediakan layer filesystem dan layer shell, serta berada di antara setiap pemanggilan tool yang dilakukan model. Tidak ada dialog permission yang membatasi plugin dari extension point tersebut, karena plugin adalah kode Node biasa yang dimuat ke dalam process yang sama dengan komponen lainnya. Menginstal plugin berarti menjalankan kode milik pihak yang tidak Anda kenal dengan permission agent Anda, dan permission agent Anda adalah permission Unix user Anda.
Ini adalah keputusan trust yang sama seperti saat Anda menghubungkan MCP server ke agent pada VPS, ketika MCP adalah model context protocol. Karena itu, menjalankan coding agent dengan aman pada VPS dimulai dari account yang digunakan untuk menjalankannya, bukan dari modelnya. Hal ini juga menjelaskan mengapa serangan supply chain npm berdampak besar pada server: proses instalasi adalah tahap terjadinya compromise, dan tidak ada prompt yang meminta konfirmasi.
Asal plugin
Plugin berada dalam profile. Profile adalah komposisi bernama yang disimpan di bawah $DSH_HOME, dengan nilai default ~/.dsh, dan setiap direktori profile menyimpan plugin di luar pohon yang diinstalnya. CLI mengelolanya dengan meneruskan argumen Anda langsung ke pnpm, menggunakan direktori profile sebagai direktori kerja.
dsh plugin --profile web add github:deepseek-harness/turtle-ui
dsh plugin --profile web remove turtle-uiKarena argumen tersebut diteruskan ke pnpm tanpa perubahan, add, remove, update, dan why berperilaku seperti pada proyek pnpm mana pun, dan plugin dapat berupa paket npm atau referensi GitHub. pnpm harus tersedia di PATH terlebih dahulu. Pada Node 24, corepack enable pnpm menempatkannya di sana. Node 25 berhenti mendistribusikan Corepack, jadi pada Node 25 dan versi yang lebih baru, instal pnpm dengan npm install -g pnpm.
Penemuan plugin dilakukan melalui topic GitHub. Pembuat plugin menambahkan topic dsh-plugin ke repositori mereka, dan Anda dapat menemukan plugin yang tersedia dengan menelusuri topic tersebut. Topic adalah label yang diterapkan pembuat pada repositorinya sendiri. Tidak ada pihak yang meninjaunya atau membubuhkan tanda tangan, dan halaman topic mengurutkan repositori berdasarkan jumlah bintang, yang mengukur popularitas, bukan keamanan.
Rilis saat ini juga menyertakan bundle indeks plugin Custom eksperimental. Aktifkan fitur tersebut di bagian Plugins, lalu tab Discover memungkinkan Anda menambahkan indeks, yaitu file JSON yang diambil dari URL yang Anda berikan. Harness tidak menyediakan indeksnya sendiri, hanya memeriksa format file, bukan judul, pembuat, atau sumber yang diklaim oleh suatu market, dan siapa pun yang berada di jalur jaringan dapat mengubah indeks yang disajikan melalui http: biasa. Market adalah katalog yang ditulis pihak lain, bukan hasil peninjauan.
Empat kebiasaan berikut membuat pengelolaan plugin tetap terkendali. Baca source sebelum menginstal karena sebagian besar plugin cukup kecil untuk dibaca dalam sepuluh menit. Kunci versi atau commit yang tepat, bukan mengikuti branch. Jalankan harness dengan user yang tidak memiliki aset lain, pada VPS yang bersedia Anda bangun ulang. Berikan agent API key sendiri dengan batas pengeluaran sendiri, terpisah dari key yang digunakan service produksi Anda. Saat Anda membaca plugin dan ingin mengetahui file mana yang membawa risiko, panduan pemeriksaan plugin dsh membahas manifest, entry point, dan extension point yang didaftarkan plugin.
Jika Anda ingin membandingkan desain sebelum memilih salah satunya, harness multi-agent Omnigent menangani masalah yang sama dengan struktur berbeda, dan trade-off-nya menjadi jelas setelah plugin digunakan. Jika akhirnya Anda mempertahankan dua atau tiga plugin pada host yang sama, alih-alih memilih satu pemenang, menempatkan setiap harness di balik satu API yang di-host sendiri menghemat kebutuhan akan satu tunnel per port, dengan konsekuensi adanya satu service tambahan yang harus diikat ke loopback dan diberi password yang sebenarnya sejak hari pertama.
Apa yang rusak terlebih dahulu
Node terlalu lama. Branch utama proyek dan 0.2.2-alpha.2 memerlukan Node 24.9 atau yang lebih baru, dan CI-nya menguji Node 24 ditambah pemeriksaan kompatibilitas pada Node 24.9 dan Node 26, tanpa pengujian pada Node 22. Rilis bertanda (tagged releases) yang lebih lama hingga 0.2.1-rc.4 mencantumkan Node 22.19 sebagai versi yang dapat diterima, namun proyek ini tidak lagi dapat di-build menggunakan versi tersebut. Runtime yang lebih lama akan gagal saat startup karena kode menggunakan sintaks dan API yang tidak tersedia. Jalankan node --version sebelum melakukan hal lain.
Port 3080 sudah digunakan. Harness kedua, proses yang menggantung, atau aplikasi lain yang tidak terkait juga menggunakan port 3080. Temukan proses tersebut dengan ss -tlnp | grep 3080, lalu hentikan prosesnya atau jalankan harness di tempat lain dengan dsh web --port 3180. --port adalah milik aplikasi web, jadi port tersebut digunakan setelah web.
Browser tidak dapat terhubung melalui tunnel. Pastikan Anda mengakses 127.0.0.1 dan bukan alamat publik server, karena port yang diteruskan (forwarded port) hanya ada di laptop Anda. Kemudian pastikan harness sedang mendengarkan (listening) di server, karena SSH akan tetap mengatur penerusan port terlepas dari apakah ada layanan yang merespons di sisi server atau tidak.
dsh plugin gagal seketika. Perintah ini adalah wrapper untuk pnpm, sehingga binari pnpm yang hilang akan menghentikannya sebelum pekerjaan plugin dimulai. Pada Node 25 dan yang lebih baru, ini adalah kondisi default karena Corepack tidak lagi disertakan dalam Node.
Agen tidak dapat melihat proyek Anda. Web UI yang baru tidak memiliki workspace yang dipilih sampai Anda menambahkannya, dan session composer tidak akan tersedia sampai Anda melakukannya. Proses ini hanya menggunakan direktori tempat ia dimulai sebagai lokasi sistem file default, sehingga unit yang WorkingDirectory-nya adalah direktori home Anda akan mengarahkan agen ke direktori home tersebut. Pilih workspace di UI, atau perbaiki unit tersebut dan muat ulang (reload).
FAQ
Apakah aman mengekspos web UI DeepSeek Harness pada port 3080?
Tidak. Pada 0.1.0-rc.6 yang dipin, server web tidak memiliki login bawaan, dan agent di belakangnya mengedit file serta menjalankan perintah shell sebagai pengguna yang memulai proses tersebut. Kunci API provider Anda tersimpan pada disk yang sama. Mulai 0.2.0-rc.2, termasuk 0.2.2-rc.1, rilis npm latest pada 12 November 2026, dan prerelease 0.2.2-rc.2 yang lebih baru, URL startup yang dicetak memuat token peluncuran yang ditukar browser dengan cookie sesi. Namun, URL tersebut adalah kredensial yang dikirim tanpa enkripsi melalui HTTP biasa, sehingga sarannya tetap sama. Biarkan listener pada 127.0.0.1 dan akses melalui SSH tunnel. Private overlay network atau reverse proxy yang mengautentikasi setiap request sebelum request tersebut mencapai port itu juga dapat digunakan. Mulai versi 0.1.0-rc.6, CLI menolak --host 0.0.0.0 dan keluar dengan usage error. 0.2.2-alpha.2 juga masih menolaknya. Hal ini menunjukkan pandangan pembuatnya terhadap penggunaan tersebut.
Apakah saya memerlukan kunci API DeepSeek, atau dapat menggunakan model lokal?
Keduanya dapat digunakan karena harness adalah runtime, bukan model. Di Settings, lalu Models, Anda dapat menempelkan kunci ke kartu DeepSeek atau catalog provider. Anda juga dapat memilih "Add model provider", lalu "Custom model API", dan memberikan base URL yang mendukung OpenAI Chat Completions, OpenAI Responses, Anthropic Messages, atau Gemini API. Server Ollama lokal merespons pada http://127.0.0.1:11434/v1/ dan menerima string apa pun pada kolom kunci API. Kunci disimpan di $DSH_HOME/.credentials.yaml, yang secara default adalah ~/.dsh/.credentials.yaml.
Apa yang sebenarnya diberikan kepada plugin saat plugin DeepSeek Harness diinstal?
Plugin memperoleh permission akun yang menjalankan harness. Plugin adalah kode Node yang dimuat ke dalam proses yang sama. Extension point mencakup shell backend, filesystem layer, tool registry, dan event yang membungkus setiap tool call. Tidak ada mekanisme sandbox yang memisahkan plugin dari komponen tersebut, kecuali plugin menyediakan sandbox sendiri. Baca source sebelum menginstalnya. Jalankan harness sebagai pengguna yang tidak memiliki data penting bagi Anda.
Versi mana yang sebaiknya saya instal, dan apakah versi tersebut akan tetap berfungsi?
Instal versi yang persis, misalnya npx @deepseek-ai/dsh@0.1.0-rc.6 web. Itulah versi Agustus 2026 yang dipin di sini. Pada 12 November 2026, tag npm latest mengarah ke 0.2.2-rc.1. GitHub mencantumkan prerelease 0.2.2-rc.2 yang lebih baru dan dirilis pada 11 November. CLI saat ini memerlukan Node 24.9 atau yang lebih baru. Proyek ini menyebut dirinya sebagai developer preview dan menyatakan bahwa perubahan yang memutus kompatibilitas dapat terjadi. Karena itu, perintah yang tidak menggunakan versi pin dapat berperilaku berbeda dari satu hari ke hari berikutnya. Periksa repository sebelum melakukan upgrade. Bersiaplah menghadapi perubahan config key dan plugin interface selama versi masih diawali dengan 0.