# Gamitin ang command na dvina

> Alamin kung ano ang ginagawa ng command na dvina kapag nagpapatakbo ang Dvina ng code para sa iyo, kung anong mga command ang mayroon ito, at alin ang nangangailangan ng iyong pag-apruba.

Kapag nagpapatakbo ang Dvina ng code o mga command para sa iyo, mayroon itong sariling command: `dvina`. Gamit ito, maaaring maghanap sa iyong Dvina ang isang script o ilang magkakasunod na hakbang, magbasa at magdagdag ng mga dokumento, memory at task, at tingnan kung sino ang may access sa isang item, sa ngalan mo.

Wala kang kailangang i-install o i-sign in. Ginagamit ng Dvina ang command kapag kailangan ito para sa iyong kahilingan, at maaari mo ring hilingin ito, gaya ng "Gamitin ang dvina para ilista ang mga task ko at magsulat ng buod bilang isang tala."

## Paano ito gumagana

- Gumagana ang `dvina` sa sarili mong Dvina, sa ngalan mo, ayon sa pinapayagan ng iyong tungkulin at sa loob ng iyong karaniwang mga limitasyon.
- May access lang ito habang ginagawa ng Dvina ang iyong kahilingan. Kapag natapos ang tugon, hindi na maa-access ng command ang iyong Dvina.
- Nagbabasa lang ito ng file o folder kapag tinukoy ito sa isang command, gaya ng file na ia-upload.

## Mga command

Nakaayos ang mga command sa mga grupo: `dvina <group> <command>`, na sinusundan ng mga argument at flag ng command.

| Grupo      | Mga command                                                                                                                 |
| ---------- | ------------------------------------------------------------------------------------------------------------------------ |
| `search`   | `dvina search <query>`: sabay-sabay na maghanap sa iyong mga chat, dokumento, memory at mundo.                                          |
| `memory`   | `ls`, `show`, `add`, `edit`: ilista, basahin, idagdag o baguhin ang iyong mga memory file.                                                |
| `world`    | `topics`, `topic`, `recall`, `feed`: ang iyong mga paksa, ang alam ng Dvina tungkol sa isang bagay, at ang iyong Feed.                       |
| `docs`     | `ls`, `show`, `read`, `search`, `create`, `upload`, `update`, `mv`, `mkdir`, `rm`: ang mga dokumento at folder sa iyong Library. |
| `canvas`   | `ls`, `show`, `create`, `write-page`: ilista, basahin, gumawa o isulat muli ang mga pahina ng canvas.                                        |
| `tasks`    | `ls`, `show`, `start`, `continue`, `stop`: ang iyong mga task na tumatakbo sa background.                                                        |
| `goals`    | `show`, `start`: mga task na tumutulong makamit ang isang layunin.                                                                          |
| `schedule` | `ls`, `add`, `cancel`: mga nakaiskedyul na mensahe at paalala, minsanan o paulit-ulit.                                              |
| `agents`   | `ls`, `show`, `create`, `update`: ang iyong mga agent.                                                                           |
| `skills`   | `ls`, `show`, `add`, `edit`: ang iyong mga skill.                                                                                |
| `projects` | `ls`, `show`: ang iyong mga proyekto.                                                                                             |
| `settings` | `get`, `set`: ang iyong mga kagustuhan, gaya ng pag-on o pag-off ng memory.                                                           |
| `share`    | `state`, `with-me`, `add`, `rm`: kung sino ang may access sa isang item, kung ano ang ibinahagi sa iyo ng iba, at pagbibigay o pag-alis ng access.  |

Hindi kayang permanenteng magtanggal ng anuman, magbukas ng mga pampublikong link, kumonekta o magdiskonekta ng mga app, o magbago ng mga setting ng admin o pagsingil ang `dvina`.

### Tulong at output

- Inililista ng `dvina --help` ang mga grupo, inililista ng `dvina <group> --help` ang mga command ng isang grupo, at inililista ng `dvina <group> <command> --help` ang mga argument at flag ng isang command.
- Maikling teksto ang output. Idagdag ang `--json` para sa JSON, o ang `--fields` na may listahang pinaghihiwalay ng mga kuwit, gaya ng `--fields id,title`, para ilang field lang ang isama.
- Nagtatapos ang mahabang listahan sa `next: --cursor <c>`. Patakbuhin muli ang command gamit ang `--cursor` na iyon para makuha ang susunod na pahina.
- Para magbasa ng value mula sa isang file, idagdag ang `-file` sa flag nito, gaya ng `--content-file notes.md`. Nag-a-upload ng file ang `dvina docs upload <file>`, at nagdadagdag ng skill folder kasama ang SKILL.md nito ang `dvina skills add <folder>`.

### Mga exit code

| Code | Kahulugan                                                                       |
| ---- | ----------------------------------------------------------------------------- |
| `0`  | Tapos na.                                                                         |
| `1`  | May iba pang nagkaproblema.                                                    |
| `2`  | Mali ang command. Tingnan ang `--help` nito.                                     |
| `3`  | Hindi nahanap.                                                                    |
| `4`  | Tinanggihan: hindi ito pinapayagan ng iyong access, ng mga patakaran ng iyong kumpanya o ng proteksyon ng data. |
| `5`  | Kailangan nito ang iyong pag-apruba.                                                       |
| `6`  | Naabot mo na ang iyong limitasyon sa paggamit.                                              |

## Aprubahan ang mga pagbabago

- Tumatakbo ang mga command na nagbabasa nang hindi humihingi ng pahintulot.
- Tumatakbo ang mga command na nagdadagdag ng bago, gaya ng `docs create`, `memory add` o `tasks start`, nang hindi humihingi ng pahintulot. Hindi nila kailanman binabago ang anumang naroon na.
- Humihingi muna ng pahintulot ang mga command na nagbabago o nag-aalis ng anuman: paglipat, pagpapalit ng pangalan, paglipat sa basurahan, pagpapalit ng tala o memory file, muling pagsulat ng pahina ng canvas, pagbabago ng agent o skill, pagpapahinto ng task, pagkansela ng nakaiskedyul na mensahe, at pagbabahagi. Nagpapakita ang Dvina ng card para sa pag-apruba sa chat na may sarili nitong buod ng pagbabago, at humihingi ito ng pahintulot sa bawat pagkakataon. Kapag tinanggihan mo ito, walang magbabago.

Ang anumang idinadagdag o binabago ng `dvina` ay dumadaan sa mga patakaran sa proteksyon ng data ng iyong kumpanya at itinatala sa iyong [audit log](/docs/teams/audit-log), tulad ng iba pang mga pagkilos ng Dvina.

## Mga kaugnay na paksa

- [Gamitin ang Dvina mula sa iba pang app gamit ang MCP](/docs/dvina-mcp/overview)
- [Mga task](/docs/use-dvina/features/tasks)
- [Pangkalahatang-ideya ng mga connector](/docs/connectors/overview)
