# Korzystaj z polecenia dvina

> Dowiedz się, do czego służy polecenie dvina, gdy Dvina uruchamia kod w Twoim imieniu, jakie polecenia są dostępne i które wymagają Twojej zgody.

Gdy Dvina uruchamia kod lub polecenia w Twoim imieniu, ma do dyspozycji własne polecenie: `dvina`. Dzięki niemu skrypt lub kilka kolejnych kroków może przeszukiwać Twoją Dvina, odczytywać i dodawać dokumenty, pamięć i zadania oraz sprawdzać, kto ma dostęp do danego elementu — w Twoim imieniu.

Nie musisz niczego instalować ani się logować. Dvina używa tego polecenia, gdy wymaga tego Twoja prośba. Możesz też poprosić o nie wprost, na przykład: „Użyj dvina, aby wyświetlić moje zadania i zapisać podsumowanie jako notatkę”.

## Jak to działa

- `dvina` działa w Twojej Dvina, w Twoim imieniu, z uprawnieniami wynikającymi z Twojej roli i w ramach Twoich standardowych limitów.
- Dostęp trwa tylko wtedy, gdy Dvina pracuje nad Twoją prośbą. Po zakończeniu odpowiedzi polecenie nie ma już dostępu do Twojej Dvina.
- Plik lub folder jest odczytywany tylko wtedy, gdy polecenie wskazuje go wprost, na przykład jako plik do przesłania.

## Polecenia

Polecenia są podzielone na grupy: `dvina <group> <command>`, a następnie argumenty i flagi danego polecenia.

| Grupa      | Polecenia                                                                                                                 |
| ---------- | ------------------------------------------------------------------------------------------------------------------------ |
| `search`   | `dvina search <query>`: przeszukuj jednocześnie swoje czaty, dokumenty, pamięć i świat.                                          |
| `memory`   | `ls`, `show`, `add`, `edit`: wyświetlaj listę plików pamięci, odczytuj je, dodawaj lub zmieniaj.                                                |
| `world`    | `topics`, `topic`, `recall`, `feed`: Twoje tematy, wiedza Dvina na dany temat i Twój Feed.                       |
| `docs`     | `ls`, `show`, `read`, `search`, `create`, `upload`, `update`, `mv`, `mkdir`, `rm`: Twoje dokumenty i foldery w Library. |
| `canvas`   | `ls`, `show`, `create`, `write-page`: wyświetlaj listę stron płótna, odczytuj je, twórz lub przepisuj.                                        |
| `tasks`    | `ls`, `show`, `start`, `continue`, `stop`: Twoje zadania w tle.                                                        |
| `goals`    | `show`, `start`: zadania służące realizacji celu.                                                                          |
| `schedule` | `ls`, `add`, `cancel`: zaplanowane wiadomości i przypomnienia, jednorazowe lub cykliczne.                                              |
| `agents`   | `ls`, `show`, `create`, `update`: Twoi agenci.                                                                           |
| `skills`   | `ls`, `show`, `add`, `edit`: Twoje umiejętności.                                                                                |
| `projects` | `ls`, `show`: Twoje projekty.                                                                                             |
| `settings` | `get`, `set`: Twoje preferencje, na przykład włączanie lub wyłączanie pamięci.                                                           |
| `share`    | `state`, `with-me`, `add`, `rm`: sprawdzanie, kto ma dostęp do elementu i co inni Ci udostępnili, oraz przyznawanie lub odbieranie dostępu.  |

`dvina` nie może trwale usuwać elementów, otwierać publicznych linków, łączyć ani odłączać aplikacji ani zmieniać ustawień administracyjnych lub rozliczeniowych.

### Pomoc i wyniki

- `dvina --help` wyświetla grupy, `dvina <group> --help` wyświetla polecenia danej grupy, a `dvina <group> <command> --help` wyświetla argumenty i flagi danego polecenia.
- Wynik ma postać krótkiego tekstu. Dodaj `--json`, aby otrzymać JSON, lub `--fields` z listą rozdzieloną przecinkami, na przykład `--fields id,title`, aby zachować tylko wybrane pola.
- Długa lista kończy się wpisem `next: --cursor <c>`. Uruchom polecenie ponownie z tym `--cursor`, aby pobrać następną stronę.
- Aby odczytać wartość z pliku, dodaj `-file` do jej flagi, na przykład `--content-file notes.md`. `dvina docs upload <file>` przesyła plik, a `dvina skills add <folder>` dodaje folder umiejętności wraz z jego plikiem SKILL.md.

### Kody zakończenia

| Kod | Znaczenie                                                                       |
| ---- | ----------------------------------------------------------------------------- |
| `0`  | Gotowe.                                                                         |
| `1`  | Wystąpił inny błąd.                                                    |
| `2`  | Polecenie jest nieprawidłowe. Sprawdź jego `--help`.                                     |
| `3`  | Nie znaleziono.                                                                    |
| `4`  | Odmowa: Twoje uprawnienia, zasady firmy lub ochrona danych nie pozwalają na tę operację. |
| `5`  | Wymaga Twojej zgody.                                                       |
| `6`  | Twój limit użytkowania został osiągnięty.                                              |

## Zatwierdzaj zmiany

- Polecenia odczytujące dane działają bez pytania o zgodę.
- Polecenia dodające coś nowego, takie jak `docs create`, `memory add` lub `tasks start`, działają bez pytania o zgodę. Nigdy nie zmieniają tego, co już istnieje.
- Polecenia zmieniające lub usuwające coś najpierw pytają Cię o zgodę. Dotyczy to przenoszenia, zmiany nazwy, przenoszenia do kosza, zastępowania notatki lub pliku pamięci, przepisywania strony płótna, zmiany agenta lub umiejętności, zatrzymywania zadania, anulowania zaplanowanej wiadomości i udostępniania. Dvina wyświetla na czacie kartę zatwierdzenia z własnym podsumowaniem zmiany i za każdym razem prosi o zgodę. Jeśli odrzucisz prośbę, nic się nie zmieni.

To, co `dvina` dodaje lub zmienia, podlega zasadom ochrony danych Twojej firmy i jest zapisywane w Twoim [dzienniku audytu](/docs/teams/audit-log), tak samo jak inne działania Dvina.

## Powiązane tematy

- [Korzystaj z Dvina w innych aplikacjach przez MCP](/docs/dvina-mcp/overview)
- [Zadania](/docs/use-dvina/features/tasks)
- [Przegląd konektorów](/docs/connectors/overview)