兹克立语
帮助建筑、清洁、更新和出版项目,以及出口和分析大赦国际会议记录.
需要20号或更新的节点。 4.6.0亚伦被钉入 package.json 并列入 .yarn/releases。 。 。 .
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 明确扩展发行文件.
浏览器检查
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:
{
"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 的可选依赖。 其他命令不导入它们,所以在省略可选的依赖性时会工作. 浏览器二进制是一个单独的设置步骤( Nameyarn 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 值和类似秘密的任务,包括索引中的摘要.
源头布局
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,并保留项目内部的临时文件.