# @juxtapose/cli 中文文档

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

版本：0\.31\.0
npm 元数据更新时间：2026-11-01T13:34:40.538Z
中文译文更新时间：2026-11-01T14:51:09.832Z
软件包许可：MIT

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

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

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

- 包体积（解压后）：1.1 MB，175 个文件
- 模块格式：ES Module
- TypeScript 类型：包内自带
- Node.js 要求：\>=22\.2\.0
- 运行依赖：3 个
- 首次发布：2026-07-29T10:58:40.323Z
- 最新版本发布：2026-11-01T13:34:40.193Z
- 已发布版本数：50（近 12 个月 50 个）

## 中文简介

六视觉回归测试CLI为Storybook， Ladle和朋友。

## 安装

```sh
npm install @juxtapose/cli
```

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

## README

# @juxtapose / cli

通过URL、Storybook和Ladle对页面进行视觉回归测试。捕获 您需要的页面或故事，将它们与批准的基线进行比较，并进行检查 截图和记录的DOM更改。

需要 **Node.js 22.2或更高版本**． 本地测试不需要托管帐户：repo 保存配置、哈希和结构；图像保存在本地缓存中。主持 上传和审查是可选的，有单独的审查决定。

```bash
pnpm add -D @juxtapose/cli
npx -p @juxtapose/cli jux browser install   # once, ~100 MB
npx storybook build --quiet --disable-telemetry --loglevel error  # or: npx ladle build
npx -p @juxtapose/cli jux init              # writes config, captures and approves initial baselines
git add juxtapose.config.json juxtapose.manifest.json juxtapose.structures/ .gitignore
```

在将它们作为参考之前，检查初始捕获。后续 `jux run` 默认情况下捕获所有故事。使用 `--since <ref>` 选择受影响的 当依赖关系图可用时的故事；不确定的选择回归到 一个完整的运行。

| 命令 | 它是做什么的 |
| --- | --- |
| `jux run` | 捕获故事并与基线进行比较 |
| `jux approve --story <id>` | 确认捕获并更新本地基线 |
| `jux check` | 退出非零，如果有任何东西仍然需要审查-为CI |
| `jux handoff <id>` | 打印一个提示来调查一个失败的故事 |
| `jux browser` | `install`， `status`， `path`， `start` 或者 `stop` |
| `jux mcp` | 用于编码代理的演播室MCP服务器； [文档](https://github.com/juxtapose-dev/juxtapose/blob/main/docs/mcp.md) |

具有结构化结果支持的命令 `--json`； `jux handoff` 产生的文本。 MCP工具在可用的情况下使用结构化结果 `run` 默认为有界 摘要，而不是完整的CLI运行报告。看到 [MCP输出方式](https://github.com/juxtapose-dev/juxtapose/blob/main/docs/mcp.md).

浏览器是 `chrome-headless-shell` 151.0.7922.34，安装一次 `jux browser install` (同一版本的现有剧作家缓存是 重用; `JUX_CHROME=<path>` 或者 `--chrome <path>` 使用你自己的)。面具, `--wait-for` 选择器是CSS。

CI外, `jux snap`， `jux run` 和 `jux init` 保持一个浏览器的温度 调用之间的后台（10分钟后空闲退出）。重用避免了浏览器 发射;它并没有使改变内容成为确定性的。 `--no-daemon` 或者 `JUX_NO_DAEMON=1` 为命令关闭它；它是 在CI和Windows上也是关闭的。 `jux browser start|stop|status` 管理它，并且 `JUX_STATE_DIR` 将其套接字和状态移开 `JUX_CACHE_DIR`。这个 温暖的浏览器保持了系统字体和时区，它开始时，所以你 安装字体或更改系统时区，运行 `jux browser stop`． 看到 [浏览器指南](https://github.com/juxtapose-dev/juxtapose/blob/main/docs/browser.md) 获取详细信息。

要查看Storybook内部的差异，请添加 [`@juxtapose/storybook`](https://www.npmjs.com/package/@juxtapose/storybook).

完整的文档: [并置在GitHub](https://github.com/juxtapose-dev/juxtapose)

MIT©Magic Factory LLC

## 常见问题

### @juxtapose/cli 是什么？

六视觉回归测试CLI为Storybook， Ladle和朋友。

### 如何安装 @juxtapose/cli？

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

### @juxtapose/cli 支持 TypeScript 吗？

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

### @juxtapose/cli 支持 ESM 还是 CommonJS？

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

### @juxtapose/cli 需要什么版本的 Node\.js？

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

### @juxtapose/cli 可以商用吗？

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

### @juxtapose/cli 还在维护吗？

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