BookLeme qo‘llanmasi: kitobni o‘rnatiladigan va tekshiriladigan Agent Skill’ga kompilyatsiya qilish

BookLeme nima

BookLeme, xitoycha nomi “读了么”, kitoblarni Agent Skill'lariga kompilyatsiya qiluvchi vositalar to‘plamidir. U oddiy xulosa yaratishga emas, balki kitobdagi ishlash usullarini, masalan, savollar berish tartibi, baholash shartlari, dalil qoidalari, jarayon holatlari va qo‘llanilmaydigan chegaralarni ajratib olishga hamda ularni o‘rnatish, chaqirish va tekshirish mumkin bo‘lgan mahsulotlarga aylantirishga e’tibor qaratadi.

Loyiha kitoblarni qayta ishlashni kompilyatsiya va ishga tushirish bosqichlariga ajratadi: kompilyatsiya vaqtida asl kitob o‘qiladi va qayta ishlanadi, ishga tushirish vaqtida esa faqat zaruratga ko‘ra yaratilgan bilim bo‘laklari yuklanadi. Shu tariqa har bir Skill chaqirilganda butun kitobni qayta o‘qishning oldi olinadi.

Eslatma: “Xulosa o‘rniga tuzilmani ajratib olish” loyiha qabul qilgan muhandislik dizayni tanlovidir, ammo README uni loyiha tomonidan hali tasdiqlanmagan taxmin sifatida belgilaydi, allaqachon isbotlangan xulosa sifatida emas.

BookLeme nimalar yaratadi

BookLeme ikkita yaratish mexanizmini taqdim etadi. Ular ajratib olish va tekshirish bosqichlaridagi oraliq ko‘rinishni bo‘lishadi, faqat renderlash bosqichida ajraladi. Shu sababli ikki turdagi mahsulotni bir vaqtda yaratishda kitobni ikki marta qayta ishlash shart emas.

knowledge_pack bilim to‘plami

Bilim to‘plami ko‘rib chiqish mumkin bo‘lgan tuzilmali bilim bazasi bo‘lib, asosan Topic Index yo‘naltirish jadvali, zaruratga ko‘ra yuklanadigan freym bo‘laklari, qarorlar bo‘yicha tezkor qo‘llanma va manbalar ro‘yxatini o‘z ichiga oladi. U “kitobdagi muayyan freymdan qanday foydalaniladi” kabi savollarga javob berish uchun mos.

behavior_skill xulq-atvor Skill'i

Xulq-atvor Skill'i to‘liq jarayonlarni bajarish uchun ishlatiladi va rollar ta’rifi, qat’iy cheklovlar, holatlar mashinasi, nomlangan chiqish shartnomasi, anti-patternlar hamda hissiy himoya qoidalarini o‘z ichiga olishi mumkin. U faqat bilimni izlash emas, balki murabbiylik dialogi kabi ko‘p bosqichli vazifalarni bajarish uchun mos.

Asosiy xususiyatlar

• Ikki mexanizmli avtomatik yo‘naltirish: 12 ta deterministik janr xususiyatiga ko‘ra bilim to‘plami yoki xulq-atvor Skill'ini tanlaydi; mexanizmni qo‘lda ham belgilash mumkin.
• Ulanadigan janr plaginlari: yangi janr qo‘shishda asosiy konveyerni o‘zgartirmasdan, foydalanuvchi plaginlari katalogiga bitta Python fayli qo‘shish mumkin.
• So‘zma-so‘z aniqlikni qayta tekshirish: iqtiboslar asl matndagi aniq uzluksiz qism bo‘lishi va bir nechta o‘lchanadigan ko‘rsatkichlar orqali tekshirilishi kerak.
• Mualliflik huquqi qat’iy to‘sig‘i: o‘rnatish va nashr etishdan oldin deterministik mualliflik huquqi tekshiruvi bajariladi; uchinchi tomon kitoblaridan yaratilgan Skill'lar sukut bo‘yicha maxfiy saqlanadi.
• Ishlash vaqtida uchinchi tomon bog‘liqliklari yo‘q: asosiy amalga oshirish faqat Python standart kutubxonasidan foydalanadi.
• Bosqich darajasidagi idempotentlik: konveyer SHA-256 yordamida davom ettiriladi; biror bosqich mahsuloti o‘chirilsa, faqat tegishli bosqichni qayta ishga tushirish kifoya.

O‘rnatish va muhitni tayyorlash

BookLeme Python 3.9 yoki undan yuqori versiyasini talab qiladi. Repozitoriy klonlangach, uchinchi tomon ish vaqti bog‘liqliklarini avval o‘rnatmasdan, Python moduli kirish nuqtasi orqali bevosita ishga tushirish mumkin.

git clone https://github.com/bookleme/bookleme.git
cd bookleme
python3 -m bookleme --version

Agar buyruq versiya ma’lumotini chiqarsa, asosiy muhit tayyor hisoblanadi. Repozitoriy PDF, EPUB, DOCX, Markdown, HTML, RTF va MOBI kabi kirish formatlarini qo‘llab-quvvatlashini bildiradi; quyida loyihaga kiritilgan Markdown formatidagi sintetik qo‘lyozma yordamida to‘liq jarayon ko‘rsatiladi.

Birinchi kompilyatsiya: qo‘lyozmadan Skill yaratish

run quyi buyrug‘ini ishga tushiring, --input orqali qo‘lyozmani, --title orqali sarlavhani belgilang:

python3 -m bookleme run \
  --input evals/cases/synthetic/coach_book.md \
  --title "Mening birinchi kitobim"

Sukut bo‘yicha BookLeme qo‘lyozmaning janr xususiyatlarini tahlil qiladi va mos yaratish mexanizmini avtomatik tanlaydi. Kompilyatsiya kirishni ro‘yxatga olish, matnni ajratib olish, xitoycha segmentatsiya, janr bo‘yicha yo‘naltirish, atomik qobiliyatlarni ajratib olish, aniqlikni tekshirish, renderlash, umumiy tekshiruv, o‘rnatish va smoke-test baholash kabi bosqichlardan o‘tadi.

Tavsiya: dastlabki tajribada repozitoriy taqdim etgan sintetik test qo‘lyozmasidan foydalaning. Uchinchi tomon kitoblarini qayta ishlashdan oldin tegishli foydalanish huquqiga ega ekaningizni tekshiring va yaratilgan mahsulotlarni tarqatish cheklovlarini tushuning.

Yaratish mexanizmini tanlash

Chiqish turini boshqarish uchun --engine dan foydalaning:

python3 -m bookleme run \
  --input evals/cases/synthetic/coach_book.md \
  --title "Murabbiylik dialogi namunasi" \
  --engine behavior_skill

Mavjud qiymatlar:

• auto: yo‘naltiruvchiga avtomatik tanlash imkonini beradi.
• knowledge_pack: faqat tuzilmali bilim to‘plamini yaratadi.
• behavior_skill: faqat ishga tushiriladigan xulq-atvor Skill'ini yaratadi.
• both: ikki turdagi mahsulotni bir vaqtda yaratadi.

Yo‘naltirishni o‘chirib, ikkala mexanizm ham to‘liq chiqishini istasangiz, --no-router dan foydalaning:

python3 -m bookleme run \
  --input evals/cases/synthetic/coach_book.md \
  --title "Ikki mexanizm namunasi" \
  --no-router

Janr plaginini belgilash

Janr plagini mahsulotning holatlar mashinasi, chiqish shartnomasi, qat’iy cheklovlari va ifoda uslubini belgilaydi. Hozir amalga oshirilgan plaginlar:

• coach_dialogue: murabbiylik yoki o‘z-o‘ziga dialog uchun; savol-javob holatlar mashinasi, hissiy himoya, uzilish va suhbatni davom ettirishni qo‘llab-quvvatlaydi.
• knowledge_reference: freym bo‘yicha tezkor ma’lumot uchun; kontentni Topic Index orqali yo‘naltiradi va kitobda berilmagan ma’lumotga duch kelganda albatta rad javobi berishi kerak.

professional_analysis va decision_checklist keyingi M4 yo‘l xaritasiga tegishli bo‘lib, hozir ularni tayyor funksiya deb hisoblamaslik kerak.

--genre orqali amalga oshirilgan plaginni majburan tanlash mumkin:

python3 -m bookleme run \
  --input evals/cases/synthetic/coach_book.md \
  --title "Hayot dizayni dialogi" \
  --engine behavior_skill \
  --genre coach_dialogue

Yaratilgan mahsulotni tekshirish

Yaratish tugagach, loyiha taqdim etgan tekshiruv buyrug‘i yordamida mahsulotni tekshiring. README'da examples/coach misol sifatida keltirilgan:

python3 -m bookleme validate examples/coach

Bu bosqich rasmiy tekshiruvchi, ichki lint va mualliflik huquqi qat’iy to‘sig‘ini ishga tushiradi. BookLeme aniqlikni tekshiriladigan ko‘rsatkichlarga ajratadi: iqtiboslarni tahlil qilish darajasi, so‘zma-so‘z buzilish darajasi, salbiy misollarga rad javobi darajasi, trigger so‘zlar mosligi, mahsulot muvofiqligi, shingle kesishish chegarasi va qamrov.

Loyiha groundedness evristik ko‘rsatkichini ham saqlab qoladi, biroq README LLM judge hali ulanmaganini aniq bildiradi. Shu sababli bu qiymat hozircha faqat hisobot qilinadi, qat’iy to‘siq sifatida ishlatilmaydi.

Regressiya testlarini ishga tushirish

Asosiy kod, plagin yoki shablonlarni o‘zgartirgandan so‘ng to‘liq testni ishga tushiring:

python3 -m unittest discover -s tests -v

Plagin ishlab chiqayotgan bo‘lsangiz, holat sxemasini tekshirishingiz va plaginni alohida tasdiqlashingiz ham mumkin:

python3 -m bookleme schema --state
python3 -m bookleme plugin validate bookleme/plugins/builtin/coach_dialogue.py

Mahsulotni o‘rnatish va foydalanish huquqini bildirish

Sukut bo‘yicha yaratish buyrug‘i mahsulotni Skill'larning asosiy manbasiga yozmaydi. O‘rnatish kerak bo‘lsa, --install ni aniq qo‘shing. Shu bilan birga, kiritilgan kontentning huquqiy holatini --user-rights orqali bildirish mumkin:

python3 -m bookleme run \
  --input path/to/book.md \
  --title "Ichki bilim Skill'i" \
  --engine both \
  --install \
  --user-rights owned

--user-rights quyidagi qiymatlarni qo‘llab-quvvatlaydi:

• owned: foydalanuvchi kontent huquqlariga ega.
• licensed: tegishli ruxsat olingan.
• public_domain: kontent jamoat mulkiga tegishli.
• unknown: huquqiy holat noma’lum.

Huquqiy bayonot yuridik xulosaning o‘rnini bosa olmaydi. MIT litsenziyasi faqat BookLeme konvertorining kodi va Skill ta’riflarini qamrab oladi; u kiritilgan kitoblarni qamrab olmaydi va foydalanuvchiga hosila mahsulotlarni tarqatish huquqini avtomatik bermaydi.

Mualliflik huquqi qat’iy to‘sig‘ini tushunish

BookLeme chiqishi asl matnni qayta tiklash emas, tuzilmali hosila qaydlar sifatida mo‘ljallangan. Loyiha oltita mualliflik huquqi qat’iy to‘sig‘ini o‘rnatgan; ulardan istalgan biri muvaffaqiyatsiz bo‘lsa, o‘rnatish yoki nashr etish to‘xtatiladi:

1. Bitta iqtibos 150 belgidan oshmasligi va kirishdagi asl matnga so‘zma-so‘z izchil bog‘lanishi kerak.
2. Jami iqtiboslar nisbati 0.03 dan oshmasligi kerak.
3. Uzluksiz ko‘chirilgan kontent 150 belgidan oshmasligi kerak.
4. 13 belgili shingle kesishishi 0.10 dan oshmasligi kerak.
5. Mahsulot to‘liq matn yoki asl bo‘laklarni o‘z ichiga olmasligi kerak.
6. contains_original_text qiymati false bo‘lishi kerak.

Uchinchi tomon kitoblaridan yaratilgan Skill'lar sukut bo‘yicha maxfiy bo‘ladi va tarqatilmaydi. Agar ommaviy tarqatish huquqi haqiqatan mavjud bo‘lsa ham, ikki martalik tasdiqlash parametrlarini aniq taqdim etish kerak:

--public --confirm-public PUBLISH

Ommaviy nashr parametri muhandislik tasdiqlash to‘sig‘idir, mualliflik huquqi berilishi emas. Foydalanuvchi ruxsat doirasi, amaldagi qonunlar va kiritilgan materiallarning huquqiy holatini o‘zi tekshirishi kerak.

Ilg‘or usul: bosqich darajasidagi idempotent davom ettirishdan foydalanish

BookLeme'ning S0 dan S9 gacha bo‘lgan konveyeri bosqich darajasidagi idempotent dizayndan foydalanadi va mavjud natijalarni aniqlash uchun SHA-256 ishlatadi. Uzun hujjatni qayta ishlash kutilmaganda to‘xtasa, allaqachon yakunlangan bosqichlar mahsulotlarini saqlab qolish mumkin; faqat biror bosqich chiqishi o‘chirilsa, vosita butun kitobni qayta ishlamasdan tegishli bosqichni qayta bajaradi.

Bu dizayn plagin yoki renderlash mantiqini tuzatish uchun ham mos. Ikki mexanizm oldingi ajratib olish, segmentatsiya, qobiliyatlarni ajratib olish va aniqlikni tekshirish natijalarini bo‘lishgani sababli, renderlash qatlamini o‘zgartirganda qo‘lyozmani qayta o‘qish shart emas.

Ilg‘or usul: maxsus janr plaginini ishlab chiqish

Maxsus plagin bookleme/plugins/user/<genre_id>.py ichiga joylashtirilishi kerak. Loyiha plaginlardan asosiy maydonlarni e’lon qilishni talab qiladi; zarur maydonlar yetishmasa, plagin yuklanmaydi.

• state_machine: jarayon holatlari va o‘tishlarini belgilaydi.
• output_contract: mahsulot taqdim etishi shart bo‘lgan chiqishlarni belgilaydi.
• hard_constraints: buzib bo‘lmaydigan qoidalarni belgilaydi.
• anti_patterns: oldini olish kerak bo‘lgan xatti-harakatlar xatolarini sanab o‘tadi.
• voice_calibration: ohang, murojaat shakli, taqiqlangan so‘zlar va xulosaga egalikni belgilaydi.
• copyright_profile: mualliflik huquqini nazorat qilish bilan bog‘liq sozlamalarni bildiradi.
• trigger_words: 3–5 ta xitoycha trigger so‘zini taqdim etadi.
• eval_prompts: baholash promptlarini taqdim etadi, ulardan kamida bittasi salbiy misol bo‘lishi kerak.

Plagin yozishdan oldin plagin spetsifikatsiyasini o‘qish tavsiya etiladi; tugatgach, plugin validate yordamida tekshiring. Plagin orqali aniqlik tekshiruvi, mualliflik huquqi qat’iy to‘sig‘i yoki salbiy misollarga rad javobi talablarini chetlab o‘tishga urinmang.

S0–S9 konveyeri qanday ishlaydi

1. S0–S2: Kiritilgan ma’lumotlarni ro‘yxatga olish, deterministik ajratib olish, normallashtirish va xitoycha bo‘limlarga ajratish amalga oshiriladi; bunda ingliz tilidagi qat’iy Chapter belgilariga tayanilmaydi.
2. S3: 12 ta xususiyat asosida janr yo‘naltiriladi; noaniqlik yuzaga kelganda ikki dvigatelli rejim avtomatik tanlanishi mumkin.
3. S4: Atom qobiliyatlar ajratib olinadi. Bunda deterministik ajratib oluvchi va ixtiyoriy OpenAI-compatible LLM ajratib oluvchisidan foydalanish mumkin; konfiguratsiya bo‘lmasa, tizim avtomatik ravishda zaxira rejimiga qaytadi.
4. S5: Iqtiboslar so‘zma-so‘z tekshiriladi, claim ledger yuritiladi va sodiqlik ko‘rsatkichlari hisoblanadi.
5. S6: Plaginlar asosida bilimlar paketi yoki xulq-atvor Skill’i render qilinadi; ikki dvigatelning haqiqiy ajralish nuqtasi shu bosqichdir.
6. S7–S9: Yakuniy tekshiruv, idempotent o‘rnatish va smoke-test baholashi bajariladi.

S3 va S4 ikkalasi ham S2 natijalarini kirish ma’lumoti sifatida oladi va parallel ishlashi mumkin. Ikki dvigatel S1, S2, S4 va S5 bosqichlarining oraliq taqdimotlarini bo‘lishib ishlatadi, shu orqali ma’lumotlarni qayta o‘qish va ajratib olishning oldi olinadi.

Amaliy tavsiyalar

• Avval loyiha bilan birga keladigan sintetik qo‘lyozma yordamida buyruqlarni o‘rganing, keyin haqiqiy kitoblar bilan ishlang.
• Mahsulot turiga ishonchingiz komil bo‘lmasa, --engine auto dan foydalaning; ikki xil natijani bir vaqtda taqqoslash kerak bo‘lsa, both yoki --no-router dan foydalaning.
• Har safar plagin yoki shablonga o‘zgartirish kiritgandan so‘ng mahsulot tekshiruvlari va birlik testlarini ishga tushiring.
• Kitobda berilmagan ma’lumotlar bo‘yicha rad etish qobiliyatini saqlang; manbadagi bo‘shliqlarni modelning umumiy bilimi bilan to‘ldirmang.
• Kitobning asl matni, muqovasi yoki skanerlangan nusxalarini repozitoriyga yubormang; shuningdek, sukut bo‘yicha maxfiy bo‘lgan uchinchi tomon kitoblari mahsulotlarini bevosita ommaga oshkor qilmang.
• Ko‘rsatkichlar va nashr chegaralarini tushunish uchun sodiqlik hujjati hamda mualliflik huquqi hujjatini o‘qing.

Joriy chegaralar

BookLeme hozirda M0–M3 bosqichlarida. coach_dialogue va knowledge_reference amalga oshirilgan, ammo professional tahlil va qarorlar ro‘yxati plaginlari keyingi yo‘l xaritasiga kiritilgan. LLM judge hali ulanmagan, shu sababli tegishli ko‘rsatkichlarning ayrimlari hanuz null qiymatiga ega. Foydalanishda allaqachon amalga oshirilgan, amalda sinovdan o‘tgan va hali tekshirilishi kerak bo‘lgan qobiliyatlarni farqlash lozim.

Xulosa

BookLeme “kitob o‘qish”ni sinovdan o‘tkazish mumkin bo‘lgan muhandislik jarayoniga aylantiradi: avval ajratib olish va bo‘limlarga ajratish, keyin qobiliyatlarni ajratib olish hamda sodiqlikni tekshirish, nihoyat bilimlar paketi yoki xulq-atvor Skill’i sifatida render qilish. Birinchi kompilyatsiya yakunlangach, kitobdagi usullardan foydalanish bilan birga manba chegaralari va tekshiriluvchanlikni saqlab qolish uchun tekshiruv, test, huquqiy bayonot va mualliflik huquqi tekshiruvlarini doimiy jarayonga kiritish tavsiya etiladi.