# Upotreba naredbe dvina

> Saznajte što naredba dvina radi kad Dvina za vas izvršava kod, koje su naredbe dostupne i koje traže vaše odobrenje.

Kad Dvina za vas izvršava kod ili naredbe, na raspolaganju ima vlastitu naredbu: `dvina`. Uz nju skripta ili nekoliko uzastopnih koraka mogu u vaše ime pretraživati vaše okruženje Dvina, čitati i dodavati dokumente, memoriju i zadatke te provjeravati tko ima pristup pojedinoj stavci.

Ne trebate ništa instalirati niti se prijavljivati. Dvina upotrebljava naredbu kad to vaš zahtjev traži, a možete je i izričito zatražiti, primjerice: „Upotrijebi dvina za popis mojih zadataka i napiši sažetak kao bilješku.”

## Kako radi

- `dvina` radi u vašem okruženju Dvina, u vaše ime, uz ovlasti koje dopušta vaša uloga i unutar vaših uobičajenih ograničenja.
- Pristup traje samo dok Dvina obrađuje vaš zahtjev. Kad odgovor završi, naredba više ne može pristupiti vašem okruženju Dvina.
- Datoteku ili mapu čita samo kad je navedena u naredbi, primjerice kao datoteka za prijenos.

## Naredbe

Naredbe su podijeljene u grupe: `dvina <group> <command>`, nakon čega slijede argumenti i zastavice naredbe.

| Grupa      | Naredbe                                                                                                                 |
| ---------- | ------------------------------------------------------------------------------------------------------------------------ |
| `search`   | `dvina search <query>`: istodobno pretražite svoje razgovore, dokumente, memoriju i svijet.                                          |
| `memory`   | `ls`, `show`, `add`, `edit`: pregledajte popis, čitajte, dodajte ili mijenjajte datoteke memorije.                                                |
| `world`    | `topics`, `topic`, `recall`, `feed`: vaše teme, ono što Dvina zna o nečemu i vaš Feed.                       |
| `docs`     | `ls`, `show`, `read`, `search`, `create`, `upload`, `update`, `mv`, `mkdir`, `rm`: vaši dokumenti i mape u odjeljku Library. |
| `canvas`   | `ls`, `show`, `create`, `write-page`: pregledajte popis, čitajte, stvarajte ili prepisujte stranice platna.                                        |
| `tasks`    | `ls`, `show`, `start`, `continue`, `stop`: vaši pozadinski zadaci.                                                        |
| `goals`    | `show`, `start`: zadaci koji rade na ostvarenju cilja.                                                                          |
| `schedule` | `ls`, `add`, `cancel`: zakazane poruke i podsjetnici, jednokratni ili ponavljajući.                                              |
| `agents`   | `ls`, `show`, `create`, `update`: vaši agenti.                                                                           |
| `skills`   | `ls`, `show`, `add`, `edit`: vaše vještine.                                                                                |
| `projects` | `ls`, `show`: vaši projekti.                                                                                             |
| `settings` | `get`, `set`: vaše postavke, poput uključivanja ili isključivanja memorije.                                                           |
| `share`    | `state`, `with-me`, `add`, `rm`: tko ima pristup stavci, što su drugi podijelili s vama te dodjeljivanje ili uklanjanje pristupa.  |

`dvina` ne može ništa trajno izbrisati, otvarati javne poveznice, povezivati ili odspajati aplikacije ni mijenjati administratorske postavke ili postavke naplate.

### Pomoć i izlaz

- `dvina --help` prikazuje popis grupa, `dvina <group> --help` popis naredbi u grupi, a `dvina <group> <command> --help` popis argumenata i zastavica naredbe.
- Izlaz je kratak tekst. Dodajte `--json` za JSON ili `--fields` s popisom odvojenim zarezima, primjerice `--fields id,title`, da biste zadržali samo neka polja.
- Dug popis završava s `next: --cursor <c>`. Ponovno pokrenite naredbu s tim `--cursor` da biste dobili sljedeću stranicu.
- Da biste pročitali vrijednost iz datoteke, dodajte `-file` odgovarajućoj zastavici, primjerice `--content-file notes.md`. `dvina docs upload <file>` prenosi datoteku, a `dvina skills add <folder>` dodaje mapu vještine s pripadajućom datotekom SKILL.md.

### Izlazni kodovi

| Kod | Značenje                                                                       |
| ---- | ----------------------------------------------------------------------------- |
| `0`  | Gotovo.                                                                         |
| `1`  | Došlo je do neke druge pogreške.                                                    |
| `2`  | Naredba nije ispravna. Provjerite njezin `--help`.                                     |
| `3`  | Nije pronađeno.                                                                    |
| `4`  | Odbijeno: vaše ovlasti pristupa, pravila vaše tvrtke ili zaštita podataka to ne dopuštaju. |
| `5`  | Potrebno je vaše odobrenje.                                                       |
| `6`  | Dosegnuli ste ograničenje upotrebe.                                              |

## Odobrite promjene

- Naredbe za čitanje izvršavaju se bez traženja odobrenja.
- Naredbe koje dodaju nešto novo, poput `docs create`, `memory add` ili `tasks start`, izvršavaju se bez traženja odobrenja. Nikad ne mijenjaju ono što već postoji.
- Naredbe koje nešto mijenjaju ili uklanjaju najprije traže vaše odobrenje: premještanje, preimenovanje, premještanje u smeće, zamjena bilješke ili datoteke memorije, prepisivanje stranice platna, izmjena agenta ili vještine, zaustavljanje zadatka, otkazivanje zakazane poruke i dijeljenje. Dvina u razgovoru prikazuje karticu za odobrenje s vlastitim sažetkom promjene i svaki put traži odobrenje. Ako odbijete, ništa se ne mijenja.

Sve što `dvina` doda ili promijeni prolazi provjeru prema pravilima zaštite podataka vaše tvrtke i bilježi se u vašem [zapisniku revizije](/docs/teams/audit-log), kao i ostale radnje koje izvodi Dvina.

## Povezano

- [Upotreba Dvina iz drugih aplikacija uz MCP](/docs/dvina-mcp/overview)
- [Zadaci](/docs/use-dvina/features/tasks)
- [Pregled konektora](/docs/connectors/overview)