Apa Itu DeepSeek Harness? Runtime Agen di Mana Segalanya Adalah Plugin

Apa Itu DeepSeek Harness?

DeepSeek Harness, disingkat menjadi dsh, adalah open-source agent harness dari DeepSeek AI di bawah lisensi MIT. Ia berada di antara sebuah model bahasa dan dunia luar, menyediakan alat, sesi, sandboxing, dan loop yang menjaga tugas terus berjalan.

Kerangka dari DeepSeek sendiri adalah "Agent = Model + Harness." Model menangani penalaran dan generasi. Harness adalah segala sesuatu yang memungkinkan penalaran itu bertindak pada filesystem nyata dan terus berjalan tanpa Anda harus mengulang penjelasan tugas di setiap langkah.

Ia berjalan di atas Cordis, sebuah kerangka plugin yang sudah ada sebelum DeepSeek Harness. Cordis memungkinkan pengaturan mengganti bagian-bagian ini secara independen. Saya akan kembali pada biaya dari pilihan itu nanti.

Dengan kerangka tersebut, berikut dua kesalahpahaman umum.

DeepSeek Harness bukan model AI

Seperti disebutkan sebelumnya, model dan runtime adalah lapisan terpisah. Pemisahan itu memungkinkan Anda mengganti penyedia tanpa mengubah alat atau pengaturan sesi. Runtime yang sama dapat menggunakan DeepSeek, Anthropic, OpenAI, atau endpoint kompatibel OpenAI.

DeepSeek Harness lebih dari sekadar asisten coding

Mode Standard menciptakan kesan asisten coding, tetapi itu hanya satu konfigurasi. Seperti akan saya bahas nanti, mode Minimal dan Creator mengubah apa yang bisa digunakan agen. Membangun konfigurasi baru tetap membutuhkan pekerjaan rekayasa; pengembang memiliki akses ke bagian-bagiannya.

Bagaimana Cordis Mengatur Plugin DeepSeek Harness

Seperti disebutkan sebelumnya, Cordis adalah kerangka plugin di bawah DeepSeek Harness. Ia memungkinkan setiap bagian meminta sebuah layanan tanpa mengikatnya pada kode satu penyedia saja.

Cordis berasal dari ekosistem chatbot Koishi dan dibangun oleh seorang pengembang bernama Shigma; DeepSeek memasarkan dan memperluasnya. Para penulisnya menjelaskan desain tersebut dalam makalah berjudul A Programming Paradigm for Spatiotemporal Composability.

Dasar-dasar itu mengarah pada slogan utama proyek dan dua istilah Cordis. Namanya terdengar akademis, tetapi perilakunya cukup sederhana.

"Segalanya adalah plugin"

Dokumentasi arsitektur DeepSeek menyatakan Anda memperluas dsh dengan memasang sebuah plugin di samping yang lain. Adapter model, alat, sesi, sandbox, penyimpanan, penjadwalan, agent loop, dan UI semuanya adalah plugin.

Secara harfiah, slogan itu terlalu jauh. Cordis tetap berada di bawah plugin. Ia memuat dan menghapusnya, memeriksa apa yang mereka butuhkan, dan menjalankan event yang mereka gunakan untuk saling berkomunikasi. Cordis adalah prasyarat, bukan satu bagian opsional lagi.

Komposabilitas spasial mengelola dependensi plugin

Sebuah plugin mendeklarasikan layanan yang dibutuhkannya tanpa memerlukan urutan boot yang ditulis manual. Plugin aktif ketika layanan tersebut ada dan nonaktif jika layanan yang diperlukan menghilang. Dependensinya menentukan kapan ia dapat berjalan.

DeepSeek menyebut ini komposabilitas spasial. Dependensi memberi tahu Cordis di mana sebuah komponen cocok, sehingga pengembang tidak perlu mengatur urutan startup secara manual.

Komposabilitas temporal membalikkan efek plugin

Cordis juga melacak pendaftaran seperti event listener, bagian prompt, dan skema alat. Menghapus sebuah plugin menghapus efek tersebut alih-alih menyisakan listener yatim. Ini tidak membatalkan aksi eksternal seperti perintah shell; keterbalikan hanya berlaku pada efek yang dilacak Cordis.

Arsitektur DeepSeek Harness: Bagaimana Runtime Terhubung

Sebuah instance yang berjalan adalah pohon plugin yang dibangun dari pengaturan yang dimuat dalam urutan tertentu. Pengaturan tersebut menentukan bagian mana yang aktif.

Cordis menghubungkan setiap plugin runtime yang dapat diganti. Gambar oleh Penulis.

Layanan Cordis memungkinkan plugin saling menemukan

Cordis menyediakan direktori layanan bersama. Plugin menggunakan kunci stabil seperti ctx.tools, ctx.llm, dan ctx.sessions alih-alih mengimpor kode dari satu penyedia. Sebuah alat yang memanggil ctx.llm tidak perlu tahu adapter model mana yang berada di belakangnya.

Preset agen dan profil runtime mengendalikan lapisan berbeda

Jika semuanya dapat diganti, tetap harus ada sesuatu yang memutuskan apa yang dipasang untuk sebuah run, dan DeepSeek Harness menjawabnya pada dua lapisan yang mudah tertukar.

Versi singkatnya: sebuah profil mengendalikan bagaimana program mulai, sementara preset mengendalikan apa yang dapat dilakukan agen. Jika Anda hanya menggunakan aplikasi web, Anda dapat melewati dua subbagian berikut.

Profil runtime

Sebuah profil runtime (web, headless, sdk, sdk-minimal, dan acp disertakan sebagai templat) memutuskan bagaimana aplikasi diluncurkan dan bundel plugin Cordis mana yang ditumpuk saat boot. Kebanyakan pembaca hanya akan menyentuh lapisan ini dengan menjalankan dsh web atau perintah serupa.

Preset agen

Sebuah preset agen (Standard, PTC, Minimal, atau Creator) menentukan apa yang dapat digunakan oleh sebuah sesi aktif. Sebuah file patch dapat mengubah preset tanpa menyentuh source Harness.

Agent loop mengoordinasikan turn, step, dan pemanggilan alat

DeepSeek membedakan step dari turn. Sebuah step adalah satu permintaan model plus pemanggilan alatnya. Sebuah turn adalah nol atau lebih step: ia dibuka sebelum input pertamanya diklaim dan ditutup ketika tidak ada lagi yang terutang. Kebanyakan turn menjalankan beberapa step sebelum agen dapat menjawab, tetapi input yang ditolak menutup turn yang tidak menghabiskan step.

Satu turn dapat berisi beberapa step. Gambar oleh Penulis.

Sesi menggunakan log peristiwa append-only

Ini bagian yang menurut saya paling penting. Sebuah sesi adalah log append-only dari peristiwa bertipe, bukan array pesan obrolan. Harness membangun riwayat model dari log itu, dan dokumentasi sesi mensyaratkan apa pun yang dikirim ke model harus dapat dipulihkan darinya.

Resume, fork, pencarian, pemutaran ulang, dan tampilan Trajectory semuanya dibangun di atas aliran peristiwa itu.

Menderivasi ulang riwayat bukanlah menjalankan ulang deterministik. Keluaran model dan keadaan eksternal bisa berbeda, tetapi log tetap menyediakan catatan yang dapat diperiksa tentang apa yang terjadi.

Riwayat sesi adalah log append-only. Gambar oleh Penulis.

Bagaimana DeepSeek Harness mengendalikan alat dan sandbox

Sebuah model dapat meminta alat berdasarkan nama, tetapi tidak bisa menjalankannya secara langsung. Dua kontrol terpisah berada di antara permintaan dan perubahan filesystem.

Pipeline eksekusi alat

Panggilan melewati pemeriksaan kebijakan, eksekusi, dan penanganan hasil. Model memilih alat; runtime memutuskan apakah dan bagaimana alat itu dijalankan.

Runtime yang memutuskan bagaimana alat dijalankan. Gambar oleh Penulis.

Sandboxing versus persetujuan

• Persetujuan menanyakan apakah pengguna harus mengonfirmasi sebuah tindakan. 
• Sandboxing membatasi di mana dan bagaimana tindakan tersebut dijalankan. 

DeepSeek memisahkannya, meski preset izin menggabungkan keduanya, seperti halnya sebuah container runtime memisahkan izin proses dari batas eksekusi.

Perlu ditandai sekarang, karena akan saya singgung lagi di bagian keterbatasan: memberi tahu model dalam system prompt untuk "hanya membaca file" adalah saran yang dapat diikutinya, bukan batas yang dipaksakan seperti pembatasan sandbox di level OS.

Mode DeepSeek Harness: Standard, PTC, Minimal, dan Creator

DeepSeek Harness menawarkan empat mode berbeda. Tidak ada dari keempatnya yang lebih unggul. Mereka adalah empat jawaban untuk "seberapa banyak runtime yang harus diekspos ke sesi ini," dan yang tepat bergantung pada tugasnya. Seperti ditunjukkan di bagian arsitektur, setiap mode mengubah kumpulan alat yang tersedia bagi agen.

Empat mode berbagi satu basis runtime. Gambar oleh Penulis.

Mode Standard

Baseline serbaguna: 

• Penyuntingan file
• Akses shell
• Pencarian file dan web
• Skills
• Perencanaan
• Goals
• Subagents
• Workflows

Untuk pekerjaan repositori biasa, ini adalah titik awal saya.

Mode PTC

Mode PTC mempertahankan hampir seluruh set alat Standard tetapi mengubah cara model mengaksesnya. (Sejak versi 0.1.2, Web PTC mode tidak lagi mengekspos alat workflow serbaguna secara default.) 

Alih-alih meminta alat secara individual di beberapa step model, model menulis sebuah program terhadap SDK yang dihasilkan. Program tersebut dapat memanggil beberapa alat melalui run_code. Setiap pemanggilan tetap melewati pemeriksaan kebijakan yang sama, jadi PTC mengubah cara model menyatakan rencana, bukan apa yang boleh dilakukannya.

Halaman produk masih menggunakan label "Code mode," tetapi rilis resmi yang lebih baru menggantinya menjadi mode PTC sambil menjaga rekaman percakapan lama tetap dapat dibaca. Saya akan menggunakan sebutan mode PTC sepanjang tulisan ini; FAQ akan kembali pada apa kepanjangan inisial tersebut.

Mode Minimal

Mode Minimal menyederhanakan lingkungan menjadi dua alat: shell persisten dan editor file pengganti-string. DeepSeek menggunakannya untuk benchmark model karena hasil uji sebagian bergantung pada harness model, bukan hanya bobotnya.

Mode Creator

Mode Creator memungkinkan pengembang memeriksa runtime dan menguji plugin Cordis di memori. Ini untuk membangun preset, dan saya tidak akan menyebutnya self-improving dalam arti yang lebih dalam.

Apa yang Membuat DeepSeek Harness Berbeda dari Kerangka Agen Lain?

DeepSeek Harness berbeda dari banyak kerangka agen dengan membuat bagian runtime tingkat bawah dapat diganti. Saya hampir memasukkan ini ke bagian arsitektur, tetapi perbedaannya mudah terlewat. Cordis menangani perubahan tersebut melalui satu sistem plugin.

Anda dapat mengubah cara agen beroperasi, bukan hanya alat yang dapat dipanggilnya. Log peristiwa juga membuat run yang dapat diperiksa pengembang, alih-alih hanya membacanya sebagai transkrip obrolan. Mode Minimal dan Creator kemudian memungkinkan mereka menguji runtime dari dua arah yang berlawanan.

DeepSeek Harness vs. Claude Code, Codex, dan OpenCode

Daftar fitur akan meleset dari inti. Setiap pesaing mendukung ekstensi; pertanyaan yang berguna adalah bagian mana yang dapat diubah pengembang. Perbedaannya terdengar kecil, tetapi tidak demikian. Perbandingan khusus Harness versus Claude Code kami menggunakan model yang sama di keduanya dan membahas setup, log, serta biaya.

DeepSeek Harness vs. Claude Code

Claude Code mendukung instruksi proyek, skills, hooks, MCP, subagents, dan Agent SDK, serta mempertahankan loop bawaannya tetap tetap. DeepSeek Harness memungkinkan pengembang mengganti loop, adapter model, dan lapisan penyimpanan melalui pengaturan.

DeepSeek Harness vs. Codex

Codex memerlukan perbandingan yang lebih cermat karena CLI dan App Server-nya juga open source. Ia menyediakan agent harness yang diperluas pengembang melalui entry point yang didokumentasikan. DeepSeek Harness dibangun dengan menitikberatkan pada pengubahan runtime itu sendiri. Keduanya menawarkan tingkat kendali yang berbeda.

DeepSeek Harness vs. OpenCode

OpenCode sudah open source, bekerja dengan beberapa penyedia model, dan menggunakan arsitektur klien-server. Anda dapat mengonfigurasi alat, izin, sesion, dan penyedianya. Plugin-pluginya memperluas inti server yang tetap, sementara DeepSeek juga membuat loop dan penyimpanan sesi dapat diganti.

Kapan Menggunakan DeepSeek Harness

Mengganti bagian runtime tidak berguna dengan sendirinya. Kontrol ekstra hanya penting ketika itu menyelesaikan masalah yang sudah Anda miliki.

• Ketika runtime itu sendiri adalah bagian dari proyek. Jika Anda memodifikasi adapter model, agent loop, penyimpanan, atau perilaku sesi, bukan hanya membangun di atas agen, ini adalah kecocokan yang lebih langsung.
• Ketika Anda membandingkan model dalam lingkungan terkontrol. Menggunakan runtime yang sama menjaga lebih banyak bagian uji tetap tetap saat menukar model, meskipun model masih dapat berbeda dalam penggunaan alat dan gaya penalaran.
• Ketika debugging run yang kompleks itu penting. Log peristiwa sesi dan tampilan Trajectory memudahkan merekonstruksi apa yang dilihat model dan alat mana yang dijalankan.
• Ketika Anda menguji internal agen. Mode Creator dan Cordis ditujukan bagi pengembang yang mempelajari bagaimana agen disusun, lebih dari mereka yang hanya butuh kode aplikasi ditulis.

Ini mungkin tidak diperlukan untuk pemanggilan model sederhana atau bagi tim yang menginginkan agen coding siap pakai tanpa perlu menyentuh bagian dalamnya. Mengganti lebih banyak bagian hanya layak jika kendali itu menyelesaikan masalah nyata.

Keterbatasan DeepSeek Harness: Status Pratinjau Pengembang dan Risiko Keamanan

Semua arsitektur di atas tidak banyak berarti tanpa penjelasan yang jelas tentang di mana ini masih kurang hari ini.

Masih pratinjau pengembang

Repositori DeepSeek menyatakan secara gamblang bahwa akan ada perubahan yang memutus kompatibilitas. Ini sudah terjadi: penggantian nama Code ke PTC disertai perubahan pada API sesi dan penghapusan opsi penyimpanan SQLite opsional. Kunci versi Anda. Melewatkan langkah itu dan berharap setup tetap stabil bukanlah rencana.

Lebih banyak kendali juga berarti lebih kompleks

Membuat lebih banyak bagian runtime dapat diganti juga memberi lebih banyak hal untuk dipelajari pengembang: dependensi plugin, pengaturan, perbedaan penyedia, dan kompatibilitas versi. Ini adalah trade-off biasa antara kemudahan dan kendali.

Apakah DeepSeek Harness bersifat lokal?

DeepSeek Harness menyimpan konten sesi, catatan alat, dan pengaturan secara lokal secara default, according to its data processing statement. Anda dapat mematikan laporan anonim tentang pengaturan dan daftar proyeknya. 

Namun penyedia model eksternal, alat web, server MCP, atau plugin masih dapat mengirim data ke luar mesin Anda berdasarkan kebijakannya sendiri. "Local-first" tidak mencakup setiap layanan yang Anda sambungkan.

Menjalankan agen membawa risiko keamanan

Sebuah runtime yang dapat mengedit file, menjalankan perintah, dan memuat plugin pihak ketiga dapat menyebabkan kerusakan nyata. Pemberitahuan keamanan DeepSeek menyatakan bahwa proyek ini belum diaudit keamanannya. Sandboxing, persetujuan, dan kontrol izin mengurangi risiko tetapi tidak menjamin isolasi.

Menjalankan perangkat lunak di mesin Anda sendiri tidak menghilangkan risiko itu. Gunakan izin terbatas dan lingkungan yang dapat dibuang untuk pekerjaan yang tidak tepercaya, serta berhati-hatilah dengan konten yang mungkin berisi instruksi tersembunyi.

Mengapa Perilaku Agen Bergantung Lebih dari Sekadar Model

Perilaku agen bergantung pada runtime serta model. Ini kembali ke "Agent = Model + Harness," dan pemisahan yang sama berlaku pada LLM agents beyond DeepSeek.

Apa yang dapat dihasilkan model bergantung pada bobotnya. Apa yang dilakukan agen juga bergantung pada konteks mana yang mencapai model, tindakan apa yang diizinkan, dan seberapa ketat eksekusi dikekang. Tidak satu pun dari itu berada di dalam bobot.

DeepSeek Harness menampilkan lapisan di sekeliling itu dengan membaginya menjadi bagian-bagian bernama yang dapat diganti pengembang. Mode Minimal menunjukkan mengapa ini penting di luar DeepSeek: skor benchmark sebagian mencerminkan harness yang digunakan untuk pengujian, bukan hanya model. Harness tidak membuat model lebih pintar. Ia mengubah pengaturan tempat model bekerja.

Kesimpulan

Kalimat pembuka adalah yang patut diingat: model bernalar, tetapi runtime yang memutuskan apa yang dapat dijangkau dan dilakukan oleh penalaran itu. DeepSeek Harness membuat runtime tersebut dapat disunting, dari adapter model dan alat hingga penyimpanan sesi dan agent loop.

Kontrol itu menciptakan biayanya. Mengganti lebih banyak bagian runtime berarti menanggung lebih banyak dari setup, perubahan versi, dan batas keamanan. Pratinjau pengembang dengan akses shell bukanlah sesuatu yang dipasang lalu dilupakan.

Pandangan saya sederhana: gunakan DeepSeek Harness ketika runtime itu sendiri adalah bagian dari pekerjaan. Jika Anda hanya perlu suntingan repositori, agen coding siap pakai menuntut lebih sedikit dari Anda.

Tutorial DeepSeek Harness kami membahas penyiapannya. Panduan alternatif Claude Code membandingkan lebih banyak agen coding, sementara Introduction to AI Agents membahas dasar-dasar yang diasumsikan artikel ini.