# Gunakan perintah dvina

> Ketahui fungsi perintah dvina apabila Dvina menjalankan kod untuk anda, perintah yang tersedia dan perintah yang memerlukan kelulusan anda.

Apabila Dvina menjalankan kod atau perintah untuk anda, ia mempunyai perintahnya sendiri: `dvina`. Dengan perintah ini, skrip atau beberapa langkah berturut-turut boleh mencari dalam Dvina anda, membaca dan menambah dokumen, memori serta tugas, dan menyemak siapa yang mempunyai akses kepada sesuatu item, bagi pihak anda.

Anda tidak perlu memasang apa-apa atau log masuk. Dvina menggunakan perintah ini apabila permintaan anda memerlukannya. Anda juga boleh memintanya, seperti "Gunakan dvina untuk menyenaraikan tugas saya dan menulis ringkasan sebagai nota."

## Cara perintah ini berfungsi

- `dvina` berfungsi dalam Dvina anda sendiri, bagi pihak anda, mengikut kebenaran peranan anda dan dalam had biasa anda.
- Aksesnya hanya berlangsung semasa Dvina mengendalikan permintaan anda. Apabila respons selesai, perintah ini tidak lagi boleh mengakses Dvina anda.
- Ia membaca fail atau folder hanya apabila perintah menyebutnya, seperti fail untuk dimuat naik.

## Perintah

Perintah disusun mengikut kumpulan: `dvina <group> <command>`, diikuti oleh argumen dan bendera perintah tersebut.

| Kumpulan   | Perintah                                                                                                                 |
| ---------- | ------------------------------------------------------------------------------------------------------------------------ |
| `search`   | `dvina search <query>`: cari dalam sembang, dokumen, memori dan dunia anda serentak.                                          |
| `memory`   | `ls`, `show`, `add`, `edit`: senaraikan, baca, tambah atau ubah fail memori anda.                                                |
| `world`    | `topics`, `topic`, `recall`, `feed`: topik anda, perkara yang Dvina tahu tentang sesuatu, dan Feed anda.                       |
| `docs`     | `ls`, `show`, `read`, `search`, `create`, `upload`, `update`, `mv`, `mkdir`, `rm`: dokumen dan folder dalam Library anda. |
| `canvas`   | `ls`, `show`, `create`, `write-page`: senaraikan, baca, cipta atau tulis semula halaman kanvas.                                        |
| `tasks`    | `ls`, `show`, `start`, `continue`, `stop`: tugas latar belakang anda.                                                        |
| `goals`    | `show`, `start`: tugas yang dijalankan untuk mencapai matlamat.                                                                          |
| `schedule` | `ls`, `add`, `cancel`: mesej dan peringatan berjadual, sekali atau berulang.                                              |
| `agents`   | `ls`, `show`, `create`, `update`: ejen anda.                                                                           |
| `skills`   | `ls`, `show`, `add`, `edit`: kemahiran anda.                                                                                |
| `projects` | `ls`, `show`: projek anda.                                                                                             |
| `settings` | `get`, `set`: keutamaan anda, seperti menghidupkan atau mematikan memori.                                                           |
| `share`    | `state`, `with-me`, `add`, `rm`: siapa yang mempunyai akses kepada sesuatu item, perkara yang dikongsi oleh orang lain dengan anda, dan pemberian atau penarikan akses.  |

`dvina` tidak boleh memadam apa-apa secara kekal, membuka pautan awam, menyambungkan atau memutuskan sambungan aplikasi, atau mengubah tetapan pentadbir atau pengebilan.

### Bantuan dan output

- `dvina --help` menyenaraikan kumpulan, `dvina <group> --help` menyenaraikan perintah dalam kumpulan, dan `dvina <group> <command> --help` menyenaraikan argumen dan bendera perintah.
- Output berupa teks ringkas. Tambahkan `--json` untuk JSON, atau `--fields` dengan senarai yang dipisahkan oleh koma, seperti `--fields id,title`, untuk mengekalkan medan tertentu sahaja.
- Senarai panjang berakhir dengan `next: --cursor <c>`. Jalankan perintah itu semula dengan `--cursor` tersebut untuk mendapatkan halaman seterusnya.
- Untuk membaca nilai daripada fail, tambahkan `-file` pada benderanya, seperti `--content-file notes.md`. `dvina docs upload <file>` memuat naik fail, dan `dvina skills add <folder>` menambah folder kemahiran bersama fail SKILL.md di dalamnya.

### Kod keluar

| Kod  | Maksud                                                                        |
| ---- | ----------------------------------------------------------------------------- |
| `0`  | Selesai.                                                                         |
| `1`  | Masalah lain berlaku.                                                    |
| `2`  | Perintah tidak betul. Semak `--help` untuk perintah itu.                                     |
| `3`  | Tidak ditemukan.                                                                    |
| `4`  | Ditolak: akses anda, peraturan syarikat anda atau perlindungan data tidak membenarkannya. |
| `5`  | Kelulusan anda diperlukan.                                                       |
| `6`  | Anda telah mencapai had penggunaan anda.                                              |

## Luluskan perubahan

- Perintah yang membaca maklumat dijalankan tanpa meminta kelulusan.
- Perintah yang menambah sesuatu yang baharu, seperti `docs create`, `memory add` atau `tasks start`, dijalankan tanpa meminta kelulusan. Perintah ini tidak pernah mengubah perkara yang sudah ada.
- Perintah yang mengubah atau membuang sesuatu meminta kelulusan anda terlebih dahulu: memindahkan, menamakan semula, memindahkan ke tong sampah, menggantikan nota atau fail memori, menulis semula halaman kanvas, mengubah ejen atau kemahiran, menghentikan tugas, membatalkan mesej berjadual, dan berkongsi. Dvina memaparkan kad kelulusan dalam sembang dengan ringkasannya sendiri tentang perubahan itu, dan meminta kelulusan setiap kali. Apabila anda menolaknya, tiada apa-apa yang berubah.

Apa-apa yang ditambah atau diubah oleh `dvina` tertakluk pada peraturan perlindungan data syarikat anda dan direkodkan dalam [log audit](/docs/teams/audit-log) anda, sama seperti tindakan Dvina yang lain.

## Berkaitan

- [Gunakan Dvina daripada aplikasi lain dengan MCP](/docs/dvina-mcp/overview)
- [Tugas](/docs/use-dvina/features/tasks)
- [Gambaran keseluruhan penyambung](/docs/connectors/overview)