Memori Grok Build merentas sesi: tetapan dan had

Grok Build, ejen terminal xAI, mempunyai memori merentas sesi: ia boleh mengingati konvensyen projek, keputusan dan langkah penyahpepijatan yang berjaya, kemudian menambahkannya ke dalam konteks sesi baharu tanpa perlu diingatkan. Ciri ini dimatikan secara lalai dan bersifat percubaan—ia boleh diaktifkan dengan satu tetapan.

Penerangan ini berdasarkan panduan rasmi dalam repositori xai-org/grok-build setakat 20 September 2026. Pengarang artikel asal tidak menggunakan produk ini: mekanismenya dihuraikan berdasarkan dokumentasi, bukannya ujian peribadi.

Maklumat praktikal tentang penggunaan Ailoot tersedia dalam dokumentasi.

Apakah manfaat memori dalam Grok Build?#

Sebagai contoh, dalam satu sesi anda menerangkan kepada ejen bahawa projek menggunakan inden dua ruang, migrasi pangkalan data dijalankan dengan arahan berasingan dan modul tertentu mengendalikan pembayaran. Dalam sesi baharu, anda perlu memberikan maklumat ini sekali lagi.

Apabila memori diaktifkan, Grok Build boleh:

• mengingati konvensyen projek yang anda jelaskan sebelum ini;
• menggunakan langkah penyahpepijatan yang pernah berjaya;
• membawa keputusan seni bina ke sesi berikutnya;
• mengelakkan daripada bertanya semula tentang perkara yang sudah dijawab.

Ciri ini bersifat percubaan dan dimatikan secara lalai. Tingkah laku ejen tidak berubah sehingga anda mengaktifkannya.

Bagaimanakah cara mengaktifkan memori?#

Sekali sahaja, untuk satu pelaksanaan:

GROK_MEMORY=1 grok

Pemboleh ubah ini hanya terpakai untuk pelaksanaan tersebut. Arahan export GROK_MEMORY=1 mengekalkannya dalam shell semasa dan mengaktifkan memori untuk semua pelaksanaan grok seterusnya daripada shell itu—sehingga sesi terminal tamat atau anda menjalankan export GROK_MEMORY=0.

Secara kekal, melalui konfigurasi. Tambahkan perkara berikut pada ~/.grok/config.toml:

[memory]
enabled = true

Dalam sesi tanpa memulakan semula: buka /memory dan tekan t.

Suis ini hanya terpakai pada sesi semasa dan tidak ditulis ke dalam konfigurasi. Anda boleh menggunakannya untuk mengaktifkan atau menyahaktifkan memori. Menyahaktifkannya akan membatalkan akses kepada alat memori, tetapi tidak memadam fail daripada cakera; mengaktifkannya semula akan membuka akses kepada storan. Suis ini tidak boleh mengatasi arahan paksa untuk menyahaktifkan memori pada seluruh proses melalui GROK_MEMORY=0: /memory kekal tidak tersedia sepanjang sesi.

Jika tetapan dinyatakan di beberapa tempat, keutamaannya adalah seperti berikut:

• GROK_MEMORY=0 memaksa memori dinyahaktifkan untuk seluruh proses dan mempunyai keutamaan tertinggi.
• enabled = false yang dinyatakan secara jelas dalam konfigurasi menyahaktifkan memori, walaupun tetapan jauh terurus mengaktifkannya.
• Memori boleh diaktifkan dengan GROK_MEMORY=1, enabled = true dalam konfigurasi atau tetapan jauh terurus.
• Jika tiada apa-apa yang dinyatakan, memori dimatikan.

Nota ditambahkan pada giliran pertama sesi. Jika anda mengaktifkan memori ketika sedang bekerja dan mahu ejen mula menggunakan maklumat projek yang disimpan, jalankan /new. Anda boleh menyemak sama ada memori diaktifkan melalui output grok inspect.

Apakah yang direkodkan oleh Grok Build, dan di manakah ia disimpan?#

Struktur direktori ~/.grok/memory/:

Cincangan pendek pengecam repositori ditambahkan pada nama direktori projek. Repositori jauh origin dalam format “organisasi/repositori” digunakan sebagai pengecam, atau laluan direktori jika tiada repositori Git. Oleh itu, klon dan pepohon kerja (salinan kerja berasingan bagi cabang Git) daripada repositori yang sama berkongsi satu memori projek: perkara yang diingati ejen dalam satu salinan tersedia dalam salinan yang lain.

Entri diwujudkan melalui empat cara:

1. Ringkasan sesi automatik pada penghujung sesi. Apabila sesi tamat, Grok Build menyimpan ringkasan perkhidmatan yang pendek dalam log harian: jumlah mesej, sehingga lima pertukaran substantif yang terawal, serta tarikh dan masa. Ringkasan dibina daripada metadata tanpa panggilan model atau kelewatan. Sesi yang sangat pendek dilangkau: jika terdapat kurang daripada tiga pertukaran substantif atau kurang daripada 50 bait teks anda, tiada entri dibuat. Ringkasan tidak merangkumi alat yang digunakan, laluan fail atau arahan. Ringkasan automatik boleh dinyahaktifkan dengan tetapan session.save_on_end = false.
2. /flush—nota terperinci atas permintaan. Dengan arahan ini, model merumuskan perkara paling penting daripada sesi semasa: keputusan, corak, langkah penyahpepijatan dan penemuan API. Ringkasan ditulis dalam log bertarikh dan diindeks untuk sesi akan datang. Dokumentasi mengesyorkan anda menjalankan /flush sebelum pemadatan konteks, pada penghujung sesi penyahpepijatan yang berjaya dan selepas menemui corak penting.
3. /remember—permintaan khusus untuk mengingati sesuatu. Taip /remember sentiasa buka pautan PR selepas menghantarnya atau beritahu ejen, “ingat bahawa...”. Panel semakan akan dibuka sebelum entri ditulis: nota hanya disimpan selepas anda mengesahkannya, dan Memory saved to ~/.grok/memory/MEMORY.md akan muncul dalam suapan. Maklumat projek disimpan dalam MEMORY.md projek; maklumat yang dikongsi merentas semua projek disimpan dalam fail global.
4. /dream—penyatuan. Arahan ini mengumpulkan log dan nota yang berselerak mengikut topik serta membuang pendua supaya carian lebih tepat. Seperti /flush, penyatuan dilakukan oleh model—model membaca entri terkumpul dan menulisnya semula mengikut topik, jadi anda patut menyemak hasilnya dari semasa ke semasa dengan /memory. Terdapat juga mod automatik: secara lalai, Grok Build menyemak syarat semasa permulaan dan sekali sejam, lalu memulakan penyatuan apabila sekurang-kurangnya 24 jam telah berlalu dan sekurang-kurangnya 5 sesi telah terkumpul. Ambang ini boleh dikonfigurasikan dalam bahagian [memory.dream] pada konfigurasi.

Nota dicari melalui indeks SQLite: secara lalai, indeks ini menggunakan carian teks penuh FTS5, dan jika model pembenaman dikonfigurasikan, carian vektor semantik turut ditambahkan.

Bagaimanakah memori dimasukkan ke dalam sesi baharu?#

Suntikan awal menggunakan ambang pemilihan min_score = 0.9, yang boleh anda ubah dalam bahagian [memory.initial_injection]. Selepas pemadatan konteks automatik, ejen mencari memori sekali lagi untuk memulihkan maklumat yang mungkin telah dikeluarkan daripada konteks bersama pertukaran yang lebih lama.

Anda juga boleh bertanya terus kepada ejen, “Apa yang kamu ingat?” Ejen akan mengumpulkan jawapan mengikut sumber: keutamaan global, pengetahuan projek dan sejarah sesi.

Entri sesi mempunyai penanda kekinian. Semakin lama sesuatu entri log sesi, semakin jelas penanda ini dipaparkan: “Semak sama ada maklumat ini masih terkini sebelum bergantung padanya.” Fail MEMORY.md global dan projek tidak menerima penanda sedemikian: kandungannya bertujuan untuk kegunaan jangka panjang, jadi anda perlu memantau ketepatannya sendiri.

Bagaimanakah cara melihat, mengedit dan memadam nota?#

Arahan /memory dalam sesi membuka tetingkap yang mengandungi semua fail memori, dikumpulkan mengikut skop: global, projek dan sesi (dalam tertib kronologi songsang). Senarai fail berada di sebelah kiri, manakala pratonton baca sahaja bagi fail yang dipilih berada di sebelah kanan.

Kekunci berguna dalam paparan keseluruhan:

Tetingkap ini boleh memadam nota individu dan fail sesi; ia tidak boleh memadam indeks MEMORY.md yang dijana (global dan projek).

Cara kedua ialah mengedit fail secara langsung. Fail ini berada dalam ~/.grok/memory/ dan boleh dibuka dengan mana-mana editor. Perubahan dalam direktori dijejaki: fail yang dibuat dan diubah suai akan diindeks semula, manakala fail yang dipadam akan dikeluarkan daripada indeks pada carian seterusnya.

Permintaan “lupakan snake_case” berfungsi tanpa jaminan: model mencari dan membuang entri yang sepadan, tetapi mungkin terlepas sebahagiannya. Untuk memastikan entri dipadam, buka fail tersebut (anda boleh menyalin laluannya dengan mudah menggunakan y dalam /memory) dan buang entri secara manual. Anda boleh memadamkan semua memori daripada baris arahan: grok memory clear untuk memori projek, grok memory clear --global untuk memori global dan grok memory clear --all untuk kedua-duanya.

Apakah perbezaan memori daripada fail arahan repositori?#

Arahan repositori dikongsi dengan semua orang yang bekerja pada projek dan dapat dilihat dalam kod serta sejarah perubahan. Memori berkembang sepanjang sesi, disimpan pada mesin anda dan tidak diterbitkan dengan sendirinya.

Memori tidak menggantikan fail arahan. Peraturan umum projek yang diperlukan oleh seluruh pasukan dan mana-mana ejen masih sesuai diletakkan dalam repositori. Kami mempunyai panduan berasingan tentang penggunaan satu fail arahan untuk Claude Code, Codex dan Cursor: AGENTS.md dan CLAUDE.md bersama-sama. Memori mengekalkan konteks peribadi: keutamaan anda, perkara yang telah dicuba dan keputusan yang telah dicapai.

Claude menggunakan perbezaan yang serupa: kami menerangkan perbezaan memori dengan CLAUDE.md dalam artikel Memori Claude dan CLAUDE.md. Untuk perbandingan alat itu sendiri, lihat Grok Build atau Claude Code.

Had dan cara menyemak sama ada memori berfungsi#

Perhatikan had-had berikut:

• Status percubaan. Arahan, ambang dan tingkah laku mungkin berubah dalam versi akan datang; semak panduan memori repositori jika sesuatu tidak berfungsi seperti yang dijangka.
• Suntikan awal dalam sesi baharu. Selepas mengaktifkan memori, mulakan kerja dengan /new supaya nota yang disimpan ditambahkan pada giliran pertama.
• Model menentukan perkara yang penting. Model mencipta ringkasan /flush dan memilih perkara yang dimasukkan ke dalam nota. Setiap satu atau dua minggu, buka /memory dan semak perkara yang terkumpul; padamkan apa-apa yang tidak diperlukan.
• Jangan minta ejen mengingati rahsia. Kunci, token dan kata laluan tidak sepatutnya berada dalam nota jangka panjang: fail dalam ~/.grok/memory/ disimpan sebagai teks biasa. Jika maklumat sensitif direkodkan, buangnya dengan mengedit fail tersebut.
• Memori projek dikongsi antara salinan repositori. Jika ejen mengingati sesuatu dalam satu klon yang sudah lapuk bagi klon lain, ambil kira direktori yang dikongsi semasa mengemas kini.

Jika memori tidak berfungsi:

1. Semak output grok inspect untuk mengesahkan bahawa memori diaktifkan.
2. Semak bahawa GROK_MEMORY=0 atau konfigurasi tidak menyahaktifkannya.
3. Untuk diagnostik, jalankan RUST_LOG=debug GROK_LOG_FILE=/tmp/grok.log grok dan semak baris berkaitan memori dalam /tmp/grok.log.

Ringkasan ringkas#

Memori Grok Build diaktifkan dengan GROK_MEMORY=1 atau [memory] enabled = true dalam ~/.grok/config.toml. Untuk memasukkan nota pada giliran pertama selepas mengaktifkannya, mulakan sesi baharu dengan /new. Ejen menulis nota ke ~/.grok/memory/: ringkasan sesi tanpa panggilan model, ringkasan terperinci dengan /flush, entri khusus dengan /remember selepas pengesahan anda dan topik tersusun dengan /dream. Lihat dan kemas kini nota melalui /memory dan dengan mengedit fail secara langsung. Ciri ini bersifat percubaan, jadi semak ambang dan arahan berdasarkan panduan rasmi serta semak nota dari semasa ke semasa.

Untuk kerja yang sistematik, gabungan klon AI + Otak Kedua + Kejuruteraan Konteks berguna.

Lawati Ailoot.