# Sử dụng lệnh dvina

> Tìm hiểu lệnh dvina làm gì khi Dvina chạy mã cho bạn, các lệnh có sẵn và những lệnh cần bạn phê duyệt.

Khi Dvina chạy mã hoặc lệnh cho bạn, Dvina có một lệnh riêng: `dvina`. Với lệnh này, một tập lệnh hoặc một chuỗi bước có thể tìm kiếm trong Dvina của bạn, đọc và thêm tài liệu, bộ nhớ và tác vụ, cũng như kiểm tra ai có quyền truy cập vào một mục, dưới danh tính của bạn.

Bạn không cần cài đặt hay đăng nhập. Dvina dùng lệnh này khi yêu cầu của bạn cần đến, và bạn cũng có thể yêu cầu trực tiếp, chẳng hạn: "Dùng dvina để liệt kê các tác vụ của tôi và viết bản tóm tắt dưới dạng ghi chú."

## Cách hoạt động

- `dvina` hoạt động trên Dvina của bạn, dưới danh tính của bạn, trong phạm vi quyền mà vai trò của bạn cho phép và các giới hạn thông thường của bạn.
- Quyền truy cập chỉ có hiệu lực trong thời gian Dvina xử lý yêu cầu của bạn. Khi câu trả lời kết thúc, lệnh không còn truy cập được Dvina của bạn.
- Lệnh chỉ đọc tệp hoặc thư mục khi tên tệp hoặc thư mục đó được chỉ định trong lệnh, chẳng hạn như tệp cần tải lên.

## Các lệnh

Các lệnh được chia thành nhóm: `dvina <group> <command>`, theo sau là các đối số và cờ của lệnh.

| Nhóm      | Các lệnh                                                                                                                 |
| ---------- | ------------------------------------------------------------------------------------------------------------------------ |
| `search`   | `dvina search <query>`: tìm kiếm đồng thời trong các cuộc trò chuyện, tài liệu, bộ nhớ và thế giới của bạn.                                          |
| `memory`   | `ls`, `show`, `add`, `edit`: liệt kê, đọc, thêm hoặc thay đổi các tệp bộ nhớ của bạn.                                                |
| `world`    | `topics`, `topic`, `recall`, `feed`: các chủ đề của bạn, những gì Dvina biết về một điều gì đó và Bảng tin của bạn.                       |
| `docs`     | `ls`, `show`, `read`, `search`, `create`, `upload`, `update`, `mv`, `mkdir`, `rm`: các tài liệu và thư mục trong Thư viện của bạn. |
| `canvas`   | `ls`, `show`, `create`, `write-page`: liệt kê, đọc, tạo hoặc viết lại các trang canvas.                                        |
| `tasks`    | `ls`, `show`, `start`, `continue`, `stop`: các tác vụ chạy nền của bạn.                                                        |
| `goals`    | `show`, `start`: các tác vụ hướng đến một mục tiêu.                                                                          |
| `schedule` | `ls`, `add`, `cancel`: tin nhắn và lời nhắc được lên lịch, một lần hoặc lặp lại.                                              |
| `agents`   | `ls`, `show`, `create`, `update`: các tác nhân của bạn.                                                                           |
| `skills`   | `ls`, `show`, `add`, `edit`: các kỹ năng của bạn.                                                                                |
| `projects` | `ls`, `show`: các dự án của bạn.                                                                                             |
| `settings` | `get`, `set`: các tùy chọn của bạn, như bật hoặc tắt bộ nhớ.                                                           |
| `share`    | `state`, `with-me`, `add`, `rm`: ai có quyền truy cập vào một mục, những gì người khác đã chia sẻ với bạn, và việc cấp hoặc thu hồi quyền truy cập.  |

`dvina` không thể xóa vĩnh viễn bất cứ thứ gì, mở liên kết công khai, kết nối hoặc ngắt kết nối ứng dụng, hay thay đổi cài đặt quản trị hoặc thanh toán.

### Trợ giúp và đầu ra

- `dvina --help` liệt kê các nhóm, `dvina <group> --help` liệt kê các lệnh trong một nhóm, và `dvina <group> <command> --help` liệt kê các đối số và cờ của một lệnh.
- Đầu ra là văn bản ngắn gọn. Thêm `--json` để nhận JSON, hoặc `--fields` kèm danh sách phân cách bằng dấu phẩy, như `--fields id,title`, để chỉ giữ lại một số trường.
- Danh sách dài kết thúc bằng `next: --cursor <c>`. Chạy lại lệnh với `--cursor` đó để lấy trang tiếp theo.
- Để đọc một giá trị từ tệp, thêm `-file` vào cờ tương ứng, như `--content-file notes.md`. `dvina docs upload <file>` tải một tệp lên, và `dvina skills add <folder>` thêm một thư mục kỹ năng cùng với tệp SKILL.md của thư mục đó.

### Mã thoát

| Mã | Ý nghĩa                                                                       |
| ---- | ----------------------------------------------------------------------------- |
| `0`  | Hoàn tất.                                                                         |
| `1`  | Đã xảy ra lỗi khác.                                                    |
| `2`  | Lệnh không đúng. Kiểm tra `--help` của lệnh.                                     |
| `3`  | Không tìm thấy.                                                                    |
| `4`  | Bị từ chối: quyền truy cập của bạn, quy định của công ty hoặc cơ chế bảo vệ dữ liệu không cho phép. |
| `5`  | Cần bạn phê duyệt.                                                       |
| `6`  | Bạn đã đạt giới hạn sử dụng.                                              |

## Phê duyệt thay đổi

- Các lệnh đọc chạy mà không cần hỏi bạn.
- Các lệnh thêm nội dung mới, như `docs create`, `memory add` hoặc `tasks start`, chạy mà không cần hỏi bạn. Các lệnh này không bao giờ thay đổi nội dung đã có.
- Các lệnh thay đổi hoặc xóa nội dung sẽ hỏi bạn trước: di chuyển, đổi tên, chuyển vào thùng rác, thay thế ghi chú hoặc tệp bộ nhớ, viết lại trang canvas, thay đổi tác nhân hoặc kỹ năng, dừng tác vụ, hủy tin nhắn đã lên lịch và chia sẻ. Dvina hiển thị một thẻ phê duyệt trong cuộc trò chuyện kèm bản tóm tắt thay đổi do Dvina viết, và hỏi bạn mỗi lần. Nếu bạn từ chối, sẽ không có gì thay đổi.

Những gì `dvina` thêm hoặc thay đổi đều được kiểm tra theo quy định bảo vệ dữ liệu của công ty bạn và được ghi vào [nhật ký kiểm tra](/docs/teams/audit-log) của bạn, giống như các hành động khác của Dvina.

## Nội dung liên quan

- [Sử dụng Dvina từ các ứng dụng khác qua MCP](/docs/dvina-mcp/overview)
- [Tác vụ](/docs/use-dvina/features/tasks)
- [Tổng quan về trình kết nối](/docs/connectors/overview)