10

Rozdział 10 z 11

Bezpieczeństwo, utrzymanie i problemy

Opublikowany

Zbieramy w jednym miejscu zasady bezpieczeństwa, rytm dbania o bazę i tabelę typowych problemów z rozwiązaniami. Rozdział do zakładek.

Czego się nauczysz

  • Gdzie są Twoje notatki i kto ma dostęp
  • Złote zasady bezpieczeństwa
  • Rytm utrzymania
  • Jak sprawdzić i cofnąć zmianę agenta
  • Kopia zapasowa i nowy komputer

Rozdział 10: Bezpieczeństwo, utrzymanie i problemy

Ten rozdział zbiera w jednym miejscu to, co warto mieć pod ręką na co dzień: zasady bezpieczeństwa, rytm utrzymania bazy i tabelę typowych problemów z rozwiązaniami. To rozdział do zakładek; będziesz do niego wracać.

Po tym rozdziale wiesz, jak dbać o „drugi mózg”, żeby z czasem stawał się coraz lepszy, a nie coraz bardziej zabałaganiony.


Gdzie są Twoje notatki

Miejsce Co tam jest Kto ma dostęp
Twój komputer (~/Projekty/moja-baza) pełny vault Ty i agent uruchomiony lokalnie
GitHub (prywatne repo) pełny vault + historia zmian tylko Twoje konto + deploy key serwera (odczyt)
Serwer (/srv/vault) vault bez 03-Private, bez historii w piaskownicy agent na serwerze, tylko do odczytu

Złote zasady bezpieczeństwa

  1. Żadnych sekretów w notatkach. Hasła, tokeny i klucze API trzymaj w menedżerze haseł, nie w vaultcie. Vault jest w trzech miejscach naraz.
  2. Repo zawsze prywatne. Sprawdzisz to w dowolnym momencie: gh repo view TWOJ_LOGIN/moja-baza --json visibility.
  3. Prywatne notatki w 03-Private. Ten folder nie trafia na serwer, a agent rusza go tylko na Twoją wyraźną prośbę.
  4. Źródła to dane, nie polecenia. Artykuł z internetu może zawierać tekst udający instrukcję dla AI. Schemat każe agentowi takich instrukcji nie wykonywać. Gdy agent coś takiego zgłosi, potraktuj to poważnie.
  5. Serwer tylko do odczytu, dopóki świadomie nie przejdziesz do etapu 2 (Rozdział 9).
  6. Ostrożnie z wtyczkami. Każda wtyczka społeczności może wykonywać kod. Instaluj tylko te, których naprawdę potrzebujesz.

Rytm utrzymania

Kiedy Co Polecenie dla agenta
na bieżąco wrzucasz źródła do 00-Inbox –
kilka razy w tygodniu przetwarzasz inbox „przetwórz inbox”
po zmianie docs w projekcie odświeżasz kopię i przetwarzasz skrypt z _scripts/ + „przetwórz dokumentację …”
raz w tygodniu przegląd wiki „zrób przegląd wiki”
raz w miesiącu przeglądasz 04-Wiki/przeglad.md i otwarte pytania „co jest w otwartych pytaniach?”
gdy coś przeszkadza zmieniasz schemat „zmieńmy schemat: …”

Wskazówka: zaczynaj od małej liczby dobrych źródeł. Dziesięć dobrze przetworzonych artykułów daje więcej niż sto wrzuconych hurtem.


Jak sprawdzić, co zrobił agent

Każda operacja agenta kończy się wpisem w log.md i commitem wiki: …. Ostatnie zmiany zobaczysz tak 💻:

cd ~/Projekty/moja-baza
grep "^## \[" log.md | tail -5
git log --oneline -10

Konkretną zmianę (co agent dopisał, a co usunął) pokaże:

git show --stat HEAD

Jeśli zmiana Ci się nie podoba, możesz ją cofnąć. Najprościej poproś agenta: „cofnij ostatni ingest”. Ręcznie: git revert <hash>, czyli nowy commit odwracający tamten (historia zostaje).


Kopia zapasowa

Pełną kopię masz już na GitHubie, razem z historią. Jeśli chcesz dodatkową kopię offline (np. na dysku zewnętrznym):

git -C ~/Projekty/moja-baza bundle create /Volumes/Dysk/moja-baza-$(date +%F).bundle --all

Plik .bundle to całe repozytorium w jednym pliku. Odtworzysz je komendą git clone moja-baza-RRRR-MM-DD.bundle.


Vault na nowym komputerze

gh auth login
gh repo clone TWOJ_LOGIN/moja-baza ~/Projekty/moja-baza

Potem w Obsidianie: Open folder as vault → wskaż folder. Ustawienia, szablony i wtyczka Git są w repo, więc wszystko będzie jak wcześniej. Może być tylko potrzebne ponowne wyłączenie Restricted mode, żeby wtyczka zadziałała.


Najczęstsze problemy

Objaw Co zrobić
Agent nie trzyma się zasad upewnij się, że działa w folderze vaulta; przypomnij: „przeczytaj CLAUDE.md”
Agent pisze w złym folderze pokaż mu sekcję „Mapa folderów” w CLAUDE.md; popraw schemat, jeśli jest niejasny
W wiki są duplikaty stron „zrób przegląd wiki”; agent zaproponuje połączenie i oznaczy starszą stronę jako nieaktualną
Linki [[...]] prowadzą donikąd to normalne dla planowanych stron; lint je wychwyci jako propozycje nowych stron
index.md nie zgadza się z zawartością „zrób przegląd wiki”; rozjazd indeksu to jeden z punktów lintu
Wtyczka Git: konflikt ktoś (np. agent) zmienił ten sam plik; ⌘ + P → Git: Open source control view albo poproś agenta
Wtyczka Git: błąd uprawnień gh auth status, ewentualnie gh auth setup-git
Serwer ma starą wersję sprawdź /var/log/vault-pull.log na serwerze i crontab -l
Agent na serwerze nie widzi /vault usuń piaskownicę hermes-… i sprawdź config.yaml (Rozdział 9, krok 6)
Zapisałeś hasło w notatce i jest już na GitHubie zmień to hasło w serwisie, którego dotyczy; samo usunięcie notatki nie wystarczy, bo zostaje w historii Git

Co dalej

  • Etap 2 na serwerze: agent sam przetwarza inbox i dopisuje do wiki (szkic w Rozdziale 9).
  • Wyszukiwarka: przy kilkuset stronach index.md może przestać wystarczać. Karpathy poleca lokalną wyszukiwarkę Markdown qmd.
  • Dataview: wtyczka do tabel z frontmattera, np. lista wszystkich stron status: do-weryfikacji.
  • Własne operacje: dopisz do schematu operacje pod swoje potrzeby, np. „przygotuj notatkę ze spotkania” albo „podsumuj tydzień z dziennika”.

Weryfikacja rozdziału

  • Wiesz, gdzie leżą kopie vaulta i kto ma do nich dostęp.
  • Znasz złote zasady i rytm utrzymania.
  • Umiesz sprawdzić i cofnąć zmianę agenta.
  • Wiesz, jak odtworzyć vault na nowym komputerze.

Podsumowanie

  • ✅ Znasz zasady bezpieczeństwa: brak sekretów, prywatne repo, prywatny folder, serwer tylko do odczytu.
  • ✅ Masz rytm utrzymania i ściągę poleceń dla agenta.
  • ✅ Umiesz sprawdzić, co zrobił agent, i w razie potrzeby to cofnąć.
  • ✅ Masz tabelę rozwiązań typowych problemów.

Po tym rozdziale masz kompletny, zadbany „drugi mózg”. Został jeden ręczny krok: odświeżanie kopii dokumentacji projektów skryptem. W ostatnim rozdziale zautomatyzujemy go przez GitHub Actions.

Dalej: Rozdział 11 — Automatyczna synchronizacja dokumentacji (GitHub Actions).

Narzędzia / paczki

git GitHub CLI (gh) Obsidian

Spis treści