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
- Ż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.
- Repo zawsze prywatne. Sprawdzisz to w dowolnym momencie:
gh repo view TWOJ_LOGIN/moja-baza --json visibility. - Prywatne notatki w
03-Private. Ten folder nie trafia na serwer, a agent rusza go tylko na Twoją wyraźną prośbę. - Ź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.
- Serwer tylko do odczytu, dopóki świadomie nie przejdziesz do etapu 2 (Rozdział 9).
- 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.mdmoże przestać wystarczać. Karpathy poleca lokalną wyszukiwarkę Markdownqmd. - 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).