@alwaysmeticulous/cli

中文文档
3.6.0发布于 2026/11/06ISCTypeScriptCommonJS零依赖构建来源已验证近 30 天下载 45.6万

温和的CLI

中文使用文档
文档目录11 节
  1. 何为冥想?
  2. 安装
  3. 快速启动
  4. 1. 记录会议
  5. 2. 模拟会议
  6. 3. CI运行
  7. CLI 命令
  8. 配置
  9. 文档
  10. 所需资源
  11. 支助

温和的CLI

npm version npm downloads License: ISC Node.js Version

用于 恶毒 - 自动端到端测试,取消测试维护。 见 文档 更多细节.

何为冥想?

Meticulous通过记录真实的用户互动,自动为您的网络应用程序创建和维护一个全面的测试套件. 当您打开一个拉取请求时, Meticulous 重复播放这些用户会话,对准您的应用程序的新旧版本,识别视觉和功能差异.

主要惠益:

  • 零维护测试随应用程序而演变
  • 缩放到数千个不写代码的测试
  • 在回归到生产之前抓住它
  • 测试真实用户流量,而非假设

安装

npm install --save-dev @alwaysmeticulous/cli

快速启动

要在应用程序仓库中安装 Meticulous, 将仓库连接到 先是修补工程,然后进行:

npx @alwaysmeticulous/cli onboard --project="<ORGANIZATION>/<PROJECT>"

如果你没有登录, onboard 打开浏览器进行签名。 在遥控器上 机器,运行 npx @alwaysmeticulous/cli auth login --device 先说.

onboard 使用您本地的 Claude 代码或 Codex 账户来准备拉请求 带有录音机和CI配置。 见 登入指南 为了吉特哈布, GitLab,和 Bitbucket 连接指令和手动替代品.

会话是用户与应用程序交互的录音,Meticulous可以重放来测试回归.

1. 记录会议

与您的应用程序交互记录新会话 :

npx @alwaysmeticulous/cli record \
  --apiToken="<API_TOKEN>" \
  --appUrl="http://localhost:3000"

说明: --apiToken 只有在非存储于 ~/.meticulous/config.json。 。 。 .

2. 模拟会议

模拟关于您本地环境的录音会话 :

npx @alwaysmeticulous/cli simulate \
  --apiToken="<API_TOKEN>" \
  --sessionId="<SESSION_ID>" \
  --appUrl="http://localhost:3000"

3. CI运行

在您的 CI 管道中添加 Meticulous 以自动测试每个牵引请求 。 见 文档 详细的CI设置指令.

CLI 命令

运行 npx @alwaysmeticulous/cli --help 以查看所有可用的命令.

常见命令 :

  • onboard 使用 Claude 代码或代码安装记录器和 CI 配置
  • record - 记录新的会话
  • simulate - 模拟当地录制的会话
  • run-all-tests - 运行所有重放测试箱
  • 可通过 --help

配置

可以通过命令行旗或环境变量配置 CLI :

  • --apiToken 编号 : METICULOUS_API_TOKEN - 你的温和API标志
  • --appUrl 编号 : METICULOUS_APP_URL - 您的应用程序运行的 URL
  • --sessionId - 需要重放的特定会话ID(用于 simulate 命令)

文档

所需资源

  • 节点.js 12

支助

版本与发布记录

@alwaysmeticulous/cli 共发布 603 个版本,首次发布于 2022/02/09;过去 12 个月发布了 179 个版本。最新版本附带 npm provenance 构建来源证明,可追溯到公开的 CI 构建记录。

版本发布日期距今
3.6.0latest2026/11/06今天
3.5.02026/11/051 天前
3.4.02026/10/297 天前
3.2.02026/10/2214 天前
3.1.02026/10/2215 天前
3.0.02026/10/1620 天前

其他发布通道:next → 2.226.1-beta.0。

关于 @alwaysmeticulous/cli 的常见问题

@alwaysmeticulous/cli 是什么?

温和的CLI

如何安装 @alwaysmeticulous/cli?

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

@alwaysmeticulous/cli 支持 TypeScript 吗?

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

@alwaysmeticulous/cli 支持 ESM 还是 CommonJS?

以 CommonJS 形式发布,可以直接 require();在 ES Module 项目中也可以用 import 引入(Node.js 会把 module.exports 作为默认导出)。

@alwaysmeticulous/cli 需要什么版本的 Node.js?

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

@alwaysmeticulous/cli 可以商用吗?

@alwaysmeticulous/cli 使用 ISC 许可。宽松许可:允许商业使用、修改和再分发,通常只需在分发时保留原版权与许可声明。以上为概括,不构成法律意见,请以许可原文为准。

@alwaysmeticulous/cli 的下载量有多少?

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

@alwaysmeticulous/cli 还在维护吗?

最新版本 3.6.0 发布于 2026/11/06(今天);至今共发布 603 个版本,其中过去 12 个月发布了 179 个;首次发布于 2022/02/09。发布频率只是参考信号:功能稳定的工具可能很少需要更新,建议结合源码仓库的 issue 和提交记录判断。