@app-studio/qa-cli

中文文档
0.11.6发布于 2026/11/06UNLICENSEDTypeScriptES Module近 30 天下载 1826

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

中文使用文档

@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 在执行前被拒绝; 证据从来就不存在。 清理保留活动、对称或无主输出 和报告推迟清理 而不阻碍推动。 见 自动演示。 。 。 .

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

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拥有回转守护进程及其引擎输出. 见 本地捕获融合。 。 。 .

将光熊猫诊断法改为: --screenshots 改为 fast 状态或情景运行. 共享 Puppeteer 主机抓取当前页面, 包括失败, 并发送 a 带有绝对PNG路径的JSON指数和 fidelity: "markdown" 默认. 用于修改的本地捆绑, 设置 QA_LIGHTPANDA_FIDELITY=native-css。 。 。 . 见 原始捕获构建 为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 共发布 34 个版本,首次发布于 2026/08/09;过去 12 个月发布了 34 个版本。

版本发布日期距今
0.11.6latest2026/11/062 天前
0.11.32026/11/017 天前
0.11.22026/10/2217 天前
0.11.12026/10/1622 天前
0.10.42026/10/081 个月前
0.10.3next2026/10/081 个月前

关于 @app-studio/qa-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 和提交记录判断。