# @alwaysmeticulous/cli 中文文档

规范地址：https://npmcn.com/package/%40alwaysmeticulous/cli/

版本：3\.6\.0
npm 元数据更新时间：2026-11-05T16:25:08.692Z
中文译文更新时间：2026-11-05T23:07:18.561Z
软件包许可：ISC

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

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

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

- 包体积（解压后）：31.9 MB，404 个文件
- 模块格式：CommonJS
- TypeScript 类型：包内自带
- Node.js 要求：\>= 18
- 运行依赖：0 个
- 首次发布：2022-02-09T08:28:42.844Z
- 最新版本发布：2026-11-05T16:25:08.269Z
- 近 30 天下载量：456451（2026-10-06 至 2026-11-04，npm 官方下载统计）
- 已发布版本数：603（近 12 个月 179 个）

## 中文简介

温和的CLI

## 安装

```sh
npm install @alwaysmeticulous/cli
```

也可以使用：`pnpm add @alwaysmeticulous/cli`、`yarn add @alwaysmeticulous/cli`、`bun add @alwaysmeticulous/cli`

## README

# 温和的CLI

[![npm version](https://img.shields.io/npm/v/@alwaysmeticulous/cli.svg)](https://www.npmjs.com/package/@alwaysmeticulous/cli) [![npm downloads](https://img.shields.io/npm/dm/@alwaysmeticulous/cli.svg)](https://www.npmjs.com/package/@alwaysmeticulous/cli) [![License: ISC](https://img.shields.io/npm/l/@alwaysmeticulous/cli.svg)](https://github.com/alwaysmeticulous/meticulous-sdk/blob/main/LICENSE) [![Node.js Version](https://img.shields.io/node/v/@alwaysmeticulous/cli.svg)](https://nodejs.org/)

用于 [恶毒](https://meticulous.ai/) - 自动端到端测试,取消测试维护。 见 [文档](https://app.meticulous.ai/docs) 更多细节.

## 何为冥想?

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

**主要惠益:**

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

## 安装

```bash
npm install --save-dev @alwaysmeticulous/cli
```

## 快速启动

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

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

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

`onboard` 使用您本地的 Claude 代码或 Codex 账户来准备拉请求 带有录音机和CI配置。 见 [登入指南](https://app.meticulous.ai/docs/onboarding-guide) 为了吉特哈布, GitLab,和 Bitbucket 连接指令和手动替代品.

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

### 1\. 记录会议

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

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

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

### 2\. 模拟会议

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

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

### 3\. CI运行

在您的 CI 管道中添加 Meticulous 以自动测试每个牵引请求 。 见 [文档](https://app.meticulous.ai/docs) 详细的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` 命令)

## 文档

-   [完整文档](https://app.meticulous.ai/docs)
-   [登入指南](https://app.meticulous.ai/docs/onboarding-guide)
-   [GitHub 仓库](https://github.com/alwaysmeticulous/meticulous-sdk)

## 所需资源

-   节点.js 12

## 支助

-   联合国 [应用符号.ai/docs](https://app.meticulous.ai/docs)
-   问题: [GitHub 问题](https://github.com/alwaysmeticulous/meticulous-sdk/issues)

## 常见问题

### @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 和提交记录判断。