Instrukcja

Pierwsze kroki

Bossanova to cyfrowy sejf, który przechowuje teksty i obrazy w postaci zaszyfrowanej na komputerze. Aby korzystać z aplikacji, trzeba się do niej zalogować, także przy użyciu bezpłatnego konta. Logowanie do konta jest niezależne od hasła głównego, które otwiera sejf.

Jeśli Google informuje, że konto już istnieje na urządzeniu, wróć tutaj i wybierz „Kontynuuj przez e-mail”, podając ten sam adres Google. Jeśli masz już konto Bossanova z tym adresem e-mail, zalogujesz się na swoje istniejące konto. Możesz też spróbować innej przeglądarki.

Obecny instalator jest przeznaczony dla Windows 10/11 x64. Instalatory dla 32-bitowego Windows i natywnego ARM64 nie są dostępne. Instalacja lub aktualizacja WebView2 może wymagać połączenia z Internetem.

1. Pobierz instalator dla swojego systemu operacyjnego ze strony pobierania i zainstaluj aplikację.
2. Dokończ instalację, a następnie otwórz Bossanova z menu Start. Obsługiwane są systemy Windows 10/11 x64. Jeśli brakuje WebView2, instalator je skonfiguruje. Jeśli instalacja na komputerze służbowym jest zablokowana, skontaktuj się z administratorem.
3. Na ekranie logowania aplikacji zarejestruj się lub zaloguj za pomocą Google, Apple albo adresu e-mail, a następnie zatwierdź to urządzenie. Bezpłatne konto pozwala zapisać dziesięć elementów.
4. Utwórz sejf na pierwszym ekranie z długim hasłem głównym i zachowaj je bezpiecznie. Aby przenieść istniejący sejf, przed utworzeniem wybierz import z innego urządzenia. Pliki kopii używają osobnej funkcji przywracania.
5. Najpierw zapisz nieszkodliwy przykład. Wypróbuj wyszukiwanie, wyświetlanie i kopiowanie, a następnie dodaj prawdziwe informacje i utwórz zewnętrzną kopię zapasową.

Deweloper nie może odzyskać zapomnianego hasła głównego. Logowanie za pomocą Google, Apple lub adresu e-mail nie pozwala go zresetować.

Zapisywanie i porządkowanie danych

Sejf Bossanova jest uporządkowany według hierarchii foldery → grupy → elementy danych. Element danych składa się z jednej nazwy i jednej wartości (tekstu lub obrazu), a grupa łączy powiązane elementy danych. Folder zawiera grupy i elementy danych nieprzypisane do grupy, a sejf jest zbiorem folderów. Na przykład folder „Klucze API” może zawierać grupę „bossanova” z elementami „Klucz API Dodo” i „Data odnowienia”. Każdy tekstowy lub graficzny element danych liczy się jako jeden element.

Foldery porządkują grupy i dane. Przeciągnij uchwyty, aby zmienić kolejność. Przy usuwaniu folderu wybierasz, czy zachować, czy usunąć jego zawartość.

Dostęp AI przełącza ikona gwiazdy. Najedź kursorem, aby zobaczyć nazwę; jasnozielone tło oznacza włączenie; gwiazda pozostaje konturem. Ten sam przycisk jest na listach, w szczegółach i formularzach danych oraz grup. Wszystkie dane i foldery mają wspólne sortowanie: domyślne, najnowsze, najstarsze, najczęściej używane, najrzadziej używane, nazwa A–Z i Z–A. Ostatni wybór jest zapisywany w sejfie na kolejne uruchomienie. Nazwy są porządkowane według języka interfejsu, z 2 przed 10. Wybierz domyślne, aby przeciągać elementy w folderze; inne sortowania zachowują ręczną kolejność.

W Ustawienia → AI → Dostęp AI domyślny dostęp do nowych danych jest wyłączony. Dotyczy nowych tekstów i obrazów, danych dodawanych podczas tworzenia lub edycji grup, szablonów oraz importów .env. Przed zapisem można zmienić każdą ikonę AI. Istniejące dane, udostępnianie niesekretnych wartości i zgody na wykonanie nie zmieniają się. Wybór jest zapisywany w tym sejfie.

1. Utwórz foldery za pomocą opcji „Dodaj foldery i zarządzaj nimi” w menu po lewej stronie i przeciągaj uchwyty, aby zmienić ich kolejność.
2. Użyj opcji „Dodaj dane”, aby wprowadzić nazwę, typ (tekst lub obraz; starsze elementy danych zachowują typ hasła, liczby lub daty) oraz wartość. Bez grupy element danych trafia bezpośrednio do folderu. Obrazy (PNG, JPEG, GIF, WebP, BMP, ICO, TIFF, TGA, PNM, QOI, HDR, do 10MiB) można przeciągać lub wklejać. Kliknięcie elementu danych otwiera jego szczegóły, a opcja „Edytuj” otwiera okno edycji z wypełnioną zapisaną wartością (użyj opcji „Pokaż wartość”, aby ją sprawdzić).
3. Przeciągnij element danych na inny element, aby utworzyć grupę, a grupę na inną grupę, aby je połączyć. Za pomocą uchwytów możesz zmieniać kolejność wszystkich elementów.
4. Gdy potrzebujesz wartości, użyj funkcji wyświetlania lub kopiowania elementu danych. Aplikacja albo dokument docelowy może zobaczyć wklejone wartości, dlatego sprawdź, dokąd je wklejasz.
5. Plany Plus i Pro zawierają szablony często używanych grup. Rzeczywiste wartości nadal trzeba wprowadzić samodzielnie.

Sekrety umieszczaj wyłącznie w polach wartości. Nazwy elementów danych, opisy oraz nazwy grup i folderów mogą być udostępniane AI zależnie od ustawień.

Importowanie pliku .env

Sekrety z pliku .env projektu możesz przenieść do sejfu w jednym kroku. Naciśnij „Importuj .env” w lewym dolnym rogu okna „Nowa grupa” albo przeciągnij plik na stronę sejfu. Jeden plik staje się jedną grupą, a każda zmienna — jednym elementem danych nazwanym tak jak zmienna. Dane pozostają sekretami; dostęp AI zależy od ustawienia dla nowych danych.

1. Podgląd pokazuje tylko nazwy zmiennych; wartości nigdy nie są wyświetlane na ekranie. Wybierz nazwę grupy (na przykład web .env) i sprawdź listę.
2. Wartości, które prawdopodobnie nie są sekretami, takie jak numery portów lub publiczne adresy URL, są oznaczone jako kandydaci „To nie jest sekret”. Domyślnie wszystko jest sekretem; tylko samodzielnie wybrane elementy można oznaczyć jako „To nie jest sekret” po potwierdzeniu ostrzeżenia.
3. Jeśli importujesz plik za pomocą selektora plików, możesz wybrać usunięcie oryginalnego pliku .env. Pliki przeciągnięte i upuszczone nie są usuwane.
4. Import jest zapisywany jako jedna operacja. Jeśli przekroczyłby limit danych planu, nic nie zostanie zapisane, a aplikacja wyświetli propozycję przejścia na wyższy plan; istniejące informacje pozostaną bez zmian.

AI może użyć zaimportowanej grupy w całości w opcji „Wstrzyknij do uruchomienia”: każdy element danych z włączoną opcją „Dostęp AI” jest wstrzykiwany jako zmienna środowiskowa o nazwie elementu. Plik .env pozostawiony w projekcie może zostać odczytany przez AI, dlatego usuń go, gdy jego zawartość znajdzie się już w sejfie.

Wyszukiwanie informacji

Gdy sejf jest odblokowany, wpisz nazwę lub słowo kluczowe w polu wyszukiwania. Wyniki zmieniają się, zanim naciśniesz Enter. Zacznij od krótkiego fragmentu nazwy; dokładne dopasowania są wyżej niż częściowe i podobne.

Wyszukiwanie działa lokalnie za pomocą algorytmów i nie wysyła zapytania do AI ani serwera konta. Domyślnie przeszukiwane są nazwy i opisy. Włącz opcję wyszukiwania również w treści wartości, aby uwzględnić wartości tekstowe; pasujące wartości sekretów nie pojawiają się w podglądzie wyników. Obrazy nie są przeszukiwane za pomocą OCR. Wybierz wynik, a następnie wyświetl lub skopiuj potrzebne pole.

Jeśli nic nie pasuje, skróć zapytanie albo zmień sposób wpisania spacji. Wyczyść zapytanie, aby wrócić do pełnej listy. Wyszukiwanie jest niedostępne, gdy sejf jest zablokowany.

Język

Ustawienia → Ogólne → Język — Język interfejsu. Wybrany język jest stosowany od razu i zapisywany w tym sejfie. Na ekranie blokady używany jest język komputera.

Blokowanie i zamykanie

Zablokuj sejf, gdy odchodzisz od komputera. Nowe sejfy są domyślnie blokowane po pięciu minutach bezczynności; ustawienia istniejących sejfów są zachowywane. Czas możesz zmienić w Ustawieniach. Zadania AI korzystające z wartości sekretów nie mogą być wykonywane, gdy sejf jest zablokowany. Podczas wykonywania żądań przez AI automatyczna blokada jest przedłużana maksymalnie na 12 godzin od odblokowania sejfu, a sejf nie blokuje się automatycznie przez 60 minut od ostatniego żądania AI, nawet jeśli odejdziesz od komputera. Dzięki temu długa kompilacja nie zostanie przerwana przez blokadę.

Zamknięcie okna pozostawia Bossanova uruchomioną w zasobniku systemowym. Kliknij ikonę aplikacji w zasobniku, aby otworzyć ją ponownie, albo wybierz „Zakończ” w menu zasobnika, aby całkowicie zakończyć działanie. AI nie może korzystać z lokalnego sejfu, gdy komputer jest wyłączony lub Bossanova została zakończona.

Jeśli wyłączysz automatyczną blokadę, zablokuj sejf lub naciśnij Ctrl/Cmd+L przed odejściem od komputera.

Uruchamianie i odblokowanie

W Ustawieniach → Ogólne → Uruchamianie i odblokowanie włącz opcję „Uruchamiaj po zalogowaniu do komputera”. Bossanova otworzy się przy następnym logowaniu. Domyślnie opcja jest wyłączona.

Automatyczne otwieranie sejfu po zalogowaniu do komputera to osobne ustawienie. Przeczytaj komunikat i potwierdź hasło główne, aby zapisać poświadczenie odblokowania w bezpiecznym magazynie tego urządzenia. Gdy oba ustawienia są włączone, przy następnym logowaniu do komputera Bossanova uruchomi się w zasobniku bez otwierania okna.

Automatyczne otwieranie działa raz na każde logowanie do systemu operacyjnego. Ręczne zablokowanie, uśpienie, zablokowanie ekranu i ponowne uruchomienie aplikacji wymagają hasła. Zmiana hasła lub zresetowanie zabezpieczeń wyłącza automatyczne otwieranie. Kopie zapasowe nie przenoszą poświadczenia odblokowania urządzenia.

Automatyczne otwieranie zwiększa ryzyko dostępu przez programy uruchomione z uprawnieniami użytkownika systemu operacyjnego. Nie używaj go na współdzielonych komputerach. Zachowaj hasło główne i zewnętrzne szyfrowane kopie zapasowe.

Przenoszenie między urządzeniami i szyfrowane kopie zapasowe

Sejf korzysta z folderu danych aplikacji użytkownika systemu operacyjnego i bezpiecznego magazynu, a nie z folderu znajdującego się obok pliku EXE. Przeniesienie pliku wykonywalnego nie przenosi sejfu. Urządzenia nie synchronizują się automatycznie.

Do zwykłego przenoszenia sejfu używaj bezpośredniego połączenia w tej samej sieci Wi-Fi/LAN. Sejf i obrazy są szyfrowane i przesyłane tylko między urządzeniami, bez serwerów Bossanova. Nie musisz przenosić pliku kopii zapasowej na USB. Bossanova (Windows) obsługuje zaszyfrowane przesyłanie do 2 GiB, wraz z obrazami. Oba urządzenia wymagają wersji obsługującej ten format kopii zapasowej.

Urządzenie odbierające sejf po raz pierwszy dołącza do tego samego sejfu. Kolejne importy scalają zmiany folderów, grup i danych. Wybierasz wersję do zachowania tylko wtedy, gdy oba urządzenia zmieniły ten sam element w różny sposób. To nie jest automatyczna synchronizacja: uruchamiaj import przy każdej wymianie zmian. Połączenia i zgody AI nie są przenoszone.

Szyfrowana kopia zapasowa to osobna kopia do odzyskiwania po awarii lub utracie danych. Utwórz ją lub przywróć w aplikacji komputerowej, w Ustawieniach → Kopia zapasowa. Przechowuj osobną kopię w bezpiecznym miejscu odpornym na awarię dysku. Przywracanie cofa dane do chwili utworzenia kopii: najpierw zapisz bieżący stan i zachowaj oryginały do czasu sprawdzenia odzyskanych danych.

Jeśli uszkodzone lub brakujące obrazy uniemożliwiają otwarcie sejfu, na ekranie blokady wybierz przywracanie z kopii zapasowej. Wybierz nieuszkodzoną kopię tego samego sejfu i podaj bieżące hasło główne oraz hasło kopii — mogą się różnić. Aplikacja zachowuje uszkodzony oryginał i pozostałe zaszyfrowane pliki, ale nie odtworzy utraconej zawartości. Przywracana jest zawartość kopii, a bieżące hasło główne pozostaje bez zmian. Następnie sprawdź połączenia AI, zatwierdzenia i udostępnianie wartości.

Automatyczne kopie zapasowe to kopie przechowywane na tym komputerze (w folderze danych aplikacji), które służą do przywracania informacji usuniętych przez pomyłkę. Po zmianie hasła lub zresetowaniu zabezpieczeń ponownie wyeksportuj sejf.

Przywróć informacje z kopii zapasowej, zastępując późniejsze dodatki i zmiany. Przed przywróceniem zaszyfrowana kopia bieżącego sejfu zostanie automatycznie zapisana na tym komputerze. Dotychczasowa historia dostępu zostanie zachowana; połączenia AI i udostępnianie wartości zostaną zresetowane.

1. Połącz oba urządzenia z tą samą zwykłą siecią Wi-Fi/LAN i zaloguj się na to samo konto Bossanova. Otwórz obie aplikacje i odblokuj istniejące sejfy. Jeśli urządzenie odbierające nie ma jeszcze sejfu, zacznij od „Importuj z innego urządzenia” na pierwszym ekranie.
2. Na urządzeniu wysyłającym wybierz Ustawienia → Kopia zapasowa → „Wyślij ten sejf”. Wyświetlony kod jest jednorazowy i wygasa po 3 minutach.
3. Na urządzeniu odbierającym wybierz „Importuj z innego urządzenia” i wpisz kod nadawcy oraz hasło główne tego sejfu. Aplikacja automatycznie znajdzie nadawcę w tej samej sieci LAN.
4. Do zakończenia pozostaw obie aplikacje na ekranie, a istniejące sejfy odblokowane. Przełączenie aplikacji w tło lub zablokowanie sejfu może anulować transfer. Sprawdź zaimportowane dane, a w razie konfliktów wybierz wersje do zachowania.

Izolacja urządzeń w gościnnej sieci Wi-Fi, VPN lub zapora może uniemożliwić znalezienie drugiego urządzenia. Użyj tej samej zwykłej sieci Wi-Fi na obu urządzeniach, zezwól na dostęp do sieci lokalnej i spróbuj ponownie. Nie ma automatycznego przełączenia na serwer pośredniczący w internecie. Kopiowanie między urządzeniami może przenieść również usunięcia i błędy, dlatego nie zastępuje osobnej kopii zapasowej.

Bezpieczeństwo

Ustawienia → Bezpieczeństwo → Zmień hasło główne — Zwykła zmiana zmienia tylko hasło odblokowujące sejf. Wewnętrzny klucz szyfrowania i stare kopie zapasowe pozostają bez zmian. Jeśli podejrzewasz wyciek, użyj opcji „Reakcja na incydent · Reset zabezpieczeń”.

Ustawienia → Bezpieczeństwo → Reakcja na incydent · Reset zabezpieczeń — Zabezpiecz bieżące informacje nowym kluczem szyfrowania i hasłem. Pola i wartości zostaną zachowane; wszystkie połączenia AI, dostęp i udostępnianie wartości zostaną zresetowane. Rozpocznie się nowa historia dostępu, a dotychczasowa pozostanie w kopii zapasowej.

Zaszyfrowana kopia zapasowa sprzed zmiany zostanie zachowana na tym komputerze. Stare kopie zapasowe nadal otwierają się za pomocą starych haseł i nie mogą bezpośrednio zastąpić nowego sejfu. Możesz je przywrócić osobno w pustej lokalizacji.

Jeśli podejrzewasz złośliwe oprogramowanie, najpierw użyj zaufanego urządzenia. Sama zmiana hasła na zainfekowanym komputerze nie zapewnia ochrony.

Wcześniej ujawnionych informacji nie można wycofać. Zmień lub unieważnij ujawnione hasła i klucze API w odpowiednich usługach. Następnie utwórz nową zewnętrzną kopię zapasową.

Trwałe usunięcie wymaga hasła głównego i nieodwracalnie usuwa sejf oraz wewnętrzne kopie na tym komputerze. Kopie zewnętrzne w innych miejscach pozostają.

Konta, plany i urządzenia

Wszystkie plany, w tym Free, wymagają zalogowania w aplikacji. Zaloguj się za pomocą Google, Apple lub adresu e-mail i zatwierdź wyświetlone urządzenie. Jeśli jesteś już zalogowany, sprawdź sekcję konta i subskrypcji w Ustawieniach.

Wybranie opcji „Ukryj mój e-mail” w Apple może utworzyć osobne konto, inne niż konto używane wcześniej z Google lub adresem e-mail. Aby nadal korzystać z istniejącej subskrypcji, zaloguj się za pomocą metody użytej dla tego konta.

Limit danych w planie dotyczy dodawania i edycji treści. Nie ogranicza wyświetlania listy zapisanych danych ani ich używania przez AI. Dostęp AI i udostępnianie jako dane niepoufne można włączać i wyłączać również dla danych tylko do odczytu. Udostępnianie wymaga zgody, a wykonanie — odblokowanego sejfu, zatwierdzonego połączenia, aktywnego urządzenia i zatwierdzenia operacji.

Po zakończeniu subskrypcji nadal możesz wyświetlać, wyszukiwać, kopiować, tworzyć kopie zapasowe i odzyskiwać istniejące informacje. Dziesięć stałych, bezpłatnych pól podstawowych pozostaje edytowalnych, a dodatkowe pola są tylko do odczytu. Zmiana nazw lub kolejności nie zmienia tego podziału. Szablony wymagają planu Plus lub Pro.

Aktywuj bezpłatny dostęp w aplikacji: Ustawienia → Konto i subskrypcja → Kod promocyjny, lub w polu kodu na stronie konta. Kod rabatowy wpisz w oknie płatności Paddle po wybraniu planu.

Bezpłatny dostęp nie wymaga karty i kończy się we wskazanym dniu, bez automatycznych opłat. Kody tego samego poziomu przedłużają pozostały okres. Jeśli masz płatny dostęp lub kod innego poziomu, zaczekaj do jego wygaśnięcia. Przed użyciem kodu anuluj niedokończoną, nieopłaconą transakcję na stronie konta.

Po zastosowaniu kodu rabatowego wybierz odpowiedni plan i dokończ płatność w Paddle. Wymagana jest metoda płatności, a subskrypcja odnawia się do jej anulowania. Sprawdź rabat, liczbę płatności objętych zniżką i pełną cenę roczną. Po zakończeniu rabatu obowiązuje zwykła cena. W zarządzaniu płatnościami możesz zmienić metodę płatności, przeglądać rachunki i anulować subskrypcję.

Zaloguj się na stronie cennika, aby zmienić plan lub okres rozliczeniowy. Zmiana obowiązuje od razu po potwierdzeniu kwot. Anulowanie jest dostępne w zarządzaniu subskrypcją. Podczas korzystania z karnetu wybierz Plus lub Pro, aby zarezerwować subskrypcję. Teraz nic nie płacisz: dodaj metodę płatności oraz potwierdź datę pierwszego obciążenia i kwotę odnowienia. Wybrany plan zacznie działać po zakończeniu karnetu i udanej pierwszej płatności. Anulowanie rezerwacji zachowuje pozostały czas pierwotnego karnetu. Anuluj ją przed dodaniem kolejnego karnetu. Niektóre rabaty przypisane do konkretnej ceny nie obejmują rezerwacji. W regionach takich jak Korea Południowa, gdzie wymagana jest dodatkowa zgoda, Paddle prosi o potwierdzenie przed pierwszym płatnym odnowieniem. Bez zgody rezerwacja zostanie anulowana bez pobierania opłat.

Zalogowane urządzenia to aplikacje połączone z kontem. Do limitu planu wliczają się tylko urządzenia z prawem do edycji sejfu. Wyłącz edycję ustawia tryb tylko do odczytu przy kolejnej weryfikacji konta; Wyloguj przy urządzeniu wymaga ponownego logowania. Obie czynności zachowują pliki sejfu i kopie zapasowe.

Wylogowanie blokuje sejf; aby z niego korzystać, zaloguj się ponownie. Oryginalny sejf i kopie zapasowe nie są usuwane. Jeśli nie możesz się zalogować, użyj opcji „Awaryjny eksport kopii zapasowej” na ekranie logowania, aby raz wyeksportować szyfrowaną kopię zapasową za pomocą hasła głównego. Po wygaśnięciu płatnego planu, przy zachowanym zalogowaniu, nadal można edytować dziesięć podstawowych pól; dodatkowe pola pozostają dostępne tylko do odczytu. Funkcje płatne działają offline przez maksymalnie siedem dni.

Łączenie AI

AI jest opcjonalne. Po połączeniu AI przekazuje Bossanova zadania wymagające wartości, nie otrzymując tej wartości. Po włączeniu opcji „Dostęp AI” dla elementu danych AI widzi tylko jego nazwę, opis i grupę, nigdy wartość. O tym, gdzie można użyć wartości, decydujesz w aplikacji na karcie zatwierdzenia, gdy AI po raz pierwszy próbuje jej użyć.

Kosz w prawym górnym rogu cofa tylko dane zatwierdzenie. Pomoc z połączeniem i konfiguracja ręczna służy do naprawy lub dodania AI spoza listy; przy zwykłym użyciu nie wymaga zmian.

1. Odblokuj Bossanova i włącz Claude Desktop w Ustawienia → AI → «Znajdź AI na tym komputerze». Całkowicie zamknij i ponownie otwórz Claude. Zwykły ChatGPT Chat połącz osobno na karcie «ChatGPT».
2. Połącz każdą AI jej przełącznikiem. Claude Desktop instaluje także bsnv dla lokalnej karty Code: /mcp sprawdza połączenie, a /bsnv wyświetla instrukcję. W Chat użyj + → Konektory; instrukcje są przekazywane przez MCP. Po aktualizacji odblokowanie Bossanova odświeża skille istniejących połączeń. Połącz wszystkie pomija natywne Claude Code, aby uniknąć duplikatów, ale obejmuje WSL.
3. Wiersz «Codex» konfiguruje hosta Codex. Samo to ustawienie nie łączy zwykłego Chat. Zwykły Chat w aplikacji i przeglądarce używa oficjalnego tunelu OpenAI.
4. W przypadku środowisk CLI rozpocznij nową rozmowę i sprawdź, czy na liście znajdują się narzędzia Bossanova. Włącz opcję „Dostęp AI” dla elementów danych, których chcesz użyć, a następnie poproś AI o wykonanie zadania jak zwykle (na przykład: „Wdróż aplikację za pomocą tokenu wdrożeniowego zapisanego w Bossanova”). AI wybiera elementy danych na podstawie nazwy i opisu.
5. Gdy AI po raz pierwszy próbuje użyć elementu danych, w Bossanova pojawia się karta zatwierdzenia. Sprawdź dane i cel (usługę albo plik wykonywalny, folder, nazwę zmiennej i nośnik), a następnie wybierz „Odrzuć”, „Tylko tym razem”, „24 godziny”, „7 dni”, „30 dni” lub „Zawsze”. Po zezwoleniu na ten sam cel nie pojawi się ponowne pytanie.

Sterowanie projektami obsługuje zwykły Chat w aplikacji i przeglądarce ChatGPT oraz Claude Desktop. Claude w przeglądarce nie jest obsługiwany. Używanie danych sejfu i dostęp do projektów wymagają osobnych uprawnień. Samodzielnie zaloguj się i zatwierdź połączenie. Jeśli brakuje narzędzi, odśwież listę lub rozpocznij nową rozmowę; stare rozmowy mogą pamiętać poprzednie połączenie. Uprawnienia, dostępność i darmowe limity OpenAI nie są gwarantowane. Połączenia WSL i Windows są oddzielne.

Jak AI korzysta z wartości

AI nigdy nie otrzymuje wartości. Zadania wymagające wartości Bossanova wykonuje w jego imieniu na jeden z dwóch sposobów.

„Wyślij w moim imieniu”: AI przekazuje żądanie HTTPS (metodę, URL, nagłówki i treść) z symbolem zastępczym w miejscu wartości; Bossanova samodzielnie wysyła żądanie i wstawia wartość tylko w tym miejscu. Wartość nigdy nie trafia do kodu, żądania ani odpowiedzi AI. Przy pierwszym użyciu usługi karta zatwierdzenia pokazuje dane i zestaw hostów tej usługi (w przypadku dobrze znanych usług, takich jak GitHub, hosty są grupowane); inne ścieżki i metody tej samej usługi nie wymagają ponownego pytania. Dozwolone są wyłącznie żądania https na porcie 443 kierowane do publicznych adresów, przekierowania nie są śledzone, a odpowiedź jest zwracana AI po zamaskowaniu każdej wartości, która wróciła w odpowiedzi. To właściwy sposób używania sekretów wysyłanych do serwera, takich jak tokeny wdrożeniowe oraz klucze API płatności, poczty lub chmury.

„Wstrzyknij do uruchomienia”: AI podaje plik wykonywalny (ścieżkę bezwzględną; w przypadku skryptów sam plik), folder roboczy, argumenty tego uruchomienia oraz nazwę zmiennej środowiskowej. Karta zatwierdzenia pojawia się przy pierwszym użyciu; po zezwoleniu Bossanova samodzielnie uruchamia program i przekazuje wartość wyłącznie za pomocą nośnika wskazanego na karcie. Argumenty można dowolnie zmieniać przy każdym uruchomieniu i nie są objęte zatwierdzeniem; zmiana pliku wykonywalnego, folderu, nazwy zmiennej, nośnika lub zawartości skryptu powoduje ponowne pytanie. Dostępne są cztery nośniki: zmienna środowiskowa (wartość bez zmian), plik tymczasowy (jego ścieżka w zmiennej, usuwany po uruchomieniu), proxy (proces otrzymuje tylko fałszywy token, a uruchamiane przez Bossanova dla danego uruchomienia proxy HTTPS zamienia go na prawdziwą wartość wyłącznie w żądaniach do hostów z karty) oraz agent SSH (klucz podpisuje tylko wewnątrz Bossanova). W przypadku nośników proxy i agenta proces nigdy nie otrzymuje samej wartości (wartość zwrócona w odpowiedzi jest ponownie zamieniana na fałszywy token). W przeciwieństwie do opcji „Wyślij w moim imieniu” proces najpierw widzi odpowiedzi, a agent SSH pozwala programowi uzyskać podpis dowolnego serwera tym kluczem; karta zatwierdzenia wyraźnie o tym informuje.

Wartości, które muszą trafić do aplikacji, takie jak klucze narzędzi do budowania i klucze klienckiego SDK, powinny korzystać z nośnika zmiennej środowiskowej. Wartość znajduje się wtedy w procesie i może pozostać w programie, jego procesach potomnych oraz danych wyjściowych. Elementów danych powiązanych już z usługą za pomocą opcji „Wyślij w moim imieniu” nie można wstrzykiwać za pomocą nośnika zmiennej środowiskowej ani pliku tymczasowego (dzięki temu sekrety serwera nie trafiają do kodu napisanego przez AI). Grupę zaimportowaną z pliku .env można wstrzyknąć w całości, a polecenia, które się nie kończą, takie jak serwer deweloperski, działają jako sesja, dzięki czemu AI może odczytywać bieżący dziennik i poprosić o zatrzymanie. Ścieżki systemu Linux w WSL są wykonywane wewnątrz tej dystrybucji. Jedno uruchomienie może trwać maksymalnie 24 godziny.

AI otrzymuje kod zakończenia, czas trwania i dziennik uruchomienia z zamaskowaną wartością (maskowane są postacie jawne, formaty base64 i URL oraz usuwane są ciągi wyglądające na sekrety). Jeśli polecenie wypisało wartość, dziennik nie jest przekazywany AI, a zwracana jest tylko przyczyna; zamaskowany dziennik można odczytać w sekcji „Ostatnie uruchomienia” na karcie AI.

Dla każdego elementu danych i celu istnieje jedno zatwierdzenie, niezależnie od tego, które AI o nie poprosiło (AI wysyłające żądanie jest zapisywane tylko w dzienniku dostępu). Dostępne okresy to „Tylko tym razem”, „24 godziny”, „7 dni”, „30 dni” i „Zawsze”, a zatwierdzenia można cofnąć na liście zatwierdzeń na karcie AI. Cofnięcie nie anuluje żądania, które dotarło już do celu, ani wartości przekazanej już uruchomionemu programowi.

Obrazy, takie jak pieczęcie i podpisy, są przechowywane po to, aby można je było wyświetlać i kopiować; nie ma funkcji pozwalającej AI używać ich automatycznie. Nie ma też funkcji automatycznego wypełniania formularzy w przeglądarce ani uzupełniania dokumentów w imieniu użytkownika.

Przy env lub file zatwierdzony proces otrzymuje prawdziwą wartość. Nawet send, proxy i agent mogą pośrednio ujawnić sekret zapisany w zatwierdzonej usłudze i odczytany inną drogą. Nie zapisuj sekretów w dokumentach, logach ani wiadomościach dostępnych dla AI. System, aplikacja i cel muszą być zaufane.

Wyłączenie dostępu AI wstrzymuje używanie sekretu i zachowuje zgody czasowe, w tym Zawsze. Po ponownym włączeniu nowe żądania mogą z nich korzystać, jeśli wartość i miejsce użycia się nie zmieniły; pierwotny termin ważności nie jest przedłużany. Wcześniejsze oczekujące żądania i zgody jednorazowe nie są wznawiane. Aby anulować zgodę, wybierz Cofnij zgodę. Udostępnianie jako dane jawne to osobne ustawienie.

Oznaczanie danych jako „To nie jest sekret”

Ustawienia, które AI musi odczytywać bez zmian, takie jak numery portów, publiczne adresy URL i identyfikatory projektów, oznacza się jako „To nie jest sekret” w widoku szczegółów elementu danych. To osobne ustawienie od opcji „Dostęp AI” i domyślnie jest wyłączone. Połączone AI odczytuje wartość oznaczoną jako „To nie jest sekret” bezpośrednio za pomocą specjalnego narzędzia odczytu; może ją odczytać również AI połączone później. Nawet gdy opcja „Dostęp AI” jest wyłączona, wartość oznaczona jako „To nie jest sekret” nadal może być odczytana za pomocą narzędzia odczytu, ale nie pojawia się na listach używanych przez opcje „Wstrzyknij do uruchomienia” i „Wyślij w moim imieniu”. Wartości „To nie jest sekret” nie są maskowane na ekranie: tekst jest w całości widoczny na liście i w widoku szczegółów, a obrazy są wyświetlane jako mały podgląd na liście i duży obraz w widoku szczegółów.

W oknach dodawania i edycji oznaczenie wartości jako niepoufnej od razu ją wyświetla. Ikona oka pozostaje na miejscu, ale jest wyszarzona i nieaktywna.

1. Otwórz szczegóły danych lub okno edycji i włącz opcję „To nie jest sekret”. Przeczytaj ostrzeżenie, że wartości już wysłanych do AI nie można wycofać, a następnie wybierz «Rozumiem, oznacz jako „To nie jest sekret”». Tego ustawienia nie można zmienić z poziomu wiersza listy. Na listach i w szczegółach ikona oka ma kolor ostrzegawczy.
2. W podglądzie importu .env elementy będące kandydatami można oznaczyć w ten sam sposób.
3. Wyłączenie oznaczenia blokuje kolejne odczyty, ale nie cofa wartości już wysłanych do AI. Podczas tworzenia i edycji danych oraz grup ustawienie pozostaje włączone przy wpisywaniu, a tekst jest widoczny. Zapisanie z włączoną opcją udostępnia także zmienioną wartość. Przywrócenie kopii zapasowej wyłącza oznaczenie.

Wartość oznaczona jako „To nie jest sekret” może trafić do wybranej usługi AI i po wysłaniu nie można jej już wycofać. Nie oznaczaj w ten sposób haseł ani kluczy API; zamiast tego użyj opcji „Wyślij w moim imieniu” lub „Wstaw do uruchomienia”.

Aktualizacje i weryfikacja plików

W Ustawieniach → Ogólne → Aktualizacje aplikacji włącz automatyczne sprawdzanie i pobieranie albo sprawdź dostępność aktualizacji ręcznie. Podczas pobierania nadal możesz korzystać z sejfu. Gotowa aktualizacja zostanie zainstalowana przy następnym otwarciu aplikacji; możesz też po zakończeniu edycji wybrać „Zaktualizuj i uruchom ponownie”. Jeśli podpisane aktualizacje nie są jeszcze gotowe, sprawdź stan wydania na oficjalnej stronie pobierania.

Aktualizacja blokuje sejf i zastępuje pliki aplikacji, zachowując zapisane informacje. Aby zaktualizować aplikację ręcznie, uruchom nowy oficjalny instalator i pozostaw dotychczasową lokalizację instalacji. W przypadku podpisanego wydania publicznego sprawdź wydawcę w sekcji Podpisy cyfrowe we właściwościach pliku Windows. Niepodpisane wewnętrzne kompilacje testowe nie są podpisanymi wydaniami publicznymi. SHA-256 to dodatkowa kontrola integralności.

Od wersji Bossanova 0.1.41 odinstalowanie aplikacji w systemie Windows powoduje wylogowanie. Jeśli zachowasz sejf, po ponownej instalacji zaloguj się na to samo konto i otwórz go hasłem głównym. Odinstalowanie domyślnie zachowuje dane sejfu. Wybranie usunięcia danych w deinstalatorze systemu Windows może również usunąć sejf. Zewnętrzne kopie zapasowe są niezależne. Aby przejść na nowy komputer, użyj eksportu i importu w tej samej sieci Wi-Fi. Można też odtworzyć zewnętrzną kopię.

Aktualizacje są pobierane w tle bez wysyłania zawartości sejfu ani danych konta.

Get-FileHash .\Bossanova-Setup.exe -Algorithm SHA256

Nie usuwaj folderu danych sejfu. Jeśli podpis lub suma kontrolna się nie zgadza, nie uruchamiaj pliku i sprawdź oficjalne wydanie.

Rozwiązywanie problemów

1. Jeśli aplikacja się nie otwiera, sprawdź wersję systemu Windows, obsługę x64 i ewentualny komunikat dotyczący WebView2. Zanim zareagujesz na ostrzeżenie programu zabezpieczającego, sprawdź stan wydania i plik na oficjalnej stronie pobierania.
2. Jeśli wyszukiwanie nie zwraca wyników, sprawdź stan blokady sejfu i zapytanie. Jeśli dodawanie danych lub import pliku .env jest zablokowany, sprawdź limit danych planu (10 w planie Free) i stan subskrypcji.
3. Jeśli brakuje narzędzi AI, upewnij się, że przełącznik połączenia tego AI jest włączony w Ustawieniach → AI, a następnie rozpocznij nową rozmowę. AI w WSL i systemie Windows jest wyświetlane osobno, dlatego połącz to, którego faktycznie używasz. Aplikację Claude i aplikację ChatGPT trzeba ponownie uruchomić po połączeniu, aby narzędzia się pojawiły.
4. Włączenie połączenia w Ustawieniach → AI udziela zgody na połączenie. Nie pojawia się druga karta zgody; uprawnienia do używania danych pozostają osobne. Stare oczekujące lub odrzucone połączenia trzeba włączyć ręcznie. Przy DENIED sprawdź reason, detail i connection. Ponowne połączenie samo nie nadaje uprawnień.
5. Jeśli AI informuje, że nie otrzymało dziennika uruchomienia, oznacza to, że polecenie wypisało wartość. Odczytaj zamaskowany dziennik w sekcji „Ostatnie uruchomienia” na karcie AI i zmień polecenie tak, aby nie wypisywało wartości.
6. Windows curl z Schannel ignoruje SSL_CERT_FILE. Przekaż tę ścieżkę przez --cacert w zatwierdzonym procesie. --ssl-revoke-best-effort stosuj tylko przy brakujących lub niedostępnych listach odwołań, nigdy --insecure. Dla Windows gh rozważ WSL. Podpisy AWS wymagają odpowiedniego nośnika, np. env lub file. Przy docker login proces może odczytać plik nośnika file do --password-stdin. Usuń tymczasowy DOCKER_CONFIG po użyciu.
7. Aby uzyskać pomoc, prześlij treść błędu, system operacyjny, wersję aplikacji i kroki prowadzące do odtworzenia problemu. Nie przesyłaj haseł, plików sejfu, wartości sekretów ani tokenów połączeń.

Bossanova nie kontroluje systemu operacyjnego ani innych programów. Przyznanie AI szerokiego dostępu do funkcji administratora, plików, ekranów lub pamięci, a także przejęcie komputera, może doprowadzić do ujawnienia informacji innymi drogami. Szczegółowe informacje znajdziesz w komunikacie o ochronie sekretów.