Zrkadlenie OneDrive

Na karte OneDrive v Projekte zrkadlite Projekt alebo pracovný priestor sandboxu so svojím OneDrivom. Súbory sa synchronizujú oboma smermi, takže súbor pridaný alebo zmenený na jednej strane sa objaví na druhej.

Pripojenie OneDrivu a voľba priečinka

Nainštalujte onedrive v Nastavenia → Pluginy → Dostupné pluginy. Na karte OneDrive v Projekte zvoľte Pripojiť OneDrive, vyberte celý Projekt alebo priečinok v ňom a potom Spustiť zrkadlenie. Vyberáte priečinok vnútri Projektu, nie miesto v OneDrive: Elowen priečinok v OneDrive založí za vás, v nadradenom priečinku nastavenom v nastaveniach pluginu (Priečinok v OneDrive). Pracovné priestory sandboxu možno pripojiť oddelene od Projektu a každý má vlastný priečinok v OneDrive. V OneDrive sú zrkadlenia Projektov a pracovných priestorov v oddelených podpriečinkoch pod nastaveným koreňovým priečinkom. Vybraný podpriečinok si v OneDrive zachová svoju cestu, takže sa dve zrkadlenia priečinkov navzájom neprepíšu.

Plugin potrebuje zapnutého poskytovateľa identity Microsoft, napríklad Microsoft Teams. Účet, ktorý nie je prepojený s Microsoftom, namiesto ovládania zrkadlenia uvidí hlásenie, že nie je pripojený. Spravované Projekty a ich pracovné priestory sandboxu potrebujú na synchronizáciu bežiace prostredie Projektu; ak karta hlási, že prostredie nebeží, spustite ho.

Vybraný priečinok je hranicou: synchronizujú sa jeho súbory a podpriečinky, zvyšok Projektu nie. Keď napríklad zrkadlíte docs/ a upravíte docs/guide.md v OneDrive, ďalší cyklus zmenu premietne do tohto súboru v Projekte, zatiaľ čo zmena v src/ zostane mimo zrkadlenia. Každý zrkadlí do svojho prepojeného účtu OneDrive, nie do spoločného účtu. Súbor .gitignore Projektu sa rešpektuje. Súbory správy verzií, závislosti, súbory .env, súkromné kľúče, úložiská prihlasovacích údajov a kôš synchronizácie sa vylučujú vždy. Ďalšie vzory glob môžete pridať v nastaveniach pluginu.

Kontrola a ovládanie zrkadlenia

Karta ukazuje priečinok v OneDrive, stav synchronizácie, poslednú synchronizáciu, počet súborov a nevyriešené konflikty. Stavy sú Synchronizované, Prebieha synchronizácia, Pozastavené, Čaká na prvú synchronizáciu, Čaká na vaše rozhodnutie, Čaká na potvrdenie a Vyžaduje pozornosť. Karta Projektu navyše ukazuje indikátor OneDrive a počet nevyriešených konfliktov. Projekt možno zrkadliť priamo a každý aktívny spravovaný worktree sandboxu možno pripojiť samostatne. Historické pozastavené prepojenia z vyradených miestnych pracovných priestorov zostávajú zachované. Aktívne zrkadlenia worktree sa na karte OneDrive v Projekte zobrazujú pod Pracovné priestory sandboxu, jeden riadok na pracovný priestor, každý s vlastným stavom a tlačidlami.

Tlačidlom Synchronizovať teraz vyžiadate okamžitú synchronizáciu, tlačidlom Pozastaviť zastavíte automatické cykly a tlačidlom Obnoviť ich znovu spustíte. Druhá požiadavka sa pripojí k cyklu, ktorý pre daný účet už beží. Keď prihlásenie k Microsoftu vyprší, zrkadlenie ukáže Vyžaduje pozornosť a požiada o nové prihlásenie; ďalšia úspešná synchronizácia hlásenie vymaže. Výpadok overovania Microsoftu stav zrkadlenia nijako nezmení a ďalší automatický cyklus to skúsi znova. Ak sa stratí prístup k Projektu, zmizne vybraný priečinok alebo sa zmení prepojená identita Microsoft, zrkadlenie sa pozastaví, namiesto toho aby prešlo na iný priečinok či účet. Zostane pozastavené, kým ho nespustíte. Kratší interval znamená častejšie kontroly a viac požiadaviek na Microsoft Graph. Zrkadlenia, ktoré sa prekrývajú v tom istom priečinku Projektu, na seba navzájom čakajú.

Odpojiť zastaví synchronizáciu, ale súbory v OneDrive ponechá. Odstránenie Projektu alebo účtu zrkadlenie zruší bez toho, aby vymazalo vzdialený priečinok.

Pozastavenie, odpojenie alebo voľba iného priečinka na zrkadlenie zastaví bežiaci cyklus na ďalšej hranici operácie. Už odoslaný prenos môže dobehnúť, ale zastavený cyklus už nezačne ďalšiu zmenu, nezapíše tento prenos do starej základne ani neprepíše stav pozastavenia. Miestne aj spravované zrkadlenia pred pokračovaním overia zapnuté prepojenie, jeho vybraný podpriečinok a pôvodný disk, položku a cestu v OneDrive. Zastavia sa aj vtedy, keď už nemožno obnoviť nárok ich workera.

Riešenie konfliktov súborov

Keď sa súbor pred synchronizáciou zmení na oboch stranách, zostanú obe verzie. Kópia z OneDrive sa uloží vedľa súboru v Projekte s názvom ako notes.onedrive-conflict-2026-09-23-06-15-00.md pre notes.md. Miestne aj spravované zrkadlenia zachovajú pôvodnú príponu a keď je názov už obsadený, pridajú číselnú príponu. Spravované konfliktné kópie vznikajú iba na voľnom mieste, takže súbor vytvorený počas sťahovania zostane zachovaný a cyklus ohlási chybu zápisu. Skôr zaznamenané názvy konfliktov zostávajú bez zmeny. Karta tento súbor pozastaví, kým nezvolíte Použiť verziu z projektu, alebo Použiť verziu z OneDrivu. Ak sa kópia v OneDrive počas rozhodovania zmení, plugin vás požiada o voľbu proti novšej kópii. Pri prvej synchronizácii miestneho priečinka sa súbory, ktoré sú na oboch stranách už rovnaké, stanú predvolenou základňou, namiesto toho aby sa označili ako konflikt. Pri spravovaných Projektoch to zatiaľ neplatí: rovnaké súbory na oboch stranách sa uchovajú ako konfliktné kópie. Súbor, ktorý sa práve ukladá, počká na ďalší cyklus.

Použiť verziu z OneDrivu presunie vašu kópiu v Projekte do .elowen-trash a na jej miesto postaví kópiu z OneDrive. Použiť verziu z projektu nahrá vašu kópiu cez súbor v OneDrive a ponechanú kópiu z OneDrive presunie do .elowen-trash. Ani jedna voľba súbor nevymaže natrvalo.

Konflikty spravovaného Projektu a worktree môžete vyriešiť na karte OneDrive. Ponechanie verzie z projektu ju nahrá iba vtedy, keď je vzdialená kópia stále tá zobrazená. Ponechanie verzie z OneDrivu použije už stiahnutú konfliktnú kópiu a predchádzajúcu verziu z projektu ponechá v koši synchronizácie. Ak sa niektorá z verzií zmenila, synchronizujte znova, aby sa ukázal aktuálny konflikt. Pozastavenie alebo odpojenie zastaví ďalšie operácie; prenos, ktorý už začal, môže dobehnúť.

Obnova odstránených súborov

V predvolenom stave sa odstránený zrkadlený súbor v OneDrive presunie v Projekte do .elowen-trash, odkiaľ ho môžete obnoviť. Keď vypnete Premietať odstránenia z OneDrivu v nastaveniach pluginu, miestna kópia zostane a znova sa nahrá do OneDrive. Odstránenie súboru v Projekte zvyčajne vymaže aj jeho kópiu v OneDrive; kontrola hromadného mazania túto akciu pozastaví, keď naraz zmizne príliš veľa súborov.

Keď z Projektu naraz zmizne viac súborov a mazanie je nezvyčajne veľké, zrkadlenie počká na potvrdenie, namiesto toho aby vzdialené súbory vymazalo. Stane sa to, keď chýba viac ako 34 % sledovaných súborov alebo aspoň 50 súborov. Skontrolujte, či je priečinok Projektu úplný, a potom toto konkrétne mazanie potvrďte tlačidlom Odstrániť … súborov z OneDrivu. Keď neskôr chýbajúcich súborov zase pribudne, potvrdenie je potrebné znova.

Skôr zrkadlený súbor, ktorý začnú vylučovať ďalšie vzory ignorovania alebo pravidlá Gitu, sa odoberie zo základne synchronizácie. Jeho kópia v OneDrive aj prípadná miestna kópia zostanú nedotknuté, aj keď bol miestny súbor už odstránený. Pravidlá ignorovania platia aj pre súbory v OneDrive bez základne, takže ďalšie cykly vylúčený súbor nevrátia ani neprepíšu miestne úpravy. Ignorované súbory sa nepočítajú do celkového počtu sledovaných súborov, ktorý sa používa na potvrdenie hromadného mazania. Súbory vynechané preto, že sa práve ukladajú, sú príliš veľké alebo nečitateľné, si základňu ponechajú.

Keď sken nedokáže prečítať celý vybraný priečinok, OneDrive vráti neúplný výpis alebo Elowen nedokáže určiť, ktoré súbory .gitignore vylučuje, cyklus sa preskočí a stav sa zmení na Vyžaduje pozornosť. Bráni to tomu, aby sa neúplný pohľad zamieňal za odstránené súbory. Stav uvádza dôvod, napríklad vypršané prihlásenie k Microsoftu, priečinok, ktorý nešlo prečítať celý, alebo súbory, ktoré nešlo synchronizovať, takže viete, či meniť nastavenia, alebo sa znova pripojiť.

Nastavenia synchronizácie OneDrivu

Administrátor upravuje celoinštalačné nastavenia v detaile pluginu v Nastavenia → Pluginy. Tieto predvolené hodnoty platia pre všetkých; každý si naďalej pripája vlastný účet Microsoft a volí vlastný priečinok na zrkadlenie.

Formulár nastavení ukazuje interval synchronizácie v sekundách a limit veľkosti súboru v MiB pri každom číselnom poli. Jeden MiB je 1 048 576 bajtov; uložené hodnoty si zachovávajú rovnaký význam. Krátke nápovedy zostávajú viditeľné a podrobný návod nájdete pod ikonou nápovedy. Karta Projektu si ponecháva hierarchický výber priečinkov.

Sken pokrýva najviac 20 000 súborov, ktoré zostanú po uplatnení pravidiel ignorovania. Keď ich má Projekt viac, neúplný sken sa preskočí a žiadne mazania sa nevykonajú. Keď OneDrive nedovolí vypísať priečinok celý alebo miestny sken zlyhá, tento cyklus synchronizácie mazania nevykoná.

Symbolické odkazy sa preskakujú, nenasledujú. Dva súbory, ktorých názvy sa líšia iba veľkosťou písmen alebo formou Unicode, sa preskočia oba, pretože ich OneDrive považuje za jeden názov, takže sa ani jeden nezrkadlí.

Súbory väčšie ako nastavený limit zostanú v oboch smeroch bez zmeny a nesynchronizujú sa. Nevytvárajú stav prekročenia limitu ani hlásenie o vynechanom súbore. Súbor vynechaný skenom si ponechá základňu, aby ho nešlo zameniť za odstránený.

Inštalácia a oprávnenia

Verziu core, ktorá plugin obsahuje, nájdete v manifeste pluginu a na marketplace. OneDrive vyžaduje UI API 62 a jednorazový runner sandboxu hostiteľa. Inštaluje ho administrátor v Nastavenia → Pluginy → Dostupné pluginy. Plugin sa prideľuje používateľom, takže ho administrátor musí prideliť v Používatelia → Povolené pluginy, kým ho účet, vrátane účtu samotného administrátora, môže použiť. Nemá žiadne meniace schopnosti, ktoré by vyžadovali ďalší súhlas.

Zapnutie, vypnutie, inštalácia alebo zmena pluginu reštartuje Elowen. Obrazovka nastavení hlási „Zmena je uložená. Elowen sa teraz reštartuje, aby ju načítala.“ Keď reštart nemôže prebehnúť hneď, hlási „Zmena je uložená. Prejaví sa pri najbližšom spustení démona.“ Synchronizácia OneDrive beží podľa intervalu alebo keď zvolíte Synchronizovať teraz; s týmito reštartmi nesúvisí.

Ďalej: Weby