# 使用 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 对某事的了解，以及你的 Feed。                                         |
| `docs`     | `ls`, `show`, `read`, `search`, `create`, `upload`, `update`, `mv`, `mkdir`, `rm`：你的 Library 中的文档和文件夹。          |
| `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 的其他操作相同。

## 相关内容

- [通过 MCP 在其他应用中使用 Dvina](/docs/dvina-mcp/overview)
- [任务](/docs/use-dvina/features/tasks)
- [连接器概览](/docs/connectors/overview)