بنکەی زانیاری / کۆد

کارکردن لە کۆگای git

Pro دەتوانێت لە ناو یەکێک لە کۆدگەیەکانی تۆدا (repositories) کار بکات وەک ئاژەنی کۆدنووس (coding agent) — خوێندنەوەی فایلە ڕاستەقینەکانت، و توانای نووسین و گۆڕینیان.

ئەم لاپەڕەیە بە ئامێری وەرگێڕدراوە بۆ ئاسانکاری. ئەسڵی ئینگلیزی ئەو وەشانەیە کە کاری پێدەکرێت.

بەستنەوەی کۆگایەک (repository)

?git، یان ئەو Git چەپ لە شریتی ئامرازەکاندا (toolbar)، پەیوەندی بە دابینکەرێکەوە دەکات: GitHub، GitLab، یان Gitea/Forgejo — کە Codeberg و ئەو ئینستانسە خۆ de-hostedـانە لە خۆ دەگرێت. تۆکە تایبەتی دەستگەیشتن (personal access token) بە ئاستێکی دیاریکراو، کۆگایەک (repository) و لقێک (branch) وەردەگرێت. کۆگایەک کە خۆی لە Nostr ڕادەگەیەنێت دەتوانرێت لەبری ناونیشانەکەی وەک ئەوەش لقی بکرێت.

پێویست ناکات ناوی کۆگاکە (repository) بنووسیت. تۆکەنەکە لکێنە و هەڵبژێرە لیستی بکە بەوەی ئەم تۆکەنە دەتوانێت بگاتە چی: Nymbot پرسیار لە forge دەکات کە ئەو token-ە چی دەبینێت و وەڵامەکە وەک لیستێک پیشان دەدات کە تۆ پشکنینی بۆ دەکەیت. پشکنینەکە هەر یەکێکیان بە لقە دیاریکراوی خۆیان (default branch) کە پێشتر پڕکراونەتەوە دەبەستێتەوە، و هەموویان لەم چاتەدا دادەنێت. هەر شتێک کە پێشتر بەستراوەتەوە وەک خۆی پیشان دەدرێت لەبری ئەوەی دووبارە پێشنیار بکرێتەوە. ئەو داواکارییە لە ئامێرەکەتەوە ڕاستەوخۆ بۆ forge دەچێت — نەک لە ڕێگەی Nymbot workerەوە — بۆ ئەوەی tokenەکە بۆ هیچ شوێنێک نەڕوات کە پێشتر ناچێت. forge-ێکی self-hosted کە داواکارییەکانی cross-origin ڕەتدەکاتەوە بە سادەیی ناتوانرێت لیست بکرێت؛ ناوی repository-ەکە بە دەست بنووسە و ئەوەی تر بە هەمان شێوە کار دەکات.

کاتێک پەیوەندی کرا، چիپەکە ناوی کۆگاکە (repository) و ئەو نامانە نیشان دەدات کە بە ... ناردوێنە مۆدێلی پرۆ هەڵبژێردراو لە ناو چوارچێوەی ئەو کۆگەیەی (repository) لەلایەنەوە کارپێکردووە. ?git disconnect لادەبات. پێوەبەستنsevering لە لیستی کۆگەکەدا (repository) تووکەنەکە لەبیر دەکاتەوە بەڵام کۆگەکە لەوێ دەهێڵێتەوە، بەو شێوەیەی کە دیاری دەکرێت هیچ تووکەنێکی نییە، بۆ ئەوەی بتوانیت دواتر یەکێکی نوێ زیاد بکەیت.

کۆگاکانی ڕاگەیەندراون لە Nostr

هەندێک کۆگاکانی کۆد (repositories) خۆیان لە Nostr ڕادەگەیەنن لەبری ئەوەی تەنها لە forge ڕابگەیەنرێن، بەکارهێنانی NIP-34 — پرۆتۆکۆڵەکە لە پشتەوەی ngit و gitworkshop. ڕاگەیاندنەکە ئەوەندەیە یەکێک لە ڕاگەیاندنەکانی Nostr کە ناوی پڕۆژەکە، بەڕێوەبەرانی، ئەو ڕێڵەیانەی کە پاتچە و کێشەکانی کۆد دەکەنەوە، و ئەو URL-انەی کە دەکرێت پڕۆژەکە لێیان کلۆن بکرێت لەخۆ دەگرێت. ڕاگەیاندنێکی دووەم دەڵێت هەر لقێک (branch) لە ئێستادا ئاڕاستەی کوێیە.

لصق بکە naddr یان یان nostr:// ناونیشانەکە لە ناو فۆرمی کۆگەکەدا بنووسە و کلیک بکە بەدوایدا بگەڕێNymbot ڕاگەیەندنی لە ڕێگەی ڕێڵەیەکانەوە دەخوێنێتەوە و فۆرمەکە پڕ دەکاتەوە: ئەو گیت هۆستەی لێی کۆلۆن کراوە، کۆگەی (repository) لەوێ، و ئەو لقەی (branch) کە پڕۆژەکە خۆی دەڵێت نوێیە. تۆ هێشتا بۆ ئەو هۆستە تۆکەنێک زیاد دەکەی، چونکە Nostr ڕاگەیاندنەکە هەڵدەگرێت و گیت سێرڤەرەکەش کۆدەکە هەڵدەگرێت.

کەواتە یاساکە تەنها ئەوەیە لە کوێوە کۆلۆن (clone) کراوە. کۆگایەک (repository) کە URL کۆلۆنکردنی لە GitHub، GitLab، Gitea یان Forgejo بوو — لەوانەش ئەو کۆگایانەی بە شێوەی self-hosted بەڕێوەدەبرێن — یەکەمە کە Nymbot دەتوانێت بخوێنێتەوە. یەکەمە تەنها لە ڕێگەی کۆلۆنکردنەوە... git:// یان ssh هیچ HTTP APIیەکی نییە بۆ خوێندنەوەی فایلەکان لە ڕێگەیەوە، و Nymbot دەڵێتەوە لەبری ئەوەی بە نیوەوە پەیوەندی بکات. لەو شوێنەی کە میزگەران (host) بە شێوەی تایبەتی میزبانی دەکرێت، دابینکەر لە ناو 명명ەکەیەوە دەخوازێت، و دەتوانیت پێش پاشەکەوتکردن ڕاستی بکەیتەوە.

کۆگایەک (repository) بەم شێوەیە زیاد کرابێت، نیشانەی هەیە ngit لە لیستیەکەدا، و وەڵامەکان پێی دەڵێن بەو ناوەی کە ڕادەگەیەنێت نەک بە ڕێگەی لەسەر ئاوێنەکە.

چی دەتوانێت بکات

پەیامێک لە ناو چوارچێوەی کۆدەکەدا (repo context) وەک ئاژەنێکی بچووک کار دەکات نەک تەنها وەک تەواوکردنێکی یەکجارە. مۆدێلەکە دەتوانێت لیستی دایرێکتۆرییەکان دابنێت، فایلەکان بخوێنێتەوە و لەناو پێکهاتەی فایلەکاندا بگەڕێت، پاشان بە بەکارهێنانی ئەوەوە وەڵام بداتەوە کە ڕاستەن ڕاستە دۆزیویەتیەوە — بەمەش وەڵامی پرسیاری "بۆچی خولی دووبارەکردنەوەکە زوو کۆتایی دێت" لە ڕێگەی کۆدەکەتەوە دەدرێت، نەک لە ڕێگەی خەمڵاندنێکەوە دەربارەی کۆدێک کە لە کۆدەکەت دەچێت.

بەشی ئەو لقەی دەبینێت کە پەیست کردووە، لە سەری ئێستایدا.

لەگەڵ سێرڤەرەکە کار دەکات بۆ چاتەکە چالاک کراوە، دەتوانێت داوا بکات فەرمانێک لە کۆدەکانتەوە جێبەجێ بکات، وەک تاقیکردنەوەکان، لە سێرڤەری Nymbot. هەر جێبەجێکردنێک چاوەڕێی ڕێگەپێدانەکەی تۆ دەکات.

نووسینکردن چالاک دەکەم

?git writes on توانای کۆمیتکردنی فایلەکان، دروستکردنی لقەکان (branches) و کردنەوەی داواکارییەکانی pull یان merge زیاد دەکات. بە شێوەیەکی دیاریکراو ناچالاکە، و باشترە تاوەکو کاتێک نەتەوێت، چالاک نەکرێت.

لەگەڵ بەردەوامبوونی نووسین، داوای گۆڕانکاری بکە و لەبری پاتچێک کە لە چاتدا لکاو کرابێت، بەدەستەوە دەهێنیت کە لقێک (branch) و داواکاریەک (pull request) بۆ پێداچوونەوە: هەر ئەرکێک کار لەسەر دەبێت لایەنێکی تایبەت بە خۆیهیچ شتێک بۆ لقە دیاریکراوەکەت (default branch) نەنێردرێت مەگەر ئەوەی کە ئەوە ڕاوەستێنیت، ئەوە ئەو لقەیە کە پۆڵت کردووە، و خۆت داوات کردووە.

دەستکارییەکانی ڕاکردنەکە وەک یەک کۆمیت (commit) بۆ هەر کۆگەیەک (repository) دەچێت، لە کۆتایی ڕاکردنەکەدا یان کاتێک مۆدێلەکە بڕیار دەدات پارچەیەک لە کارەکە تەواو بووە. ئەگەر حەز دەکەیت سەرەتا بیانوێت، کار پێ بکە پێش ئەوەی پابەند بیت، بپرسە بۆ ئەو کۆگەیەی (repository). پاشان کارەکە گۆڕانکارییەکانی ڕادەگرێت، وە وەڵامەکە وەک جیاوازییەکان (diff) نیشانی دەدات، و داوا بکە لە کاتێکدا ئەوان ئەنجامی دەدات دەستبەردار بە دەینێژێتە ناو خاشاکەوە. پێشگەیشتن هیچ تێچووی نییە.

بۆ هەر کارێک لقێک

لەگەڵ هەر کارێک بەشی تایبەت بە خۆی دەبێت کە کار دەکات، کە بۆ هەر کۆگایەک (repository) ڕاستە مەگەر ناچالاکت بکات، ئەرکێک کە کۆمیتەکان دەنووسێتە سەر لقێکی (branch) تایبەت بە خۆی، کە ناوی... nymbot/ و ناسنامەیەکی کورت. Nymbot ئەوە لە سەری لقە کارپێکەرەکە (working branch) دروست دەکات کاتێک کارەکە یەکەم کۆمیت (commit) ئەنجام دەدات، بۆیە ئەو کارەی تەنها خوێندنەوە دەکات هیچ لقێک دروست ناکات. خودی لقە کارپێکەرەکە دەستکاری ناکرێت، ئەمەش هۆکارە بۆ ئەوەی چەندین کار بتوانن لە یەک کاتدا بنووسن بۆ هەمان بۆماوە (repository) لەبری ئەوەی چاوەڕێی نوبەتی خۆیان بکەن.

کاتێک کارەکە تەواو دەبێت، Nymbot چی دەکات؟ کاتێک تەواو بوو دەڵێت. داواکارییەکی pull بکە ئایا ئەوەی ڕەچاوکراوە؛ پێشنیارکردنی یەکخستن دوگمەی Merge لە وەڵامەکەدا جێدەهێڵێت؛ شانگەکە جێبهێڵە هیچ شتێکی تری نییە. ڕێکخستنە سەرەکییەکە لە ڕێکخستنەکاندا دانراوە، لەژێر کاتێک لقەی ئەرکێک تەواو دەبێت, و هەر ڕێپۆزیتۆرییەک دەتوانێت بە شێوەیەکی جیاواز بە شێوازی خۆی هەڵبژێریت. ئەگەر فۆرجەکە هیچ APIیەک بۆ pull request-ەکان نەبێت کە Nymbot بتوانێت بەکاری بهێنێت، یان یەکێکیان ڕەت بکاتەوە، بڕەنچەکە وەک خۆی دەمێنێتەوە و وەڵامەکە ئاماژەی بۆ دەدات.

وەڵامەکە لقەکە نیشان دەدات بە... PR بکەرەوە, بەیەکەوە کردن و سڕینەوەو بە بەشی کارەکان (Tasks pane) لەگەڵ کارەکەدا ناوی دەبات. لە کاتێکدا کارەکە هێشتا بەڕێوەدەچێت، کارتەکەی، بەشی کارەکان و لیستی ئەو شتەی کە بەڕێوە دەچێت، ناوی لقەکە (branch) دەخەنە ڕوو هەر کە دروست بوو، لە سەرجەم ئامێرێک کە واژۆ کراوە بۆ هەژمارەکە. کارێک کە ڕاوەستاوە یان لە نیوەکەدا شکستی هێناوە هێشتا لقەکەی دەگەڕێنێتەوە، بۆ ئەوەی بتوانرێت تێکەڵ بکرێت، بسڕێتەوە یان وەک هەر شتێکی تر پاک بکرێتەوە. تێکەڵکردن (merge) بریتییە لە کۆمیتی تێکەڵکردن لە ڕێگەی داواکاری کێشانی (pull request) تایبەت بە forge خۆیەوە، کە بە کۆمیتەکە جێگیر کراوە کە Nymbot تۆری کردووە، بۆ ئەوەی کۆمیتە نوێیەکان کە لەو کاتەدا پاشەکەوت دەکرێن هەرگیز بەبێ بینین تێکەڵ نەکرێن. هیچ شتێک بە شێوەی زۆر (force-push) نەنێردرێت. ئەگەر لقەکە لەگەڵ لقەی کارکردنەکەدا دژایەتی هەبێت، وەڵامەکە پێشنیار دەکات PRەکە بکەرەوە بۆ چارەسەرکردن یان داوای لە Nymbot بکە بڕانچەکە نوێ بکاتەوە، کە لقە کارکەرەکە دەخاتە ناو ئەوەوە بە ڕێگەی commitی یەککردن (merge commit) لەبری rebasing. GitHub و Gitea یان Forgejo دەتوانن ئەوە بکەن؛ GitLab هیچ APIیەک بۆ ئەوە نییە، بۆیە لەوێ لە ڕێگەی داواکاری یەککردنەوە (merge request) چارەسەری دەکەیت.

گۆڕانکارییەکان بۆ فایلەکانی CI و workflow هێشتا چاوەڕێی پێداچوونەوەی تۆن، ڕێک وەک ئەوانەی کە لقێکی (branch) تایبەت بە خۆیان نییە.

ئەنجامدان ڕێگەی ڕاستەوخۆ بۆ سەر لقەکە (working branch) بکوژێنەوە. بەم شێوەیە کارێک تەنها دەستی بە کۆگەی (repository) خۆی دەبێت، و کارێکی دووەم لەسەر هەمان لق تەنها دەخوێنێتەوە تا ئەو کاتەی یەکەمەکە تەواو دەبێت. وەشانە کۆنەکانی ئەپڵیکەیشنەکەش بە هەمان شێوە کار دەکەن.

گەڕانەوە بۆ حاڵەتی پێشulo کە ڕاکردنێک گۆڕیویەتی

وەڵامێک کە بۆ کۆگەی تۆ نووسراوە دەڵێت چی دەستکاری کردووە: کۆگەکە، لقەکە، و هەموو فایلێک. ئەم گۆڕانکارییانە هەڵوەشێنەوە دەیانخاتەوە — هەر یەک لەو ڕێگایانە لەو کۆمیتەیەوە دەخوێندرێتەوە کە شاخەکە (branch) پێش کارکردنەکە لەسەری بووە و وەک خۆی کۆمیت کراوە. ئەرکێک کە کار لەسەر... شاخێکی تایبەت بە خۆی چەقی لقەکەی کارکردن بە تەنیا جێهێشت، بۆیە هیچ لەوێ نییە کە بیگەڕێندرێتەوە: سڕینەوە لقەکەی لادەبات لە جیاتی ئەوە.

ئەوە گەڕانەوەیە (revert)، نەک نووسینەوە. هیچ شتێک نەسڕاوەتەوە و هیچ مێژوویەکیش نەنووسراوەتەوە: ئەوەی Nymbot ئەنجامی دا لە تۆمارەکەدا (log) دەمێنێتەوە، تەنها چیتر حاڵەتی لقەکە (branch) نییە. هەر کەسێک لە نێوانەکەدا داتایەک ڕاکێشابێت، کۆپییەکی (checkout) دەبێت کە هێشتا کار دەکات.

هیچ تێچوونێکی نییە. هەڵوەشاندنەوە کاریگەری لەسەر هیچ مۆدێلێک نییە، بۆیە هیچ کرێیەک بەفیڕۆ نادات — دەستگەیشتن بە تۆکەنەکە لەگەڵ ئەو یەک داواکارییەدا دەڕوات وەک هەر داواکارییەکی تری، و هیچ شتێک لە چەکپۆینتەکەدا لە هیچ شوێنێکدا پاشەکەوت ناکرێت جگە لە لە ئامێرەکەی خۆتەوە.

نرخی ئەرکێکی کۆگەی (repo) چەندە

ئەرکێکی کۆدگۆڕ (repo) تا شەش بانگی کردنەوەی مۆدێل بەکاردەهێنێت — سەیری بکە، بخوێنەوە، بگەڕێ، وەڵام بدەوە — هەمووی بە نرخێکی مۆدێلەکەی دیاریکراو بەرهەڵدەهێنرێت نرخی Proتەنها ئەو بانگەشانەی بە ڕاستی بەکاردەهێنرێن کرێ دەکرێن، بۆیە وەڵامدانەوەی پرسیارێک لە یەک فایل تێچووی نزیکەی وەک وەڵامدانەوەیەکی ئاساییە.

ئەپەکە کۆتایی و ژمارەی پەیوەندییەکان ڕاپۆرد دەکات دوای هەر ئەرکێکی کۆگەکە (repo).

کاتێک کارێک شوێنی تێدا نامێنێت

ئەرکی کۆگاکردن (repository task) خولێکە، نەک تەنها یەک وەڵام: مۆدێلەکە لیستێکی ئۆپەرەیشن (directory) دەخوێنێتەوە، فایلێک دەخوێنێتەوە، لە دارۆکەدا (tree) گەڕان دەکات، یەکێکی تری دەخوێنێتەوە، و تەنها لەو کاتەدا دەنووسێت. ئەو خولە ڕێپێدانێکی هەیە — ژمارەیەک بانگکردنی مۆدێل کە وەڵامەکە کرێتی بۆ تەرخان کردووە — چونکە ئاژانێکی بێ سنوور، پسوولەیەکی بێ سنوورە.

کاتێک کارێک ڕێژەی دیاریکراوی بەکاربهێت لەکاتێکدا هێشتا کارێک ماوە، Nymbot ڕادەوەستێت، ئەوەی لایە پێدەیت و ئاگادارت دەکاتەوە. هیچ تێچوویەکی تریش ناکرێت.

دەتوانیت ڕێگەی پێ بدەیت بەردەوام بێت. بودجەی بەردەوامبوون لە ڕێکخستنەکاندا (Settings) دیاری بکە و کاتێک کارێک تەواو دەبێت، Nymbot ڕێپێدانێکی تری لە هەمان باڵانس دەڕاکێشێت، بە جۆرێک ڕێک لەو شوێنەی وەستاوە دەست پێ دەکاتەوە لەبری ئەوەی لە سەرەتای کۆگاکە (repository) دووبارە بخوێنێتەوە. هەنگاو بە هەنگاو دەڕوات، هەر هەنگاوێک تێچووی خۆی دەڵێت، و لەو ساتەی بودجەکە بەسەر بچێت، یان کارەکە تەواو دەبێت، یان تۆ دوگمەی ڕاوەستان (Stop) دەکەیت، ڕادەوەستێت. هەڵبژاردنی "تا کاتێک باڵانسم تەواو دەبێت" هێشتا وەک سنوورێکی باڵایە — ئەوە باڵانسەکەتە نەک ژمارەیەک کە تۆ نووسیوتە.

بە ئاسایی ئامێرەکەت هەر قۆناغێک دەەنێرێت، بۆیە کارێک تەنها لە کاتێکدا بەردەوام دەبێت کە ئەپەکە کراوە بێت. لەگەڵ ڕاکردنی پشتەوە کاتێک کار پێکراوە، سێرڤەرەکە هەنگاوی دواتر دەنێرێت، لە کاتی داخستنی ئەپەکەدا، لە ناو هەمان بودجەدا، لانی کەم ٤٠ هەنگاو و ٦ nothing کات، و جارێک پێ دەڵێت کاتێک ئەرکەکە تەواو بوو. بۆ ئەوە ئەنجامی دەدات بەوەی تۆکەنی کۆگای (repository token) بە کلیلێک داخراوە کە تەنها خۆی هەڵی دەگرێت لە کاتی کارکردنی ئەرکەکەدا، و دەینوسێنێتەوە کاتێک ئەرکەکە کۆتایی دێت و هەمیشە لە ناو ٦ کاتژمێردا. ئەرکێکی پاشبنکەیی (background task) دەنووسێتە لقەکەی خۆی وەک هەر ئەرکێکی تر.

سەبارەت بەو نیشانەیە

چونکە سینک دەبێت، ئەو چاتەی کە کۆگایەکەی بەکاردێنێت لە هەموو ئەو ئامێرەی کە تێیدا چوونەژوورەوە کار دەکات بەبێ ئەوەی دووبارە پەیوەندی پێوە بکەیتەوە. بڕینی پەیوەندی کۆگاکە لەسەر ئامێرێک، تۆکەنەکە لەسەر ئەوانی تر دەسڕێتەوە. تۆکەنەکە هەرگیز ناچێتە ناو سێرڤەر بەڕێوەبەرەکۆنەینەری {}