# @azrico/azcli 中文文档

规范地址：https://npmcn.com/package/%40azrico/azcli/

版本：1\.3\.22
npm 元数据更新时间：2026-11-07T10:12:58.422Z
中文译文更新时间：2026-11-07T15:33:36.756Z
软件包许可：MIT

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

原始 npm 页面：https://www.npmjs.com/package/%40azrico/azcli
原文对照：https://npmcn.com/package/%40azrico/azcli/?lang=original

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

- 包体积（解压后）：981 kB，229 个文件
- 模块格式：CommonJS
- TypeScript 类型：未声明
- Node.js 要求：\>=20
- 运行依赖：8 个
- 首次发布：2022-06-25T10:16:02.820Z
- 最新版本发布：2026-11-07T10:12:58.236Z
- 近 30 天下载量：7576（2026-10-08 至 2026-11-06，npm 官方下载统计）
- 已发布版本数：169（近 12 个月 54 个）

## 中文简介

项目建设、出版、依赖和人工智能笔录助手

## 安装

```sh
npm install @azrico/azcli
```

也可以使用：`pnpm add @azrico/azcli`、`yarn add @azrico/azcli`、`bun add @azrico/azcli`

## README

# 兹克立语

帮助建筑、清洁、更新和出版项目,以及出口和分析大赦国际会议记录.

需要20号或更新的节点。 4.6.0亚伦被钉入 `package.json` 并列入 `.yarn/releases`。 。 。 .

```sh
node .yarn/releases/yarn-4.6.0.cjs install --immutable
node .yarn/releases/yarn-4.6.0.cjs typecheck
node .yarn/releases/yarn-4.6.0.cjs test
node .yarn/releases/yarn-4.6.0.cjs build
node dist/cli/index.js --help
```

随着Yarn在 PATH 上可用,相应的命令是 `yarn install --immutable`, (中文(简体) ), `yarn typecheck`, (中文(简体) ), `yarn test`,以及 `yarn build`。 。 。 .

`yarn build-dev` 编译 CLI 并复制从 `temp/` 输入 `dist/`。 。 。 . `yarn start` 监视源和资产的变化。 构建直接使用TypeScript并保存出源地图.

## 图标

| 命令 | 行为 |
| --- | --- |
| `build [mode]` | 构建一个推断的工程,或选择 `php`, (中文(简体) ), `yarn`, (中文(简体) ), `python`,或 `docker`. Docker 架构也开始 Compose 服务. |
| `clean build` | 删除 `build/` 财务报告和审定财务报表 `dist/` 在选定的项目中. |
| `clean all` | 同时去除依赖性,缓存和锁文件. |
| `up [target..]` | 更新依赖; Yarn 目标可能被省略或重复. |
| `publish` | 发布 Yarn 或 Python 软件包 。 Yarn软件包先被构建. |
| `package prepare` | 在构建前生成工作空间的核心包. |
| `package finalize` | 生成可公布的列表 `dist/`, (中文(简体) ), `build/`,或 `temp/`。 。 。 . |
| `package publish` | 出版已准备好的软件包. |
| `package go` | 准备,建造,完成,然后公布;停止第一次失败. |
| `transcripts <claude|codex>` | 导出会话到 Markdown 中 `index.json`。 。 。 . |
| `optimize-transcripts [analyser] [source] [last-chats]` | 别名 `optimize`。编写记录短片 `source` (默认:分析器)并运行分析器代理(`claude` 或者说 `codex`默认值 `claude`碞硂. `last-chats` 与 `--last`· ; `--analyser-model` (单位:千美元)`--model`)取出分析器的模型. |
| `verify-changes` | 运行检查从 `.azcli/verify.json` 匹配文件自基础参考书后就变了 首先恢复了CRLF/LF结尾被更改的修改文件中HEAD的行尾. 报告 `passed`, (中文(简体) ), `failed`,或 `not-run`; 失败时退出 1 (`--strict` 也跑不动. `--profile`, (中文(简体) ), `--base`, (中文(简体) ), `--json`, (中文(简体) ), `--no-fix` (按下线到终点恢复). |
| `restore-line-endings` | 仅恢复 CRLF/ LF 结尾被更改的修改文件中的 HEAD 线尾( 第一步) `verify-changes`) (中文(简体) ). `--path`。 。 。 . |
| `find-price` | 价格 a BOM 文件 (`--bom`)或部分编号后 `--` (单位:千美元)`NE555P:250 3051BK005:30m`,默认 1 pcs)来自鼠标/DigiKey APIS(默认:有证书的)或站点(`--use-mouser-scrap`, (中文(简体) ), `--use-digikey-scrap`) (中文(简体) ). 写作 `prices.csv`, (中文(简体) ), `report.json` 财务报告和审定财务报表 `report.md` 改为 `output/<date_time>/` (或旁边) `--out`),并在结尾列出. 全权证书来自国旗、环境或 `.env` 在当前目录中。 刮刮机需要Python号 `camoufox[geoip]` (单位:千美元)`CAMOUFOX_PYTHON` 在Linux上,Xvfb; `--headless` 运行时不显示 `--headful` 打开可见窗口( 其他操作系统默认为无头); 参见 `skills/az-find-price/SKILL.md`。 。 。 . |
| `scrape <urls..>` | 用 Camoufox 浏览器逐一装入页面 `find-price` 与(相同的瓶检处理,Xvfb, `--headless` 编号 : `--headful`),并将每页打印为AI代理的可读文本(链接为: `[text](url)`表格行为 `cell | cell`),或其最后的 HTML 与 `--html`。 。 。 . `-p X` (单位:千美元)`--part`填补 `{part}` 在有 URL 编码的 URL 中 `X`; 重复搜索每个URL的每个部分. `--out` 写入文件。 失败的页面获得 `error:` 线条和命令在其余部分之后出口1个。 同样的 Python `camoufox[geoip]` 要求作为 `find-price`; 发行商搜索 URL 已进入 `skills/az-find-price/references/distributors.md`。 。 。 . |
| `install-skills` | 复制套件中运出的技能( E)`skills/`改为: `~/.claude/skills`. 通过技能名称(`azcli install-skills azrico-js azrico-css`只安装这些. `--target` 选择另一个目录。 在这个仓库里, `yarn install-skills` 在不出版的情况下建立和运行. |
| `install-mods` | 添加套件中运出 Claude 代码 mods (`mods/`,参见 `mods/README.md`作为 `azrico-claude-mods` 插件市场并安装它们。 传出mod名 (`azcli install-mods azrico-model-router`只安装这些。 安全重跑; 从软件包中装入 Mods , 因此重新启动 Claude 代码或运行 `/reload-plugins` 后来. |
| `patch-claude-vscode` | 补丁已安装的 Claude 代码 VS 代码扩展名(`~/.vscode/extensions`, (中文(简体) ), `~/.vscode-server/extensions`,或 `--dir`因此,一个mod的盒子在答复(一个 `AssistantMessage` compare switch)可以在回复文本后坐:当mod's tree将引擎排行放在第一(`[row, ...buttons]`)盒子去后取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取.取取取取取取取取取取取取取取取取取........... 一个mod也可以给自己的盒子打出样式: `<Box key="azcli-style" display="none"><Text>{css}</Text></Box>` 在它的树上变成一个 `<style>` 下级 `@scope` 该框的编号`:scope` 是盒子本身,所以它没有达到其它目标;没有被标记的表面隐藏它。 保持一个 `.azcli-backup` 在脚本旁,跳过已补丁的版本,拒绝代码不匹配的版本,以及 `--restore` 撤销它。 每次扩展更新后再运行,然后运行"开发者:重装窗口". |
| `worktree start <path>` | 安装已锁定的工作树依赖, 在配置的默认值上选择一个自由端口, 运行 dev 服务器解开, 等待它回答或退出 。 报告 URL, pid, 编译结果, 和日志文件( 在 git dir 内) 。 如果进程退出,立即失败; `--timeout` 约束等. `--page`, (中文(简体) ), `--port`, (中文(简体) ), `--skip-install`。 。 。 . |
| `worktree status <path>` | 分行提示和工作树和目标的脏文件,前行/后行计数,分行是否被合并,各行各业的依赖性清单都发生了变化. |
| \`工作树同步-方向在 | 关闭 |
| `browser-check [directory]` | 启动选中项目的 Dev 服务器, 等待准备, 用服务器来源运行其浏览器测试脚本 `BASE_URL`。 。 。 . `--tags`, (中文(简体) ), `--headed`, (中文(简体) ), `--url`, (中文(简体) ), `--json`。 。 。 . |

工作树命令已读取 `.azcli/worktree.json` 从工作树, 否则从 `--project`; 运行 `azcli worktree start --help` 用于格式。 三个都接受 `--target` 财务报告和审定财务报表 `--json`。 。 。 .

项目命令接受 `--path` 选择工作目录。 构建、更新、清理和公布接受 `--type`,如 `--python`,以及诸如 `--nopython` 或者说 `--no-python`启用 `--quiet` 抑制进步。 出错转到 stderr 并导致非零退出状态 .

必须在PATH上提供外部工具。 命令带有明确的参数数组和工作目录。 在 Windows 上, 标准节点和编译器 `.cmd`编号 :`.bat` shims在没有命令壳的情况下解决了他们的入境点. 自定义分批发射器被拒绝,但有解释错误.

生产混凝土安装(`up --prod` 和 WordPress 构建) 保存锁定文件并安装 `--no-dev`。普通作曲家更新保留了现有的依赖性再现行为。 Python 构建/ publish 明确扩展发行文件.

## 浏览器检查

```sh
azcli browser-check ./worktrees/order --tags "@shipping and not @save"
azcli browser-check --path ./web --url http://localhost:3001 --tags "@shipping" --headed
```

目录默认为当前目录,不需要是Git寄存器. 所有浏览器检查配置都位于其中 `.azcli/browser.json`没有 `--url`,启动会安装锁定的项目依赖性,在配置的默认值上选择一个自由端口,并等待服务器。 退出,超时,或失败的编译服务器在测试命令运行前停止浏览器检查. 启动的服务器在成功或测试失败后仍然运行;命令会打印它们的URL,pid,和日志位置. 日志写入 `.azcli/logs/browser/` 在选定的目录中; 添加 `.azcli/logs/` 对该项目的 `.gitignore`。 。 。 . `--skip-install`, (中文(简体) ), `--port`, (中文(简体) ), `--page`,以及 `--timeout` 控制启动 .

使用 `--url` 用于已运行的服务器; 跳过安装和启动 。 其可用性由项目测试检查. 服务器的 **来源** (策略、主机和端口,没有页面路径) `BASE_URL`。 。 。 . `--headed` 套装 `HEADED=1`;项目浏览器悬钩必须读取该变量才能显示浏览器.

默认情况下, 浏览器检查运行 `yarn test:browser` 在选定的目录中。 一起配置测试命令和服务器 `.azcli/browser.json` (此示例假设应用程序的启动脚本为 `PORT`:

```json
{
  "command": "yarn",
  "args": ["test:browser"],
  "baseUrlEnv": "BASE_URL",
  "report": "cucumber-report.html",
  "install": {
    "command": "yarn",
    "args": ["install", "--immutable"]
  },
  "dev": {
    "command": "yarn",
    "args": ["start"],
    "defaultPort": 3000,
    "portEnv": "PORT",
    "readyPath": "/",
    "timeoutSeconds": 120,
    "pages": { "order": "/order" }
  }
}
```

`command` 当文件存在时需要; `args` 默认为空数组。 可选 `cwd` 选择选定项目内的目录. `report` 相对于测试工作目录,必须留在其中. `baseUrlEnv` 默认为 `BASE_URL`。配置从选定的目录中读取,返回到 `--project`;倒置配置仍然运行在所选目录上. 标记作为附件附上 `--tags <expression>` 没有壳分析。 npm 脚本,使用 `"command": "npm", "args": ["run", "test:browser", "--"]`。 。 。 .

`dev` 启动时需要;没有配置或 `dev`,供应 `--url`。 。 。 . `install` 是可选的,默认为 `yarn install --immutable` 在选定的目录中。 两个都接受 `command`, (中文(简体) ), `args`选择 `cwd` 相对于该目录. `dev.defaultPort` 默认为 3000; 启动可选择上方的第一个自由端口, 除非 `--port` 提供. `dev.portEnv` 默认为 `PORT`,以及 `{port}` dev 参数中,替换为选定的端口. `dev.readyPath` 默认为 `/`, (中文(简体) ), `timeoutSeconds` 改为120,以及 `binDirs` 改为 `["node_modules/.bin"]`。 。 。 . `--page` 从 `dev.pages`; 它影响已报告的服务器 URL, 而 `BASE_URL` 仍然是起源。 可选 `compiledPattern` 财务报告和审定财务报表 `failedPattern` 自定义与 Dev 日志匹配的 regex 。 Worktree配置从未被浏览器检查读取.

目标应用程序拥有 `.feature` 文档、 Cucumber 步骤定义、 认证、 定着和清理。 举例来说 `package.json` 可以定义 `"test:browser": "cucumber-js"`。它的浏览器钩应创建 Playwright 上下文 `baseURL: process.env.BASE_URL` 并发射 `headless: process.env.HEADED !== '1'`配置 Cucumber 的 HTML formatter 来写入由 : `report`; azcli 报告文件成功运行后存在的路径 。 测试失败传播到退出代码 1. `--quiet` 压制进程和子进程输出; `--json` 返回服务器细节并在成功时抓取测试输出,而失败则使用普通的 CLI 错误处理器.

`@cucumber/cucumber` (12.x,与20号节点兼容)和 `@playwright/test` 是 azcli 的可选依赖。 其他命令不导入它们,所以在省略可选的依赖性时会工作. 浏览器二进制是一个单独的设置步骤( Name`yarn playwright install chromium` 在申请中)。 应用程序的测试脚本和步骤定义必须拥有自己的可解析的Cucumber/Playwright依赖性,通常被宣布为它的不解依赖性;在全球安装azcli不会使其可选的包暴露在另一个工程的模块分辨率上. 任何软件包或浏览器二进制都是在它所配置的依赖性安装之外通过浏览器检查自动安装的.

## 转写选项

使用 `--project <text>` 反复过滤项目, `--since-days 0` 包括所有日期 `--last N` 以选择各个项目的最新匹配会话. `--list` 不导出列表。 渲染支持 `--user-only`, (中文(简体) ), `--no-include-tools`, (中文(简体) ), `--no-include-thinking`,以及 `--include-subagents`。 。 。 .

接受优化 `--in` 用于当前导出。 它只复制了将会话索引到新分析目录后再编辑,保留了原始导出. `--out` 必须指定一个空目录;省略的输出路径接收一个唯一的后缀. `--dry-run` 准备编辑的快照并打印代理命令而不启动它。 秘密删除覆盖已知项目 `.env` 值和类似秘密的任务,包括索引中的摘要.

## 源头布局

```text
src/
  cli/                         entry point, registration, shared CLI options
  core/                        subprocesses, files, JSON guards, logging, project detection
  features/
    build/ clean/ update/ publish/ package/
    transcripts/               extraction, rendering, types, JSONL readers
      sources/                 Claude and Codex adapters
    optimize-transcripts/      snapshots, redaction, prompts, agent execution
tests/
  fixtures/                    synthetic JSONL sessions
scripts/                       build and test entry points
```

每个功能都拥有一个被打入的yargs命令模块及其执行. 共享子进程使用 `core/process.ts`;特性代码允许失败到达CLI边界. 测试使用临时项目固定装置并注入指令跑道,因此套接字不会发布套接字或运行多克/AI服务. 测试脚本类型检查测试和源, 发现每个 `tests/*.test.ts`,并保留项目内部的临时文件.

## 常见问题

### @azrico/azcli 是什么？

项目建设、出版、依赖和人工智能笔录助手

### 如何安装 @azrico/azcli？

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

### @azrico/azcli 支持 TypeScript 吗？

该包的 package\.json 没有声明类型入口。需要类型提示时，可以在 npm 上查找社区维护的 @types/azrico\_\_azcli 是否存在。

### @azrico/azcli 支持 ESM 还是 CommonJS？

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

### @azrico/azcli 需要什么版本的 Node\.js？

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

### @azrico/azcli 可以商用吗？

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

### @azrico/azcli 的下载量有多少？

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

### @azrico/azcli 还在维护吗？

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