# Используйте команду dvina

> Узнайте, как работает команда dvina, когда Dvina выполняет код за вас, какие команды доступны и какие из них требуют вашего подтверждения.

Когда Dvina выполняет за вас код или команды, она использует собственную команду — `dvina`. С её помощью скрипт или несколько последовательных шагов могут от вашего имени выполнять поиск в вашей Dvina, читать и добавлять документы, память и задачи, а также проверять, у кого есть доступ к объекту.

Ничего устанавливать или входить в аккаунт не нужно. Dvina использует эту команду, когда это нужно для выполнения вашего запроса. Вы также можете попросить об этом напрямую, например: «Используй dvina, чтобы показать мои задачи и записать краткую сводку в заметку».

## Как это работает

- `dvina` работает в вашей Dvina от вашего имени, с разрешениями вашей роли и в пределах ваших обычных лимитов.
- Доступ действует только пока Dvina работает над вашим запросом. После завершения ответа команда больше не может обращаться к вашей Dvina.
- Команда читает файл или папку, только если они явно указаны в ней, например файл для загрузки.

## Команды

Команды объединены в группы: `dvina <group> <command>`, затем аргументы и флаги команды.

| Группа     | Команды                                                                                                                  |
| ---------- | ------------------------------------------------------------------------------------------------------------------------ |
| `search`   | `dvina search <query>`: поиск сразу по вашим чатам, документам, памяти и миру.                                             |
| `memory`   | `ls`, `show`, `add`, `edit`: просмотр списка, чтение, добавление или изменение файлов памяти.                              |
| `world`    | `topics`, `topic`, `recall`, `feed`: ваши темы, сведения Dvina о чём-либо и ваша Лента.                                     |
| `docs`     | `ls`, `show`, `read`, `search`, `create`, `upload`, `update`, `mv`, `mkdir`, `rm`: документы и папки вашей Библиотеки.       |
| `canvas`   | `ls`, `show`, `create`, `write-page`: просмотр списка, чтение, создание или перезапись страниц холста.                     |
| `tasks`    | `ls`, `show`, `start`, `continue`, `stop`: ваши фоновые задачи.                                                            |
| `goals`    | `show`, `start`: задачи, направленные на достижение цели.                                                                 |
| `schedule` | `ls`, `add`, `cancel`: запланированные сообщения и напоминания, разовые или повторяющиеся.                               |
| `agents`   | `ls`, `show`, `create`, `update`: ваши агенты.                                                                            |
| `skills`   | `ls`, `show`, `add`, `edit`: ваши навыки.                                                                                 |
| `projects` | `ls`, `show`: ваши проекты.                                                                                              |
| `settings` | `get`, `set`: ваши настройки, например включение или отключение памяти.                                                  |
| `share`    | `state`, `with-me`, `add`, `rm`: кто имеет доступ к объекту, чем с вами поделились другие, предоставление или отзыв доступа. |

`dvina` не может удалять что-либо навсегда, открывать публичные ссылки, подключать или отключать приложения, а также изменять настройки администрирования или оплаты.

### Справка и вывод

- `dvina --help` показывает список групп, `dvina <group> --help` — команды группы, а `dvina <group> <command> --help` — аргументы и флаги команды.
- Результат выводится в виде короткого текста. Добавьте `--json`, чтобы получить JSON, или `--fields` со списком через запятую, например `--fields id,title`, чтобы оставить только нужные поля.
- Длинный список заканчивается строкой `next: --cursor <c>`. Выполните команду ещё раз с этим `--cursor`, чтобы получить следующую страницу.
- Чтобы прочитать значение из файла, добавьте `-file` к соответствующему флагу, например `--content-file notes.md`. Команда `dvina docs upload <file>` загружает файл, а `dvina skills add <folder>` добавляет папку навыка с её файлом SKILL.md.

### Коды завершения

| Код  | Значение                                                                      |
| ---- | ----------------------------------------------------------------------------- |
| `0`  | Выполнено.                                                                    |
| `1`  | Произошла другая ошибка.                                                      |
| `2`  | Неверная команда. Проверьте её справку `--help`.                              |
| `3`  | Не найдено.                                                                   |
| `4`  | Отказ: действие запрещено вашими правами доступа, правилами компании или правилами защиты данных. |
| `5`  | Требуется ваше подтверждение.                                                |
| `6`  | Вы достигли лимита использования.                                            |

## Подтверждайте изменения

- Команды чтения выполняются без подтверждения.
- Команды, которые добавляют что-то новое, например `docs create`, `memory add` или `tasks start`, выполняются без подтверждения. Они никогда не меняют то, что уже есть.
- Команды, которые что-то изменяют или удаляют, сначала запрашивают ваше подтверждение: перемещение, переименование, перемещение в корзину, замена заметки или файла памяти, перезапись страницы холста, изменение агента или навыка, остановка задачи, отмена запланированного сообщения и предоставление доступа. Dvina показывает в чате карточку подтверждения со своим кратким описанием изменения и каждый раз спрашивает вашего разрешения. Если вы отклоняете запрос, ничего не меняется.

Всё, что `dvina` добавляет или изменяет, проходит проверку по правилам защиты данных вашей компании и записывается в ваш [журнал аудита](/docs/teams/audit-log), как и другие действия Dvina.

## См. также

- [Используйте Dvina из других приложений через MCP](/docs/dvina-mcp/overview)
- [Задачи](/docs/use-dvina/features/tasks)
- [Обзор коннекторов](/docs/connectors/overview)