Skip to content

readme-MS.md

Latest commit

 

History

History
871 lines (582 loc) · 43.4 KB

readme-MS.md

File metadata and controls

871 lines (582 loc) · 43.4 KB
Raw

📕 Memory Books (Sambungan SillyTavern)

Sambungan SillyTavern generasi baharu untuk penciptaan memori yang automatik, berstruktur, dan boleh dipercayai. Tandakan babak dalam sembang, jana ringkasan berasaskan JSON dengan AI, dan simpan sebagai entri dalam lorebook anda. Menyokong sembang kumpulan, pengurusan profil lanjutan, prom sampingan/penjejak, dan konsolidasi memori berbilang tahap.

❓ Kosa Kata

  • Scene → Memori
  • Satu fakta yang disimpan → Klip
  • Penjejak berterusan → Prom Sampingan
  • Banyak Memori → Ringkasan / Konsolidasi
  • Satu entri panjang → Pemadatan

Klip vs Prom Sampingan

Klip vs Prom Sampingan
Klip Prom Sampingan
Simpan teks sembang yang dipilih ke dalam entri Buku Memori. Minta AI menyemak sembang dan mengemas kini entri penjejak.
Paling sesuai untuk satu fakta, baris, janji, pilihan, item, atau nota yang jelas. Paling sesuai untuk maklumat yang berubah dari semasa ke semasa.
Fikirkan: “pin nota ini.” Fikirkan: “pastikan bahagian ini dikemas kini.”

Untuk penjelasan lebih panjang, lihat Panduan Pengguna.

Pemadatan vs Konsolidasi

Pemadatan vs Konsolidasi
Pemadatan Konsolidasi
Memendekkan satu entri sedia ada yang diurus STMB. Menggabungkan beberapa memori atau ringkasan menjadi satu rekap peringkat lebih tinggi.
Gunakan apabila entri Klip, Prom Sampingan, atau Memori masih berguna, tetapi semakin terlalu panjang. Gunakan apabila beberapa memori sudah bersedia menjadi Arc, Chapter, Book, atau ringkasan yang lebih besar.
Fikirkan: “kemaskan satu entri ini.” Fikirkan: “gulung memori ini menjadi rekap.”

Untuk penjelasan lebih panjang, lihat Panduan Pengguna.

❗ Baca Saya Dahulu!

Mula di sini:

Pautan lain:

Nota: Menyokong pelbagai bahasa. Lihat folder /locales untuk senarai. Readme dan Panduan Pengguna yang diterjemahkan boleh didapati dalam folder /userguides. Penukar lorebook dan pustaka templat prom sampingan berada dalam folder /resources.

📑 Jadual Kandungan

📋 Prasyarat

  • SillyTavern: 1.14.0+ (disyorkan versi terkini)
  • Barisan Tugas Pilihan: STMB berfungsi tanpa barisan tugas. Untuk menggunakan barisan, pasang dan aktifkan Chat Top Bar / Chat Top Info Bar, sambungan rasmi SillyTavern yang menambah bar atas pada tetingkap chat. STMB menggunakan bar itu untuk memaparkan butang dan laci Tugas Buku Memori.
  • Sokongan Chat Completion: Sokongan penuh untuk OpenAI, Claude, Anthropic, OpenRouter, atau API chat completion lain
  • Sokongan Text Completion: API text completion (Kobold, TextGen, dll.) disokong apabila disambungkan melalui titik akhir API Chat Completion yang serasi OpenAI. Saya syorkan menyediakan sambungan API Chat Completion mengikut tip KoboldCpp di bawah, kemudian sediakan profil STMB dan gunakan konfigurasi Tersuai (disyorkan) atau manual penuh jika perlu.

NOTA: Jika anda menggunakan Text Completion, anda mesti mempunyai pratetap chat completion.

Tip KoboldCpp untuk menggunakan 📕 ST Memory Books

Sediakan ini dalam ST terlebih dahulu. Anda boleh kembali ke Text Completion selepas STMB berfungsi.

  • API Chat Completion
  • Sumber chat completion tersuai
  • Titik akhir http://localhost:5001/v1 (atau 127.0.0.1:5000/v1)
  • Masukkan apa-apa dalam "custom API key" (ST memerlukan satu)
  • ID model mesti koboldcpp/modelname (jangan masukkan .gguf dalam nama model)
  • Muat turun dan import mana-mana pratetap chat completion supaya anda mempunyai pratetap chat completion
  • Tetapkan panjang respons maksimum pada pratetap chat completion kepada sekurang-kurangnya 2048; 4096 disyorkan

Tip Llama.cpp untuk menggunakan 📕 ST Memory Books

Sama seperti Kobold, sediakan ini sebagai Chat Completion API dalam ST. Anda boleh kembali ke Chat Completion selepas anda mengesahkan STMB berfungsi.

  • Cipta profil sambungan baharu untuk Chat Completion API
  • Sumber Pelengkap: Custom (Open-AI Compatible)
  • URL Titik Akhir: http://host.docker.internal:8080/v1 jika ST berjalan dalam Docker, jika tidak http://localhost:8080/v1
  • Kunci API Tersuai: masukkan apa sahaja (ST memerlukan satu)
  • ID Model: llama2-7b-chat.gguf atau model anda sendiri
  • Pemprosesan pasca prom: tiada

Untuk memulakan Llama.cpp, saya syorkan meletakkan sesuatu seperti berikut dalam skrip shell atau fail bat supaya permulaan lebih mudah:

llama-server -m <laluan-model> -c <saiz-konteks> --port 8080

💡 Tetapan Pengaktifan Info Dunia/Lorebook Global Disyorkan

  • Match Whole Words: biarkan tidak ditanda (false)
  • Scan Depth: lebih tinggi lebih baik
  • Max Recursion Steps: 2
  • Context %: 80% berdasarkan tetingkap konteks 100,000 token
  • Jika lorebook memori ialah satu-satunya lorebook, pastikan Tangguhkan Sehingga Rekursi dimatikan dalam profil STMB atau memori mungkin tidak mencetus

🚀 Mula Pantas

1. Pasang & Muat

Tunggu butang ini

  • Muat SillyTavern dan pilih watak atau sembang kumpulan.
  • Tunggu butang chevron (► ◄) muncul pada mesej sembang.

2. Tandakan Babak

Butang mula yang diklik

Butang di tengah babak

Butang tamat yang diklik

  • Klik ► pada mesej pertama babak anda.
  • Klik ◄ pada mesej terakhir.

Butang yang ditekan akan kelihatan seperti contoh di bawah. Warna anda mungkin berbeza mengikut tema CSS.

3. Cipta Memori

  • Buka menu Extensions (ikon tongkat sihir 🪄) dan klik "Memory Books", atau gunakan perintah /creatememory.
  • Sahkan tetapan (profil, konteks, API/model) jika diminta.
  • Tunggu penjanaan AI dan entri lorebook automatik.

🧩 Jenis Memori: Babak vs Ringkasan

📕 Memory Books menyokong memori babak dan konsolidasi ringkasan berbilang tahap, masing-masing untuk kesinambungan yang berbeza.

🎬 Memori Babak (Lalai)

Memori babak menangkap apa yang berlaku dalam julat mesej tertentu.

  • Berdasarkan pemilihan babak yang jelas (► ◄)
  • Ideal untuk ingatan momen-ke-momen
  • Memelihara dialog, tindakan, dan hasil serta-merta
  • Terbaik digunakan dengan kerap

Ini ialah jenis memori standard yang paling biasa digunakan.

🌈 Konsolidasi Ringkasan

Butang konsolidasi

Konsolidasi ringkasan menangkap apa yang berubah dari masa ke masa merentasi beberapa memori atau ringkasan.

Daripada meringkaskan satu babak, ringkasan konsolidasi memfokuskan kepada:

  • Perkembangan watak dan perubahan hubungan
  • Matlamat jangka panjang, ketegangan, dan penyelesaian
  • Trajektori emosi dan arah naratif
  • Perubahan keadaan berterusan yang perlu kekal stabil

Tahap konsolidasi pertama ialah Arc, dibina daripada memori babak. Tahap yang lebih tinggi juga disokong untuk cerita yang lebih panjang:

  • Arc
  • Chapter
  • Book
  • Legend
  • Series
  • Epic

💡 Anggap ini sebagai rekap, bukan log babak.

Bila perlu guna Ringkasan Konsolidasi

  • Selepas perubahan hubungan yang besar
  • Di akhir bab atau arka cerita
  • Apabila motivasi, kepercayaan, atau dinamik kuasa berubah
  • Sebelum memulakan fasa baharu cerita

Cara ia berfungsi

  • Ringkasan konsolidasi dijana daripada memori/ringkasan STMB yang sedia ada, bukan terus daripada sembang mentah
  • Alat Gabungkan Ingatan membolehkan anda memilih tahap sasaran dan memilih entri sumber
  • STMB boleh memantau tahap ringkasan yang dipilih dan memaparkan prompt ya/later apabila tahap itu mencapai jumlah minimum entri sumber yang layak
  • STMB boleh menyahaktifkan entri sumber selepas konsolidasi jika anda mahu ringkasan tahap lebih tinggi mengambil alih
  • Respons ringkasan AI yang gagal boleh disemak dan diperbetulkan daripada UI sebelum mencuba simpanan sekali lagi

Ini memberikan anda:

  • penggunaan token yang lebih rendah
  • kesinambungan naratif yang lebih baik dalam sembang panjang

📝 Penjanaan Memori

Output JSON Sahaja

Semua prom dan pratetap mesti mengarahkan AI untuk memulangkan hanya JSON yang sah, contohnya:

{
  "title": "Tajuk babak pendek",
  "content": "Ringkasan terperinci babak...",
  "keywords": ["kata kunci1", "kata kunci2"]
}

Tiada teks lain dibenarkan dalam respons.

Pratetap Terbina Dalam

  1. Summary: Ringkasan terperinci beat demi beat.
  2. Summarize: Pengepala Markdown untuk garis masa, beat, interaksi, dan hasil.
  3. Synopsis: Markdown yang komprehensif dan berstruktur.
  4. Sum Up: Ringkasan beat yang padat dengan garis masa.
  5. Minimal: Ringkasan 1-2 ayat.
  6. Northgate: Gaya ringkasan sastera untuk penulisan kreatif.
  7. Aelemar: Fokus pada titik plot dan memori watak.
  8. Comprehensive: Gaya sinopsis dengan pengekstrakan kata kunci yang dipertingkatkan.

Prom Tersuai

  • Cipta prom anda sendiri, tetapi mesti memulangkan JSON yang sah seperti di atas.

📚 Integrasi Lorebook

  • Penciptaan Entri Automatik: Memori baharu disimpan sebagai entri bersama semua metadata.
  • Pengesanan Berasaskan Bendera: Hanya entri dengan bendera stmemorybooks diiktiraf sebagai memori.
  • Penomboran Automatik: Penomboran berurutan, berlapik sifar, dengan beberapa format yang disokong ([000], (000), {000}, #000).
  • Susunan Manual/Automatik: Tetapan susunan penyisipan per-profil.
  • Muat Semula Editor: Opsyenal untuk memuat semula editor lorebook secara automatik selepas menambah memori.

Memori sedia ada mesti ditukar! Gunakan Penukar Lorebook untuk menambah bendera stmemorybooks dan medan yang diperlukan.

✂️ Klip ke Buku Memori

Klip teks

Klip ke Buku Memori adalah untuk nota cepat “ingat ini”. Serlahkan teks sembang yang penting, klik butang gunting terapung, kemudian simpan teks yang dipilih sebagai poin dalam Buku Memori tanpa membuka editor lorebook terlebih dahulu.

Jika anda mahu penjejak berterusan yang dikemas kini dari semasa ke semasa, gunakan Prom Sampingan. Versi ringkas: Klip = satu fakta yang disimpan; Prom Sampingan = penjejak berterusan.

Cara ia berfungsi

  • Serlahkan teks tepat yang mahu anda ingat.
  • Klik butang gunting terapung. Anda boleh menghidupkan atau mematikan butang ini dalam pop timbul Memory Books.
  • Pilih entri klip sedia ada atau cipta entri baharu.
  • Semak entri semasa dan pratonton yang dikemas kini sebelum menyimpan.
  • Namakan semula entri/bahagian jika perlu.

Entri klip ialah entri lorebook biasa yang ditandakan dengan [STMB Clip] di hujung tajuk entri. Contoh:

Seraphina Menyembuhkan Saya [STMB Clip]

Bahagian yang kelihatan dalam entri menggunakan tajuk tanpa [STMB Clip]:

=== Seraphina Menyembuhkan Saya ===

- Seraphina menyembuhkan luka saya dengan sihir.
- Seraphina, penjaga hutan ini

=== END Seraphina Menyembuhkan Saya ===

Tip

  • Satu entri klip mempunyai satu bahagian. Gunakan tajuk berfokus seperti Perkara yang {{user}} Suka, Nama Panggilan, atau Pilihan Makanan supaya kata kunci kekal khusus.
  • Entri klip baharu boleh sentiasa aktif atau dicetuskan kata kunci. Sentiasa aktif paling mudah; kata kunci lebih baik apabila entri hanya patut muncul kadang-kadang.
  • Entri sedia ada boleh menjadi entri klip dengan menambahkan [STMB Clip] di hujung tajuk.
  • Entri klip yang panjang mungkin menunjukkan peringatan untuk disemak atau dipadatkan. Pemadatan boleh membantu menjadikan entri klip, Prom Sampingan, dan memori STMB lebih cekap token sebelum anda menggantikan yang asal.
  • Entri klip tidak menambah atribusi sumber. Ia hanya menyimpan teks yang anda pilih untuk diklip.

🔎 Klip Topikal

Klip Topikal mencipta atau mengemas kini entri memori bergaya Klip yang berfokus tentang satu topik.

Gunakan apabila anda sudah mempunyai memori STMB yang disimpan, tetapi mahu satu entri “tentang topik ini” yang kemas dan mengumpulkan butiran berkaitan daripada memori tersebut. Contoh:

  • Tentang Seraphina
  • Tentang sihir {{user}}
  • Tentang hubungan Alex dan Mira
  • Tentang siasatan Black Harbor

Klip Topikal berbeza daripada Klip ke Buku Memori biasa. Klip biasa menyimpan teks chat yang diserlahkan secara terus. Klip Topikal membaca entri memori STMB sedia ada, meminta AI mengekstrak butiran tentang satu topik, kemudian memberikan draf yang boleh diedit sebelum disimpan.

Cara ia berfungsi

  1. Buka Memory Books.
  2. Klik 🔎 Klip Topikal.
  3. Pilih Buku Memori sumber.
  4. Masukkan Topik.
  5. Masukkan Kata kunci pengaktifan, atau biarkan kosong untuk menggunakan topik.
  6. Pilih sama ada untuk mencipta Klip Topikal baharu atau mengemas kini entri [STMB Clip] sedia ada.
  7. Pilih Profil Penjanaan.
  8. Klik Jana Draf.
  9. Semak dan edit draf.
  10. Klik Simpan Klip Topikal hanya apabila anda berpuas hati.

Klip Topikal menyimpan entri sebagai entri Klip biasa yang ditandakan dengan [STMB Clip]. Entri baharu menggunakan tajuk seperti:

Tentang Seraphina [STMB Clip]

Mengemas kini Klip Topikal sedia ada

Apabila anda mengemas kini Klip Topikal sedia ada, STMB mengingati memori sumber yang digunakan semasa larian terakhir yang berjaya. Kemas kini seterusnya biasanya hanya menggunakan memori sumber yang baharu atau berubah.

Jika anda mahu membina semula keseluruhan entri daripada semua memori yang layak, hidupkan Bina semula daripada semua memori sumber sebelum menjana draf.

Nota

  • Klip Topikal hanya menggunakan entri memori STMB yang disahkan sebagai bahan sumber.
  • Entri Klip dan entri Prom Sampingan tidak digunakan sebagai memori sumber.
  • Sasaran kemas kini ialah entri [STMB Clip] sedia ada.
  • Draf AI sentiasa boleh disemak dan diedit sebelum disimpan.
  • STMB tidak menyimpan draf yang dijana sehingga anda mengklik Simpan Klip Topikal.
  • Jika permintaan besar, STMB mungkin menunjukkan amaran token sebelum menjalankannya.

🆕 Pintasan Perintah Slash

  • /creatememory - Cipta memori daripada babak yang ditandakan.
  • /scenememory X-Y - Tetapkan julat babak dan cipta memori, contohnya /scenememory 10-15.
  • /nextmemory - Cipta memori dari akhir memori terakhir hingga mesej semasa.
  • /stmb-catchup interval=x start=y end=y - Mencipta memori susulan untuk chat panjang sedia ada dengan memproses julat mesej yang dipilih dalam bahagian mengikut saiz interval.
  • /sideprompt "Name" {{macro}}="value" [X-Y] - Jalankan side prompt ({{macro}} adalah pilihan).
  • /sideprompt-set "Set Name" [X-Y] - Jalankan Side Prompt Set yang disimpan.
  • /sideprompt-macroset "Set Name" {{macro}}="value" [X-Y] - Jalankan Side Prompt Set dan bekalkan nilai makro yang boleh digunakan semula.
  • /sideprompt-on "Name" | all - Hidupkan side prompt mengikut nama atau semua.
  • /sideprompt-off "Name" | all - Matikan side prompt mengikut nama atau semua.
  • /stmb-highest - Kembalikan message id tertinggi bagi memori yang telah diproses dalam sembang ini.
  • /stmb-set-highest <N|none> - Tetapkan secara manual message id tertinggi yang telah diproses untuk sembang ini.
  • /stmb-stop - Hentikan semua penjanaan STMB yang sedang berjalan di mana-mana (henti kecemasan).

/stmb-catchup

Gunakan /stmb-catchup apabila menukar chat panjang sedia ada kepada memori STMB.

Sintaks:

/stmb-catchup interval=x start=y end=y

Contoh:

/stmb-catchup interval=30 start=0 end=300

Parameter:

  • interval=x - Anggaran bilangan mesej bagi setiap memori yang dijana.
  • start=y - Nombor mesej pertama yang akan disertakan.
  • end=y - Nombor mesej terakhir yang akan disertakan.

Ini bertujuan untuk penukaran susulan, bukan penggunaan biasa secara berterusan. Selepas STMB sudah mengejar semula, gunakan ringkasan automatik atau /nextmemory.

👥 Sokongan Sembang Kumpulan

STMB berfungsi dalam sembang kumpulan dengan alat memori manual, automatik dan arahan slash yang sama seperti dalam sembang satu dengan satu. Anda tidak perlu menghidupkan mod sembang kumpulan yang berasingan: pilih kumpulan dan gunakan STMB seperti biasa.

Memori yang menyedari peserta

  • STMB membaca penutur yang dilampirkan pada setiap mesej sembang kumpulan dan memastikan atribusi watak jelas dalam ringkasan yang dijana.
  • Apabila STMB dapat mengenal pasti ahli kumpulan yang mengambil bahagian, memori yang disimpan menerima penapis watak SillyTavern inklusif untuk ahli tersebut. Ini memastikan memori kumpulan terikat kepada watak yang benar-benar terlibat dalam babak itu.
  • Penanda babak, ID mesej tertinggi yang telah diproses, pilihan lorebook manual dan keadaan lain bagi setiap sembang disimpan bersama sembang kumpulan aktif. Menukar sembang tidak memindahkan tetapan tersebut ke sembang lain.

Mod Automatik dan Cipta Automatik: satu Memory Book

Mod Automatik menggunakan lorebook yang terikat pada sembang kumpulan. Mod Cipta Automatik boleh mencipta dan mengikat satu lorebook jika kumpulan itu belum memilikinya. Dalam kedua-dua mod, memori disimpan ke Memory Book kumpulan tersebut dan penapis peserta ditambahkan secara automatik apabila penutur dapat dikenal pasti.

Ini ialah persediaan paling mudah dan mencukupi untuk kebanyakan sembang kumpulan.

Mod Manual: Memory Book kumpulan dan watak

Mod Lorebook Manual boleh mengekalkan satu Memory Book kumpulan utama serta satu Memory Book yang ditetapkan untuk setiap ahli kumpulan. Penetapan lorebook watak individu memerlukan SillyTavern-LorebookOrdering (STLO) dipasang dan diaktifkan.

  1. Buka sembang kumpulan dan aktifkan Mod Lorebook Manual.
  2. Pilih lorebook manual utama. Ini menjadi Memory Book kumpulan kanonik.
  3. Di bawah Lorebook Watak Kumpulan, pilih satu lorebook untuk setiap ahli. Anda boleh menetapkan lorebook yang sama kepada lebih daripada satu watak.
  4. Cipta memori seperti biasa.
  5. Sahkan watak yang mengambil bahagian. STMB memilih awal ahli yang dikesan daripada mesej. Jika tiada sesiapa dipilih, memori digunakan untuk semua ahli kumpulan.

STMB menyimpan memori kanonik ke Memory Book kumpulan dan menyalinnya ke Memory Book yang ditetapkan untuk peserta terpilih. Entri berkaitan dipautkan secara dalaman supaya konsolidasi kumpulan dan watak dapat mengekalkan garis masa yang selaras. Jika mana-mana lorebook watak yang diperlukan tiada atau telah dipadam, STMB berhenti dan tidak meninggalkan set memori separa.

Pengesahan peserta mengandungi pilihan Terima peserta yang dikesan secara automatik pada masa hadapan. Aktifkannya jika anda mempercayai pengesanan penutur dan tidak mahu meluluskan senarai bagi setiap memori.

Prom kumpulan dan watak yang berasingan (pilihan)

Untuk menghasilkan versi berlainan bagi memori yang sama:

  1. Buka Pengurus Profil dan edit profil yang digunakan untuk penciptaan memori.
  2. Aktifkan Gunakan prom kumpulan dan watak yang berasingan dalam sembang kumpulan.
  3. Pilih Prom Ringkasan Kumpulan dan Prom Ringkasan Watak.

Prom kumpulan menulis versi bersama untuk Memory Book kumpulan utama. Dalam Mod Manual dengan STLO, prom watak boleh menghasilkan versi berfokuskan watak untuk Memory Book yang ditetapkan secara individu. Ini menggunakan permintaan penjanaan tambahan, tetapi membolehkan memori bersama menerangkan keseluruhan babak sementara salinan individu menumpukan perkara yang penting kepada watak tersebut. Jika beberapa ahli berkongsi satu Memory Book yang ditetapkan, STMB mengekalkan hanya satu salinan bersama di situ.

💡 Disyorkan: Mulakan dengan satu Memory Book kumpulan. Tambahkan Memory Book bagi setiap watak hanya apabila ahli tertentu memerlukan pengetahuan, kesinambungan atau konteks yang berbeza.

🧭 Mod Operasi

Mod Automatik (Lalai)

Contoh pengikatan lorebook sembang

  • Cara ia berfungsi: Menggunakan lorebook yang terikat pada sembang semasa anda secara automatik.
  • Terbaik untuk: Kesederhanaan dan kelajuan. Kebanyakan pengguna harus bermula di sini.
  • Cara guna: Pastikan lorebook dipilih dalam menu lungsur "Chat Lorebooks" untuk watak atau sembang kumpulan anda.

Mod Cipta Lorebook Automatik

  • Cara ia berfungsi: Mencipta dan mengikat lorebook baharu secara automatik apabila tiada lorebook wujud, menggunakan templat penamaan tersuai anda.
  • Terbaik untuk: Pengguna baharu dan persediaan pantas. Sesuai untuk penciptaan lorebook satu klik.
  • Cara guna:
    1. Dayakan "Cipta buku legenda secara automatik jika tiada" dalam tetapan sambungan.
    2. Konfigurasikan templat penamaan anda (lalai: "LTM - {{char}} - {{chat}}").
    3. Apabila anda mencipta memori tanpa lorebook yang terikat, satu akan dicipta dan diikat secara automatik.
  • Pemegang tempat templat: {{char}} (nama watak), {{user}} (nama anda), {{chat}} (ID sembang)
  • Penomboran pintar: Menambah nombor secara automatik (2, 3, 4...) jika nama pendua wujud.
  • Nota: Tidak boleh digunakan serentak dengan Mod Lorebook Manual.

Mod Lorebook Manual

  • Cara ia berfungsi: Membolehkan anda memilih lorebook yang berbeza untuk memori bagi setiap sembang, mengabaikan lorebook utama yang terikat pada sembang.
  • Terbaik untuk: Pengguna lanjutan yang mahu mengarahkan memori ke lorebook tertentu yang berasingan.
  • Cara guna:
    1. Dayakan "Dayakan Mod Buku Legenda Manual" dalam tetapan sambungan.
    2. Kali pertama anda mencipta memori dalam sembang, anda akan diminta memilih lorebook.
    3. Pilihan ini disimpan untuk sembang tersebut sehingga anda mengosongkannya atau bertukar kembali ke Mod Automatik.
  • Nota: Tidak boleh digunakan serentak dengan Mod Cipta Lorebook Automatik.

🎡 Penjejak & Prom Sampingan

Tempat mencari Penjejak & Prom Sampingan

📘 Side Prompts mempunyai panduan sendiri: Side Prompts Guide. Gunakan panduan itu untuk set, makro, contoh, dan penyelesaian masalah. 🎡 Perlukan laluan klik yang tepat? Lihat panduan Scribe untuk mengaktifkan Side Prompts.

Side Prompts ialah larian prompt STMB yang berasingan untuk mengekalkan keadaan sembang yang sedang berjalan. Gunakannya untuk penjejak dan nota sokongan yang tidak patut mengembungkan balasan watak biasa. Jika anda hanya mahu menyimpan satu fakta yang diserlahkan, gunakan Klip ke Buku Memori sebaliknya.

Gunakan Side Prompts untuk perkara seperti:

  • 💰 Inventori & Sumber ("Apa item yang pengguna miliki?")
  • ❤️ Status Hubungan ("Apa perasaan X terhadap Y?")
  • 📊 Statistik Watak ("Kesihatan semasa, kemahiran, reputasi")
  • 🎯 Kemajuan Misi ("Apa matlamat yang aktif?")
  • 🌍 Keadaan Dunia ("Apa yang berubah dalam latar?")

Akses: Daripada tetapan Memory Books, klik “🎡 Penjejak & Prom Sampingan”.

Ciri-ciri:

  • Lihat, cipta, gandakan, edit, padam, eksport, dan import Side Prompts.
  • Jalankan Side Prompts secara manual, selepas memori, atau sebagai sebahagian daripada Side Prompt Set.
  • Gunakan makro SillyTavern standard seperti {{user}} dan {{char}}.
  • Gunakan makro runtime seperti {{npc name}} apabila prompt memerlukan nilai yang dibekalkan semasa dijalankan.
  • Simpan output Side Prompt sebagai entri side-prompt yang berasingan dalam lorebook memori anda.

Tip Penggunaan:

  • Salin daripada templat terbina dalam apabila mencipta prompt baharu.
  • Side Prompts tidak perlu mengembalikan JSON. Teks biasa atau Markdown juga boleh digunakan.
  • Side Prompts biasanya dikemas kini/ditindih; memori disimpan secara berurutan.
  • Sintaks manual ialah /sideprompt "Name" {{macro}}="value" [X-Y].
  • Gunakan Side Prompt Sets apabila sembang memerlukan himpunan penjejak yang tersusun.
  • Side Prompt Set yang dipilih untuk dijalankan selepas memori akan menggantikan Side Prompts individu yang dihidupkan untuk dijalankan selepas memori dalam sembang itu.
  • Pustaka Templat Side Prompts tambahan tersedia sebagai fail JSON. Import sahaja untuk digunakan.

🧹 Pemadatan

Klik di sini untuk Menu Pemadatan

Pemadatan ialah aliran semak untuk menjadikan entri lorebook yang diurus oleh STMB lebih cekap token. STMB meminta AI menulis semula satu entri sedia ada, kemudian menunjukkan kandungan asal dan draf yang dipadatkan sebelum apa-apa digantikan.

Ini berasingan daripada Ringkasan Konsolidasi: Pemadatan menulis semula satu entri; Konsolidasi menggabungkan beberapa memori menjadi rekap yang lebih besar.

Anda boleh membukanya daripada pop timbul utama Memory Books dengan 📝 Pemadatan. Entri Klip yang panjang juga mungkin menawarkan butang Padatkan Entri daripada aliran Klip.

Entri yang layak

Pemadatan menyenaraikan entri yang layak daripada Buku Memori yang dipilih:

  • Entri Klip yang ditandakan dengan [STMB Clip]
  • Entri Prom Sampingan
  • Entri memori STMB yang ditandakan oleh Memory Books

Entri lorebook biasa yang tidak diurus oleh STMB tidak akan dipaparkan.

Cara ia berfungsi

  1. Buka Memory Books dan klik 📝 Pemadatan.
  2. Pilih Buku Memori. Jika sembang semasa sudah mempunyai Buku Memori yang sah, STMB akan memilihnya terlebih dahulu; jika tidak, pilih satu daripada menu lungsur boleh cari.
  3. Pilih Profil Pemadatan. Ini mengawal sambungan/model AI yang digunakan untuk permintaan pemadatan.
  4. Secara pilihan, klik Edit Prom Pemadatan jika anda mahu mengubah arahan yang dihantar kepada AI.
  5. Klik Padatkan Entri di sebelah entri yang mahu ditulis semula.
  6. Bandingkan Kandungan asal dan Draf dipadatkan. STMB menunjukkan anggaran kiraan token untuk kedua-duanya.
  7. Edit draf jika perlu, kemudian pilih Gantikan dengan Versi Dipadatkan, Salin Draf Dipadatkan, atau Batal.

STMB tidak menggantikan entri asal secara automatik. Entri lorebook hanya berubah jika anda mengklik Gantikan dengan Versi Dipadatkan.

Prom Pemadatan

Prom Pemadatan boleh diedit. Prom lalai menyuruh AI mengekalkan fakta penting, nama, kata ganti nama, makro, tajuk pembungkus, dan penanda akhir sambil membuang pengulangan dan kata-kata bernilai rendah.

Pemegang tempat prom yang disokong:

  • {{ENTRY_CONTENT}} — kandungan entri lorebook semasa. Pemegang tempat ini wajib ada.
  • {{ENTRY_KIND}} — jenis entri, seperti Klip, Prom Sampingan, atau Memori.
  • {{ENTRY_TITLE}} — tajuk entri lorebook.

Gunakan Tetapkan Semula kepada Lalai dalam editor prom jika anda mahu memulihkan Prom Pemadatan terbina dalam.

Sesuai digunakan untuk

  • entri Klip yang panjang
  • entri penjejak Prom Sampingan yang telah mengumpul nota berulang
  • entri memori STMB yang berguna tetapi terlalu bertele-tele
  • entri yang sentiasa aktif dan mula membazir konteks

Tidak dimaksudkan untuk

  • menambah fakta baharu
  • meringkaskan sembang mentah
  • mencipta memori baharu
  • menulis semula entri lorebook biasa yang tidak diurus oleh STMB

🧠 Integrasi Regex untuk Penyesuaian Lanjutan

Konfigurasi regex

  • Kawalan penuh terhadap pemprosesan teks: Memory Books kini berintegrasi dengan sambungan Regex SillyTavern, membolehkan anda menggunakan transformasi teks yang berkuasa pada dua peringkat utama:
    1. Penjanaan Prom: Ubah suai prom yang dihantar ke AI secara automatik dengan mencipta skrip regex yang menyasarkan penempatan User Input.
    2. Penghuraian Respons: Bersihkan, format semula, atau piawaikan respons mentah AI sebelum ia disimpan dengan menyasarkan penempatan AI Output.
  • Sokongan pelbagai pilihan: Anda boleh memilih beberapa skrip regex untuk pemprosesan keluar dan masuk.
  • Cara ia berfungsi: Hidupkan Gunakan regex (lanjutan) dalam STMB, klik 📐 Konfigurasi regex…, kemudian pilih skrip mana yang patut dijalankan STMB sebelum menghantar ke AI dan sebelum respons dihuraikan/disimpan.
  • Penting: Pilihan regex dikawal oleh STMB. Skrip yang dipilih di sana akan dijalankan walaupun ia sedang dilumpuhkan dalam sambungan Regex itu sendiri.

👤 Pengurusan Profil

Pengurusan Profil

  • Profil: Setiap profil termasuk API, model, suhu, prom/pratetap, format tajuk, dan tetapan lorebook.
  • Import/Eksport: Kongsi profil sebagai JSON.
  • Penciptaan Profil: Gunakan pop timbul pilihan lanjutan untuk menyimpan profil baharu.
  • Penggantian Per-Profil: Tukar sementara API/model/suhu untuk penciptaan memori, kemudian pulihkan tetapan asal anda.
  • Profil/Pembekal Binaan Dalam: STMB menyertakan pilihan Tetapan SillyTavern Semasa yang wajib, yang menggunakan sambungan/tetapan SillyTavern aktif anda secara terus.

⚙️ Tetapan & Konfigurasi

Panel tetapan utama 1 Panel tetapan utama 2 Panel tetapan utama 3

Tetapan Global

Gambaran keseluruhan video pendek di Youtube

  • Dayakan Mod Buku Legenda Manual: Dayakan untuk memilih lorebook bagi setiap sembang.
  • Cipta buku legenda secara automatik jika tiada: ⭐ Baharu dalam v4.2.0 - Cipta dan ikat lorebook secara automatik menggunakan templat penamaan anda.
  • Templat Nama Buku Legenda: ⭐ Baharu dalam v4.2.0 - Sesuaikan nama lorebook ciptaan automatik dengan pemegang tempat {{char}}, {{user}}, {{chat}}.
  • Benarkan Pertindihan Babak: Benarkan atau halang julat memori yang bertindih.
  • Sentiasa Guna Profil Lalai: Langkau pop timbul pengesahan.
  • Tunjukkan pratonton memori: Dayakan pop timbul pratonton untuk menyemak dan mengedit memori sebelum menambah ke lorebook.
  • Tunjukkan Pemberitahuan: Togol mesej toast.
  • Muat Semula Editor: Muat semula editor lorebook secara automatik selepas penciptaan memori.
  • Token Respons Maksimum: Tetapkan panjang penjanaan maksimum untuk ringkasan memori.
  • Ambang Amaran Token: Tetapkan tahap amaran untuk babak besar.
  • Memori Terdahulu Lalai: Bilangan memori sebelumnya untuk dimasukkan sebagai konteks (0-7).
  • Cipta ringkasan memori secara automatik: Dayakan penciptaan memori automatik pada selang masa tertentu.
  • Selang Ringkasan Automatik: Bilangan mesej selepas mana ringkasan memori dicipta secara automatik.
  • Penimbal Ringkasan Automatik: Tangguhkan auto-summary dengan bilangan mesej yang boleh dikonfigurasikan.
  • Minta pengesahan konsolidasi apabila tier sedia: Tunjukkan prompt ya/tidak apabila tier ringkasan yang dipilih sudah mempunyai cukup entri sumber yang layak untuk dikonsolidasikan.
  • Tier Konsolidasi Automatik: Pilih satu atau lebih tier ringkasan yang akan mencetuskan prompt tersebut. Kini menyokong Arc hingga Series.
  • Tunjukkan semula mesej tersembunyi sebelum penjanaan memori: Boleh menjalankan /unhide X-Y sebelum mencipta memori.
  • Sembunyikan mesej secara automatik selepas menambah memori: Pilihan untuk menyembunyikan semua mesej yang diproses atau hanya julat memori terakhir.
  • Gunakan regex (lanjutan): Mendayakan pop timbul pemilihan regex STMB untuk pemprosesan keluar/masuk.
  • Format Tajuk Memori: Pilih atau sesuaikan format tajuk (lihat di bawah).

Medan Profil

Konfigurasi profil

  • Nama: Nama paparan.
  • API/Pembekal: Tetapan SillyTavern Semasa, openai, claude, custom, full manual, dan pembekal lain yang disokong.
  • Model: Nama model, contohnya gpt-4, claude-3-opus.
  • Temperature: 0.0–2.0.
  • Prompt atau Pratetap: Tersuai atau terbina dalam.
  • Format Tajuk: Templat per-profil.
  • Mod Pengaktifan: Vectorized, Constant, Normal.
  • Posisi: ↑Char, ↓Char, ↑EM, ↓EM, ↑AN, Outlet, dan nama medan.
  • Mod Susunan: Auto/manual.
  • Rekursi: Halang/tangguhkan hingga rekursi.

🏷️ Pemformatan Tajuk

Format tajuk Format-format tajuk

Sesuaikan tajuk entri lorebook anda menggunakan sistem templat yang berkuasa.

  • Pemegang tempat:
    • {{title}} - Tajuk yang dijana AI, contohnya "Pertemuan Takdir".
    • {{scene}} - Julat mesej, contohnya "Babak 15-23".
    • {{char}} - Nama watak.
    • {{user}} - Nama pengguna anda.
    • {{messages}} - Bilangan mesej dalam babak.
    • {{profile}} - Nama profil yang digunakan untuk penjanaan.
    • Pemegang tempat tarikh/masa semasa dalam pelbagai format, contohnya August 13, 2025 untuk tarikh dan 11:08 PM untuk masa.
  • Penomboran automatik: Gunakan [0], [00], (0), {0}, #0, dan juga bentuk berbalut seperti #[000], ([000]), {[000]} untuk penomboran berurutan berlapik sifar.
  • Format Tersuai: Anda boleh mencipta format anda sendiri. Sejak v4.5.1, semua aksara Unicode yang boleh dicetak, termasuk emoji, CJK, aksen, dan simbol, dibenarkan dalam tajuk. Hanya aksara kawalan Unicode disekat.

🧵 Memori Konteks

Penjanaan memori dengan konteks

  • Sertakan sehingga 7 memori terdahulu sebagai konteks untuk kesinambungan yang lebih baik.
  • Anggaran token termasuk memori konteks untuk ketepatan.
  • Pilihan lanjutan membolehkan anda mengatasi sementara tingkah laku prom/profil untuk satu kali penjanaan memori.

🧾 Barisan Tugas Pilihan (memerlukan Chat Top Bar)

Barisan Tugas ST Memory Books

Barisan tugas adalah pilihan, tetapi berkuasa. Anda tidak memerlukannya untuk menggunakan Memory Books.

Jika anda memasang dan mengaktifkan Chat Top Bar / Chat Top Info Bar, STMB menambah butang Tugas Buku Memori pada bar atas chat. Ini membuka laci barisan tempat anda boleh melihat tugas Memory Books yang aktif, selesai, gagal, dibatalkan, atau perlu disemak.

Ini sangat berguna apabila anda:

  • mencipta memori daripada babak yang lebih panjang
  • menjalankan konsolidasi
  • menjalankan Side Prompts selepas penciptaan memori
  • bekerja dalam chat panjang dan mahukan kemajuan serta pengendalian semakan yang lebih jelas

Barisan boleh menunjukkan status tugas, membatalkan tugas aktif, mencuba semula tugas yang gagal, dan menyembunyikan tugas yang selesai. Jika tugas dalam barisan memerlukan semakan pengguna, STMB boleh menandakannya sebagai Perlu semakan dan bukannya menulis ganti sesuatu yang tidak selamat secara senyap.

Jika Chat Top Bar tidak dipasang atau tidak diaktifkan, STMB masih berfungsi seperti biasa. Anda hanya tidak akan mempunyai UI barisan tugas.

Memasang Chat Top Bar

Cara memasang Chat Top Bar

🎨 Maklum Balas Visual & Kebolehcapaian

Pemilihan babak lengkap menunjukkan semua keadaan visual

  • Keadaan Butang: tidak aktif, aktif, pemilihan sah, dalam babak, memproses.

  • Kebolehcapaian: navigasi papan kekunci, penunjuk fokus, atribut ARIA, pergerakan dikurangkan, mesra mudah alih.

Soalan Lazim

Patutkah saya menggunakan lorebook berasingan untuk memori?

Saya syorkan lorebook memori anda menjadi buku yang berasingan. Ini memudahkan pengurusan memori berbanding entri lain. Contohnya, ia lebih mudah untuk dipasang pada sembang kumpulan, digunakan dalam sembang lain, atau diberi bajet lorebook individu menggunakan STLO.

Adakah saya perlu menjalankan vektor?

Boleh, tetapi ia tidak wajib. Jika anda tidak menggunakan sambungan vektor, ia masih berfungsi melalui kata kunci. Semuanya diautomasikan supaya anda tidak perlu memikirkan kata kunci apa yang perlu digunakan.

Patutkah saya menggunakan 'Tangguhkan Sehingga Rekursi' jika Memory Books ialah satu-satunya lorebook?

Tidak. Jika tiada info dunia atau lorebook lain, memilih Tangguhkan Sehingga Rekursi boleh menghalang gelung pertama daripada mencetus, menyebabkan tiada apa yang diaktifkan. Jika Memory Books ialah satu-satunya lorebook, sama ada matikan Tangguhkan Sehingga Rekursi atau pastikan sekurang-kurangnya satu lagi info dunia/lorebook dikonfigurasikan.

Mengapa AI tidak nampak entri saya?

Pertama, pastikan entri itu benar-benar dihantar. Saya suka menggunakan WorldInfo-Info untuk itu.

Jika entri memang dicetuskan dan dihantar ke AI, kemungkinan anda perlu menegur AI dalam OOC. Contohnya: [OOC: WHY are you not using the information you were given? Specifically: (whatever it was)] 😁

Penyelesaian Masalah

Amaran pertindihan babak Dayakan pertindihan babak

  • Saya tidak dapat mencari Memory Books dalam menu Extensions! Tetapan berada dalam menu Extensions, iaitu ikon tongkat sihir 🪄 di sebelah kiri kotak input anda. Cari "Memory Books".

Lokasi tetapan STMB

  • Tiada lorebook tersedia atau dipilih:

    • Dalam Mod Manual, pilih lorebook apabila diminta.
    • Dalam Mod Automatik, ikat lorebook pada sembang anda.
    • Atau dayakan "Cipta buku legenda secara automatik jika tiada" untuk penciptaan automatik.

  • Ralat Pengesahan Lorebook:

    • Anda mungkin telah memadam lorebook yang sebelum ini diikat. Hanya ikat lorebook baharu, walaupun ia kosong.

  • Tiada babak dipilih:

    • Tandakan kedua-dua titik mula (►) dan tamat (◄).

  • Babak bertindih dengan memori sedia ada:

    • Pilih julat yang berbeza, atau dayakan "Allow Scene Overlap" dalam tetapan.

  • AI gagal menjana memori yang sah:

    • Gunakan model yang menyokong output JSON.
    • Semak prom dan tetapan model anda.

  • Ambang amaran token melebihi had:

    • Gunakan babak yang lebih kecil, atau tingkatkan ambang.

  • Butang chevron hilang:

    • Tunggu sambungan dimuatkan, atau muat semula.

  • Data watak tidak tersedia:

    • Tunggu sembang/kumpulan dimuat sepenuhnya.

📚 Tingkatkan Kuasa dengan Penyusunan Lorebook (STLO)

Untuk organisasi memori lanjutan dan integrasi cerita yang lebih mendalam, gunakan STMB bersama SillyTavern-LorebookOrdering (STLO). Lihat panduan untuk amalan terbaik, arahan persediaan, dan tip.

📝 Polisi Karakter (v4.5.1+)

  • Dibenarkan dalam tajuk: Semua aksara Unicode yang boleh dicetak dibenarkan, termasuk huruf beraksen, emoji, CJK, dan simbol.
  • Disekat: Hanya aksara kawalan Unicode (U+0000–U+001F, U+007F–U+009F) disekat; ini dibuang secara automatik.

Lihat Butiran Polisi Karakter untuk contoh dan nota migrasi.

👨‍💻 Untuk Pembangun

Membina Sambungan

Sambungan ini menggunakan Bun untuk binaan. Proses binaan akan meminimumkan dan menggabungkan fail sumber.

# Bina sambungan
bun run build

Git Hooks

Projek ini menyertakan pre-commit hook yang secara automatik membina sambungan dan memasukkan artifak binaan ke dalam commit anda. Ini memastikan fail binaan sentiasa sepadan dengan kod sumber.

Untuk memasang git hook:

bun run install-hooks

Hook tersebut akan:

  • Menjalankan bun run build sebelum setiap commit
  • Menambah artifak binaan ke dalam commit
  • Membatalkan commit jika binaan gagal

Dibangunkan dengan kasih sayang menggunakan VS Code/Cline, ujian menyeluruh, dan maklum balas komuniti. 🤖💕