# Tumia amri ya dvina

> Jifunze amri ya dvina hufanya nini Dvina inapotekeleza msimbo kwa niaba yako, ina amri zipi, na zipi zinahitaji idhini yako.

Dvina inapotekeleza msimbo au amri kwa niaba yako, ina amri yake yenyewe: `dvina`. Kwa kuitumia, hati ya msimbo au hatua chache zinazofuatana zinaweza kutafuta kwenye Dvina yako, kusoma na kuongeza hati, kumbukumbu na kazi, na kuangalia nani ana ruhusa ya kufikia kipengee, kwa utambulisho wako.

Huhitaji kusakinisha chochote wala kuingia katika akaunti. Dvina hutumia amri hii ombi lako linapoihitaji, na unaweza kuomba itumike, kwa mfano: "Tumia dvina kuorodhesha kazi zangu na kuandika muhtasari kama dokezo."

## Jinsi inavyofanya kazi

- `dvina` hufanya kazi kwenye Dvina yako mwenyewe, kwa utambulisho wako, kulingana na ruhusa za jukumu lako na ndani ya vikomo vyako vya kawaida.
- Ruhusa yake ya kufikia Dvina yako hudumu tu wakati Dvina inashughulikia ombi lako. Jibu linapokamilika, amri haiwezi tena kufikia Dvina yako.
- Husoma faili au folda tu ikiwa amri inaitaja, kama vile faili ya kupakia.

## Amri

Amri zimepangwa katika makundi: `dvina <group> <command>`, kisha hoja na viashiria vya amri hiyo.

| Kundi      | Amri                                                                                                                 |
| ---------- | ------------------------------------------------------------------------------------------------------------------------ |
| `search`   | `dvina search <query>`: tafuta kwenye mazungumzo, hati, kumbukumbu na ulimwengu wako kwa wakati mmoja.                                          |
| `memory`   | `ls`, `show`, `add`, `edit`: orodhesha, soma, ongeza au badilisha faili zako za kumbukumbu.                                                |
| `world`    | `topics`, `topic`, `recall`, `feed`: mada zako, kile Dvina inachojua kuhusu jambo fulani, na Mlisho wako.                       |
| `docs`     | `ls`, `show`, `read`, `search`, `create`, `upload`, `update`, `mv`, `mkdir`, `rm`: hati na folda za Maktaba yako. |
| `canvas`   | `ls`, `show`, `create`, `write-page`: orodhesha, soma, unda au andika upya kurasa za turubai.                                        |
| `tasks`    | `ls`, `show`, `start`, `continue`, `stop`: kazi zako zinazoendeshwa chinichini.                                                        |
| `goals`    | `show`, `start`: kazi zinazofanywa ili kufikia lengo.                                                                          |
| `schedule` | `ls`, `add`, `cancel`: ujumbe na vikumbusho vilivyoratibiwa, vya mara moja au vinavyojirudia.                                              |
| `agents`   | `ls`, `show`, `create`, `update`: mawakala wako.                                                                           |
| `skills`   | `ls`, `show`, `add`, `edit`: ujuzi wako.                                                                                |
| `projects` | `ls`, `show`: miradi yako.                                                                                             |
| `settings` | `get`, `set`: mapendeleo yako, kama kuwasha au kuzima kumbukumbu.                                                           |
| `share`    | `state`, `with-me`, `add`, `rm`: nani ana ruhusa ya kufikia kipengee, kile wengine wameshiriki nawe, na kutoa au kuondoa ruhusa ya kufikia.  |

`dvina` haiwezi kufuta chochote kabisa, kufungua viungo vya umma, kuunganisha au kutenganisha programu, wala kubadilisha mipangilio ya usimamizi au utozaji.

### Msaada na matokeo

- `dvina --help` huorodhesha makundi, `dvina <group> --help` huorodhesha amri za kundi, na `dvina <group> <command> --help` huorodhesha hoja na viashiria vya amri.
- Matokeo ni maandishi mafupi. Ongeza `--json` ili kupata JSON, au `--fields` pamoja na orodha iliyotenganishwa kwa koma, kama `--fields id,title`, ili kubakiza sehemu fulani tu.
- Orodha ndefu huisha kwa `next: --cursor <c>`. Tekeleza amri tena ukitumia `--cursor` hiyo ili kupata ukurasa unaofuata.
- Ili kusoma thamani kutoka kwenye faili, ongeza `-file` kwenye kiashiria chake, kama `--content-file notes.md`. `dvina docs upload <file>` hupakia faili, na `dvina skills add <folder>` huongeza folda ya ujuzi pamoja na SKILL.md yake.

### Misimbo ya kutoka

| Msimbo | Maana                                                                       |
| ---- | ----------------------------------------------------------------------------- |
| `0`  | Imekamilika.                                                                         |
| `1`  | Tatizo lingine limetokea.                                                    |
| `2`  | Amri si sahihi. Angalia `--help` yake.                                     |
| `3`  | Haijapatikana.                                                                    |
| `4`  | Imekataliwa: ruhusa zako, kanuni za kampuni yako au ulinzi wa data haviruhusu. |
| `5`  | Inahitaji idhini yako.                                                       |
| `6`  | Umefikia kikomo chako cha matumizi.                                              |

## Idhinisha mabadiliko

- Amri za kusoma hutekelezwa bila kukuomba idhini.
- Amri zinazoongeza kitu kipya, kama `docs create`, `memory add` au `tasks start`, hutekelezwa bila kukuomba idhini. Hazibadilishi kamwe kilichopo tayari.
- Amri zinazobadilisha au kuondoa kitu hukuomba idhini kwanza: kuhamisha, kubadilisha jina, kuhamishia kwenye tupio, kubadilisha dokezo au faili ya kumbukumbu kwa nyingine, kuandika upya ukurasa wa turubai, kubadilisha wakala au ujuzi, kusimamisha kazi, kughairi ujumbe ulioratibiwa, na kushiriki. Dvina huonyesha kadi ya idhini kwenye mazungumzo ikiwa na muhtasari wake wa mabadiliko, na hukuomba idhini kila mara. Ukikataa, hakuna kinachobadilika.

Kile `dvina` inachoongeza au kubadilisha hupitia kanuni za kampuni yako za ulinzi wa data na kurekodiwa kwenye [kumbukumbu yako ya ukaguzi](/docs/teams/audit-log), sawa na vitendo vingine vya Dvina.

## Yanayohusiana

- [Tumia Dvina kutoka kwenye programu nyingine kwa MCP](/docs/dvina-mcp/overview)
- [Kazi](/docs/use-dvina/features/tasks)
- [Muhtasari wa viunganishi](/docs/connectors/overview)