Claude Code-da geri qaytarma: checkpoint nədir və nəyi bərpa etmir

Agent faylları həqiqətən dəyişir və bəzən düz olanı yox. Nasazlıqdan yox - sadəcə tapşırığı sizin nəzərdə tutduğunuzdan fərqli başa düşüb. Yaxşı xəbər budur: kodun snapshotunu Claude Code özü çəkir, sizin köməyiniz olmadan, və uğursuz cəhdi bir neçə klik ilə geri qaytarmaq olur.

Pis xəbər isə odur ki, bu snapshotların sərhədi var. Agentin fayllara yazdığı hər şey qorunan sahə daxilində olur və oradan onu geri qaytarmaq mümkündür. Bu sahədən kənarda qalan hər şey isə - hasarın o tayında: snapshotlar onu görməyib və geri qaytara bilməyəcək. Hasarın harada keçdiyini əvvəlcədən bilmək daha yaxşıdır, nəsə itəndə yox.

Aşağıda - geri qaytarma necə işləyir, hasarı harada keçir, nə qədər yaşayır və hasarın o tayında qalanı nə ilə örtmək olar.

Checkpoint nədir

Checkpoint - agentin düzəliş etmək üzrə olduğu faylların, ona toxunmazdan əvvəl çəkilmiş snapshotudur. Layihənin ehtiyat nüsxəsi yox, versiya tarixçəsinə yazı da yox, cari sessiya daxilindəki işlək bərpa nöqtəsi, yəni agentlə söhbətiniz daxilindəki nöqtə.

Bu bölməni oxumağın əsas səbəbi: snapshot hər mesajınızdan əvvəl avtomatik çəkilir. Onu özünüz yaratmırsınız, tənzimləmirsiniz və basmağı unuda bilməzsiniz. Mesajı göndərdiniz - nöqtə artıq var.

Ardıcıllığa diqqət edin: əvvəl snapshot, sonra düzəlişlər. Elə buna görə nöqtəyə qayıtmaq "kodu bu mesajdan əvvəlki halına qaytar" deməkdir. Siz zamanda bir anı yox, konkret öz mesajınızı seçirsiniz, ondan sonrakı hər şeyi ləğv etmək üçün.

Davamı üçün asan olsun deyə daha bir dəqiqləşdirmə. Checkpoint kod haqqındadır. Claude Code söhbəti də geri qaytara bilir, amma bu menyuda ayrı seçimdir: kod və söhbət birlikdə, ya da ayrı-ayrı qaytarılır - siz qərar verirsiniz.

Geri qaytarma menyusu necə açılır

Giriş iki yoldur, ikisi də eyni işi görür:

• daxiletmə sətrindəki /rewind əmri. Onun tanış təxəllüsləri də var: /undo və /checkpoint;
• daxiletmə sətri boşdursa, Esc Esc düymələri.

Bu sessiyadakı mesajlarınızın siyahısı açılacaq. Fayllar siyahısı yox, zaman şkalası da yox - məhz mesajlar, göndərdiyiniz hər biri üçün bir sətir. İşlərin xarab olduğu nöqtədən sonrakını seçirsiniz.

Ayrıca hal: əgər əvvəl elə həmin işə salınmış agentdə /clear etmisinizsə, yeni versiyalarda siyahının başında əlavə sətir görünür. O, təmizləmədən əvvəlki söhbətə qaytarır. Təmizləmə, gördüyünüz kimi, heç nəyi məhv etmir.

Menyu nə təklif edir

Nöqtəni seçdiniz - agent onunla dəqiq nə etmək istədiyinizi soruşur. Altı variant var:

Bu cədvəl haqqında bilməyə dəyən birinci şey: menyunun tərkibi dəyişir. Kodla bağlı iki punkt yalnız seçilmiş nöqtədən sonra agent həqiqətən faylları dəyişibsə göstərilir. Dəyişməyibsə, qaytaracaq bir şey yoxdur və bu sətirlər sadəcə olmayacaq. Ona görə menyuda altı yox, dörd punkt çıxıbsa, proqramınız elə eynidir.

Summarize ilə başlayan iki sətir ayrı dayanır. Onlar kodla yox, söhbətin uzunluğu ilə işləyir: onun bir hissəsini qısa xülasəyə çevirir. Diskdəki fayllara ümumiyyətlə toxunmurlar. Bu nə üçün lazım olur - ayrıca və geniş mövzudur, burada isə bunun geri qaytarma olmadığını və kodun bu yolla qaytarılmadığını bilmək kifayətdir.

Sinirləri qoruyan kiçik bir detal. Söhbət qaytarıldıqdan sonra elə həmin mesajın mətni daxiletmə sətrinə geri qayıdır. Nə yazdığınızı xatırlayıb yenidən yazmağa ehtiyac yoxdur - ifadəni düzəldib yenidən göndərin.

Geri qaytarma nəyi bərpa edir, nəyi yox

Öz zonasında geri qaytarma etibarlıdır. O, iki şeyi bərpa edir: agentin öz redaktə alətləri ilə etdiyi fayl düzəlişlərini və bu sessiyadakı söhbət tarixçəsini.

Hasarın o tayında qalan isə budur.

• Terminaldakı əmrlərlə edilən dəyişikliklər. Agent təkcə faylları redaktə etmir, əmrləri də işə sala bilir. Fayl rm əmri ilə silinibsə, köçürülübsə və ya kopyalama ilə üzərinə yazılıbsa, snapshot bunu görməyib və geri qaytara bilməyəcək.
• Agentin yanından keçən dəyişikliklər. Agentin bu sessiyada toxunmadığı fayllara geri qaytarma ümumiyyətlə toxunmur: onları özünüz redaktorda düzəltmisinizsə, başqa proqram üzərinə yazıbsa, yanında ikinci sessiya işləyibsə - bunların hamısı olduğu kimi qalır, menyu vasitəsilə nə bərpa etmək, nə də ləğv etmək mümkündür. Amma agentin də redaktə etdiyi faylı özünüz əl ilə düzəltmisinizsə, kodun bərpası onu snapshota tam qaytaracaq - sizin düzəlişiniz də daxil olmaqla.
• Subagentlərin düzəlişləri. Agent işin bir hissəsini köməkçi subagentə tapşırıbsa, onun düzəlişləri adətən snapshotlara düşmür və geri qaytarma onları bərpa etməyəcək. Onları git vasitəsilə geri qaytarırlar.
• Simvolik keçidli (symlink) fayllarla nadir hal. Belə faylları geri qaytarma buraxır və bu barədə ayrıca sətirdə açıq yazır. Rastlaşsanız, özünüz anlayacaqsınız, xüsusi hazırlıq lazım deyil.

Lap qısa desək: geri qaytarma agentin fayllara nə yazdığına baxır, kompüterdə baş verən hər şeyə yox.

Geri qaytarma nə qədər yaşayır

Snapshotlar sonsuz yığılmır. Menyudakı nöqtələrin hamısı siyahıdadır, snapshotlar isə yalnız son yüz nöqtə üçün saxlanılır: bir söhbət üçün bu çoxdur, amma sonsuz deyil, köhnələr isə tədricən sıradan çıxarılır.

Amma nöqtələr açıq terminal pəncərəsinə bağlı deyil. Onlar sessiya ilə birlikdə saxlanılır, ona görə terminalı bağlayıb sabah geri qayıda, eyni söhbətə davam edə bilərsiniz - geri qaytarma menyusu heç nə olmamış kimi işləyəcək.

Tamamilə uzun müddət də qalmır. Sessiyalar və onların snapshotları təxminən bir aydan sonra avtomatik silinir, müddət istəyə görə tənzimlənir.

Buradan sadə nəticə çıxır: geri qaytarma bir tapşırığın üfüqündə - dəqiqələr, saatlar, agentlə bir söhbət - yaxşı işləyir. O, layihə tarixçəsinin anbarı kimi düşünülməyib və bu, çatışmazlıq deyil, sadəcə başqa işdir. Daha uzun müddətləri kim örtür - bunu sonra araşdırırıq.

Dörd sığorta, hər birinin öz işi

Ləğv etmə, snapshot, qovluq nüsxəsi və versiya tarixçəsi - eyni şeyin dörd adı deyil. Onlar müxtəlif müddətləri və müxtəlif itki növlərini örtür.

Sığortanı əvvəlcə əhatə dairəsinə, sonra müddətinə görə seçirlər. Claude adi faylları öz redaktə alətləri ilə dəyişirsə və sessiya hüdudlarından kənara çıxmırsa, beş dəqiqəlik eksperimenti checkpoint yaxşı örtür. İşdə terminaldakı əmrlər və ya xarici dəyişikliklər varsa, müddət nə qədər qısa olsa da, təkcə checkpoint yetərli deyil. Yalnız əhatə dairəsinə uyğun gələn sığortalar arasından müddətə baxın: bir neçə günlük iş və ya vacib mərhələ agentlə söhbətdən asılı olmayan mexanizm tələb edir.

Qovluq nüsxəsi haqqında düz demək lazımdır. Qorxulu nəsə qarşısında birdəfəlik tədbir kimi işə yarayır: kopyaladınız, sındırmağa girişdiniz, alınmadı - geri qaytardınız. Sistem kimi isə yaşamır. Bir həftədən sonra demək olar ki, eyni bir neçə qovluğunuz olur və hansının təzə olduğunu artıq heç kim xatırlamır.

Son sətir yeganədir ki, həm vəziyyətləri uzun müddət saxlaya bilir, həm də onlar arasında dəqiq nəyin dəyişdiyini göstərir. Bu, git-dir və bu, ayrıca böyük mövzudur: öz aləti, öz əmrlər dəsti, burada onu açmırıq. Cədvəldəki yerini başa düşmək kifayətdir: ən uzun üfüq və geri qaytarmanın örtmədiyindən yeganə qoruma.

Bu, iş tərzini necə dəyişir

Məsələ o qədər də düymələr dəstində deyil. Geri qaytarmadan praktikada bunlar çıxır:

• snapshot özü çəkilir, amma demək olar ki, pulsuz olan yalnız Claude-un redaktə alətləri ilə adi fayllar üzərində edilən eksperimentdir. Terminaldakı əmrlər və ya sessiya hüdudlarından kənar dəyişikliklər lazım gələcəksə, əvvəlcə başqa sığorta seçin;
• agent sizin əvəzinizə geri qaytarmır. O, yanlış getdiyini deyə bilər, amma menyunu açıb seçən sizsiniz;
• terminalda əmr işə salmaq xahişi fayl düzəlişindən fərqli hərəkət sinfidir. Birincini geri qaytarma örtməyəcək, ikincini örtəcək. Fərq yalnız sorğunun mətnində görünür, ona görə də onu oxumaq dəyər;
• addım nə qədər böyükdürsə, geri qaytarmadan fayda bir o qədər azdır. Qaytarmaq mümkündür, amma agent nə qədər çox iş görübsə, bir menyudan dəqiq nəyin qayıtdığını anlamaq bir o qədər çətinləşir. Xırda addımlar burada da qazanır;
• geri qaytarma və versiya tarixçəsi rəqabət aparmır. Birincisi bir söhbət daxilindəki dəqiqələri və saatları örtür, ikincisi - günləri, həftələri və layihənin mərhələlərini.

Geri qaytarma menyusunun tərkibi və saxlanma müddətləri Claude Code-un versiyasından və tənzimləmələrdən asılıdır, ona görə sizinki burada təsvir olunandan fərqlənə bilər. Sizin versiyanızın nə təklif etdiyini həmişə menyunun özü göstərəcək.