设备云.dev CLI
一行换云大师
安装( 不需要节点) :
$ curl -fsSL https://get.devicecloud.dev/install.sh | sh
在视窗上 :
irm https://get.devicecloud.dev/install.ps1 | iex
或者通过npm,如果您已经拥有了节点22+:
$ npm install -g @devicecloud.dev/dcd
稍后升级 dcd upgrade (二进制安装)或 npm install -g @devicecloud.dev/dcd@latest (npm安装).
使用 :
# maestro cloud --apiKey <apiKey> <appFile> .myFlows/
$ dcd cloud --apiKey <apiKey> <appFile> .myFlows/
见文件全文: 文档
MCP 服务器
dcd mcp 是一个 MCP 磁共振 服务器,因此AI代理(Claude, Codex, Cursor, VS Code)可以运行云测试并读取结果. 你没有自己运行。 你把它加入你的MCP客户端的配置中,由客户端启动. 它在你的机器和无头,比如在CI.
准备吧 dcd mcp install
安装 CLI( 见本页上方), 签名, 然后将服务器添加到您的 AI 工具 :
$ 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中的克洛德代码:
$ 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:
{
"mcpServers": {
"devicecloud": {
"command": "/Users/you/.dcd/bin/dcd",
"args": ["mcp"]
}
}
}
VS 代码 (.vscode/mcp.json,或用户 mcp.json) 用途 servers (单位:千美元) type数字 :
{
"servers": {
"devicecloud": {
"type": "stdio",
"command": "/Users/you/.dcd/bin/dcd",
"args": ["mcp"]
}
}
}
编码( C)~/.codex/config.toml,由 Codex CLI, IDE 扩展和桌面应用共享 :
[mcp_servers.devicecloud]
command = "/Users/you/.dcd/bin/dcd"
args = ["mcp"]
Claude Code 和 Codex CLI 从终端运行, 请查看您的路径 :
$ 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 覆盖它,所以你只需要它 一个已经使用它:
{
"mcpServers": {
"devicecloud": {
"command": "npx",
"args": ["-y", "[email protected]/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+和 小时。 。 。 . pnpm install 构建 CLI 并自动安装 git 钩.
$ 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 扫描在两个地方运行, 共享允许列表 .gitleaks.toml数字 :
- 承诺前钩 (via husky)——扫描所显示的改变,如果发现一个秘密,则会阻挡承诺. 安装二进制使其可以运行; 没有它, 钩子会跳过一个警告 :
$ brew install gitleaks # or see github.com/gitleaks/gitleaks#installing - 中情局 - 那个
secret-scan任务扫描每个推拉请求的全部历史,并且是执行支持站,无论本地设置如何.
捐款
欢迎捐款! 读取 捐款额 当地 • 制定承诺/PR公约(公约的公关名称,壁球相接), 如何释放工作。 所有贡献者都签名 撰稿人许可协议 机器人促使你做第一次公关 跟着我们 行为守则。 。 。 .
找到安全问题了吗? 请 别 公开问题——见 警卫。 。 。 .
许可证
麻省理工学院 Moropo有限公司 t/ a 设备