# @duvoai/cli 中文文档

规范地址：https://npmcn.com/package/%40duvoai/cli/

版本：1\.107\.0
npm 元数据更新时间：2026-11-09T12:26:22.827Z
中文译文更新时间：2026-11-13T00:53:23.911Z
软件包许可：未声明

本文由上游 README 翻译，可能存在偏差，请结合原文核对 API、命令与配置。版权与许可归原作者所有。

原始 npm 页面：https://www.npmjs.com/package/%40duvoai/cli
原文对照：https://npmcn.com/package/%40duvoai/cli/?lang=original

## 关键信息（来自 npm 元数据）

- 包体积（解压后）：3.5 MB，5 个文件
- 模块格式：ES Module
- TypeScript 类型：未声明
- Node.js 要求：\>=22\.22\.0
- 运行依赖：3 个
- 首次发布：2026-04-22T20:27:22.204Z
- 最新版本发布：2026-11-09T12:26:22.523Z
- 近 30 天下载量：11495（2026-10-13 至 2026-11-11，npm 官方下载统计）
- 已发布版本数：108（近 12 个月 108 个）

## 中文简介

Duvo 公共 API 的命令行界面

## 安装

```sh
npm install @duvoai/cli
```

也可以使用：`pnpm add @duvoai/cli`、`yarn add @duvoai/cli`、`bun add @duvoai/cli`

## README

# @duvoai/cli (英语)

命令行接口 [杜沃语Name](https://duvo.ai/) 大众API.

## 安装

```bash
npm install -g @duvoai/cli
```

需要22.22.0节点.

或安装独立的二进制(不需要节点.js):

```bash
curl -fsSL https://duvo.ai/install-cli.sh | sh
```

## 更新

```bash
duvo update
```

`duvo update` 检测CLI是如何安装和更新的: npm 安装运行 `npm install -g @duvoai/cli@latest`; 独立 二进制下载最新版本,验证其校验和,以及 替换自己。 使用 `duvo update --check` 看有没有更新 版本存在而不安装它.

## 折旧通知

当 API 标记一个已贬值的终点时, CLI 打印出一个短的 警告到 stderr (如果服务器提供日落日期和链接) ,他们。 折旧警告总是显示,它们不影响Stdout和 不能寂灭.

## 快开始

```bash
# 1. Log in (prompts for your API key and saves it to a profile)
duvo login --name default

# 2. Verify you're logged in
duvo whoami

# 3. Create your first agent (interactive)
duvo agents create

# ...or create one non-interactively with flags
duvo agents create --name "My agent" --input "What this agent should do"

# ...optionally pick the LLM the agent runs on
duvo agents create --name "My agent" --model claude-opus-4-7

# 4. Kick off a run and watch it complete
duvo runs start --agent <agent-id> --follow

# Switch an existing agent to a different model later
duvo agents set-model <agent-id> --model claude-opus-4-7
```

从团队设置中获取 API 密钥 : [https://app.duvo.ai/ settings/api-keys (英语)](https://app.duvo.ai/settings/api-keys)。 。 。 .

## 认证

您可以保存多个配置文件并在它们之间切换:

```bash
duvo login --name acme         # prompts for the API key
duvo login --name team-2       # prompts for the API key

duvo profiles list             # show saved profiles
duvo profiles use acme         # set the default profile
duvo --profile team-2 whoami   # one-off override for a single command
```

## 工作流量

### 启动运行和流出消息

```bash
# Start a run and tail messages until it completes
duvo runs start --agent <agent-id> --message "Process this week's reports" --follow

# Tail messages on a run that's already in progress
duvo runs messages <run-id> --follow
```

`--follow` 每两秒投票一次,跑道达到时则离开 终端状态( o)`completed`, (中文(简体) ), `failed`, (中文(简体) ), `stopped`,或 `error`) (中文(简体) ). 最终线 总是显示运行状态, 例如 . `Run completed.`

为了在程序上消耗溪流 `--follow --json`: 每个新 消息被打印为JSON对象在自己的行上(NDJSON).

```bash
duvo runs messages <run-id> --follow --json | while IFS= read -r line; do
  echo "$line" | jq -r '.text_content // empty'
done
```

### 脚本使用 --json

每个命令都接受 `--json` 发送原始的 API 响应而不是 表格或密钥/值视图——用于管道 `jq`。 。 。 .

```bash
# Start a run and capture the ID
RUN_ID=$(duvo runs start --agent "$AGENT_ID" --message "Go" --json | jq -r '.run.id')

# Follow messages on that run
duvo runs messages "$RUN_ID" --follow
```

### 为代理修改建立连接

整合是需要实况转播的修订版(a)段 连接). 使用 `revision-integrations` 可以看到槽和 `revision-integrations connections` 将你和他们的联系.

```bash
# 1. See the integration slots on a revision
duvo revision-integrations list --agent <agent-id> --revision <revision-id>
# INTEGRATION ID  TYPE   NAME   SLOT ID   CREATED
# 22222222-...    gmail  Gmail  slot-1    2026-04-15…

# 2. List your available connections
duvo connections list --type gmail

# 3. Pin a connection to the slot (use SLOT ID or INTEGRATION ID from step 1)
duvo revision-integrations connections pin <connection-id> \
  --agent <agent-id> --revision <revision-id> --integration slot-1

# 4. Verify
duvo revision-integrations connections list \
  --agent <agent-id> --revision <revision-id> --integration slot-1
```

> **说明:** 这个 `--integration` 旗帜接受 **衬衫标识** 或 **综合编号** 来自 `revision-integrations list`。 。 。 .

### 队列工作

```bash
# Create a queue
duvo queues create --name "support-tickets"

# On a team that has moved to the Automations workspace, a queue has to be
# created inside an automation — `duvo automations list` gives you the id
duvo queues create --name "support-tickets" --automation-id <automation-id>

# `duvo agents create` takes the same flag; without it a new agent gets an
# automation of its own rather than joining an existing one
duvo agents create --name "Ticket triage" --automation-id <automation-id>

# Create cases in bulk from a JSON file (up to 100)
duvo cases create --queue <queue-id> --from-file cases.json

# List pending cases
duvo cases list --queue <queue-id> --status pending

# Count pending cases without fetching Case rows
duvo cases list --queue <queue-id> --status pending --count-only

# Get case status counts for several queues in one call
duvo queues stats --queue-ids <id1>,<id2>,<id3>

# Bulk re-process pending cases on an agent
duvo cases bulk-reprocess --queue <queue-id> --agent <agent-id> \
  --ids <id1>,<id2>,<id3>
```

### 人类的 " 落地 " 反应

当运行暂停并提问时,直接从CLI回复:

```bash
duvo runs get <run-id>              # shows pending_human_request details
duvo runs respond <run-id>          # defaults to the current pending request
```

## 图标

在可能情况下,Clarity命令自动检测进程版本. 遗留的v1格式使用单一的分析有效载荷,而v2则以当前进程和转换建议版本为快照. 使用 v2 等特定命令 `versions`, (中文(简体) ), `current`, (中文(简体) ), `proposal`, (中文(简体) ), `compare`, (中文(简体) ), `gaps`, (中文(简体) ), `evidence`,以及 `readiness` 仅用于v2进程.

默认输出为摘要一和紧凑. JSON产出还包括一个紧凑 `summary` 块中,除 `--include-transcripts` 通过.

`duvo agents schedules list --all-users` 返回最多一个响应的行值。 在一个行程比这还多的代理上,CLI警告说,有的失踪了,它确实返回的行是按创建日期算最老的.

| 命令 | 说明 |
| --- | --- |
| `duvo login` | 在命名的配置文件下存储 API 密钥 |
| `duvo logout` | 删除配置文件 |
| `duvo whoami` | 显示活动配置文件、 认证用户、 团队 ID 和 认证类型 |
| `duvo profiles <subcmd>` | `list`, (中文(简体) ), `use`, (中文(简体) ), `rename`, (中文(简体) ), `remove` |
| `duvo update` | 将CLI更新到最新版本(`--check` 检查而不安装) |
| `duvo agents list` | 在你的团队中列出特工 |
| `duvo agents get <id>` | 显示一个代理的详细信息 |
| `duvo agents create` | 创建新代理( N)`--model` 选择 LLM ) |
| `duvo agents update <id>` | 更新代理服务器的名称或设置 |
| `duvo agents move <id> --to-team <id>` | 将一个代理( 及其连接的工作空间) 移动到另一个团队( Name`--all-together`, (中文(简体) ), `--dry-run`, (中文(简体) ), `-y`, (中文(简体) ), `--json`(中文(简体) ) |
| `duvo agents duplicate <id>` (别名) `clone`(中文(简体) ) | 复制代理到“ 复制... ” 代理; 内存不被复制( Copy of...)`--no-connections`, (中文(简体) ), `--no-queue`, (中文(简体) ), `--no-skills-files`, (中文(简体) ), `--no-logins-secrets`, (中文(简体) ), `--no-plugins`, (中文(简体) ), `--no-aop`, (中文(简体) ), `--json`(中文(简体) ) |
| `duvo agents models` | 列出可供代理人使用的 LLM 模型 |
| `duvo agents set-model <id> --model <model>` | 切换代理器最新修订版所用的 LLM 模型 |
| `duvo agents eval-scores <agent-id>` | 显示代理任务的总评分( N)`--since`, (中文(简体) ), `--scope`(中文(简体) ) |
| `duvo agents eval-rubrics <agent-id>` | 列出代理服务器的活跃评价标题( E)`--build`(中文(简体) ) |
| `duvo agents schedules list <agent-id>` | 列出您拥有的代理程序列表( L)`duvo agents schedules <agent-id>` 工作; `--all-users` 列出每个成员、每个成员创建者、提高团队作用的清单) |
| `duvo agents schedules create <agent-id> --frequency <f> --timezone <tz>` | 为代理创建时间表( I)`--time`, (中文(简体) ), `--day`, (中文(简体) ), `--day-of-month`, (中文(简体) ), `--cron`(中文(简体) ) |
| `duvo agents schedules update <agent-id> <schedule-id>` | 更新时间表`--enable`编号 :`--disable`, (中文(简体) ), `--frequency`, (中文(简体) ), `--time`, (中文(简体) ), `--clear-*`, (...) (中文(简体) ) |
| `duvo agents schedules delete <agent-id> <schedule-id>` | 删除时间表 |
| `duvo agents case-triggers list <agent-id>` | 为代理人配置的大小写触发器 |
| `duvo agents case-triggers create <agent-id> --queue <id>` | 创建代理的事件触发器 |
| `duvo agents case-triggers get <agent-id> <trigger-id>` | 用身份证触发案件 |
| `duvo agents case-triggers update <agent-id> <trigger-id>` | 更新案件触发器( E)`--enable` 编号 : `--disable`, (中文(简体) ), `--queue`, (中文(简体) ), `--concurrency`(中文(简体) ) |
| `duvo agents case-triggers delete <agent-id> <trigger-id>` | 删除大小写触发器 |
| `duvo agents triggers list <agent-id>` | 列出事件触发您在代理机上 |
| `duvo agents triggers types <agent-id>` | 列出代理服务器可用的事件触发类型 |
| `duvo agents triggers set <agent-id> --integration <slug> --trigger-type <type>` | 创建或更新事件触发( E)`--filter-config`, (中文(简体) ), `--disabled` 暂停它) |
| `duvo agents triggers delete <agent-id> <trigger-id>` | 删除事件触发器及其过滤器配置( E)`-y`, (中文(简体) ), `--json`(中文(简体) ) |
| `duvo agents memory files <agent-id>` | 列出代理人的内存文件( L)`duvo agents memory <agent-id>` 工作情况) |
| `duvo agents memory file-get <agent-id> <path>` | 打印一个内存文件的内容( 流到 stdout) |
| `duvo agent-folders list` | 列出您的团队代理文件夹 |
| `duvo agent-folders create` | 创建代理文件夹 |
| `duvo agent-folders update <id>` | 重命名或移动代理文件夹 |
| `duvo agent-folders delete <id>` | 删除代理文件夹 |
| `duvo agent-folders move-agents` | 将代理人移动到文件夹或根中 |
| `duvo automations list` | 列出您的团队的自动化 |
| `duvo automations get <id>` | 使用 ID 获取自动化 |
| `duvo automations create --name <name>` | 创建自动化( 它的第一个代理是同时创建的) |
| `duvo automations rename <id> --name <name>` | 重命名自动化 |
| `duvo automations duplicate <id>` (别名) `clone`(中文(简体) ) | 将一个自动化复制到一个"Copy of..." 自动化,从它的活的代理,队列和路由中复制出来;你的触发器和调度被复制关闭(`--json`(中文(简体) ) |
| `duvo automations delete <id>` | 删除自动化( 其代理和队列停止调度) |
| `duvo automations current <id>` | 显示当前设置的自动化程序( 代理、 队列、 触发器、 调度) |
| `duvo automations flow <id>` | 显示自动化当前流程图( 代理、 队列、 移交) |
| `duvo automations readiness <id>` | 显示要设置什么才能运行到真正的工作 |
| `duvo automations dashboard-data <id>` | 显示模块的仪表板数字,在仪表板计算时计算(`--dashboard`, (中文(简体) ), `--range`, (中文(简体) ), `--time-zone`(中文(简体) ) |
| `duvo automations roles <id>` | 列出自动化的流程角色, 以及由谁掌握这些角色 |
| `duvo automations add-member <id> --email <email> --role <key>` | 将某人置于进程角色( 电子邮件; 先问, 除非 `--yes`(中文(简体) ) |
| `duvo automations policy <id>` | 显示一个自动化的 整个政策, 同一个问杜沃读 |
| `duvo automations assign-interview <id>` | 指派一次政策面试(`--email`, (中文(简体) ), `--context`; 除非 `--yes`(中文(简体) ) |
| `duvo automations tabs <id>` | 显示自动制表符和被绑定的脉冲仪表板 |
| `duvo attributes list` | 列出团队的属性( 如 Severity 或 Cost), 它们的值以及每个进程持有多少 |
| `duvo attributes create --name <n> --type <t>` | 创建选择( C)`--value`数字(可重复)`--unit`)或文本属性 |
| `duvo attributes update <attribute-id>` | 重命名属性, 更改其单位, 或添加并删除选定的值 |
| `duvo attributes delete <attribute-id>` | 删除一个属性, 从每个自动化中清除它( 首先任务, 除非 `--yes`(中文(简体) ) |
| `duvo attributes values --automation <id>` | 显示自动化控件的属性值( 或 `--process <id>`(中文(简体) ) |
| `duvo attributes automations` | 列出团队的自动化及其价值( Q) :`--attribute`, (中文(简体) ), `--value` 仅保留控件) |
| `duvo attributes set <attribute-id> --automation <id>` | 设置自动化值( N)`--value`, (中文(简体) ), `--number` 或者说 `--text`(中文(简体) ) |
| `duvo attributes clear <attribute-id> --automation <id>` | 清除一个属性的自动化值 |
| `duvo runs start --agent <id>` | 启动给定代理的新运行; 添加 `--follow` 信息流到结束 |
| `duvo runs list` | List Runs for your team. 名单运行为您的团队。 添加 `--count-only` 只返回匹配的总数. |
| `duvo runs get <id>` | 获取身份代理 |
| `duvo runs evaluation <run-id>` | 为运行获取最新的评价, 并用标题标记特定代理标题( 自动解决代理) |
| `duvo runs messages <id>` | 列出运行的消息; 添加 `--follow` 在运行结束前对新消息进行民意调查 |
| `duvo runs send-message <id> --message <text>` | 发送消息给代理运行 |
| `duvo runs respond <run-id> [request-id]` | 在跑步时响应人行走请求( 对待决请求违约) |
| `duvo runs stop <id>` | 停止运行代理运行 |
| `duvo suggestions list <agent-id>` | 列出代理人的建议( A)`--status pending` 是收件箱; `--status history` 显示已解决) |
| `duvo suggestions consume <suggestion-id>` | 应用一个建议:将其修改移至代理人的订正草案 |
| `duvo suggestions reject <suggestion-id>` | 撤销待决建议 |
| `duvo sandboxes create` | 为传输文件创建沙盒 |
| `duvo sandboxes files <id>` | 在沙盒目录中列出文件 |
| `duvo sandboxes upload <id> <file>` | 上传本地文件( 最大 10MB) |
| `duvo sandboxes prepare-upload-url <id> --path <p>` | 获得预先签名的上传 URL |
| `duvo cases list --queue <id>` | 在队列中列出案例 。 添加 `--count-only` 只返回匹配的总数. |
| `duvo cases search --queue <id>` | 在过滤器丰富的队列中搜索大小写 `list`数字 : `--label "<key=value|value>"` (可重复;同一密钥的值为ORED、不同的密钥AND)和结构化 `--field` 过滤器,全部安装 `list`其它过滤器 |
| `duvo cases get <id>` | 以 ID 方式获取一个案件及其事件历史 |
| `duvo cases create --queue <id>` | 创建一个或多个案例( C)`--title` 用于一个或 `--from-file` 带有 JSON 阵列) |
| `duvo cases delete <id>` | 删除大小写( 中断任何关联的活动运行) |
| `duvo cases clear --queue <id>` | 删除队列中的每个大小写( 先中断活动运行) |
| `duvo cases bulk-delete --queue <id> --ids <list>` | 删除队列( 1- 100; 先中断活动运行) 中的多例 |
| `duvo cases bulk-reprocess --queue <id> --agent <id> --ids <list>` | 在队列消费者代理上重新处理个案( 1- 100; 中断活动运行; 见 `duvo queues agents`(中文(简体) ) |
| `duvo cases bulk-update-status --queue <id> --ids <list>` | 更新多个案件的状态以完成或失败( 1100) |
| `duvo cases runs <case-id>` | 处理过案件的列表运行( 代理运行) |
| `duvo cases labels list <case-id> --queue <id>` | 指定给大小写的列表标签 |
| `duvo cases labels assign <case-id> --queue <id> --label "<key=value|value>" [...]` | 给一个案件指定标签( I)`--label` 可重复, 接受 `key=value` 只标记 `value`(中文(简体) ) |
| `duvo cases labels unlink <case-id> --queue <id> --label-id <label-id> [...]` | 从大小写中删除标签( R)`--label-id` 可重复) |
| `duvo notifications list` | 列出你们团队的最新通知`--type`, (中文(简体) ), `--unread`, (中文(简体) ), `--important`, (中文(简体) ), `--severity`, (中文(简体) ), `--batch`, (中文(简体) ), `--sort`,光标平面) |
| `duvo notifications get <id>` | 凭身份证得到通知 |
| `duvo notifications feed` | 列出您团队的通知信息( 单个通知与每个代理批次相连接), 最新活动首先(`--type`, (中文(简体) ), `--unread`,光标平面) |
| `duvo notifications get-batch <id>` | 按身份证分批通知,每类活人计数,未读数,情节最严重 |
| `duvo notifications counts` | 获得团队的每类通知计数(`--unread` 仅数未读) |
| `duvo notifications unread-count` | 获取未读通知数 |
| `duvo notifications mark-read <id>` | 将通知标为已读 |
| `duvo notifications mark-batch-read <id>` | 将通知批次的每个未读成员标为已读(`--types` 缩入) |
| `duvo notifications mark-all-read` | 将所有通知标为您的团队已读 |
| `duvo notifications dismiss <id>` | 解除重要( 未解决) `connection_broken`通知 |
| `duvo notifications delete-read` | 删除您团队的所有已读通知 |
| `duvo notifications delete-all` | 删除您的团队的全部通知, 已读和未读 |
| `duvo clarity list` | 列表清晰进程 |
| `duvo clarity search <query>` | 搜索清晰进程 |
| `duvo clarity status <process-id>` | 显示进程状态、 生成进度和选定的版本 ID |
| `duvo clarity overview <process-id>` | 显示首个包含健康、计数、警告和下一个命令的简要和清晰概览 |
| `duvo clarity versions <process-id>` | 列出 v2 当前/ 提议的历史、 选定版本和提议主锚 |
| `duvo clarity current <process-id>` | 读取 v2 当前进程快照 |
| `duvo clarity proposal <process-id>` | 读取 v2 转换建议快照 |
| `duvo clarity compare <process-id>` | 比较选中的 v2 当前进程和提案快照 |
| `duvo clarity captures <process-id>` | 附于清晰进程的清单抓取 |
| `duvo clarity capture <process-id> <capture-id>` | 读取一个包含在清晰进程上的抓取 |
| `duvo clarity gaps <process-id>` | 分组v2提案缺口和额外请求 |
| `duvo clarity evidence <process-id>` | 打印 v2 当前进程证据来源; 添加 `--citation <id>` 解决一个源 |
| `duvo clarity readiness <process-id>` | 汇总 v2 自动化准备程度评级 |
| `duvo clarity facets <process-id>` | 为代理商建立结构化的成本、风险、血统和自动化方面 |
| `duvo clarity export <process-id>` | 导出清晰上下文为 Markdown 或 JSON |
| `duvo clarity doctor [process-id]` | 检查认证/API/工具准备情况,并在提供时检查流程环境健康状况 |
| `duvo clarity tools` | 列出带有 CLI 命令和基础公共 API 端点的 CLI 工具 |
| `duvo clarity artifact-chat-conversations <process-id> --snapshot-kind <kind>` | 列出用于当前进程或变换建议视图的 文物聊天对话框 |
| `duvo clarity artifact-chat-messages <process-id> <conversation-id>` | 读取关于一次人工聊天的信息 |
| `duvo clarity generate-current-process <process-id>` | 启动当前进程生成 |
| `duvo clarity generate-transformation-proposal <process-id>` | 启动转型建议生成或再生 |
| `duvo clarity promote-current-process <process-id> <snapshot-id>` | 推动当前进程快照以活化 |
| `duvo clarity promote-transformation-proposal <process-id> <proposal-id>` | 推动转型建议快照活出场 |
| `duvo clarity revert-current-process <process-id> <snapshot-id>` | 删除当前进程快照 |
| `duvo clarity revert-transformation-proposal <process-id> <proposal-id>` | 删除变换建议快照 |
| `duvo clarity assign-extra-capture-request <process-id> <proposal-id> <request-id>` | 指定或取消额外抓捕请求 |
| `duvo clarity postprocess <process-id> <snapshot-type> <snapshot-id>` | 为当前进程或转型建议快照重新运行后处理 |
| `duvo clarity build-automation <process-id>` | 从最新提案开始自动化生成 |
| `duvo clarity stop-transformation-proposal <process-id>` | 停止飞行中的转换-提议生成 |
| `duvo clarity create [--name <name>] [--json]` | 为当前团队创建一个新的 Clarity v2 进程 |
| `duvo clarity create-invite-link <process-id>` | 创建或重新生成邀请链接 |
| `duvo clarity import-artifact <process-id> <file>` | 导入本地 Miro SVG、 XML、 PNG 或 JPEG 导出 |
| `duvo queue-labels list --queue <queue-id>` | 队列上定义的列表标签( 有大小写计数) |
| `duvo queue-labels create --queue <queue-id> --value <v>` | 在队列上创建标签( C)`--value` (所需) |
| `duvo queue-labels update <label-id> --queue <queue-id> --value <v>` | 重命名标签或更改标签的颜色( N)`--value` (所需) |
| `duvo queue-labels delete <label-id> --queue <queue-id>` | 删除标签并删除所有大小写 |
| `duvo files list` | 名单组文件 |
| `duvo files upload-url` | 获取团队文件的预签名上传 URL |
| `duvo files download-url <path>` | 获取预签名下载 URL |
| `duvo files content <path>` | 打印文本文件的内容 |
| `duvo files content-set <path>` | 更新文本文件的内容 |
| `duvo files rename` | 重命名团队文件 |
| `duvo files delete <path>` | 删除团队文件 |
| `duvo revisions list --agent <id>` | 代理服务器列表修改 |
| `duvo revisions get <id> --agent <id>` | 获取 ID 的修改 |
| `duvo revisions create --agent <id> --name <text>` | 为来自 `--config-file`, (中文(简体) ), `--code`,或 `--aop-file` 与 `--source-revision` |
| `duvo revisions update <id>` | 更新修订版的配置 `--config-file`,或只将其 AOP 替换为 `--aop-file` (交接目标取自AOP) |
| `duvo integrations list` | 列出团队的整合目录 |
| `duvo integrations custom create --name <n> --auth-method <m> --server-url <url>` | 在您的团队目录中创建自定义集成类型 |
| `duvo integrations custom delete <custom-integration-id>` | 删除自定义集成类型( 连接- 移动相关连接) |
| `duvo connections list` | 列出您的连接( 过滤器与 `--type`(中文(简体) ) |
| `duvo connections get <id>` | 通过身份识别获取您的连接 |
| `duvo connections create` | 创建用户提供的连接( Custom MCP 服务器) |
| `duvo connections update <id>` | 更新连接( 名称、 服务器 URL、 页眉、 共享) |
| `duvo connections delete <id>` | 删除连接和任何与之相连的触发器 |
| `duvo connections credentials <id>` | 列出已配置的标题密钥( 已编辑的敏感值) |
| `duvo oauth native start <provider>` | 启动本地 OAuth 连接( Gmail, Outlook,...) 。 打印授权 URL. |
| `duvo oauth mcp probe <url>` | 探索一个 MCP 服务器 URL 并列出它所曝光的工具(`--header KEY=VALUE` (可重复). |
| `duvo oauth mcp authorize --url <url> --name <n>` | 启动基于 OAuth 的连接到远程 MCP 服务器( DCR) 。 打印认证 URL. |
| `duvo oauth mcp check --url <url>` | 为 OAuth 动态客户端注册支持 探索 MCP 服务器 URL. |
| `duvo revision-integrations list` | 修改后的列表集成( 显示 SLOT ID 和 整合 ID 栏) |
| `duvo revision-integrations attach` | 在修订后附加一个或多个整合 |
| `duvo revision-integrations remove <integration-id>` | 删除修改后的集成槽 |
| `duvo revision-integrations connections list` | 列出修改后集成槽的绑定连接 |
| `duvo revision-integrations connections pin <id>` | 将您连接到一个版本的集成槽 |
| `duvo revision-integrations connections unpin <id>` | 从修订集成槽中解开连接 |
| `duvo secrets list` | 列出您可见的 Env- var 秘密( 团队共享加个人) |
| `duvo secrets get <id>` | 用 ID 获取一个 env- var 秘密( 值永远不会被曝光) |
| `duvo secrets create --name <n> --value KEY=VAL` | 创建一个 env- var 秘密 (`--shared` 让它分享团队) |
| `duvo secrets update <id>` | 更新一个秘密( E)`--set`, (中文(简体) ), `--remove`, (中文(简体) ), `--rename`,元数据字段) |
| `duvo secrets delete <id>` | 软去去掉内脏的秘密 |
| `duvo credentials list [--domain <d>]` | 列表浏览器登录( 密码和OTP 机密永远不会返回) |
| `duvo credentials get <id>` | 通过 ID 获取浏览器登录 |
| `duvo credentials create --domain <d> [--password <p>] [--otp-secret <s>]` | 创建浏览器登录 。 OTP值必须是基础32 TOTP设置秘密或atpauth URI. |
| `duvo credentials update <id>` | 更新浏览器登录 |
| `duvo credentials delete <id>` | 删除浏览器登录 |
| `duvo revision-secrets list --agent <id> --revision <id>` | 列出修订版所附的内存 |
| `duvo revision-secrets attach --agent <id> --revision <id> --secret <id>` | 在修订版中附加一个内存- var 秘密 |
| `duvo revision-secrets detach <secret-id> --agent <id> --revision <id>` | 从修订版中解开一个封地的秘密 |
| `duvo revision-logins list --agent <id> --revision <id>` | 附加到修订版的浏览器登录列表 |
| `duvo revision-logins attach --agent <id> --revision <id> --credential <id>` | 附加浏览器登录到修订版 |
| `duvo revision-logins detach <credential-id> --agent <id> --revision <id>` | 从修订版中删除浏览器登录 |
| `duvo plugins list` | 在修订版中按名称列出可参考插件 |
| `duvo queues list` | 为您的团队列出队列 |
| `duvo queues get <id>` | 按 ID 排队 |
| `duvo queues create --name <name>` |  |

## 常见问题

### @duvoai/cli 是什么？

Duvo 公共 API 的命令行界面

### 如何安装 @duvoai/cli？

在项目目录运行 npm install @duvoai/cli，或使用 pnpm add / yarn add / bun add。它还提供命令行工具 duvo，可以用 npx duvo 直接运行。

### @duvoai/cli 支持 TypeScript 吗？

该包的 package\.json 没有声明类型入口。需要类型提示时，可以在 npm 上查找社区维护的 @types/duvoai\_\_cli 是否存在。

### @duvoai/cli 支持 ESM 还是 CommonJS？

以 ES Module 形式发布，推荐使用 import 引入。在 CommonJS 项目中，Node\.js 20\.19\+ / 22\.12\+ 可以直接 require\(\) 不含顶层 await 的 ES Module，更早的版本需要改用动态 import\(\)。

### @duvoai/cli 需要什么版本的 Node\.js？

package\.json 的 engines 字段要求 Node\.js \>=22\.22\.0。版本不符时 npm 默认只给出警告，开启 engine-strict 后会拒绝安装。

### @duvoai/cli 可以商用吗？

@duvoai/cli 使用 未声明 许可。package\.json 没有声明许可证。没有许可证的代码默认保留全部权利，商用前请联系作者或查看仓库中的 LICENSE 文件。以上为概括，不构成法律意见，请以许可原文为准。

### @duvoai/cli 的下载量有多少？

根据 npm 官方下载统计，@duvoai/cli 在 2026/10/13 – 2026/11/11 这 30 天内被下载 11,495 次，日均约 383 次。下载量会把 CI 构建、镜像同步和作为其他包依赖的安装一并计入，适合横向比较热度，不能直接等同于使用人数。

### @duvoai/cli 还在维护吗？

最新版本 1\.107\.0 发布于 2026/11/09（4 天前）；至今共发布 108 个版本，其中过去 12 个月发布了 108 个；首次发布于 2026/04/23。发布频率只是参考信号：功能稳定的工具可能很少需要更新，建议结合源码仓库的 issue 和提交记录判断。

