Jinsi ya Kutumia AI OpenHands: Mwongozo wa Vitendo wa Usanidi, Mawaidha na Utiririshaji wa Kazi Halisi
Ikiwa umewahi kutamani msanidi programu mahiri aweze kushirikiana nawe kuandaa programu 24/7, AI OpenHands inakaribia sana. Ni "mhandisi wa AI" wa chanzo huria ambaye anaweza kusoma repo yako, kuandika msimbo, kuendesha vituo, kuvinjari hati na kurudia—sawa na msanidi mdogo ambaye anajifunza haraka na anafanya kazi bila kuchoka. Lakini uwezo huonekana tu unapoisanidi kwa usahihi na kujifunza jinsi ya kuiendesha.
Mwongozo huu unakuongoza jinsi ya kutumia AI OpenHands hatua kwa hatua—kuanzia usakinishaji hadi utiririshaji wa kazi wa hali ya juu—ili uweze kusafirisha haraka zaidi kwa ujasiri.
- Chaguo za usakinishaji na kuanza haraka
- Kuendesha OpenHands ndani ya nchi au na mifumo ya wingu
- Mbinu bora za mawaidha, repos, na majukumu
- Utiririshaji wa kazi uliothibitishwa kwa kazi ya vipengele, utatuzi, majaribio na hati
- Njia za ulinzi, faragha na ushirikiano
Inafaa kuzingatia: OpenHands inatengenezwa kikamilifu na timu ya All Hands na jumuiya. Hati rasmi ndio dira yako ya maelekezo na vidokezo vya sasa. Unaweza pia kufuata miongozo ya usakinishaji inayofanya kazi kutoka kwa watendaji ambao wameandika usanidi wa ndani na VM. Kwa kuendesha na mifumo ya ndani, hati hizo zinajumuisha mwongozo maalum pia.
AI OpenHands ni Nini—na Kwa Nini Uitumie?
Fikiria AI OpenHands kama mshirika wa AI aliye na kibodi. Tofauti na wasaidizi wa gumzo pekee, OpenHands inaweza:
- Kufungua na kusoma faili za mradi
- Tumia kituo kuendesha amri, majaribio na linters
- Hariri msimbo katika faili na saraka
- Vinjari wavuti (kulingana na usanidi)
- Pendekeza na utumie mipango ya hatua kwa hatua
Hii inafanya kuwa bora kwa kazi kama vile kutekeleza vipengele, kurekebisha hitilafu, kuandika majaribio, kuunda hati, kurekebisha na kuboresha misimbo. Badala ya kuhangaika na mawaidha na kunakili/kubandika, unampa OpenHands lengo na kuiruhusu irudie, huku ukisimamia hatua zake.
Mwanzo wa Haraka: Njia ya Haraka Sana ya Kutumia OpenHands
Kuna njia kadhaa za kuanza. Chaguo lako linategemea ikiwa unataka kutumia LLM ya wingu au kuendesha kila kitu ndani ya nchi.
Chaguo A: Tumia LLM ya Wingu (rahisi zaidi)
- Fuata hati rasmi za "Anza Kujenga" na "Kuanza" ili kusakinisha na kuendesha programu. Kwa kawaida uta:
- Sakinisha mahitaji ya awali (Docker, Node, Python, Git kulingana na njia)
- Toa ufunguo wa API kwa mfumo wa wingu unaotumika (mfano, OpenAI, Anthropic, au zingine ambazo mradi unasaidia wakati huo)
- Zindua kiolesura cha OpenHands na uunganishe hifadhi yako
Njia hii inakufanya uwe na tija haraka na gharama ndogo ya kompyuta.
Chaguo B: Endesha OpenHands na LLM ya Ndani
- Ikiwa unapendelea kuweka msimbo na mawaidha nje ya wingu au unataka kuepuka gharama za API, tumia mwongozo wa LLM za Ndani katika hati rasmi.
- Sanidi mfumo unaoendana wa ndani (kupitia Ollama au sehemu zingine za nyuma zinazotumika wakati huo)
- Sanidi ncha za mfumo na mipaka ya muktadha
- Hakikisha mashine yako ina VRAM/CPU na nafasi ya diski ya kutosha
Chaguo C: Sambaza kwa VM
- Ikiwa unahitaji mazingira maalum, watendaji wameandika jinsi ya kuendesha OpenHands kwenye VM na kuunda programu kwa dakika. Hii ni muhimu kwa timu ambazo zinataka mfumo thabiti, ulioshirikiwa wa mhandisi wa AI.
Uendeshaji wa Kwanza: Usanidi wa Mradi na Uundaji Kazi
OpenHands huangaza wakati inaweza kuona msimbo wako. Anza kwa:
- Kufungua hifadhi unayotaka ifanye kazi nayo.
- Kuendesha au kuorodhesha mradi ili OpenHands iweze kuweka ramani ya muundo.
- Kuipa lengo wazi na vikwazo.
Mfano mzuri wa uundaji kazi:
- "Ongeza urejeshaji wa nenosiri la mtumiaji kwenye huduma ya
auth kwa kutumia viungo vya barua pepe vinavyotegemea tokeni. Tumia moduli iliyopo ya mailer. Ongeza majaribio ya kitengo kwa utengenezaji na muda wa kumalizika wa tokeni. Usibadilishe schema ya data ya mtumiaji."
Kwa nini hii inafanya kazi:
- Inataja kipengele, wigo, utegemezi na mipaka. Kadiri unavyokuwa wazi, ndivyo OpenHands inapanga na kutekeleza vizuri zaidi.
Jinsi ya Kuandika Mawaidha Madhubuti kwa OpenHands
Fikiria mawaidha kama tiketi fupi. Bora zaidi:
- Eleza matokeo: "Tekeleza X na vikwazo vya Y"
- Rejelea faili, moduli, au majaribio: "Ona
auth/routes.py na tests/test_auth.py"
- Eleza vikwazo: "Hakuna mabadiliko ya schema ya DB; weka violesura vilivyopo"
- Jumuisha vigezo vya kukubalika: "Majaribio yanapaswa kupita:
pytest -k password_reset"
Kiolezo unachoweza kutumia tena:
Lengo: <Unachotaka kujengwa au kurekebishwa>
Muktadha: <Faili zinazofaa, vikwazo vinavyojulikana, huduma za nje>
Kukubalika: <Jinsi kupita kunavyoonekana: majaribio, ncha, metriki>
Mipaka: <Usichobadilishe au mbinu za kuepuka>
Zana: <Amri inazoweza kuendesha, hati, au vyanzo vya data>
Utiririshaji wa Kazi Mkuu: Panga → Tekeleza → Thibitisha → Safisha
OpenHands kwa kawaida hupendekeza mpango wa hatua nyingi. Hivi ndivyo unavyoiongoza:
- Idhinisha au urekebishe mpango wake mapema. Isukume kuendesha majaribio kwanza ili kuweka msingi wa kushindwa.
- Iulize kuunda au kusasisha jaribio ili kufafanua mafanikio, kisha utekeleze msimbo.
- Iweke iendeshe seti ya majaribio na linters mara kwa mara.
- Ikiwa inakwama, ongeza muktadha zaidi: majina ya faili, athari za mrundikano, au kumbukumbu.
Kidokezo: Himiza mabadiliko madogo ya ukubwa wa PR badala ya uhariri mkuu. Hii husaidia na uwezo wa kukagua na kurudisha nyuma.
Mifano ya Utiririshaji wa Kazi Unayoweza Kunakili
1) Utekelezaji wa Kipengele
- Kidokezo: "Ongeza usafirishaji wa CSV kwenye ukurasa wa
orders. Tumia upangaji wa seva, matokeo ya mkondo kupitia text/csv. Ongeza kitufe cha Export katika OrdersTable.jsx na ncha katika routes/orders.ts. Jumuisha majaribio ya upangaji na vichwa."
- Huchanganua repo; huandaa mpango
- Huongeza ncha na kitufe cha mteja
- Huandika majaribio na kuyaendesha
- Unasimamia, unaidhinisha mabadiliko, na kuunganisha mara tu ikiwa kijani.
2) Utatuzi wa Ujenzi Unaoshindwa
- Kidokezo: "CI inashindwa kwenye Node 20. Rekebisha hitilafu za uagizaji wa ESM/CJS katika
build.mjs. Weka programu-jalizi zilizopo za kusongesha; sasisha usanidi na msimbo ili kupitisha CI."
- Toa kumbukumbu au uunganishe na vizalia vya CI.
- Omba OpenHands kuiga ndani ya nchi (
npm run build) na kupendekeza tofauti ndogo.
3) Ufikiaji wa Jaribio na Uimarishaji
- Kidokezo: "Ongeza ufikiaji wa
payments/service.py kutoka 62% hadi 85%+. Ongeza majaribio ya kitengo kwa retry_charge, refund, webhook_signature. Usibadilishe mantiki ya biashara isipokuwa jaribio litaonyesha hitilafu."
- Acha OpenHands itengeneze majaribio, iyaendeshe, na iyasafishe.
4) Hati na Uzoefu wa Msanidi Programu
- Kidokezo: "Unda
CONTRIBUTING.md na DEVELOPMENT.md kwa repo hii. Jumuisha usanidi wa mazingira, hati, amri za majaribio, na miongozo ya PR."
- Iweke ithibitishe amri kwa kuziendesha haswa.
Njia za Ulinzi: Weka OpenHands Kusaidia na Salama
- Wigo wa saraka: ionyeshe kwenye repo au saraka maalum ili kuepuka uhariri wa bahati mbaya mahali pengine.
- Ulinzi wa faili: Weka alama faili za usanidi au miundombinu muhimu kama ya kusoma tu inapowezekana.
- Ukaguzi wa amri: Hitaji idhini kwa amri za uharibifu (mfano,
rm -rf, kuweka upya hifadhidata).
- Usafi wa siri: Kamwe usibandike funguo za API kwenye mawaidha. Tumia vigezo vya mazingira na kumbukumbu zilizofichwa.
- Ufikiaji wa mtandao: Ikiwa kuvinjari kumewashwa, iweke kwenye sandbox na uingie simu zinazotoka.
Mifumo ya Ndani dhidi ya Wingu: Kuchagua Kinachokufaa
- Faida: Hoja/uandishi wa msimbo wenye nguvu, usanidi mdogo, urudiaji wa haraka
- Hasara: Gharama inayoendelea, mazingatio ya usimamizi wa data
- Faida: Faragha, udhibiti, utabirika wa gharama
- Hasara: Mahitaji ya maunzi, ubora wa mfumo hutofautiana, utengenezaji zaidi unahitajika
Ona maagizo rasmi ya LLM za Ndani ili kusanidi sehemu za nyuma za mfumo na mipaka ya kumbukumbu.
Uchezaji wa Timu: Kutumia OpenHands katika Utiririshaji wa Ushirikiano
- Utiririshaji wa kazi wa tawi la kwanza: Iweke OpenHands itengeneze tawi la kipengele na isukume mabadiliko kwa ukaguzi wa PR.
- Usafi wa ahadi: Iulize itoe ahadi za atomiki na ujumbe wazi na nambari za suala la marejeleo.
- Violezo vya PR: Tengeneza na uimarishe violezo vya PR ili wakaguzi wajue kilichobadilika na kwa nini.
- Wamiliki wa msimbo: Unganisha na CODEOWNERS ili kuelekeza PR zilizozalishwa na AI kwa wakaguzi sahihi.
Kutatua Masuala ya Kawaida
- Inakwama au inarudia: Punguza wigo. Iulize ieleze hatua yake inayofuata. Toa jaribio linaloshindwa.
- Tofauti chafu: Omba mpango mdogo, ulioratibiwa—majaribio kwanza, kisha mabadiliko madogo ya msimbo.
- Uhariri wa faili usio sahihi: Bainisha njia halisi na uikumbushe mipaka.
- Kupita ndani ya nchi lakini kushindwa katika CI: Shiriki maelezo ya mazingira ya CI na kumbukumbu; iweke irudie na chombo.
Vidokezo vya Utendaji na Hatua za Nguvu
- Muktadha wa mwanzo-joto: Iulize isome faili muhimu kwanza (
README, package.json, faili kuu za huduma).
- Ipe hati: Toa
make test au npm run verify ili iweze kuthibitisha haraka.
- Fundisha kikoa: Toa muhtasari mfupi wa usanifu; inalipa kwa makosa machache ya kimantiki.
- Imarisha mtindo: Elekeza kwa usanidi wa
.eslintrc, .prettierrc, black/ruff ili fomati kwa usahihi.
- Tumia vituo vya ukaguzi: Baada ya kila hatua muhimu, omba muhtasari na hatua zinazofuata ili kuiweka kwenye mstari.
Hali Halisi: Kutoka Ripoti ya Hitilafu hadi Kiraka kwa Saa Moja
- Hali: Hitilafu ya uzalishaji inadondosha 500s ambazo hazijashughulikiwa kwenye upakiaji wa JSON uliopotoka katika API ya
orders.
- Kidokezo chako: "Zalisha upya 500 kwenye JSON iliyopotoka katika
orders POST. Ongeza uthibitishaji wa schema na urudishe 400 na maelezo ya hitilafu. Sasisha majaribio ili kufidia upakiaji uliopotoka."
- Huendesha API ndani ya nchi, huzalisha upya hitilafu
- Huongeza safu ya uthibitishaji na kishughulikiaji cha hitilafu
- Husasisha majaribio na kuhakikisha CI inapita
- Hutoa PR iliyoshikamana na ingizo la kumbukumbu ya mabadiliko
Muda uliookolewa: Umezingatia uchambuzi wa athari na uzinduzi, wakati OpenHands ilishughulikia scaffolding.
Ujumuishaji Unaoboresha OpenHands
- Waendeshaji wa jaribio: pytest, Jest, Vitest, JUnit
- Zana za ujenzi: Vite, Webpack, Rollup, Babel
- Wasimamizi wa vifurushi: npm, pnpm, yarn, pip/poetry
- Linters/formatters: ESLint, Prettier, black, ruff
- Vyombo: Docker Compose kwa usawa wa ndani na CI
Kwa kusanifisha zana hizi, OpenHands inaweza kufikiria juu ya mrundikano wako kwa uhakika zaidi na kujiendesha zaidi ya kitanzi cha dev.
Kwa Njia: Kutumia Sider.AI Pamoja na OpenHands
Alama ya Umuhimu: 8/10. Ikiwa unatumia OpenHands kama mhandisi wako wa AI, inafaa kuiunganisha na rubani wa utafiti na uandishi kwa vipimo, maelezo ya PR, na hati. Kwa njia, Sider.AI inaweza kukusaidia kuandaa haraka vipimo vya kiufundi, kufupisha RFC, au kubadilisha kumbukumbu za uendeshaji za OpenHands kuwa kumbukumbu safi za mabadiliko na matoleo. Mchanganyiko hupunguza ubadilishaji wa muktadha: OpenHands hushughulikia hatua za msimbo wakati Sider.AI inabadilisha matokeo kuwa hati safi, zinazoelekezwa kwa mtumiaji.
Orodha ya Usalama, Faragha na Uzingatiaji
- Weka siri katika vars za env; kamwe usipachike funguo kwenye mawaidha
- Kagua kila mabadiliko yanayozalishwa na AI kama vile ungefanya PR ya msanidi programu mdogo
- Ingia amri na hatua kwa ukaguzi
- Bandika matoleo ya zana; epuka uboreshaji wa bahati mbaya katika faili za kufuli
- Ikiwa unatumia LLM za wingu, lingana na sera zako za uhifadhi wa data
Wakati Usitumie OpenHands
- Ubunifu mpya wa algorithm bila jaribio kali au scaffolding ya vipimo
- Misimbo iliyodhibitiwa sana bila mchakato thabiti wa ukaguzi
- Hati za kutupwa mara moja ambapo uandishi wa msimbo wa mikono ni haraka
Dakika zako 60 za Kwanza na OpenHands: Kitabu Kidogo cha Uchezaji
- Dakika 0–10: Sakinisha na uzindue kwa kutumia Mwanzo wa Haraka rasmi
- Dakika 10–20: Unganisha repo yako; iulize iweke ramani ya muundo wa mradi
- Dakika 20–35: Fafanua lengo dogo, linaloweza kujaribiwa; idhinisha mpango wake
- Dakika 35–50: Iache itekeleze na iendeshe majaribio; isukume inavyohitajika
- Dakika 50–60: Kagua tofauti, safisha, na uunganishe kwenye tawi la kipengele
Viungo Muhimu na Hatua Zinazofuata
- "Anza Kujenga" rasmi na hati za matumizi za OpenHands: vidokezo, mwanzo wa haraka, na mbinu bora.
- Mwongozo wa usanidi wa LLM ya Ndani: sanidi na uendeshe OpenHands kabisa kwenye mashine yako.
- Mwongozo wa usakinishaji unaoendeshwa na jumuiya kwenye VM: hatua halisi za usakinishaji na mradi wa onyesho la haraka.
Mambo Muhimu
- Unda kazi kama tiketi zilizo na vigezo wazi vya kukubalika.
- Weka marudio madogo; jaribu mapema na mara kwa mara.
- Tumia njia za ulinzi na ukague mabadiliko—ichukulie kama mshirika mdogo wa timu.
- Chagua wingu kwa urahisi, mifumo ya ndani kwa faragha.
- Oanisha na zana za hati (mfano, Sider.AI) ili kuharakisha vipimo na maelezo ya toleo.
Maswali Yanayoulizwa Mara kwa Mara
Swali la 1:Ninawezaje kusakinisha na kuanza kutumia AI OpenHands haraka?
Tumia mwanzo wa haraka rasmi ili kusakinisha mahitaji ya awali, chomeka LLM inayotumika (wingu au ya ndani), na uzindue UI ili kuunganisha hifadhi yako. Hati za "Anza Kujenga" hutoa maagizo ya hatua kwa hatua na vidokezo vya usanidi.
Swali la 2:Je, ninaweza kuendesha OpenHands na LLM ya ndani badala ya mfumo wa wingu?
Ndiyo. Fuata mwongozo wa LLM za Ndani ili kusanidi sehemu ya nyuma ya mfumo wa ndani na urekebishe mipangilio ya muktadha. Hii ni bora kwa miradi nyeti kwa faragha au kuepuka gharama za API.
Swali la 3:Ni njia gani bora ya kuelekeza OpenHands kwa kazi za uandishi wa msimbo?
Andika mawaidha kama tiketi fupi: fafanua lengo, rejelea faili maalum, weka mipaka, na ujumuishe vigezo vya kukubalika. Iulize itengeneze au iendeshe majaribio ili kuthibitisha maendeleo.
Swali la 4:Je, AI OpenHands ni salama kutumia kwenye msimbo wa uzalishaji?
Ichukulie kama msanidi programu mdogo: tumia ulinzi wa tawi, ukaguzi wa msimbo, na CI ili kuthibitisha mabadiliko. Ongeza njia za ulinzi kwa amri na uweke siri nje ya mawaidha.
Swali la 5:OpenHands inalinganishwaje na msaidizi wa msimbo wa jadi?
Tofauti na zana za gumzo pekee, OpenHands inaweza kuendesha amri, kuhariri faili, na kurudia kwa uhuru ndani ya repo yako. Imejengwa kwa kazi za mwisho hadi mwisho kama vile vipengele, utatuzi, na majaribio.
