Zrcadlení OneDrive

Na kartě OneDrive v Projektu zrcadlete Projekt nebo pracovní prostor sandboxu se svým OneDrivem. Soubory se synchronizují oběma směry, takže soubor přidaný nebo změněný na jedné straně se objeví na druhé.

Připojení OneDrivu a volba složky

Nainstalujte onedrive v Nastavení → Pluginy → Dostupné pluginy. Na kartě OneDrive v Projektu zvolte Připojit OneDrive, vyberte celý Projekt nebo složku v něm a pak Spustit zrcadlení. Vybíráte složku uvnitř Projektu, ne místo v OneDrivu: Elowen složku v OneDrivu založí za vás, v nadřazené složce nastavené v nastavení pluginu (Složka v OneDrive). Pracovní prostory sandboxu lze připojit odděleně od Projektu a každý má vlastní složku v OneDrivu. V OneDrivu jsou zrcadlení Projektů a pracovních prostorů v oddělených podsložkách pod nastavenou kořenovou složkou. Vybraná podsložka si v OneDrivu zachová svou cestu, takže se dvě zrcadlení složek navzájem nepřepíšou.

Plugin potřebuje zapnutého poskytovatele identity Microsoft, například Microsoft Teams. Účet, který není propojený s Microsoftem, místo ovládání zrcadlení uvidí hlášení, že není připojený. Spravované Projekty a jejich pracovní prostory sandboxu potřebují pro synchronizaci běžící prostředí Projektu; pokud karta hlásí, že prostředí neběží, spusťte ho.

Vybraná složka je hranicí: synchronizují se její soubory a podsložky, zbytek Projektu ne. Když třeba zrcadlíte docs/ a upravíte docs/guide.md v OneDrivu, další cyklus změnu promítne do tohoto souboru v Projektu, zatímco změna v src/ zůstane mimo zrcadlení. Každý zrcadlí do svého propojeného účtu OneDrive, ne do společného účtu. Soubor .gitignore Projektu se respektuje. Soubory správy verzí, závislosti, soubory .env, soukromé klíče, úložiště přihlašovacích údajů a koš synchronizace se vylučují vždy. Další vzory glob můžete přidat v nastavení pluginu.

Kontrola a ovládání zrcadlení

Karta ukazuje složku v OneDrivu, stav synchronizace, poslední synchronizaci, počet souborů a nevyřešené konflikty. Stavy jsou Synchronizováno, Probíhá synchronizace, Pozastaveno, Čeká na první synchronizaci, Čeká na vaše rozhodnutí, Čeká na potvrzení a Vyžaduje pozornost. Karta Projektu navíc ukazuje indikátor OneDrivu a počet nevyřešených konfliktů. Projekt lze zrcadlit přímo a každý aktivní spravovaný worktree sandboxu lze připojit samostatně. Historická pozastavená propojení z vyřazených místních pracovních prostorů zůstávají zachovaná. Aktivní zrcadlení worktree se na kartě OneDrive v Projektu zobrazují pod Pracovní prostory sandboxu, jeden řádek na pracovní prostor, každý s vlastním stavem a tlačítky.

Tlačítkem Synchronizovat nyní vyžádáte okamžitou synchronizaci, tlačítkem Pozastavit zastavíte automatické cykly a tlačítkem Obnovit je zase spustíte. Druhý požadavek se připojí k cyklu, který pro daný účet už běží. Když přihlášení k Microsoftu vyprší, zrcadlení ukáže Vyžaduje pozornost a požádá o nové přihlášení; další úspěšná synchronizace hlášení smaže. Výpadek ověřování Microsoftu stav zrcadlení nijak nezmění a další automatický cyklus to zkusí znovu. Pokud se ztratí přístup k Projektu, zmizí vybraná složka nebo se změní propojená identita Microsoft, zrcadlení se pozastaví, místo aby přešlo na jinou složku či účet. Zůstane pozastavené, dokud ho nespustíte. Kratší interval znamená častější kontroly a víc požadavků na Microsoft Graph. Zrcadlení, která se překrývají ve stejné složce Projektu, na sebe navzájem čekají.

Odpojit zastaví synchronizaci, ale soubory v OneDrivu ponechá. Odstranění Projektu nebo účtu zrcadlení zruší, aniž by smazalo vzdálenou složku.

Pozastavení, odpojení nebo volba jiné složky k zrcadlení zastaví běžící cyklus na další hranici operace. Už odeslaný přenos může doběhnout, ale zastavený cyklus už nezačne další změnu, nezapíše tento přenos do staré základny ani nepřepíše stav pozastavení. Místní i spravované zrcadlení před pokračováním ověří zapnuté propojení, jeho vybranou podsložku a původní disk, položku a cestu v OneDrivu. Zastaví se i tehdy, když už nelze obnovit nárok jejich workera.

Řešení konfliktů souborů

Když se soubor před synchronizací změní na obou stranách, zůstanou obě verze. Kopie z OneDrivu se uloží vedle souboru v Projektu s názvem jako notes.onedrive-conflict-2026-09-23-06-15-00.md pro notes.md. Místní i spravovaná zrcadlení zachovají původní příponu a když je název už obsazený, přidají číselnou příponu. Spravované konfliktní kopie vznikají jen na volném místě, takže soubor vytvořený během stahování zůstane zachovaný a cyklus ohlásí chybu zápisu. Dřív zaznamenané názvy konfliktů zůstávají beze změny. Karta tento soubor pozastaví, dokud nezvolíte Použít verzi z projektu, nebo Použít verzi z OneDrivu. Pokud se kopie v OneDrivu během rozhodování změní, plugin vás požádá o volbu proti novější kopii. Při první synchronizaci místní složky se soubory, které jsou na obou stranách už stejné, stanou výchozí základnou, místo aby se označily jako konflikt. U spravovaných Projektů to zatím neplatí: stejné soubory na obou stranách se uchovají jako konfliktní kopie. Soubor, který se právě ukládá, počká na další cyklus.

Použít verzi z OneDrivu přesune vaši kopii v Projektu do .elowen-trash a na její místo postaví kopii z OneDrivu. Použít verzi z projektu nahraje vaši kopii přes soubor v OneDrivu a ponechanou kopii z OneDrivu přesune do .elowen-trash. Ani jedna volba soubor nesmaže natrvalo.

Konflikty spravovaného Projektu a worktree můžete vyřešit na kartě OneDrive. Ponechání verze z projektu ji nahraje jen tehdy, když je vzdálená kopie pořád ta zobrazená. Ponechání verze z OneDrivu použije už staženou konfliktní kopii a předchozí verzi z projektu ponechá v koši synchronizace. Pokud se některá z verzí změnila, synchronizujte znovu, aby se ukázal aktuální konflikt. Pozastavení nebo odpojení zastaví další operace; přenos, který už začal, může doběhnout.

Obnova smazaných souborů

Ve výchozím stavu se smazaný zrcadlený soubor v OneDrivu přesune v Projektu do .elowen-trash, odkud ho můžete obnovit. Když vypnete Promítat smazání z OneDrivu v nastavení pluginu, místní kopie zůstane a znovu se nahraje do OneDrivu. Smazání souboru v Projektu obvykle smaže i jeho kopii v OneDrivu; kontrola hromadného mazání tuto akci pozastaví, když najednou zmizí příliš mnoho souborů.

Když z Projektu najednou zmizí víc souborů a mazání je nezvykle velké, zrcadlení počká na potvrzení, místo aby vzdálené soubory smazalo. Stane se to, když chybí víc než 34 % sledovaných souborů nebo aspoň 50 souborů. Zkontrolujte, že je složka Projektu úplná, a pak toto konkrétní mazání potvrďte tlačítkem Odstranit … souborů z OneDrivu. Když později chybějících souborů zase přibude, potvrzení je potřeba znovu.

Dřív zrcadlený soubor, který začnou vylučovat další vzory ignorování nebo pravidla Gitu, se odebere ze základny synchronizace. Jeho kopie v OneDrivu i případná místní kopie zůstanou nedotčené, i když byl místní soubor už odstraněn. Pravidla ignorování platí i pro soubory v OneDrivu bez základny, takže další cykly vyloučený soubor nevrátí ani nepřepíšou místní úpravy. Ignorované soubory se nepočítají do celkového počtu sledovaných souborů, který se používá pro potvrzení hromadného mazání. Soubory vynechané proto, že se právě ukládají, jsou příliš velké nebo nečitelné, si základnu ponechají.

Když sken nedokáže přečíst celou vybranou složku, OneDrive vrátí neúplný výpis nebo Elowen nedokáže určit, které soubory .gitignore vylučuje, cyklus se přeskočí a stav se změní na Vyžaduje pozornost. Brání to tomu, aby se neúplný pohled zaměnil za smazané soubory. Stav uvádí důvod, například vypršelé přihlášení k Microsoftu, složku, kterou nešlo přečíst celou, nebo soubory, které nešlo synchronizovat, takže víte, zda měnit nastavení, nebo se znovu připojit.

Nastavení synchronizace OneDrivu

Administrátor upravuje celoinstanční nastavení v detailu pluginu v Nastavení → Pluginy. Tyto výchozí hodnoty platí pro všechny; každý si nadále připojuje vlastní účet Microsoft a volí vlastní složku k zrcadlení.

Formulář nastavení ukazuje interval synchronizace v sekundách a limit velikosti souboru v MiB u každého číselného pole. Jeden MiB je 1 048 576 bajtů; uložené hodnoty si zachovávají stejný význam. Krátké nápovědy zůstávají viditelné a podrobný návod najdete pod ikonou nápovědy. Karta Projektu si ponechává hierarchický výběr složek.

Sken pokrývá nejvýš 20 000 souborů, které zůstanou po uplatnění pravidel ignorování. Když jich má Projekt víc, neúplný sken se přeskočí a žádná mazání se neprovedou. Když OneDrive nedovolí vypsat složku celou nebo místní sken selže, tento cyklus synchronizace mazání neprovede.

Symbolické odkazy se přeskakují, nenásledují. Dva soubory, jejichž názvy se liší jen velikostí písmen nebo formou Unicode, se přeskočí oba, protože je OneDrive považuje za jeden název, takže se ani jeden nezrcadlí.

Soubory větší než nastavený limit zůstanou v obou směrech beze změny a nesynchronizují se. Nevytvářejí stav překročení limitu ani hlášení o vynechaném souboru. Soubor vynechaný skenem si ponechá základnu, aby ho nešlo zaměnit za smazaný.

Instalace a oprávnění

Verzi core, která plugin obsahuje, najdete v manifestu pluginu a na marketplace. OneDrive vyžaduje UI API 62 a jednorázový runner sandboxu hostitele. Instaluje ho administrátor v Nastavení → Pluginy → Dostupné pluginy. Plugin se přiděluje uživatelům, takže ho administrátor musí přidělit v Uživatelé → Povolené pluginy, než ho účet, včetně účtu samotného administrátora, může použít. Nemá žádné měnící schopnosti, které by vyžadovaly další souhlas.

Zapnutí, vypnutí, instalace nebo změna pluginu restartuje Elowen. Obrazovka nastavení hlásí „Změna je uložená. Elowen se teď restartuje, aby ji načetla.“ Když restart nemůže proběhnout hned, hlásí „Změna je uložená. Projeví se při příštím spuštění démona.“ Synchronizace OneDrivu běží podle intervalu nebo když zvolíte Synchronizovat nyní; s těmito restarty nesouvisí.

Dále: Weby