Ars Umbris bilan ishlashni boshlash: tiplashtirilgan, agentlarga mos IDE’ni o‘rnating va o‘rganing

Ars Umbris nima?

Ars Umbris tiplangan bilimlar uchun moslashuvchan, agentlarga mos IDE hisoblanadi. U bilimlar, turlar, ko‘nikmalar, vositalar va UI komponentlarini bir-biriga bog‘liq bo‘lishi mumkin bo‘lgan kompozitsion repozitoriylarda birlashtiradi.

Loyiha ushbu repozitoriylarni yagona tiplangan graf sifatida o‘qiydi. U maydonlar va havolalarni tekshiradi, so‘ng agentlar amal qilishi mumkin bo‘lgan diagnostikalarni taqdim etadi. Odamlar va agentlar vositalar yaratish, ko‘rinishlar qo‘shish va ilovani o‘zgartirish uchun bir xil primitivlar va SDKlardan foydalanishi mumkin.

Ars Umbris hozirda erta alfa bosqichida, shuning uchun xatolar va moslikni buzuvchi o‘zgarishlar bo‘lishi mumkin. Hozircha u faqat macOSni qo‘llab-quvvatlaydi.

Arxitektura qanday tuzilgan

Ars Umbris uchta asosiy qatlamga bo‘lingan. Ularni tushunish tizimni sozlash yoki kengaytirishda qayerdan izlash kerakligini aniqlashga yordam beradi.

1. au-engine

au-engine — tiplangan fayl substrati ustida qurilgan, repozitoriylararo graf mexanizmi. U repozitoriylar bo‘ylab fayllarni indekslaydi va ularni tiplangan, so‘rov yuborish mumkin bo‘lgan, jonli grafga aylantiradi.

Mexanizm Markdown va YAML fayllari uchun maxsus tiplash tilini ham amalga oshiradi. Batafsil ma’lumot uchun au-engine.md faylini o‘qing.

2. au-host

au-host — Electron host ilovasi. U graf ustiga tiplangan proyeksiyalarni yoki ko‘rinishlarni o‘rnatadi hamda tiplangan ma’lumotlar asosida konfiguratsiya orqali boshqariladigan kompozitsiyalarni qo‘llab-quvvatlaydi.

Bu kompozitsiyalarni tahrirlash mumkin va ular odamlar hamda agentlar tomonidan boshqarilishi mumkin. Host hujjatlari uchun au-host.md fayliga qarang.

3. au-mcp

au-mcp kengaytiriladigan agent qatlamini taqdim etadi. U MCP orqali tiplangan vositalar va ko‘nikmalarni ochadi hamda adapterlar orqali siz tanlagan agent harnessi bilan ishlaydi.

MCP qatlami haqida batafsil ma’lumot olish uchun au-mcp.md faylini o‘qing.

O‘rnatishga tayyorlanish

O‘rnatish jarayonida ikkita katalogdan foydalaniladi:

• ~/arsumbris/ katalogida bir nechta Ars Umbris repozitoriylari saqlanadi.
• ~/.arsumbris/ katalogida Ars Umbris konfiguratsiya fayllari saqlanadi.

Loyiha faqat macOSda ishlashi va faol ishlab chiqilayotgani sababli, tizimga o‘zgartirish kiritishdan oldin zarur shartlarni ko‘rib chiqing. Repozitoriydagi amaldagi o‘rnatish yo‘riqnomasi talab qilinadigan dasturiy ta’minot va sozlash tartibi uchun asosiy manba hisoblanadi.

Kirish nuqtasi repozitoriysini o‘rnatish

README o‘rnatishni quyidagi ko‘rsatmalar orqali agentingizdan bajarishni so‘rashni tavsiya qiladi:

Ars Umbrisni o‘rnatishga yordam bering.

1) Agar mavjud bo‘lmasa, ikkita papka yarating:
   - ~/arsumbris/ bir nechta repozitoriylarni saqlaydi.
   - ~/.arsumbris/ konfiguratsiyalarni saqlaydi.

2) Kirish nuqtasi repozitoriysini klonlang:
   git clone https://github.com/arsumbris/arsumbris.git ~/arsumbris/arsumbris
   Agar bu manzil allaqachon mavjud bo‘lsa, davom etishdan oldin uni tekshiring; ustiga yozmang.

3) ~/arsumbris/arsumbris/INSTALL.md faylini o‘qing va undagi amaldagi sozlash jarayoniga amal qiling.
   Zarur shartlarni tekshiring va mashinamda kerak bo‘ladigan har qanday o‘zgarishlarni kiritishdan oldin tushuntiring.

Muhim xavfsizlik qadami — klonlashdan oldin mavjud ~/arsumbris/arsumbris katalogini tekshirish. Mavjud checkout ustiga yozmang. Repozitoriy mavjud bo‘lgach, INSTALL.md faylini oching va undagi amaldagi ko‘rsatmalarga hujjatlashtirilgan tartibda amal qiling.

Repozitoriyning amaldagi sozlash jarayoniga amal qilish

1. macOSdan foydalanayotganingizni tasdiqlang.
2. Agar mavjud bo‘lmasa, ~/arsumbris/ va ~/.arsumbris/ kataloglarini yarating.
3. ~/arsumbris/arsumbris katalogi allaqachon mavjud yoki mavjud emasligini tekshiring.
4. Agar mavjud bo‘lmasa, repozitoriyni git clone https://github.com/arsumbris/arsumbris.git ~/arsumbris/arsumbris buyrug‘i bilan klonlang.
5. Agar mavjud bo‘lsa, uni almashtirmasdan tekshiring.
6. ~/arsumbris/arsumbris/INSTALL.md faylini o‘qing.
7. Ushbu faylda ko‘rsatilgan zarur shartlarni tekshiring va o‘rnating; taklif etilgan mashina o‘zgarishlarini qo‘llashdan oldin ko‘rib chiqing.
8. INSTALL.md faylida hujjatlashtirilgan qolgan sozlash bosqichlarini tartib bilan bajaring.

Ars Umbris faol ishlab chiqilayotgani sababli, uchinchi tomon manbalaridagi eskirgan sozlash ko‘rsatmalariga tayanmang. O‘rnatayotgan versiyangiz uchun checkout qilingan repozitoriyning o‘rnatish yo‘riqnomasidan foydalaning.

Asosiy foydalanish tushunchalari

Ars Umbris tiplangan bilimlar va imkoniyatlarni o‘z ichiga olgan repozitoriylar asosida ishlab chiqilgan. Repozitoriy bilimlar, tur ta’riflari, ko‘nikmalar, vositalar va UI komponentlarini o‘z ichiga olishi mumkin. Repozitoriylar boshqa repozitoriylarga ham bog‘liq bo‘lishi mumkin, bu esa imkoniyatlar va bilimlarni loyihalar o‘rtasida qayta ishlatish imkonini beradi.

Yuqori darajada odatiy ish jarayoni quyidagicha:

1. Tegishli repozitoriylarni ~/arsumbris/ katalogiga joylashtiring yoki klonlang.
2. au-engine ushbu repozitoriylar bo‘ylab fayl substratini indekslashiga imkon bering.
3. Hosil bo‘lgan tiplangan grafdan bog‘langan ma’lumotlar, maydonlar va havolalar bilan ishlash uchun foydalaning.
4. Graf ustiga proyeksiyalar va ko‘rinishlarni o‘rnatish uchun au-hostdan foydalaning.
5. Agent harnessini au-mcp va MCP adapterlari orqali ulang.
6. Diagnostikalarni tekshirish, vositalar yaratish, ko‘rinishlar qo‘shish va ilovani o‘zgartirish uchun agentlar yoki inson foydalanuvchilardan foydalaning.

README yagona namunaviy loyiha yoki buyruq satri ish jarayonini belgilamaydi. Aniq buyruqlaringiz va mavjud proyeksiyalar INSTALL.md faylida tasvirlangan sozlash jarayoni hamda siz ulaydigan repozitoriylarga bog‘liq.

MCP orqali agentlar bilan ishlash

Ars Umbris Model Context Protocol orqali agent harnessiga ulanish uchun yaratilgan. au-mcp qatlami tiplangan vositalar va ko‘nikmalarni taqdim etadi, adapterlar esa bu imkoniyatlarni siz tanlagan harnessga ulaydi.

Bu agentga ilovani yaratishda foydalaniladigan ayni asosiy primitivlar va SDKlar bilan ishlash imkonini beradi. Amalda agent o‘rnatishingizda mavjud imkoniyatlar va konfiguratsiyaga muvofiq vositalar yaratish, ko‘rinishlar qo‘shish va ilovani o‘zgartirishda ishtirok etishi mumkin.

Ilg‘or maslahatlar va xavfsizlik masalalari

Repositorylarni qayta foydalanish mumkin bo‘lgan holda tashkil qiling

Bilim va imkoniyatlarni qayta foydalanish hamda ulashish mumkin bo‘lgan repositorylarga ajrating. Repositorylararo bog‘liqliklar loyiha modelining markaziy qismidir, shuning uchun repositorylarni alohida papkalar emas, balki yagona tiplangan grafning qismlari sifatida tasavvur qiling.

Diagnostikadan fikr-mulohaza sifatida foydalaning

Dvigatel tiplangan graf bo‘ylab maydonlar va havolalarni tekshiradi. Tiplangan Markdown, YAML yoki repositoryga oid boshqa kontentni tahrirlashda, ayniqsa agent o‘zgarishlar kiritayotganida, uning diagnostikasini fikr-mulohaza sifatida qabul qiling.

Qatlam hujjatlarini o‘qing

Harakatni tushunishingiz kerak bo‘lganda, tegishli qatlam hujjatlariga murojaat qiling: dvigatel, host yoki MCP agent qatlami.

O‘zgarishlarni qo‘llashdan oldin ko‘rib chiqing

O‘rnatish so‘rovida kerakli mashina o‘zgarishlarini kiritishdan oldin ularni tushuntirish tavsiya etiladi. Agentlarga repositorylar yoki konfiguratsiyani o‘zgartirishga ruxsat berishda ham xuddi shunday ehtiyotkor yondashuvga amal qiling.

Joriy xavfsizlik modelini hisobga oling

Ars Umbris kodni mashinangizda ishga tushiradi va hozircha qumloq muhitga ega emas. Loyihadan foydalanishdan oldin, ayniqsa agentlarni ulashda yoki to‘liq nazorat qilmaydigan repositorylar bilan ishlashda, SAFETY.md faylini ko‘rib chiqing.

Xulosa

Ars Umbris tiplangan bilimlar uchun eksperimental IDE tarkibida tiplangan repositorylararo graf, Electron asosidagi host va MCP agent qatlamini birlashtiradi. Ishni boshlash uchun ikkita konfiguratsiya katalogini tayyorlang, kirish nuqtasi repositorysini mavjud fayllar ustiga yozmasdan klonlang va undagi joriy INSTALL.md ko‘rsatmalariga amal qiling. O‘rnatilgach, repositorylar, proyeksiyalar, vositalar, ko‘nikmalar va agentlar qanday hamkorlik qilishini o‘rganing, shu bilan birga loyihaning alfa holati va qumloqsiz bajarilish modelini yodda tuting.