Ukuqalisa nge-Ars Umbris: Faka futhi Uhlole i-IDE Yolwazi Olunezinhlobo, Eyakhelwe Ama-Agent

Yini i-Ars Umbris?

I-Ars Umbris iyi-IDE eguquguqukayo, eyenzelwe ama-agent, yolwazi olunezinhlobo. Ihlanganisa ulwazi, izinhlobo, amakhono, amathuluzi, nezingxenye ze-UI kumarepository ahlanganisekayo angancika komunye nomunye.

Le phrojekthi ifunda la marepository njengegrafu eyodwa enohlobo. Ihlola izinkambu nezinkomba, bese inikeza ukuhlolwa kwezinkinga ama-agent angakwazi ukukusebenzisa. Abantu nama-agent bangasebenzisa izisekelo nama-SDK afanayo ukwakha amathuluzi, ukwengeza ukubukwa, nokushintsha uhlelo lokusebenza.

I-Ars Umbris okwamanje ise-early alpha, ngakho lindela iziphazamiso nezinguquko ezingahambisani nezinguqulo zangaphambilini. Okwamanje isekela i-macOS kuphela.

Indlela I-Architecture Ehlanganisana Ngayo

I-Ars Umbris ihlelwe yaba izingqimba ezintathu eziyinhloko. Ukuziqonda kukusiza ukunquma ukuthi ubheke kuphi lapho ulungisa noma unweba uhlelo.

1. au-engine

au-engine iyinjini yegrafu ewela ama-repository, eyakhelwe phezu kwesisekelo samafayela esinezinhlobo. Ikhomba amafayela kuwo wonke ama-repository bese iwaguqula abe yigrafu ephilayo, enezinhlobo futhi engabuzwa.

Le njini iphinde isebenzise ulimi lokwenza izinhlobo olwenziwe ngokukhethekile lwamafayela e-Markdown ne-YAML. Ukuze uthole imininingwane eyengeziwe, funda i-au-engine.md.

2. au-host

au-host iwuhlelo lokusingatha lwe-Electron. Ixhoma ama-projection anohlobo, noma ukubukwa, phezu kwegrafu futhi isekele ukuhlanganiswa okuqhutshwa ukucushwa kwedatha enohlobo.

Lokhu kuhlanganiswa kungahlelwa futhi kungaqhutshwa abantu kanye nama-agent. Bheka i-au-host.md ukuze uthole imibhalo ye-host.

3. au-mcp

au-mcp inikeza ungqimba olwandisekayo lwama-agent. Iveza amathuluzi namakhono anohlobo nge-MCP futhi ixhumana ne-agent harness oyikhethayo ngama-adapter.

Funda i-au-mcp.md ukuze ufunde kabanzi ngongqimba lwe-MCP.

Lungiselela Ukufakwa

Inqubo yokufaka isebenzisa ama-directory amabili:

• ~/arsumbris/ igcina ama-repository amaningi e-Ars Umbris.
• ~/.arsumbris/ igcina amafayela okucushwa e-Ars Umbris.

Ngenxa yokuthi le phrojekthi isebenza ku-macOS kuphela futhi isathuthukiswa ngenkuthalo, buyekeza izimfuneko ngaphambi kokwenza izinguquko ohlelweni. Imiyalelo yokufaka ekhona manje ku-repository iyona mthombo ogunyaziwe wesoftware edingekayo kanye nokulandelana kokusetha.

Faka I-Entry-Point Repository

I-README incoma ukuthi ucele i-agent yakho yenze ukufakwa ngemiyalelo elandelayo:

Please help me install Ars Umbris.

1) Create two folders if they do not already exist:
   - ~/arsumbris/ will hold multiple repositories.
   - ~/.arsumbris/ will hold configurations.

2) Clone the entry-point repository:
   git clone https://github.com/arsumbris/arsumbris.git ~/arsumbris/arsumbris
   If that destination already exists, inspect it before proceeding; do not overwrite it.

3) Read ~/arsumbris/arsumbris/INSTALL.md and follow its current setup process.
   Check prerequisites and explain any changes needed on my machine before making them.

Isinyathelo esibalulekile sokuphepha ukuhlola i-directory ekhona ethi ~/arsumbris/arsumbris ngaphambi kokwenza i-clone. Ungabhali phezu kwe-checkout ekhona. Ngemva kokuba i-repository isitholakala, vula i-INSTALL.md bese ulandela imiyalelo yayo yamanje ngokulandelana okubhaliwe.

Landela Inqubo Yamanje Yokusetha Ye-Repository

1. Qinisekisa ukuthi usebenzisa i-macOS.
2. Dala i-~/arsumbris/ ne-~/.arsumbris/ uma zingekho.
3. Hlola ukuthi i-~/arsumbris/arsumbris isivele ikhona yini.
4. Uma ingekho, yenza i-clone ye-repository ngomyalo othi git clone https://github.com/arsumbris/arsumbris.git ~/arsumbris/arsumbris.
5. Uma isikhona, yihlole esikhundleni sokuyishintsha.
6. Funda i-~/arsumbris/arsumbris/INSTALL.md.
7. Hlola futhi ufake izimfuneko ezicaciswe yilelo fayela, ubuyekeze izinguquko ezihlongozwayo emshinini ngaphambi kokuzisebenzisa.
8. Qedela izinyathelo ezisele zokusetha ngokulandelana okubhalwe ku-INSTALL.md.

Ngenxa yokuthi i-Ars Umbris isathuthukiswa ngenkuthalo, gwema ukuthembela emiyalweni yokusetha ephelelwe yisikhathi evela emithonjeni yezinkampani zangaphandle. Sebenzisa umhlahlandlela wokufaka we-repository oyikhiphile enguqulweni oyifakayo.

Imiqondo Eyisisekelo Yokusebenzisa

I-Ars Umbris yakhelwe phezu kwama-repository aqukethe ulwazi namakhono anohlobo. I-repository ingaqukatha ulwazi, izincazelo zezinhlobo, amakhono, amathuluzi, nezingxenye ze-UI. Ama-repository nawo angancika kwamanye ama-repository, okwenza amakhono nolwazi kuphinde kusetshenziswe kuwo wonke amaphrojekthi.

Ngokujwayelekile, ukuhamba komsebenzi kubukeka kanje:

1. Beka noma wenze i-clone yama-repository ahlobene ngaphansi kwe-~/arsumbris/.
2. Vumela i-au-engine ikhombe isisekelo samafayela kuwo wonke lawo marepository.
3. Sebenzisa igrafu enohlobo ewumphumela ukusebenza ngedatha exhunyiwe, izinkambu, nezinkomba.
4. Sebenzisa i-au-host ukuxhuma ama-projection nokubukwa phezu kwegrafu.
5. Xhuma i-agent harness nge-au-mcp nama-adapter e-MCP.
6. Sebenzisa ama-agent noma abasebenzisi abangabantu ukuhlola ukuhlolwa kwezinkinga, ukwakha amathuluzi, ukwengeza ukubukwa, nokushintsha uhlelo lokusebenza.

I-README ayinqumi iphrojekthi eyisibonelo eyodwa noma ukuhamba komsebenzi komugqa womyalo. Imiyalo yakho ngqo kanye nama-projection atholakalayo kuncike ekusetheni okuchazwe ku-INSTALL.md nakuma-repository owaxhumayo.

Ukusebenza Nama-agent Nge-MCP

I-Ars Umbris yakhelwe ukuxhumana ne-agent harness nge-Model Context Protocol. Ungqimba lwe-au-mcp lunikeza amathuluzi namakhono anohlobo, kuyilapho ama-adapter exhuma lawo makhono ku-harness oyikhethayo.

Lokhu kuvumela i-agent ukuthi isebenze ngezisekelo nama-SDK afanayo asetshenziselwa ukwakha uhlelo lokusebenza. Empeleni, i-agent ingabamba iqhaza ekwakheni amathuluzi, ekwengezeni ukubukwa, nasekushintsheni uhlelo lokusebenza, ngokuhambisana namakhono nokucushwa okutholakala ekufakweni kwakho.

Amathiphu Athuthukile Nokucatshangelwa Kokuphepha

Gcina Ama-Repository Ehlanganiseka

Hlela ulwazi namakhono kube ama-repository angasetshenziswa futhi axhunywe kabusha. Ukuncika phakathi kwama-repository kuyingxenye esemqoka yemodeli yephrojekthi, ngakho cabanga ngama-repository njengezingxenye zegrafu eyodwa enohlobo, hhayi njengamafolda ahlukene.

Sebenzisa Ukuxilonga Njengempendulo

Injini ihlola izinkambu nezinkomba kuyo yonke igrafu enohlobo. Thatha imiphumela yayo yokuxilonga njengempendulo lapho uhlela i-Markdown enohlobo, i-YAML, noma okunye okuqukethwe okuhlobene nama-repository, ikakhulukazi lapho i-agent yenza izinguquko.

Funda Imibhalo Yezingqimba

Lapho udinga ukuqonda indlela yokuziphatha, bheka imibhalo yesendlalelo esifanele: injini, umsingathi, noma isendlalelo se-agent ye-MCP.

Buyekeza Izinguquko Ngaphambi Kokuzisebenzisa

Umyalelo wokufaka uncoma ngokukhethekile ukuchaza izinguquko ezidingekayo emshinini ngaphambi kokuzenza. Landela le ndlela yokuqapha efanayo lapho uvumela ama-agent ukuthi aguqule ama-repository noma ukucushwa.

Qaphela Imodeli Yamanje Yezokuphepha

i-Ars Umbris isebenzisa ikhodi emshinini wakho futhi okwamanje ayinakho ukuvalelwa endaweni ephephile. Buyekeza SAFETY.md ngaphambi kokusebenzisa iphrojekthi, ikakhulukazi lapho uxhuma ama-agent noma usebenza nama-repository ongawalawuli ngokuphelele.

Isiphetho

i-Ars Umbris ihlanganisa igrafu enohlobo phakathi kwama-repository, umsunguli osuselwe ku-Electron, kanye nesendlalelo se-agent ye-MCP ibe yi-IDE yokuhlola yolwazi olunohlobo. Ukuze uqalise, lungisa izinkomba ezimbili zokucushwa, klona i-repository yendawo yokuqala ngaphandle kokubhala phezu kwamafayela akhona, bese ulandela i-INSTALL.md yayo yamanje. Uma isifakiwe, hlola ukuthi ama-repository, ukuqagela, amathuluzi, amakhono, nama-agent asebenzisana kanjani, ube ugcina engqondweni isimo se-alpha sephrojekthi kanye nemodeli yayo yokusebenzisa ikhodi ngaphandle kokuvalelwa endaweni ephephile.