# @app-studio/qa-cli 中文文档

规范地址：https://npmcn.com/package/%40app-studio/qa-cli/

版本：0\.11\.6
npm 元数据更新时间：2026-11-05T23:12:56.415Z
中文译文更新时间：2026-11-08T09:40:14.716Z
软件包许可：UNLICENSED

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

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

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

- 包体积（解压后）：451 kB，114 个文件
- 模块格式：ES Module
- TypeScript 类型：包内自带
- Node.js 要求：\>=20
- 运行依赖：8 个
- 首次发布：2026-08-09T15:46:05.143Z
- 最新版本发布：2026-11-05T23:12:55.822Z
- 近 30 天下载量：1826（2026-10-07 至 2026-11-05，npm 官方下载统计）
- 已发布版本数：34（近 12 个月 34 个）

## 中文简介

Qa命令:分层跑道,医生,收养,硬化的端对端管弦乐,播种和鼠标.

## 安装

```sh
npm install @app-studio/qa-cli
```

也可以使用：`pnpm add @app-studio/qa-cli`、`yarn add @app-studio/qa-cli`、`bun add @app-studio/qa-cli`

## README

# `@app-studio/qa-cli`

一个人类和特工的指挥面.

`qa demos run` 自动记录更改了 API 和 Canonial 浏览器方案 与QA的本地CSS浏览器和FFmpeg,没有Playwright. `qa demos plan` 解释选择; `qa demos check` 检查源/艺术新鲜度( 无) 发射任何东西。 配置情景/代码/共享输入 `qa.demos.json` 忽略 `tmp/qa/` 中。通过本地审查/承诺保留当前证据; 推动触发对自有证据进行最佳清理而不扫描或拒绝 承诺。 如果运行是活动的, 它的证明保持不变 直到运行结束, 那么 清净回向. 安装/重新安装 `qa demos install-hook` 之后 克隆或 CLI 替换; 参见自动演示中的共享检查出方程 。 只有最新的完全成功和最新的相关失败 每个演示保留. `--stage` 财务报告和审定财务报表 `--committed` 在执行前被拒绝; 证据从来就不存在。 清理保留活动、对称或无主输出 和报告推迟清理 而不阻碍推动。 见 [自动演示](https://npmcn.com/package/docs/AUTOMATIC_DEMOS.md)。 。 。 .

`qa api studio --base-url <url>` 打开真正的 HTTP 工作台; `qa api run` 毫无头绪地使用同样的断言。 配置 `--checkpoint-adapter <module>` 以 `--save-checkpoint <id> --until <step>`,然后恢复和 只运行其后缀 `--checkpoint <id>`。 。 。 . `qa api restore` 站点恢复 检查而不运行后缀。 见 [API 工作室](https://npmcn.com/package/docs/API_STUDIO.md)。 。 。 .

```sh
qa state validate
qa state list
qa state inspect --id <id>
qa state run --id <id> [--mode mock|live] [--engine <name>] [--profile fast|proof|record] [--screenshots] [--video mp4|webm|gif] [--diagnostics=false]

qa design record --file <acceptance.json> --reviewer <designer-id>
qa design validate [--feature <key>]
qa design list

qa scenario validate
qa scenario list
qa scenario coverage
qa scenario run --id <id> [--mode mock|live] [--engine <name>] [--profile fast|proof|record] [--screenshots] [--video mp4|webm|gif] [--diagnostics=false]
qa scenario run [--mode mock|live] # complete release-candidate portfolio
qa scenario benchmark --id <id> --engine lightpanda [--runs 5]

qa browser list [--json]
qa browser build lightpanda --source <checkout> [--dir <bundle-dir>]
qa browser install lightpanda [--release <tag> | --artifact <bundle-dir>] [--dir <path>]
```

校正读取 App Studio 的原始功能/形式 specs(或 明文) 假设 v3 迁移文件). 特性编译为 `<feature>:best` 加一个 每名身份证 `if` 条件。 运行时命令解决现场主机 `qa.bindings.json` ,并通过环境变量传递选定的ID. 命名引擎选择应用程序拥有的命令; 能力声明停止 a 仅用于视觉证据或视频的DOM引擎。 国家领导才能没有 维护复制的流程目录或第二个浏览器执行.

QA通过可选的依赖性在macOS/Linux ARM64和x64上安装匹配的本地CSS浏览器. `qa browser list` 查明; `qa browser install lightpanda` 使用包含的构建. `--release nightly` 明确选择上游。 继续启用可选依赖性 。 明确的灯花跑需要经过核实的本地捆绑; 使用 `QA_LIGHTPANDA_EXECUTABLE` 开发时使用当地制造的捆绑.

Puppeteer套房默认保留了受限控制台/请求/错误/高压诊断. 添加 `--video gif`, (中文(简体) ), `mp4` 或者说 `webm` 以记录实际情景页面(需要FFmpeg)。 共享 `launchLightpanda` API拥有回转守护进程及其引擎输出. 见 [本地捕获融合](https://npmcn.com/package/docs/NATIVE_CAPTURE.md)。 。 。 .

将光熊猫诊断法改为: `--screenshots` 改为 `fast` 状态或情景运行. 共享 Puppeteer 主机抓取当前页面, 包括失败, 并发送 a 带有绝对PNG路径的JSON指数和 `fidelity: "markdown"` 默认. 用于修改的本地捆绑, 设置 `QA_LIGHTPANDA_FIDELITY=native-css`。 。 。 . 见 [原始捕获构建](https://npmcn.com/package/docs/NATIVE_CAPTURE.md) 为macOS/Linux所建, 经核实的文物安装和捆绑的PNG/video/GIF帮助器。 CLI通过 `QA_BROWSER_SCREENSHOTS=true` 财务报告和审定财务报表 `QA_STATE_OUTPUT_DIR`编号 :`QA_SCENARIO_OUTPUT_DIR` 从主体的 `evidence` 约束,或 `test-results/qa-states`编号 :`qa-scenarios`。 。 。 . 使用 `--screenshots=false` 以禁用已继承的请求。 PNG 诊断没有 证明东道方保留完整的检查站合同。 一个本地主机可以 声明视觉 `proof`编号 :`record` 当它使用经过验证的本地 CSS 建筑时 警犬检查站收集器和真实的PNG/录像抓取;没有 认证桌面浏览器像素等同 .

`qa browser install lightpanda` 级本地浏览器, 证明它运行于 `lightpanda version`,然后移动到 `~/.local/bin` (或 `--dir`) (中文(简体) ). 本地录音机和迁移的套房不需要Playwright安装. 使用 QA 浏览器接受并报告能力失败 准确的命令和证据 保留遗留引擎管理命令 对于现有的外部消费者来说,这些跑步者永远不会回到他们身边.

使用 `qa run --list` 检查渐进式证明层 `qa run --from <layer>` 只有在已知的下层绿色之后.

独立抓取主机可以使用导出 `beginProofOutput(root, output, id)` 写入自有抓取目录,然后调用 `finish(passed)` 终于 关闭浏览器/世界后。 它保持了一次成功和最新的相关 失败,与 CLI 清理共享输出锁,并留下断言和 与宿主出处. 推动请求清理; 如果此输出仍在运行, 主机先完成,然后重试待清理.

## 常见问题

### @app-studio/qa-cli 是什么？

Qa命令:分层跑道,医生,收养,硬化的端对端管弦乐,播种和鼠标\.

### 如何安装 @app-studio/qa-cli？

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

### @app-studio/qa-cli 支持 TypeScript 吗？

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

### @app-studio/qa-cli 支持 ESM 还是 CommonJS？

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

### @app-studio/qa-cli 需要什么版本的 Node\.js？

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

### @app-studio/qa-cli 可以商用吗？

@app-studio/qa-cli 使用 UNLICENSED 许可。作者声明为 UNLICENSED，即不授予公开使用许可（与公共领域的 Unlicense 不同）。使用前需获得作者授权。以上为概括，不构成法律意见，请以许可原文为准。

### @app-studio/qa-cli 的下载量有多少？

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

### @app-studio/qa-cli 还在维护吗？

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