SSD Nodes Learn Hosting plans →
Panduan Matt ConnorOleh Matt Connor · Dikemas kini 2026-10-25

Apa itu Compartment untuk memori ejen luar talian?

Compartment menyimpan memori ejen secara disulitkan pada mesin anda tanpa sambungan internet. Ketahui model ancaman, risiko kehilangan kunci, dan fungsi versi 4.6.0.

Perkara yang membezakan Compartment

Compartment ialah stor memori ejen yang menyulitkan setiap rekod pada mesin yang menciptanya dan tidak pernah berhubung dengan servis rangkaian. Dua ciri membezakannya daripada produk lain dalam bidang memori ejen. Vault ialah satu fail termeterai yang hanya boleh dibuka dengan frasa laluan anda, manakala langkah embedding dijalankan secara setempat. Oleh itu, teks memori tidak pernah dihantar ke mana-mana untuk ditukar menjadi vektor. Versi 4.6.0 diterbitkan pada 10 August 2026, lesennya ialah Apache-2.0 dan pemasangannya tersedia daripada PyPI. Versi yang lebih baharu telah diterbitkan, dan setakat 12 October 2026, versi terkini di PyPI ialah 4.11.0, yang diterbitkan pada 30 September 2026. Panduan ini kekal menggunakan 4.6.0.

Itu ialah dakwaan tentang model ancaman, jadi panduan ini menganggapnya sedemikian. Penyulitan data semasa disimpan serta reka bentuk luar talian melindungi senarai perkara tertentu. Perkara lain masih terdedah, dan jurang itulah yang menimbulkan masalah selepas sistem mula digunakan.

Panduan ini mengikut dokumentasi projek sendiri untuk versi 4.6.0, yang dibaca semula kali terakhir pada 12 October 2026. Compartment menyediakan aplikasi desktop, item menu bar pada macOS dan ikon kawasan pemberitahuan pada Windows, selain alat baris perintahnya. Prompt frasa laluan tidak boleh dikendalikan daripada container automatik. Anggap perkara berikut sebagai tingkah laku yang didokumenkan, bukan tingkah laku yang diukur di sini. Jalankannya pada mesin ganti sebelum anda mempercayakan apa-apa data sebenar kepadanya.

Perlindungan sebenar penyulitan pada storan (encryption at rest)

Vault ini dimeterai dengan XChaCha20-Poly1305, iaitu sifir AEAD (authenticated encryption with associated data), dan keyslot yang memegang kunci induk dibalut dengan Argon2id, iaitu fungsi hashing kata laluan yang direka untuk menjadi perlahan dan memerlukan banyak memori. Dua perkara terhasil daripada ini. Salinan fail pada cakera yang dicuri, dalam sandaran lama, atau yang dilampirkan pada tiket sokongan hanyalah bait-bait data tanpa makna. Selain itu, satu bit yang berubah akan menyebabkan pengesahan gagal apabila fail dibuka, maka kerosakan data menjadi ralat yang jelas dan bukannya jawapan yang salah.

Vektor embedding juga disulitkan, yang mana lebih penting daripada kedengarannya. Embedding bukanlah satu hash. Kajian mengenai penyongsangan embedding telah berjaya mendapatkan semula serpihan teks asal daripada vektornya sahaja, jadi indeks vektor teks biasa yang diletakkan bersebelahan dengan pangkalan data yang disulitkan adalah hampir sama dengan membiarkan pangkalan data tersebut terbuka. Compartment tidak menulis indeks teks biasa ke cakera.

Pemadaman adalah pemadaman sebenar. Setiap rekod membawa kuncinya sendiri, dan compartment forget --shred memusnahkan kunci tersebut, jadi teks sifer yang tertinggal tidak boleh dinyahsulit oleh sesiapa pun, termasuk anda sendiri. Bandingkan ini dengan baris yang dipadam daripada fail pangkalan data, yang biasanya kekal boleh dibaca dalam halaman bebas (free pages) sehingga sesuatu data lain menimpanya.

Luar talian (offline) adalah separuh lagi daripada perlindungannya. Tiada apa-apa yang dimuat naik, jadi tiada akaun vendor yang memegang memori anda dan tiada kunci API yang boleh menyebabkan kebocoran data.

Perkara yang tidak dilindungi oleh Compartment

Tuntutan keselamatan terhenti pada sempadan vault, dan sempadan itu lebih dekat daripada yang disangka.

Ejen membaca teks biasa (plaintext). Recall menyahsulit memori dan menyerahkan teks tersebut kepada ejen. Jika ejen itu merupakan model yang dihoskan, memori tersebut akan dihantar kepada penyedia model di dalam prompt seterusnya, sama seperti data lain dalam tetingkap konteks. Penyulitan semasa dalam simpanan (encryption at rest) melindungi fail tersebut. Ia tidak melindungi proses perolehan (retrieval). Oleh itu, peraturan dalam menjauhkan rahsia daripada ejen AI tidak menjadi longgar hanya kerana storan disulitkan: kata laluan yang disimpan sebagai memori adalah kata laluan yang anda telah tetapkan untuk ditampal ke dalam prompt secara automatik.

Vault yang tidak dikunci pada mesin yang sedang berjalan adalah terbuka. Nota keselamatan projek menyatakan perkara ini dengan jelas. Semasa vault tidak dikunci, kunci induk (master key) dan set kerja berada dalam RAM, Python tidak dapat menjamin bahawa penimbal (buffer) akan dipadamkan, dan swap atau imej hibernasi boleh menulis memori tersebut ke cakera. Perisian hasad yang berjalan sebagai pengguna anda tidak perlu memecahkan sifir, kerana ia boleh meminta data daripada vault yang sudah tidak dikunci.

Identiti pemanggil adalah deklaratif. Namespace boleh dihadkan mengikut pemanggil, tetapi nama pemanggil datang daripada proses hos, jadi hos yang menipu tentang namanya akan menerima kebenaran yang dituntutnya. Kebenaran namespace adalah untuk organisasi, bukan sempadan keselamatan terhadap program tempatan yang berniat jahat.

Proses pemusnahan (shredding) tidak dapat mencapai salinan. forget --shred memusnahkan kunci di dalam fail semasa. Sandaran yang dibuat sebelum proses shred masih menyimpan rekod tersebut, dan masih boleh dibuka dengan frasa laluan pada hari itu.

Frasa laluan yang lemah menamatkan perbincangan. Argon2id menjadikan setiap tekaan mahal dari segi pengiraan. Ia tidak dapat menyelamatkan frasa laluan yang muncul dalam senarai perkataan.

Pasang Compartment daripada keluaran yang dipinkan

Compartment memerlukan Python 3.11 atau lebih baharu. Projek ini bergerak pantas, dengan 23 keluaran di PyPI antara 26 July dan 10 August 2026 serta 35 keluaran setakat 12 October 2026. Oleh itu, pin versi tersebut dan jangan mengambil versi yang tersedia pada hari pemasangan.

python3 --version
pip install "compartment==4.6.0"
compartment --version
compartment init

compartment --version sepatutnya memaparkan versi yang anda pin. Jika shell menjawab compartment: command not found, direktori pemasangan tiada dalam PATH anda. Pada kebanyakan sistem, direktori itu ialah ~/.local/bin. pipx install compartment==4.6.0 dan uv tool install compartment==4.6.0 mengelakkan masalah itu dengan mengurus path masing-masing.

compartment init meminta frasa laluan dua kali dan tidak memaparkan apa-apa aksara. Frasa laluan itu ialah satu-satunya kunci. Projek ini tidak menjana kata laluan atau frasa pemulihan, dan ini disengajakan: tiada kelayakan yang dipegang oleh perisian tetapi tidak dipegang oleh anda.

Semak hasilnya sebelum menyambungkan apa-apa kepadanya.

compartment status

Vault yang berfungsi dengan baik melaporkan bahawa ia telah dibuka kuncinya. Jika laporan menunjukkan vault terkunci, jalankan compartment unlock dan masukkan frasa laluan. Proses mula semula akan menguncinya semula kerana kelayakan yang memastikan vault kekal terbuka bergantung pada rahsia bagi setiap boot. Pada macOS, compartment unlock --keychain membolehkan vault kekal terbuka selepas reboot dengan menyimpan kelayakan itu dalam keychain sistem.

Lokasi sebenar data

Vault lalai terletak di ~/.compartment/memory.vault. Tentukan lokasi lain dengan --vault PATH pada mana-mana arahan, atau gunakan pemboleh ubah persekitaran COMPARTMENT_VAULT.

Satu fail tersebut merupakan keseluruhan storan. Ia dibuka dengan pengepala yang mengandungi versi format dan keyslot Argon2id, diikuti dengan payload yang dimeterai, kemudian entri jurnal yang ditambah apabila memori baharu tiba. Setiap entri jurnal dibingkaikan dengan panjangnya dan CRC (cyclic redundancy check) bagi panjang tersebut, supaya penulisan yang terhenti akibat kegagalan sistem dikenal pasti sebagai entri yang terpotong dan bukannya dibaca sebagai data. Pemadatan (compaction) mensirikan vault, menulis fail sementara, melakukan fsync, kemudian menamakan semula fail tersebut ke tempat asalnya, yang bermaksud pembaca tidak akan melihat vault yang ditulis separuh jalan.

Akibat yang berguna: skrip sandaran hanya perlu menyalin satu laluan sahaja. Akibat yang menyusahkan: anda tidak boleh menggunakan grep ke atasnya, dan anda tidak boleh membaikinya menggunakan editor teks. Jika anda mahukan memori yang boleh dibaca dengan cat dan dikomit ke git, fail memori tempatan biasa Memmy adalah pertukaran yang bertentangan. Kedua-duanya adalah munasabah, bergantung kepada sama ada perkara yang anda takuti ialah komputer riba yang dicuri atau alatan yang rosak.

compartment uninstall membuang perisian tersebut dan mengekalkan vault. Gunakan --purge hanya apabila anda benar-benar pasti.

Menyambungkannya ke ejen

Satu arahan menyambungkan klien yang disokong.

compartment integrate --list
compartment integrate claude

Bagi Claude Code yang menulis entri pelayan MCP (model context protocol) dan hook PostToolUse ke dalam ~/.claude/settings.json, dengan membuat sandaran fail terlebih dahulu, ia memasang kemahiran /compartmentalize di bawah ~/.claude/skills/, dan menambah blok terurus ke ~/.claude/CLAUDE.md yang memberitahu ejen bahawa Compartment menggantikan memori berasaskan fail yang digunakannya sebelum ini. Sahkan kedua-dua bahagian:

compartment hook status
compartment recent

Untuk mendaftarkan pelayan secara manual pula:

claude mcp add --scope user compartment -- \
    compartment --vault ~/.compartment/memory.vault --caller claude-code serve

Mana-mana hos lain yang berupaya menjalankan MCP boleh menggunakan pelayan yang sama dengan nama pemanggilnya sendiri.

{ "mcpServers": { "compartment": {
    "command": "compartment",
    "args": ["--vault", "/path/to/memory.vault",
             "--caller", "your-agent-name", "serve"] } } }

Berikan setiap hos nilai --caller yang berbeza. Nilai ini merupakan label yang direkodkan dalam log audit dan kunci yang digunakan untuk pemberian namespace, jadi nama yang dikongsi akan menjadikan kedua-duanya tidak berguna.

Jika Claude Code telah menulis fakta ke dalam fail memorinya sendiri, compartment import-claude --dry-run akan menunjukkan perkara yang akan dipindahkan sebelum sebarang pemindahan berlaku. Baca apa yang disimpan oleh Claude Code dalam fail memorinya terlebih dahulu, kerana mengimport nota selama setahun ke dalam vault baharu adalah punca stor memori dipenuhi dengan perkara yang tidak sepatutnya disimpan.

Seberapa pantas vault tempatan

Ini adalah angka yang diterbitkan oleh projek tersebut untuk vault bersaiz peribadi. Angka ini datang daripada dokumentasi projek, bukan daripada ujian yang dijalankan di sini.

CartaCompartment published local latency, milliseconds
Data di sebalik carta ini
[
  {
    "label": "Store one memory, end to end",
    "latency_ms": 40
  },
  {
    "label": "Embed one memory, bundled model",
    "latency_ms": 25
  },
  {
    "label": "Hybrid search, median",
    "latency_ms": 11.6
  },
  {
    "label": "Vector search at 20k records, p95",
    "latency_ms": 0.68
  }
]

Penyimpanan satu memori dinyatakan pada 40 ms, dan carian vektor merentasi dua puluh ribu rekod pada 0.68 ms untuk persentil ke-95. Hujah projek untuk mengekalkan memori secara tempatan adalah berdasarkan aritmetik: satu perjalanan pergi-balik rangkaian ke API memori yang dihoskan sering kali menelan kos lebih tinggi daripada median 11.6 ms untuk carian hibrid penuh di sini.

Dua perincian reka bentuk menjelaskan angka carian tersebut. Di bawah dua puluh ribu rekod, Compartment membandingkan pertanyaan dengan setiap vektor, jadi recall adalah tepat mengikut binaan dan bukannya anggaran. Melebihi jumlah tersebut, ia bertukar kepada HNSW (hierarchical navigable small world), iaitu indeks anggaran yang mengorbankan sedikit recall demi kelajuan. Vault tersebut juga merekodkan hash SHA-256 bagi model embedding dan enggan dibuka di bawah model yang berbeza, kerana vektor daripada dua model yang berbeza boleh dibandingkan tanpa sebarang ralat muncul, dan skor yang dikembalikan tidak membawa sebarang makna.

Sandaran, dan salinan yang masih boleh dibuka pada tahun hadapan

Vault yang dikunci merupakan satu fail mudah alih, jadi memindahkannya bermakna membuat salinan.

compartment lock
scp ~/.compartment/memory.vault other-machine:
compartment --vault memory.vault unlock

Kunci fail tersebut terlebih dahulu. Menyalin fail semasa ejen sedang menulis boleh menyebabkan entri jurnal terpotong di tengah-tengah proses penambahan, dan walaupun pembingkaian CRC membolehkan pembaca melangkau serpihan hujung tersebut, memori di dalamnya akan hilang. compartment lock --sign memeterai fail dengan manifest Ed25519, supaya mesin penerima boleh mengesahkan salinan tersebut sampai dalam keadaan sempurna tanpa perlu memegang kata laluan.

Oleh kerana fail tersebut sudah dimeterai, storan awan biasa merupakan tempat yang boleh diterima untuk menyimpannya. Inilah titik di mana penyulitan semasa rehat (encryption at rest) memberikan pulangan secara langsung: sasaran sandaran tidak akan melihat sebarang memori.

Dua amaran. Proses shredding tidak mencapai sandaran, jadi rekod yang anda musnahkan secara kriptografi hari ini masih boleh dibaca dalam salinan minggu lepas oleh sesiapa sahaja yang mempunyai kata laluan minggu lepas. Dan compartment export --plaintext menulis keseluruhan vault tanpa penyulitan, yang merupakan alat yang betul untuk migrasi ke sistem lain tetapi fail yang salah untuk ditinggalkan di dalam ~/Downloads.

Simpan beberapa salinan sahaja dan letakkan tarikh padanya. Storan memori akan menjadi liabiliti apabila tiada sesiapa yang membersihkannya, yang merupakan hujah dalam mengapa memori ejen yang lapuk merosakkan proses perolehan secara senyap.

Pengendalian kunci, putaran, dan faktor kedua

compartment rekey
compartment 2fa enable
compartment 2fa status

rekey menukar frasa laluan dengan membungkus semula kunci induk dalam keyslot fail semasa. Salinan lama mengekalkan frasa laluan lama, kerana bait tersebut telah dimeterai sebelum perubahan dibuat dan tiada proses yang mengubahnya semula. Lakukan putaran pada salinan tersebut juga, atau terima hakikat bahawa frasa laluan yang telah dibersarakan masih boleh membuka sesuatu.

2fa enable menambah fail kunci sebagai faktor kedua, yang digabungkan dengan frasa laluan semasa derivasi kunci, supaya kedua-duanya diperlukan untuk membuka vault. Ini juga menggandakan bilangan perkara yang boleh anda hilangkan. Simpan fail kunci di luar mesin yang menyimpan vault tersebut.

Untuk skrip dan CI (integrasi berterusan), frasa laluan boleh dihantar melalui pemboleh ubah persekitaran COMPARTMENT_PASSPHRASE, dan unlock --passphrase-stdin membacanya daripada paip (pipe). Utamakan penggunaan paip. Pemboleh ubah persekitaran boleh dibaca oleh proses lain yang dimiliki oleh pengguna yang sama, dan ia cenderung untuk muncul dalam log kerja.

Sejarah audit dirantai menggunakan hash, dan compartment audit verify menyemak rantaian tersebut serta melaporkan pautan pertama yang rosak. Jalankan arahan ini selepas sebarang pemulihan (restore), kerana pada waktu itulah fail yang terpotong secara senyap akan dikesan.

Apa yang berlaku apabila anda kehilangan frasa laluan

Tiada apa-apa yang berlaku, dan itulah reka bentuknya. Tiada tetapan semula, tiada frasa pemulihan, dan tiada alamat untuk dihubungi, kerana tiada salinan kunci wujud di luar ingatan anda dan fail kunci pilihan anda. Bilik kebal (vault) tersebut kekal sebagai fail yang mengandungi bait yang kelihatan rawak.

Oleh itu, pelan pemulihan bukanlah pelan untuk bilik kebal tersebut. Ia adalah pelan untuk frasa laluan anda. Rekodkannya dalam pengurus kata laluan pada hari anda menjalankan compartment init. Kemudian ujinya: kunci bilik kebal tersebut, buka kuncinya menggunakan hanya apa yang anda tulis, dan biarkan ejen mula mengisinya selepas ia berjaya dibuka.

Compartment atau memory server

Compartment direka untuk satu mesin. Perkongsian antara mesin bermaksud menyalin fail terkunci atau melakukan eksport dan import. Beberapa ejen pada mesin yang sama boleh menggunakan satu vault serentak kerana file lock nasihat menyusun operasi tulis mereka. Dokumentasi tidak menerangkan penggunaan satu fail oleh dua mesin untuk operasi tulis. Oleh itu, jangan halakan laptop dan workstation kepada vault yang sama pada network share atau folder sync.

Apabila beberapa mesin memerlukan memori yang sama pada masa yang sama, itu ialah masalah server. Memory server Mem0 yang dihos sendiri pada VPS menyelesaikannya: satu endpoint, banyak klien dan memori yang kekal walaupun laptop ditukar. Kosnya perlu dinyatakan dengan jelas. Server itu menjalankan proses yang boleh membaca data yang disimpannya. Oleh itu, model ancaman anda kini merangkumi VPS dan semua pihak yang boleh mencapai API-nya.

Pilih berdasarkan kehilangan yang benar-benar anda bimbangkan. Jika anda bimbang tentang laptop yang dicuri atau vendor yang membaca nota anda, vault setempat yang disulitkan ialah pilihan yang lebih kukuh. Jika anda bimbang tentang ejen yang melupakan segala-galanya apabila anda bertukar mesin, gunakan server.

FAQ

Apakah yang sebenarnya dilindungi oleh penyulitan Compartment?

Penyulitan itu melindungi fail. Vault dimeterai dengan XChaCha20-Poly1305, keyslot-nya dibalut dengan Argon2id dan vektor embedding turut disulitkan. Oleh itu, disk yang dicuri atau backup lama hanya menghasilkan bait yang tidak boleh dibaca. Penyulitan itu tidak melindungi vault yang telah dibuka kuncinya pada mesin yang sedang berjalan kerana master key berada dalam RAM selagi vault terbuka. Penyulitan itu juga tidak mengawal perkara yang dilakukan ejen terhadap memori selepas hasil recall dikembalikan sebagai teks biasa.

Jika Compartment luar talian, adakah memori saya terlindung daripada penyedia model?

Hanya sehingga memori itu dipanggil semula. Penyimpanan dan carian berlaku tanpa rangkaian, manakala model embedding dijalankan secara setempat. Oleh itu, tiada data meninggalkan mesin pada masa penulisan. Pada masa bacaan, ejen menerima teks biasa. Jika ejen itu menggunakan model yang dihoskan, memori tersebut masuk ke dalam prompt dan dihantar kepada penyedia seperti kandungan lain dalam context window. Jangan simpan kelayakan sebagai memori.

Apakah yang berlaku jika saya kehilangan frasa laluan Compartment?

Vault tidak boleh dipulihkan, dan ini disengajakan. Compartment tidak menjana seed atau frasa pemulihan serta tidak menyimpan kelayakan yang tidak anda miliki. Oleh itu, tiada apa-apa yang boleh ditetapkan semula. Simpan frasa laluan dalam password manager, simpan mana-mana 2FA keyfile di luar mesin yang menyimpan vault dan pastikan anda boleh membuka kunci salinan sebelum vault mengandungi sesuatu yang penting bagi anda.

Bolehkah dua mesin berkongsi satu vault Compartment?

Tidak pada masa yang sama. Vault terkunci ialah satu fail mudah alih, dan kaedah yang didokumenkan ialah menguncinya, menyalinnya, kemudian membuka kuncinya pada mesin lain dengan --vault. Dokumentasi hanya merangkumi file lock nasihat yang menyusun operasi tulis bagi ejen pada satu mesin. Dokumentasi tidak merangkumi dua mesin yang menulis kepada satu fail. Oleh itu, anggap konfigurasi itu boleh menyebabkan memori hilang. Gunakan memory server apabila anda memerlukannya.

Adakah artikel ini berguna?

#agent-memory#compartment#encryption#offline#privacy