Această pagină explică, în termeni simpli, modul în care awesome-repositories.com decide ce să îți afișeze și în ce ordine. Nu există nicio „cutie neagră” secretă — iată ce face sistemul în realitate.
Ce conține directorul
Directorul este o colecție curatoriată de repository-uri open-source de pe GitHub. Fiecare este preluat, apoi citit și analizat de AI: modelul parcurge fișierul README și documentația proiectului pentru a înțelege ce este, ce problemă rezolvă și unde se încadrează. Paginile cu relevanță scăzută, proiectele abandonate și duplicatele sunt eliminate în loc să fie păstrate doar pentru volum.
Nu indexăm fiecare repository de pe GitHub. Scopul este de a oferi un set mai restrâns de proiecte care merită atenția ta, descrise în mod consecvent, în loc să fim o oglindă exhaustivă a platformei.
Cum funcționează clasamentul căutării
Când efectuezi o căutare, sistemul colectează mai întâi proiectele candidate prin mai multe treceri paralele: o potrivire de cuvinte cheie în vocabularul nostru de tag-uri curatoriate, o potrivire semantică ce compară sensul interogării tale cu fiecare proiect (astfel încât termenii pe care nu i-ai tastat contează în continuare), o trecere care preia proiectele menționate direct și o trecere care accesează repository-urile pe care nu le-am analizat încă complet. Aceste liste de candidați sunt apoi combinate, astfel încât un proiect care apare în mai multe treceri este favorizat.
Un model AI citește apoi interogarea ta așa cum ar face-o o persoană — determinând intenția, tipul de instrument pe care îl cauți și caracteristicile concrete pe care ar trebui să le aibă o potrivire bună — și evaluează fiecare candidat pe rând, oferind un verdict de relevanță și o scurtă explicație în limbaj natural. Ordinea finală este un amestec ponderat: verdictul AI per proiect are cea mai mare pondere, completat de suprapunerea tag-urilor, filtrele setate de tine și semnalele de click reale, cu o penalizare pentru orice rezultat care conține un termen exclus de tine.
Dacă AI-ul nu este disponibil — din cauza unei întreruperi, a unei limite de cotă sau dacă este pur și simplu dezactivat — căutarea nu rămâne goală. Aceasta revine la o clasare deterministă bazată pe suprapunerea tag-urilor, filtrele tale și click-uri, astfel încât să primești în continuare rezultate relevante, doar că fără raționamentul AI pentru fiecare rezultat.
Cum primesc repository-urile descrierile și tag-urile
Scurta descriere, prezentarea pe scurt și etichetele fiecărui repository sunt generate de AI pe baza fișierului README și a documentației proiectului, nu sunt preluate de pe o pagină de marketing. Aceeași analiză plasează proiectul într-o taxonomie comună — o structură consistentă de cazuri de utilizare, ecosisteme și maturitate — astfel încât să poți filtra întregul director în loc să cauți prin etichete neorganizate.
Prompt-urile, regulile de punctaj și forma acelei taxonomii sunt ajustate și revizuite de noi și corectate atunci când modelul greșește.
Ce înseamnă o căutare curatoriată
Unele căutări sunt salvate ca pagini „curatoriate” — o interogare fixă, cum ar fi „framework-uri web Rust”, cu un URL stabil. Pe acele pagini, un editor poate fixa anumite repository-uri despre care consideră că aparțin categoriei. Proiectele fixate nu sunt clasate forțat pe primele locuri: ele sunt introduse în același grup de candidați și evaluate de același algoritm AI ca orice alt proiect, deci o selecție trebuie să își câștige poziția.
Actualitate și reanalizare
Repository-urile sunt resincronizate și reanalizate periodic pe măsură ce codul și documentația lor se schimbă, astfel încât descrierile și etichetele să nu devină perimate. Proiectele nou trimise sunt analizate înainte de a apărea în rezultatele clasate.
AI, cu supraveghere umană
Pentru claritate: AI-ul face munca grea aici — citește proiectele, construiește taxonomia și clasează fiecare căutare. Nu rulează nesupravegheat. Noi scriem și ajustăm prompt-urile, regulile de punctaj și limitele de curariere, revizuim rezultatele și le corectăm când sunt greșite. Scopul este să combinăm viteza și scalabilitatea AI-ului cu discernământul cuiva care folosește efectiv aceste instrumente.
Corecții
Crezi că un repository este clasat greșit, descris incorect sau lipsește? Spune-ne. Trimite un proiect de pe orice pagină sau trimite un email la hello@awesome-repositories.com iar noi vom analiza solicitarea.