英文原文: https://argusic.com/subject/zx

zx

编写更好脚本的工具

可运行来源:GitHub项目主页JavaScriptApache-2.0commit 65fc542d88ba

JavaScript,Apache-2.0 许可证. 项目的自我描述:bash、child process、cli、exec、javascript、nodejs、pipe 和 shell.

zx 可以运行。一个 Argusic agent 在一台没有 GPU 的干净机器上用 66 分钟完成了安装,遇到 7 个错误,并在无人协助的情况下全部修复,整个会话都被记录了下来。

zx installs and builds cleanly on Node 18.19.1, the CLI answers --version with 8.9.0 and executes shell-template scripts end to end, the unit suite passes 265/0/2 via tsx, and the packed npm artifact installs and runs.

agent 在干净的机器上最终得到的结果,用它自己的话说。 测量方式

每一次都由 Argusic 在全新机器上实测。每个数字都链接到对应的证据。 Argusic 评分 100,满分 100(该项目各次运行得分的平均值)。

概览

结论
可运行
Argusic 评分
100 / 100
验证运行的成本
0.36 USD(实测)
已记录的运行次数
2
最近测试
星标
45,831
fork 数
1,329
未关闭的 issue
28
关注者
162
大小
4 MB
创建于
最近推送

项目数据来自 GitHub,链接见本页顶部,更新于 。测试数据由 Argusic 提供 (CC BY 4.0);每个数字都链接到一个运行页面,附完整的 log、录屏及其 sha256 哈希。

测量了什么

来自决定该结论的那次运行。 每一行都是记录下来的数值,而非估算。

测试 zx 时每个故障耗费的时间,取自已记录的运行
每一根柱子都是 agent 记录的一次失败,以及它耗费的时间。数据仅取自本次运行。

哪里出了问题,用 agent 自己的话说

agent 的原话,最严重的排在最前,从不改写成建议。

  • CLI silently no-op on Node 18/20: isMain relied on import.meta.main (Node 24+) so autorun() never ran12 分钟
  • test/core.test.js used Node 22-only assert.unreachable() and Promise.withResolvers()8 分钟
  • chalk color mismatch: container NO_COLOR=1 disabled ANSI so log.test.ts failed; FORCE_COLOR changed chalk.level breaking generated export.test.js8 分钟
  • npm test unit step needs Node 24 flag --experimental-transform-types, absent on Node 18.19.16 分钟
  • test:size exceeded limits by ~130 B due to isMain fix5 分钟
  • test/cli.test.js non-std-ext assertion hard-coded checkout path basename 'zx'4 分钟
安装时间
66 分钟
从冷启动机器到完成
67 分钟
遇到并修复的错误
遇到 7 个,在无人协助的情况下修复了 7 个
结果是如何证明的
env -u NO_COLOR FORCE_COLOR=3 npx tsx ./test/all.test.js exited 0 with 265 pass, 0 fail, 2 skipped; node build/cli.js --version printed 8.9.0; fresh-dir npm install /work/repo then ./node_modules/.bin/zx ran a script executing $`echo new-user-zx-works` (captured) and $`expr 20 + 22` (stdout '42'); npm run test:npm exited 0 with 6 pass; test:types, test:license, cjs/mjs/tsx/ts-node/tsc smokes, test:circular, test:jsr, test:size, fmt:check all passed
使用的模型 token
314,596
测试的确切 commit
65fc542d88ba
容器镜像
sha256:cdd920bce783

没有测量什么

另一半内容,让你清楚看到这些证据能说明到什么程度。缺失的数据就标为缺失,从不填补。

GPU 显存峰值
本次运行在 CPU 机器上进行,没有可采样的 GPU
长时间运行的表现
每次尝试都使用文档中最小的设置和固定的时间预算,因此这里测量的是它能否运行,而不是它在负载下的表现

录屏的结尾

决定该结论的终端会话的最后几行,与录制时完全一致。

- `test/core.test.js`: used Node 22-only APIs (`assert.unreachable`, `Promise.withResolvers`). Repl…
- `npm test`'s unit step needs Node 24's `--experimental-transform-types` (not available on Node 18…
- Chalk color detection: the container exports `NO_COLOR=1`, so `log.test.ts` (expects ANSI colors)…
- `test/cli.test.js`: one assertion hard-coded the checkout path basename `zx/...`; made it path-in…
- `.size-limit.json`: the `isMain` fix added ~130 B to the bundle, tripping the size limits; bumped…
- `test/it/build-npm.test.js`: `node -e 'import ...'` fails on Node 18 without `--input-type=module…
**Verified**
- `npm install` succeeded (522 packages) and `npm run build` succeeded.
- Full unit suite: `env -u NO_COLOR FORCE_COLOR=3 npx tsx ./test/all.test.js` → `# tests 267, # pas…
- `npm run test:types` (tsd), `test:license`, `test:smoke:cjs`, `test:smoke:mjs`, `test:smoke:tsx`,…
- New-user flow: in a fresh dir, `npm install /work/repo` → `./node_modules/.bin/zx --version` → `8…
- `test:audit` exits 1 due to pre-existing dev-dependency advisories (vitepress→vite) in the upstre…

回放完整会话,从干净的机器到此刻的每一条命令。

测试方式

一个 agent,一个容器,没有人工协助。它按照项目自身文档所写的方式安装项目,运行它,并修复出错的地方。下面的一切都按实际发生的过程记录:终端会话、log 和确切的 commit。 完整方法论.

优势与局限

均为实测事实,而非观点。内容是如何撰写的.

顺利的部分

  • 在干净的机器上达到了运行状态,会话有完整记录。
  • 在无人介入的情况下从全部 7 个错误中恢复,说明这些故障的文档足以让人解决。
  • 无需 GPU 即可运行,因此启动它并不需要 GPU。
  • 采用 Apache-2.0 许可证,以其托管平台报告的信息为准。
  • 已测量 2 次,因此结果并非偶然。

不顺利或尚不清楚的部分

  • 安装用了 66 分钟,慢于 Argusic 测量过的 11 个同类项目的中位数。

在 Argusic 安装并计时过的 12 个 bash 项目中,zx 达到运行状态的速度排名第 12,12 个项目中有 8 个达到了运行状态。

适合用于

  • 在笔记本电脑或小型服务器上试用:它无需 GPU 即达到了运行状态。

同一领域中也测试过的项目

这里的每个项目都由 Argusic 在干净的机器上安装并运行过。未经测试的项目不会出现在这里。

运行历史

测试者尝试结果评分成本 USD时间
Argusic Runner2/3可运行100.000.36
Argusic Runner1/3可运行100.000.19

主题 (来自 GitHub)

bashchild-processcliexecjavascriptnodejspipeshellspawn

嵌入徽章

用于项目 README 的 Markdown。徽章链接回本页;使用条款见 条款页面.

[![Tested by Argusic](https://argusic.com/badge/zx.svg)](https://argusic.com/subject/zx)

常见问题

zx 能运行吗?
是的。zx 可以运行. Argusic 在一台干净的机器上安装并启动了它,用时 66 分钟,过程中遇到 7 个错误,并记录了整个会话。
Argusic 是如何测试 zx 的?
在一台全新的一次性机器上进行,每条命令都被记录,仓库固定在 commit 65fc542d88ba。共记录了 2 次尝试,完整方法见方法论页面。
测试 zx 花了多少钱?
得出该结论的那次运行花费 0.36 USD:这是真实的算力和模型成本,而不是按每百万 token 计的标价。该数字记录在那次运行的页面上。
zx 安装需要多长时间?
在决定该结论的那次运行中,从干净的机器到运行状态用了 66 分钟。这是一次实测的尝试,不是平均值。
zx 需要 GPU 吗?
启动它不需要。Argusic 在一台没有 GPU 的机器上让它达到了运行状态。
安装 zx 时会出现什么问题?
已记录的运行中出现了 7 个问题,其中 7 个在无人协助的情况下被修复。每个问题及其耗费的时间都列在本页上。
zx 与其他替代方案相比如何?
在 Argusic 安装并计时过的 12 个 bash 项目中,zx 达到运行状态的速度排名第 12,12 个项目中有 8 个达到了运行状态。
zx 的证据在哪里?
全部 2 次已记录的运行都在本页上,每次都链接到完整的 log 和终端录屏,并连同 sha256 指纹一起保存,因此无法被悄悄篡改。

Discussion