iCode bilan boshlash: AI agent terminalini ishga tushirish va sozlash

iCode nima?

iCode — AI agentlari va ish jarayonlarini boshqarish uchun mo‘ljallangan ochiq kodli terminal ilovasi. U suhbatlar, model profillari, agent konfiguratsiyasi, shell orqali foydalanish, fayl farqlari, ortga qaytarish boshqaruvlari va bajarilish tahlilini bitta interfeysga birlashtiradi.

Ishlanmoqda: iCode interfeyslari, fayl formatlari va standart sozlamalari relizlar orasida o‘zgarishi mumkin.

iCode AI modelini o‘z ichiga olmaydi. Buning o‘rniga, model provayderlarini o‘zingiz ulaysiz va agent qaysi sozlangan profildan foydalanishini tanlaysiz.

Asosiy imkoniyatlar

• Terminal chati: Formatlangan ro‘yxatlar va diagrammalarni o‘z ichiga olgan boy Markdown javoblarini ko‘ring.
• Sozlanadigan agentlar: Agent kodini yozmasdan ko‘rsatmalar, vositalar, quyi agentlar, ko‘nikmalar, MCP serverlari va xotirani belgilang.
• Bir nechta model profillari: Turli provayderlar uchun profillarni sozlang va suhbat davomida modellarni almashtiring.
• Ish jarayonini vizualizatsiya qilish: Ish jarayonlarini tugunma-tugun kuzating va har bir agent tugunining modeli, vosita chaqiruvlari hamda token sarfini tekshiring.
• O‘zgarishlarni ko‘rib chiqish: Agent o‘zgartirgan har bir faylni birlashtirilgan yoki bo‘lingan diff ko‘rinishida tekshiring.
• Ortga qaytarish: Oldingi burilishni tanlang, qaytariladigan o‘zgarishlarni ko‘rib chiqing va shu nuqtadan keyingi suhbatni o‘chiring.
• Trayektoriya tahlili: Vaqt, token, kesh va parallellik tafsilotlarini, shuningdek model, hook va vosita chaqiruvlarini tekshiring.
• Integratsiyalangan shell: iCode ichida haqiqiy terminalni, jumladan to‘liq ekranli ilovalarni ishga tushiring.

Talablar

Yagona majburiy talab — uv. U loyiha uchun Python 3.14 ni ta’minlaydi, shuning uchun bu Python versiyasini alohida o‘rnatishingiz shart emas.

Eng yaxshi tajriba uchun zamonaviy terminaldan foydalaning. README Windows’da Windows Terminalni, macOS va Linux’da esa Ghosttyni tavsiya qiladi.

iCode’ni o‘rnatish va ishga tushirish

Repository’ning mahalliy nusxasidan boshlang. Terminalni uning ildiz katalogida oching va barcha kerakli qo‘shimchalar bilan loyihani sinxronlang:

uv sync --extra all

--extra all parametridan aynan ko‘rsatilganidek foydalaning. Loyiha oddiy uv sync buyrug‘idan foydalanmaslik yoki parametrni --all-extras bilan almashtirmaslikni alohida ogohlantiradi.

Keyin vendored ripgrep ikkilik faylini yuklab oling. macOS yoki Linux’da quyidagini bajaring:

./scripts/fetch_rg.sh

Windows’da uning o‘rniga PowerShell skriptini bajaring:

.\scripts\fetch_rg.ps1

Va nihoyat, iCode’ni ishga tushiring:

uv run icode

Loyihaning kod nomi Chrys, shuning uchun quyidagi buyruq ham ayni ilovani ishga tushiradi:

uv run chrys

Birinchi modelingizni sozlang

iCode model profillarisiz yetkazib beriladi. Birinchi ishga tushirishda F4 tugmasini bosib, Model Configuration oynasini oching va foydalanadigan modelingiz provayderi uchun profil qo‘shing.

Profillarni sozlaganingizdan so‘ng, turli provayderlarning profillarini yonma-yon saqlashingiz va suhbat davomida ular o‘rtasida almashishingiz mumkin. iCode hech qanday modelni taqdim etmagani sababli, siz sozlagan provayder ulanishi model so‘rovlari qayerga yuborilishini belgilaydi.

Asosiy foydalanish

Kiritish panelidan navigatsiya qiling

Bosh ekranda joriy agent, model, tasdiqlash rejimi va sessiya ko‘rinib turadi. Bir nechta prefiks muhim funksiyalarga tezkor kirishni ta’minlaydi:

• # agentlarga kirish imkonini beradi.
• $ modellarga kirish imkonini beradi.
• / buyruqlarga kirish imkonini beradi.
• @ fayllarga kirish imkonini beradi.
• ! shell’ga kirish imkonini beradi.

Suhbatni boshlang

Agent va sozlangan modelni tanlang, so‘ng kiritish paneliga so‘rovingizni kiriting. Javoblar to‘g‘ridan-to‘g‘ri terminalda boy Markdown formatida ko‘rsatiladi. Agent fayllarni o‘zgartirganda, iCode bu o‘zgarishlarni qayd etadi, shunda ularni burilishlar bo‘yicha yoki birgalikda ko‘rib chiqishingiz mumkin.

Agentni sozlang

F2 tugmasini bosib, Agent Configuration oynasini oching. Agent — ilova kodi emas, balki konfiguratsiyadir. Bu ekranda uning ko‘rsatmalari, vositalari, quyi agentlari, ko‘nikmalari, MCP serverlari va xotirasini tahrirlashingiz mumkin.

Agent ko‘rsatmalarini uning maqsadiga mos saqlang va faqat unga kerak bo‘lgan vositalar hamda integratsiyalarni yoqing. Bu maxfiylik uchun ham muhim, chunki tashqi vositalar va serverlar ma’lumotlarni mustaqil ravishda qayta ishlashi mumkin.

Fayl o‘zgarishlarini ko‘rib chiqing

Agent o‘zgartirgan fayllarni tekshirish uchun diff ko‘ruvchisidan foydalaning. O‘zgarishlarni bir burilishdan keyin alohida ko‘rib chiqishingiz yoki ularni umumiy ko‘rinishga jamlashingiz mumkin. Birlashtirilgan va bo‘lingan ko‘rinishlarning ikkalasi ham mavjud.

Ish jarayonlarini ishga tushiring va tekshiring

Ish jarayoni rejimi ish jarayonining tugunma-tugun bajarilishini kuzatish imkonini beradi. Har bir agent tuguni uchun iCode tanlangan model, uning vosita chaqiruvlari va token sarfini ko‘rsatishi mumkin.

Bu ko‘rinish vazifa bir nechta bosqich yoki agentlarni o‘z ichiga olganda foydalidir. Bajarilishni yagona noaniq javob sifatida ko‘rish o‘rniga, ishning grafik bo‘ylab qanday harakatlanishini kuzatishingiz mumkin.

Ilg‘or maslahatlar

Noto‘g‘ri qadamdan davom etishdan oldin ortga qaytishdan foydalaning

Agar suhbat keraksiz o‘zgarishlarni keltirib chiqarsa, avvalgi qadamni tanlang va ortga qaytishni oching. iCode ortga qaytishni qo‘llashdan oldin qaysi fayl o‘zgarishlari bekor qilinishini ko‘rsatadi. So‘ng tanlangan qadamdan keyingi suhbat qismini o‘chiradi.

Tasdiqlashdan oldin taklif qilinayotgan fayl o‘zgarishlarining bekor qilinishini diqqat bilan ko‘rib chiqing, ayniqsa bir nechta qadam bir xil fayllarni o‘zgartirgan bo‘lsa.

Trajectory yordamida bajarilishni tahlil qiling

Trajectory ko‘rinishini ochish uchun F12 tugmasini bosing. Uning umumiy ko‘rinishi vaqt va tokenlar qayerga sarflanganini tushuntiradi hamda model faoliyati, vositalar bajarilishi va kutish vaqtini ajratib ko‘rsatadi. Shuningdek, har bir qadam bo‘yicha token va kesh sarfi, shuningdek parallellik haqidagi ma’lumotlarni taqdim etadi.

Xronologiya qadam ichidagi alohida model chaqiruvlari, hooklar va vosita chaqiruvlarini batafsil ko‘rsatadi. Undan qimmat yoki sekin o‘zaro aloqalarni tekshirish va amallar ketma-ketligini tushunish uchun foydalaning.

Integratsiyalangan shell'dan foydalaning

Shell'ga ! belgisi orqali kiring. Bu cheklangan buyruq chiqishi paneli emas, balki haqiqiy terminaldir, shuning uchun to‘liq ekranli dasturlar shu joyning o‘zida ishga tushishi va har bir tugma bosilishini qabul qilishi mumkin.

Buyruqlar, skill skriptlari va workflow'lar tarmoqqa kirish huquqiga ega bo‘lgan mustaqil dasturlar ekanini unutmang. Ularni ishga tushirishdan oldin, ayniqsa nozik muhitlarda, nima qilishini tekshiring.

To‘liq foydalanuvchi qo‘llanmasini oching

Ichki foydalanuvchi qo‘llanmasini ochish uchun iCode ichida F8 tugmasini bosing. Xuddi shu hujjatlar repozitoriyning docs/ katalogida ingliz va soddalashtirilgan xitoy tillarida mavjud.

Maxfiylik va tashqi ulanishlar

iCode telemetriya, analitika yoki ishdan chiqishlar haqida hisobot yuborish funksiyasiga ega emas va ma’lumotlaringizni yig‘maydi. Odatiy holatda u hech narsani, jumladan foydalanish ma’lumotlarini ham, loyihaga yoki boshqa uchinchi tomonlarga yubormaydi.

Shunga qaramay, ma’lumotlar siz sozlagan manzillarga, jumladan model provayderlari, MCP serverlari, hooklar va OpenTelemetry eksportyorlariga uzatilishi mumkin. Veb-vositalar odatiy holatda o‘chirilgan. Ular yoqilgan bo‘lsa, qidiruvlar siz sozlagan provayderga yoki provayder sozlanmaganida Exa'ning umumiy mcp.exa.ai xizmatiga yuboriladi, sahifalar esa bevosita ularning veb-saytlaridan so‘raladi.

Muvofiqlik va litsenziyalash

iCode orkestratsiya vositasi bo‘lib, AI modelini taqdim etmaydi. Modellarni biznes yoki muhandislik maqsadlarida ulashda YI AI qonuni va boshqa amaldagi huquqiy yoki me’yoriy talablar bo‘yicha muvofiqlik uchun siz javobgarsiz.

Loyiha Apache License 2.0 asosida ochiq kodli hisoblanadi. Birga kiritilgan uchinchi tomon komponentlari o‘zlarining tegishli litsenziyalarini saqlab qoladi; ular repozitoriyning NOTICE faylida hujjatlashtirilgan.

Xulosa

uv, zamonaviy terminal va sozlangan model profili yordamida iCode'dan terminalga asoslangan AI agentlari va workflow'lar uchun markaziy interfeys sifatida foydalanishingiz mumkin. Oddiy suhbatdan boshlang, yaratilgan har bir fayl o‘zgarishini tekshiring, so‘ng vazifalaringiz murakkablashgani sari agent sozlamalari, workflow'lar, ortga qaytish, shell'ga kirish va Trajectory tahlilini o‘rganing.