8

Rozdział 8 z 11

Wtyczka Obsidian Git — automatyczna synchronizacja

Opublikowany

Instalujemy wtyczkę Git, która sama zapisuje zmiany, wysyła je na GitHuba i pobiera zmiany agenta. Pokazujemy pułapkę Options vs Hotkeys i dlaczego 5 minut jest lepsze niż 1.

Czego się nauczysz

  • Restricted mode i wtyczki społeczności
  • Instalacja wtyczki Git (Vinzent)
  • Options vs Hotkeys — pułapka
  • Interwały i „after stopping file edits"
  • Pull on startup i test w terminalu

Rozdział 8: Wtyczka Obsidian Git — automatyczna synchronizacja

Ręczne git push po każdej notatce szybko się nudzi. W tym rozdziale instalujemy wtyczkę Git do Obsidiana. Sama zapisuje zmiany, wysyła je na GitHuba i pobiera zmiany zrobione gdzie indziej (np. przez agenta). Pokażemy też pułapki w ustawieniach, na które łatwo trafić.

Po tym rozdziale piszesz w Obsidianie, a vault sam synchronizuje się z prywatnym repozytorium co kilka minut.


Krok 1 — Włącz wtyczki społeczności 📱

Wtyczki od społeczności są w Obsidianie domyślnie zablokowane (Restricted mode).

  1. Otwórz ustawienia: ⌘ + ,.
  2. Po lewej kliknij Community plugins.
  3. Obsidian pokaże ostrzeżenie o bezpieczeństwie wtyczek i zaleci kopię zapasową. Kopię już masz: vault leży na GitHubie (Rozdział 7).
  4. Kliknij Exit Restricted mode.

Wtyczki mogą wykonywać kod na Twoim komputerze, dlatego instaluj tylko popularne i sprawdzone. Obsidian przegląda wtyczki w oficjalnym katalogu, a większość ma otwarty kod na GitHubie.


Krok 2 — Zainstaluj wtyczkę Git 📱

  1. Przy Community plugins kliknij Browse.
  2. W wyszukiwarce wpisz Git.
  3. Wybierz wtyczkę Git autorstwa Vinzent (kilka milionów pobrań, kod: github.com/vinzent03/obsidian-git).
  4. Kliknij Install, a potem Enable.

Oczekiwany rezultat: w Settings → Community plugins na liście „Installed plugins” jest Git z włączonym (fioletowym) przełącznikiem.


Krok 3 — Wejdź w ustawienia wtyczki (uwaga na pułapkę) 📱

Na stronie wtyczki są przyciski Options, Hotkeys, Disable, Uninstall…

  • Options otwiera ustawienia wtyczki. To tego szukasz.
  • Hotkeys otwiera listę skrótów klawiszowych z komendami „Git: …”. To nie są ustawienia synchronizacji.

Pułapka z praktyki: łatwo trafić w Hotkeys i szukać tam interwałów, których tam nie ma. Jeśli widzisz długą listę „Git: Commit…, Git: Create new branch…” z przyciskami „Blank”, jesteś w skrótach. Wróć i kliknij Options.

Do ustawień dojdziesz też inaczej: w Settings przewiń lewą kolumnę na sam dół. W sekcji Community plugins jest pozycja Git.

W nowszych wersjach (np. 2.42) ustawienia są pogrupowane w kategorie: Automatic, Commit, Sync, Editor, Views, Interface, Identity, Advanced.

Opcjonalnie: skrót do ręcznej synchronizacji

Skoro trafiłeś do Hotkeys: przy Git: Commit-and-sync kliknij ⊕ i naciśnij np. ⌘ + Shift + S. Tym skrótem wyślesz zmiany natychmiast, bez czekania na automat.


Krok 4 — Ustawienia automatyczne 📱

Wejdź w kategorię Automatic i ustaw:

Ustawienie Wartość Po co
Use separate commit and push intervals wyłączone jeden zegar na zapis i wysyłkę, czyli prościej
Auto commit-and-sync interval (minutes) 5 co 5 minut zapis + wysyłka na GitHuba
Auto commit-and-sync after stopping file edits włączone czeka, aż skończysz pisać
Auto push interval (minutes) 0 push robi się razem z commit-and-sync
Auto pull interval (minutes) 5 co 5 minut pobiera zmiany (np. od agenta)

Pozostałe opcje zostaw domyślne. Wiadomość commita (kategoria Commit) też: vault backup: {{date}}.

Dlaczego 5 minut, a nie 1?

Interwał 1 minuty działa, ale ma wady:

  • zaśmiecona historia: setki commitów „vault backup” tygodniowo; trudno znaleźć konkretną zmianę;
  • ciągłe łączenie z GitHubem bez realnej korzyści;
  • większe ryzyko konfliktów, gdy Ty i agent edytujecie w tym samym czasie.

5 minut to dobry kompromis. Gdy chcesz wysłać zmiany od razu, użyj skrótu albo ⌘ + P → Git: Commit-and-sync.

Co daje „after stopping file edits”?

Bez tej opcji wtyczka zapisuje „po zegarku”, nawet w połowie zdania. Z nią czeka, aż przestaniesz pisać:

Bez opcji Z opcją (zalecane)
10:00 zaczynasz pisać 10:00 zaczynasz pisać
10:05 zapis w trakcie pisania ✂️ 10:05 wciąż piszesz, wtyczka czeka ⏳
10:10 kolejny zapis w trakcie ✂️ 10:12 kończysz pisać
10:15 zapis ok. 10:17 jeden zapis z całą notatką ✅

Mniej commitów, a każdy zawiera kompletną zmianę. Opcja działa tylko wtedy, gdy interwał commit-and-sync jest większy od 0.


Krok 5 — Pobieranie przy starcie 📱

Wróć strzałką ‹ do listy kategorii, wejdź w Sync i włącz Pull on startup (w niektórych wersjach: Pull changes on startup; jeśli nie ma go w Sync, poszukaj w Automatic).

Dzięki temu po otwarciu Obsidiana od razu masz najnowszą wersję, łącznie ze zmianami agenta na serwerze.


Krok 6 — Test 📱💻

  1. Zamknij ustawienia (Esc).
  2. ⌘ + P → wpisz commit-and-sync → wybierz Git: Commit-and-sync → Enter.
  3. W prawym górnym rogu mignie komunikat, np. Pushed … albo No changes to commit. Oba są poprawne.

Sprawdź w terminalu, co trafiło na GitHuba:

cd ~/Projekty/moja-baza
git fetch -q origin
git status -sb
git log origin/main --format='%h %ad | %s' --date=format:'%H:%M' -5

Oczekiwany rezultat: ## main...origin/main (wszystko wysłane), a na górze historii commit vault backup: ….

Pierwszy taki commit zwykle zawiera samą wtyczkę: .obsidian/community-plugins.json i folder .obsidian/plugins/obsidian-git/ (main.js, manifest.json, styles.css, data.json). To dobrze: po sklonowaniu vaulta na innym komputerze wtyczka będzie od razu zainstalowana i skonfigurowana.

Możesz też potwierdzić, że ustawienia się zapisały i że nie ma w nich haseł:

grep -E '"(autoSaveInterval|autoPullInterval|autoPushInterval|autoPullOnBoot|autoBackupAfterFileChange)"' .obsidian/plugins/obsidian-git/data.json

Powinno pokazać 5, 5, 0, true, true. Hasła do GitHuba wtyczka nie przechowuje w repo. Git na macOS trzyma je w pęku kluczy.


Weryfikacja rozdziału

  • Restricted mode jest wyłączony, a wtyczka Git by Vinzent zainstalowana i włączona.
  • Automatic: commit-and-sync 5, pull 5, push 0, „after stopping file edits” włączone.
  • Sync: Pull on startup włączone.
  • Ręczny Git: Commit-and-sync działa bez błędów.
  • git status -sb pokazuje, że lokalny vault i GitHub są zgodne.

Częste problemy

Objaw Co zrobić
Szukasz interwałów i widzisz tylko listę „Git: …” z „Blank” to Hotkeys; wróć i kliknij Options
Czerwony błąd przy push: brak uprawnień w terminalu: gh auth status; jeśli trzeba, gh auth setup-git
Komunikat o konflikcie (merge conflict) ktoś (np. agent) zmienił ten sam plik; otwórz ⌘ + P → Git: Open source control view, a w razie wątpliwości poproś agenta o pomoc
Wtyczka nic nie robi sprawdź, czy interwał nie jest 0 i czy wtyczka jest włączona

Podsumowanie

  • ✅ Włączyłeś wtyczki społeczności i zainstalowałeś Git by Vinzent.
  • ✅ Wiesz, czym różnią się Options i Hotkeys.
  • ✅ Ustawiłeś synchronizację co 5 minut, czekanie na koniec pisania i pobieranie przy starcie.
  • ✅ Sprawdziłeś w terminalu, że zmiany docierają na GitHuba.

Po tym rozdziale Twój „drugi mózg” sam synchronizuje się z prywatnym repozytorium. W następnym rozdziale podłączymy do niego agenta działającego 24/7 na serwerze.

Dalej: Rozdział 9 — Podłączenie agenta Hermes na VPS (tylko do odczytu).

Narzędzia / paczki

Obsidian Git git

Spis treści