Dvina MCP

使用 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 添加或更改的内容会经过你公司的数据保护规则检查，并记录在你的审计日志中，与 Dvina 的其他操作相同。