# A dvina parancs használata

> Ismerd meg, mire szolgál a dvina parancs, amikor Dvina kódot futtat neked, milyen parancsai vannak, és melyekhez kell a jóváhagyásod.

Amikor Dvina kódot vagy parancsokat futtat neked, egy saját parancsot is használhat: `dvina`. Ezzel egy szkript vagy néhány egymást követő lépés a nevedben kereshet a Dvina-tartalmaid között, olvashat és hozzáadhat dokumentumokat, emlékeket és feladatokat, valamint ellenőrizheti, ki fér hozzá egy elemhez.

Nem kell semmit telepítened, és bejelentkezned sem kell. Dvina akkor használja a parancsot, ha a kérésedhez szükség van rá, de külön is kérheted, például így: „A dvina segítségével listázd a feladataimat, és írd meg az összefoglalójukat egy jegyzetben.”

## Hogyan működik?

- A `dvina` a saját Dvina-környezetedben, a nevedben működik, a szerepköröd által engedélyezett műveletekkel és a szokásos korlátaidon belül.
- Csak addig fér hozzá, amíg Dvina a kéréseden dolgozik. Amint a válasz véget ér, a parancs már nem fér hozzá a Dvina-környezetedhez.
- Csak akkor olvas be egy fájlt vagy mappát, ha egy parancs megnevezi azt, például egy feltöltendő fájlt.

## Parancsok

A parancsok csoportokba rendeződnek: `dvina <group> <command>`, majd a parancs argumentumai és kapcsolói következnek.

| Csoport      | Parancsok                                                                                                                 |
| ---------- | ------------------------------------------------------------------------------------------------------------------------ |
| `search`   | `dvina search <query>`: keresés egyszerre a beszélgetéseid, dokumentumaid, emlékeid és világod tartalmai között.                                          |
| `memory`   | `ls`, `show`, `add`, `edit`: memóriafájljaid listázása, olvasása, hozzáadása vagy módosítása.                                                |
| `world`    | `topics`, `topic`, `recall`, `feed`: a témáid, Dvina ismeretei egy adott dologról és a Feed tartalmaid.                       |
| `docs`     | `ls`, `show`, `read`, `search`, `create`, `upload`, `update`, `mv`, `mkdir`, `rm`: a Library dokumentumai és mappái. |
| `canvas`   | `ls`, `show`, `create`, `write-page`: vászonoldalak listázása, olvasása, létrehozása vagy újraírása.                                        |
| `tasks`    | `ls`, `show`, `start`, `continue`, `stop`: a háttérben futó feladataid.                                                        |
| `goals`    | `show`, `start`: egy cél elérésén dolgozó feladatok.                                                                          |
| `schedule` | `ls`, `add`, `cancel`: egyszeri vagy ismétlődő ütemezett üzenetek és emlékeztetők.                                              |
| `agents`   | `ls`, `show`, `create`, `update`: az ügynökeid.                                                                           |
| `skills`   | `ls`, `show`, `add`, `edit`: a készségeid.                                                                                |
| `projects` | `ls`, `show`: a projektjeid.                                                                                             |
| `settings` | `get`, `set`: a beállításaid, például a memória be- vagy kikapcsolása.                                                           |
| `share`    | `state`, `with-me`, `add`, `rm`: ki fér hozzá egy elemhez, mit osztottak meg veled mások, valamint hozzáférés megadása vagy visszavonása.  |

A `dvina` nem tud semmit véglegesen törölni, nyilvános linkeket megnyitni, alkalmazásokat csatlakoztatni vagy leválasztani, illetve adminisztrátori vagy számlázási beállításokat módosítani.

### Súgó és kimenet

- A `dvina --help` a csoportokat, a `dvina <group> --help` egy csoport parancsait, a `dvina <group> <command> --help` pedig egy parancs argumentumait és kapcsolóit listázza.
- A kimenet rövid szöveg. JSON-kimenethez add hozzá a `--json` kapcsolót, vagy csak bizonyos mezők megtartásához használd a `--fields` kapcsolót egy vesszőkkel elválasztott listával, például így: `--fields id,title`.
- A hosszú listák végén a `next: --cursor <c>` jelenik meg. A következő oldal lekéréséhez futtasd újra a parancsot ezzel a `--cursor` kapcsolóval.
- Ha egy értéket fájlból szeretnél beolvasni, egészítsd ki a hozzá tartozó kapcsolót a `-file` utótaggal, például így: `--content-file notes.md`. A `dvina docs upload <file>` feltölt egy fájlt, a `dvina skills add <folder>` pedig hozzáad egy készségmappát a benne lévő SKILL.md fájllal együtt.

### Kilépési kódok

| Kód | Jelentés                                                                       |
| ---- | ----------------------------------------------------------------------------- |
| `0`  | Kész.                                                                         |
| `1`  | Egyéb hiba történt.                                                    |
| `2`  | Hibás a parancs. Nézd meg a `--help` súgóját.                                     |
| `3`  | Nem található.                                                                    |
| `4`  | Elutasítva: a hozzáférési jogosultságod, a vállalatod szabályai vagy az adatvédelem nem engedik. |
| `5`  | A jóváhagyásodra van szükség.                                                       |
| `6`  | Elérted a használati korlátodat.                                              |

## Módosítások jóváhagyása

- Az olvasási parancsok jóváhagyás kérése nélkül futnak.
- Az új elemeket hozzáadó parancsok, például a `docs create`, a `memory add` vagy a `tasks start`, jóváhagyás kérése nélkül futnak. A meglévő tartalmakat soha nem módosítják.
- A módosító vagy eltávolító parancsok előbb megkérdezik, hogy jóváhagyod-e a műveletet: ilyen az áthelyezés, az átnevezés, a kukába helyezés, egy jegyzet vagy memóriafájl lecserélése, egy vászonoldal újraírása, egy ügynök vagy készség módosítása, egy feladat leállítása, egy ütemezett üzenet törlése és a megosztás. Dvina egy jóváhagyási kártyát jelenít meg a beszélgetésben a módosítás saját összefoglalójával, és minden alkalommal jóváhagyást kér. Ha elutasítod, semmi sem változik.

A `dvina` által hozzáadott vagy módosított tartalmakra a vállalatod adatvédelmi szabályai vonatkoznak, és a műveletek bekerülnek az [auditnaplódba](/docs/teams/audit-log), ugyanúgy, mint Dvina többi művelete.

## Kapcsolódó témák

- [Dvina használata más alkalmazásokból MCP-vel](/docs/dvina-mcp/overview)
- [Feladatok](/docs/use-dvina/features/tasks)
- [Csatlakozók áttekintése](/docs/connectors/overview)