Kalka
Dokumentacja

Rozwiązywanie problemów

Rozwiązania problemów z ostrzeżeniami przy pierwszym uruchomieniu na macOS i Windowsie, Linuksem, aktualizacjami, portem MCP, automatycznym zapisem w przeglądarce oraz sposób zgłaszania błędów.

docs / troubleshooting

macOS nie chce otworzyć Kalki

Wersje beta nie są jeszcze podpisane certyfikatem Apple Developer, więc macOS blokuje pierwsze uruchomienie.

  1. Otwórz Kalkę raz i pozwól macOS jej odmówić.
  2. Otwórz Ustawienia systemowe › Prywatność i ochrona.
  3. Przewiń w dół do komunikatu o Kalce i kliknij Otwórz mimo to.
  4. Potwierdź hasłem lub Touch ID. Kalka się otworzy, a macOS nie zapyta ponownie dla tej wersji.

Usuń znacznik kwarantanny w Terminalu, a potem otwórz ją ponownie:

xattr -dr com.apple.quarantine /Applications/Kalka.app

Windows SmartScreen blokuje instalator

SmartScreen ostrzega przed instalatorami, których rzadko widział, a wersje beta nie są jeszcze podpisane. W niebieskim oknie „System Windows ochronił ten komputer” kliknij Więcej informacji, a potem Uruchom mimo to.

Linux

Kalka jest dostępna jako AppImage. Jeśli nie uruchamia się po dwukrotnym kliknięciu, najpierw nadaj jej prawo wykonywania:

chmod +x Kalka-*.AppImage

Na Windowsie i Linuksie menu Kalki jest wewnątrz okna, a nie na systemowym pasku menu.

Aktualizacje nie instalują się na macOS

Niepodpisana Kalka nie może sama się zastąpić na macOS. Okno Uaktualnienie oprogramowania o tym informuje i proponuje Pobierz: zainstaluj nowy plik .dmg w miejsce starej Kalki w folderze Programy. Twoje dokumenty i ustawienia zostają.

Agenci nie mogą połączyć się z Kalką

Serwer MCP działa wewnątrz aplikacji na komputer, na porcie 7600. Żeby agenci mogli się z nim połączyć, Kalka musi być otwarta.

  • „Port 7600 jest używany przez inny program” w Ustawienia › MCP: port zajmuje inny program, często pozostawiony serwer deweloperski Kalki albo druga kopia Kalki. Zamknij go, a potem uruchom serwer ponownie w Ustawieniach.
  • „Serwer MCP nie odpowiedział na czas” albo „jest nieosiągalny”: sprawdź, czy Kalka jest otwarta, a potem uruchom agenta ponownie, żeby połączył się jeszcze raz.
  • „Serwer MCP odrzucił połączenie lokalne”: uruchom Kalkę ponownie; wystawi nowy lokalny token.

Jak podłączyć każdego agenta, opisuje strona MCP i ACP.

Automatyczny zapis prosi o zgodę w przeglądarce

W Chrome i Edge strona internetowa może zapisać plik na dysku tylko za twoją zgodą. Gdy włączasz automatyczny zapis dla pliku otwartego z dysku, przeglądarka zapyta raz. Jeśli odmówisz, Kalka nie będzie mogła zapisywać automatycznie i powie ci o tym. Przeglądarki bez dostępu do plików, takie jak Safari i Firefox, przy każdym zapisie pobierają kopię.

Wersje nie działają

Panel Historia wymaga aplikacji na komputer, dokumentu zapisanego na twoim komputerze i zainstalowanego Gita. Na macOS zainstaluj Gita poleceniem xcode-select --install; na Windowsie ze strony git-scm.com. Żeby publikować wersje online, twój komputer musi już móc wysyłać zmiany do tego repozytorium przez Gita.

Za dużo ruchu

W Ustawienia › Ogólne, w sekcji Wygląd, opcja Animacje może podążać za systemowym ustawieniem ograniczenia ruchu albo wyłączyć animacje. Ogranicz animacje agentów pokazuje nowe warstwy agenta od razu, zamiast pozwalać im pojawiać się blok po bloku.

Ustawienia, karta Ogólne: język, motyw, animacje, Ogranicz animacje agentów, twoje imię i odzyskiwanie po awarii
Ustawienia › Ogólne, z opcjami Animacje, Ogranicz animacje agentów i odzyskiwaniem po awarii.

Odzyskiwanie utraconej pracy

Jeśli Kalka zamknęła się przed zapisem, otwórz ją ponownie: zaproponuje przywrócenie niezapisanych dokumentów. Zobacz Pliki i wersje.

Zgłaszanie błędu

Otwórz zgłoszenie na github.com/leyscore/kalka/issues. Jeśli Kalka nie może się uruchomić, jej ekran błędu ma link Report a problem, który otwiera zgłoszenie z już wpisaną wersją i systemem. Opisz swoje kroki, oczekiwany wynik i to, co się stało; plik lub zrzut ekranu bardzo pomaga.