# GitHub सिंक

डिवाइस कोड या टोकन से GitHub जोड़ें, प्रोजेक्ट को नई या मौजूदा रिपो के रूप में पब्लिश करें, मशीनों के बीच पुश और पुल करें, और जानें कि आपका टोकन कैसे सुरक्षित रहता है।

GitHub सिंक वैकल्पिक रूप से मशीन के बाहर बैकअप और बहु-कंप्यूटर हस्तांतरण देता है, और यह उस [असली Git रिपो](/docs/git-history/) पर बना है जो हर प्रोजेक्ट पहले से ही है। लोकल कमिट GitHub के बिना काम करती हैं। जुड़ने पर भी तस्वीर में कोई Oleafly अकाउंट नहीं आता: केवल आपका GitHub।

## अपना अकाउंट जोड़ना

Settings, **Integrations**, **GitHub**, फिर दो में से कोई एक रास्ता:

- **Connect GitHub** (अनुशंसित): एक डिवाइस-कोड प्रवाह। Oleafly एक छोटा कोड दिखाता है, आपका ब्राउज़र `github.com/login/device` खोलता है (कोड के लिए एक **Copy** बटन के साथ), आप मंज़ूरी देते हैं, और ऐप कुछ ही सेकंड में उसे पहचान लेता है। कनेक्शन केवल `repo` और `read:user` स्कोप माँगता है।
- **Personal access token**: अगर आप खुद का क्रेडेंशियल बनाना पसंद करते हैं, तो "Advanced: use a personal access token" खोलकर कोई PAT पेस्ट करें।

एक बार जुड़ने पर, आपका अवतार और उपयोगकर्ता नाम Settings में और ऊपरी टूलबार के GitHub मेन्यू में दिखने लगते हैं। **Disconnect** टोकन भूल जाता है।

### आपका टोकन कैसे सुरक्षित रहता है

टोकन एक AES-256-GCM एन्क्रिप्टेड, स्वामी-प्रतिबंधित स्थानीय फ़ाइल में सहेजा जाता है और कभी ऐप की UI परत को नहीं सौंपा जाता; इंटरफ़ेस को केवल इतना ही पता चलता है कि "connected as @you"। जब Git को प्रमाणीकरण की ज़रूरत होती है, तो टोकन एक इन-मेमोरी क्रेडेंशियल हेल्पर से इंजेक्ट किया जाता है, इसलिए वह कभी कमांड लाइन में, `.git/config` में या आपके शेल इतिहास में नहीं दिखता। रिमोट URL में टोकन जोड़ने वाले पुराने बिल्ड शुरू होते ही अपने आप साफ़ हो जाते हैं।

## कोई प्रोजेक्ट पब्लिश करना

Source Control पैनल में **Publish to GitHub** पर क्लिक करें:

- **Create new repository**: कोई नाम चुनें (प्रोजेक्ट से पहले से भरा हुआ), **Private** (अनुशंसित) को चेक्ड रखें या हटाएँ, और **Create and push** करें। Oleafly रिपो बनाता है, प्रोजेक्ट की फ़ाइलें कमिट करता है, `origin` जोड़ता है, और पुश करता है।
- **Link existing**: अपनी रिपॉज़िटरी की खोज योग्य सूची में से चुनें (प्राइवेट वालों पर ताला दिखता है) और **Link and push** करें।

पब्लिश करने के बाद, टूलबार का GitHub मेन्यू **Open in GitHub** और **Copy repository link** देता है।

### जो फ़ाइलें सीक्रेट जैसी दिखती हैं वे स्थानीय रहती हैं

पब्लिश करते समय कभी वे फ़ाइलें कमिट नहीं होतीं जो आम तौर पर कुंजियाँ या पासवर्ड रखती हैं, जैसे `.env`, `*.pem`, SSH प्राइवेट की, या `credentials.json`। वे प्रोजेक्ट फ़ोल्डर में अनस्टेज्ड रहती हैं, और डायलॉग उनके नाम बताता है। फिर भी किसी एक को पब्लिश करने के लिए, उसे Source Control में खुद स्टेज करके कमिट करें। `.env.example` जैसे टेम्पलेट, पब्लिक की और Keynote की `.key` फ़ाइलें हमेशा की तरह पब्लिश होती हैं।

पुश पूरा इतिहास अपलोड करता है। अगर इनमें से किसी नाम की फ़ाइल कभी कमिट हुई हो, तो Oleafly उसकी सूची देता है और GitHub पर कुछ भी बनाने से पहले **Cancel** या **Publish anyway** की प्रतीक्षा करता है।

## रोज़मर्रा का सिंक

Source Control पैनल के **Push** और **Pull** बटन वही करते हैं जो कहते हैं, आपकी मौजूदा ब्रांच पर `origin` के साथ। **Fetch** और **Sync** **More Source Control actions** मेन्यू में हैं, और **Commit & Push** तथा **Commit & Sync** **Commit** के बगल के मेन्यू में। ब्रांच पिल के बगल का **ahead/behind** संकेतक (↑ ↓) बताता है कब कुछ पुश या पुल करना है।

### दो कंप्यूटर

1. मशीन A पर: प्रोजेक्ट पब्लिश करें, काम करें, **Push** करें।
2. मशीन B पर: वही GitHub अकाउंट जोड़ें, फिर **Import a project → GitHub** चुनें और रिपॉज़िटरी चुनें। [इंपोर्ट गाइड](/docs/import-project/#import-from-github) देखें। उसके बाद: **Pull**, काम करें, **Push** करें।
3. वापस A पर: शुरू करने से पहले **Pull** करें। संकेतक आपको याद दिला देता है।

कवर रंग, मुख्य-डॉक्यूमेंट चुनाव और इतिहास सब साथ चलते हैं, क्योंकि वे प्रोजेक्ट फ़ोल्डर में ही रहते हैं।

## अपना मन बदलना

एक बार रिमोट सेट होने पर, **More Source Control actions** मेन्यू में दो और आइटम आ जाते हैं:

- **Change repo** पब्लिश डायलॉग दोबारा खोलता है ताकि `origin` कहीं और इशारा करे।
- **Unlink** रिमोट हटा देता है; स्थानीय प्रोजेक्ट और उसका इतिहास अछूते रहते हैं।

## कंफ़्लिक्ट और ब्रांच

अगर किसी pull में मर्ज कंफ़्लिक्ट आए, तो Source Control कंफ़्लिक्ट वाली फ़ाइलों की सूची देता है। हर एक के लिए **Use current** या **Use incoming** चुनें, या फ़ाइल एडिट करके **Mark resolved** चुनें, फिर **Complete merge** करें। **Abort merge** फ़ाइलों को पहले जैसा कर देता है। Push और Pull उसी ब्रांच पर काम करते हैं जो आपने चेक आउट की है, और पैनल के शीर्ष का ब्रांच मेन्यू ब्रांच बदलता या बनाता है। [Git और सोर्स कंट्रोल](/docs/git-history/#branches-and-stashes) देखें।

## सीमाएँ, साफ़-साफ़

Oleafly HTTPS रिमोट प्रमाणीकृत करता है। Publish आपके लिए एक सही रिमोट सेट कर देता है।

## अगर कुछ विफल हो

- "No remote 'origin'": पहले पब्लिश करें; Push और Pull को एक रिमोट चाहिए।
- रिमोट में कमिट पहले से मौजूद होने के कारण Push अस्वीकृत: पहले pull करें, फिर push करें।
- "No GitHub token set": Settings, Integrations, GitHub में जाकर जोड़ें।

और जानकारी [FAQ](/docs/faq/#history-and-collaboration) में।
