# @devicecloud\.dev/dcd 中文文档

规范地址：https://npmcn.com/package/%40devicecloud.dev/dcd/

版本：5\.13\.0
npm 元数据更新时间：2026-11-13T17:25:49.147Z
中文译文更新时间：2026-11-13T17:26:32.019Z
软件包许可：MIT

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

原始 npm 页面：https://www.npmjs.com/package/%40devicecloud.dev/dcd
原文对照：https://npmcn.com/package/%40devicecloud.dev/dcd/?lang=original
项目主页：https://devicecloud.dev/
源码仓库：https://github.com/devicecloud-dev/dcd-cli

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

- 包体积（解压后）：980 kB，173 个文件
- 模块格式：ES Module
- TypeScript 类型：包内自带
- Node.js 要求：\>=22\.0\.0
- 运行依赖：13 个
- 首次发布：2024-02-15T14:40:01.927Z
- 最新版本发布：2026-11-13T17:25:48.556Z
- 近 30 天下载量：36560（2026-10-12 至 2026-11-10，npm 官方下载统计）
- 已发布版本数：193（近 12 个月 84 个）

## 中文简介

在云中运行Maestro移动UI测试——上传一款iOS/Android构建,执行跨真实设备的流,流结果. 载运dcd CLI和一个dcd-mcp MCP服务器.

## 安装

```sh
npm install @devicecloud.dev/dcd
```

也可以使用：`pnpm add @devicecloud.dev/dcd`、`yarn add @devicecloud.dev/dcd`、`bun add @devicecloud.dev/dcd`

## README

# 设备云.dev CLI

* * *

一行换云大师

安装( 不需要节点) :

```sh-session
$ curl -fsSL https://get.devicecloud.dev/install.sh | sh
```

在视窗上 :

```powershell
irm https://get.devicecloud.dev/install.ps1 | iex
```

或者通过npm,如果您已经拥有了节点22+:

```sh-session
$ npm install -g @devicecloud.dev/dcd
```

稍后升级 `dcd upgrade` (二进制安装)或 `npm install -g @devicecloud.dev/dcd@latest` (npm安装).

使用 :

```sh-session
# maestro cloud --apiKey <apiKey> <appFile> .myFlows/
$ dcd cloud --apiKey <apiKey> <appFile> .myFlows/
```

见文件全文: [文档](https://docs.devicecloud.dev/)

## MCP 服务器

`dcd mcp` 是一个 [MCP 磁共振](https://modelcontextprotocol.io/) 服务器,因此AI代理(Claude, Codex, Cursor, VS Code)可以运行云测试并读取结果. 你没有自己运行。 你把它加入你的MCP客户端的配置中,由客户端启动. 它在你的机器和无头,比如在CI.

### 准备吧 `dcd mcp install`

安装 CLI( 见本页上方), 签名, 然后将服务器添加到您的 AI 工具 :

```sh-session
$ dcd login
$ dcd mcp install cursor     # or claude-code, claude-desktop, codex, vscode
```

从列表中选择客户名。 添加 `--read-only` 用于只提供无变化工具的服务器,或 `--print` 来看看会增加什么 不改变任何东西。 对于克洛德代码,代码和VS代码,它运行 `claude mcp add`, (中文(简体) ), `codex mcp add` 财务报告和审定财务报表 `code --add-mcp`对于克劳德桌面和Cursor,它增加了他们的JSON配置文件的条目,并保留了其他所有内容. 之后重新启动应用程序.

### 无头, 有 API 密钥

对于没有您运行的代理, 如在 CI 或脚本中, 用 API 密钥签名 而不是 `dcd login`。在 Sets → API 密钥下创建一个控制台,并将其作为 `DEVICE_CLOUD_API_KEY` 在环境。 例如,CI中的克洛德代码:

```sh-session
$ claude mcp add --scope user devicecloud -e DEVICE_CLOUD_API_KEY="$DEVICE_CLOUD_API_KEY" -- dcd mcp
```

在JSON配置中,把它放在服务器的 `env`数字 : `"env": { "DEVICE_CLOUD_API_KEY": "<your-api-key>" }`在您的 CI 提供者中存储此密钥 .

### 手设的

开始 dcd 由它 **完整路径**。桌面应用程序,如克洛德桌面和光标通常从 Dock 或 Start 菜单打开,所以它们看不到您的外壳设置的 PATH , 空的 `dcd` 给“ 命令未找到” 。 安装者在尾端打印路径; 是 `~/.dcd/bin/dcd` 默认情况下,由于配置文件不扩展而全部写出 `~`。 。 。 .

Claude 桌面 (`claude_desktop_config.json`)和光标(`~/.cursor/mcp.json`:

```jsonc
{
  "mcpServers": {
    "devicecloud": {
      "command": "/Users/you/.dcd/bin/dcd",
      "args": ["mcp"]
    }
  }
}
```

VS 代码 (`.vscode/mcp.json`,或用户 `mcp.json`) 用途 `servers` (单位:千美元) `type`数字 :

```jsonc
{
  "servers": {
    "devicecloud": {
      "type": "stdio",
      "command": "/Users/you/.dcd/bin/dcd",
      "args": ["mcp"]
    }
  }
}
```

编码( C)`~/.codex/config.toml`,由 Codex CLI, IDE 扩展和桌面应用共享 :

```toml
[mcp_servers.devicecloud]
command = "/Users/you/.dcd/bin/dcd"
args = ["mcp"]
```

Claude Code 和 Codex CLI 从终端运行, 请查看您的路径 :

```sh-session
$ claude mcp add --scope user devicecloud -- dcd mcp
$ codex mcp add devicecloud -- dcd mcp
```

如果您使用 npm 包而不是独立的二进制,则命令是 `npx` 与 `"args": ["-y", "@devicecloud.dev/dcd", "mcp"]`这需要节点22 或更新的应用程序的 PATH, 它检查npm 每次开始.

它的标志与CLI相同: `dcd login` 会话,会在其运行时更新,或 `DEVICE_CLOUD_API_KEY`。指向一个非螺旋环境 `DCD_API_URL`。 。 。 .

### 工具

| 工具 | 它会做什么 |
| --- | --- |
| `dcd_list_devices` | 发现可用的设备、 OS 版本和 Maestro 版本 |
| `dcd_list_runs` | 列出最近的测试运行( filter by name/ date, pagized) |
| `dcd_get_status` | 获取运行状态 + 每一次测试结果 |
| `dcd_download_artifacts` | 将运行的文物/ 报告下载到磁盘 |
| `dcd_run_cloud_test` | 提交流以运行于云上(**可收帐**(中文(简体) ) |

默认 `dcd_run_cloud_test` 是 async: 它返回一个 `uploadId` 立即,你调查 `dcd_get_status`。通过 `wait: true` (以下列日期为准: `waitTimeoutSeconds`封锁直至完成,或 `dryRun: true` 预览不提交流程.

**仅读模式 .** `dcd_run_cloud_test` 消耗测试分钟,所以它被注解为不只读/毁(客户在拨打之前可以提示)。 为了完全隐藏,建议自主或不信任的代理人,添加 `--read-only` 之后 `mcp` (或传至) `dcd mcp install`),或设置 `DCD_MCP_READONLY=1` 内 `env`。 。 。 .

### `dcd-mcp`

Npm 包件也装了船 `dcd-mcp`一个旧服务器 `dcd_*` 工具. `dcd mcp` 覆盖它,所以你只需要它 一个已经使用它:

```jsonc
{
  "mcpServers": {
    "devicecloud": {
      "command": "npx",
      "args": ["-y", "--package=@devicecloud.dev/dcd", "dcd-mcp"],
      "env": { "DEVICE_CLOUD_API_KEY": "<your-api-key>" }
    }
  }
}
```

`--package` 事项: 软件包的默认 bin 是 `dcd`这样 `npx @devicecloud.dev/dcd dcd-mcp` 将会运行 `dcd dcd-mcp` (未知命令)代替服务器. 它的标志像 `dcd mcp`,并带走 `--read-only` 财务报告和审定财务报表 `DCD_MCP_READONLY=1` 同样的方式.

## 发展

要求节点22+和 [小时](https://pnpm.io/)。 。 。 . `pnpm install` 构建 CLI 并自动安装 git 钩.

```sh-session
$ pnpm install        # install deps, build, set up git hooks
$ pnpm dcd <args>     # run the CLI from source
$ pnpm lint           # ESLint
$ pnpm typecheck      # strict tsc, no emit
$ pnpm test:unit      # unit tests, no backend needed — what CI runs
$ pnpm test           # the above, plus integration tests if MOCK_API_DIR is set
```

### 秘密扫描

A 类 [gi](https://github.com/gitleaks/gitleaks) 扫描在两个地方运行, 共享允许列表 `.gitleaks.toml`数字 :

-   **承诺前钩** (via husky)——扫描所显示的改变,如果发现一个秘密,则会阻挡承诺. 安装二进制使其可以运行; 没有它, 钩子会跳过一个警告 :
    
    ```sh-session
    $ brew install gitleaks      # or see github.com/gitleaks/gitleaks#installing
    ```
    
-   **中情局** - 那个 `secret-scan` 任务扫描每个推拉请求的全部历史,并且是执行支持站,无论本地设置如何.

## 捐款

欢迎捐款! 读取 **[捐款额](https://npmcn.com/package/%40devicecloud.dev/dcd/CONTRIBUTING.md)** 当地 • 制定承诺/PR公约(公约的公关名称,壁球相接), 如何释放工作。 所有贡献者都签名 [撰稿人许可协议](https://npmcn.com/package/%40devicecloud.dev/dcd/CLA.md) 机器人促使你做第一次公关 跟着我们 [行为守则](https://npmcn.com/package/%40devicecloud.dev/dcd/CODE_OF_CONDUCT.md)。 。 。 .

找到安全问题了吗? 请 **别** 公开问题——见 [警卫](https://npmcn.com/package/%40devicecloud.dev/dcd/SECURITY.md)。 。 。 .

## 许可证

[麻省理工学院](https://npmcn.com/package/%40devicecloud.dev/dcd/LICENSE) Moropo有限公司 t/ a 设备

## 常见问题

### @devicecloud\.dev/dcd 是什么？

在云中运行Maestro移动UI测试——上传一款iOS/Android构建,执行跨真实设备的流,流结果\. 载运dcd CLI和一个dcd-mcp MCP服务器\.

### 如何安装 @devicecloud\.dev/dcd？

在项目目录运行 npm install @devicecloud\.dev/dcd，或使用 pnpm add / yarn add / bun add。它还提供命令行工具 dcd、dcd-mcp，可以用 npx dcd 直接运行。

### @devicecloud\.dev/dcd 支持 TypeScript 吗？

支持。包内自带 TypeScript 类型声明（package\.json 声明了 types 入口），安装后即可获得类型提示，无需再安装 @types 包。

### @devicecloud\.dev/dcd 支持 ESM 还是 CommonJS？

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

### @devicecloud\.dev/dcd 需要什么版本的 Node\.js？

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

### @devicecloud\.dev/dcd 可以商用吗？

@devicecloud\.dev/dcd 使用 MIT 许可。宽松许可：允许商业使用、修改和再分发，通常只需在分发时保留原版权与许可声明。以上为概括，不构成法律意见，请以许可原文为准。

### @devicecloud\.dev/dcd 的下载量有多少？

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

### @devicecloud\.dev/dcd 还在维护吗？

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