# @auv-js/cli 中文文档

规范地址：https://npmcn.com/package/%40auv-js/cli/

版本：0\.0\.43
npm 元数据更新时间：2026-11-04T13:42:55.682Z
中文译文更新时间：2026-11-07T07:17:19.154Z
软件包许可：Apache-2\.0

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

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

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

- 包体积（解压后）：66.8 kB，15 个文件
- 模块格式：ES Module
- TypeScript 类型：包内自带
- 运行依赖：1 个
- 首次发布：2026-08-17T12:01:43.495Z
- 最新版本发布：2026-11-04T13:42:55.176Z
- 近 30 天下载量：26557（2026-10-07 至 2026-11-05，npm 官方下载统计）
- 已发布版本数：27（近 12 个月 27 个）

## 中文简介

NAPI 绑定和平台匹配的 AUV 命令行可执行文件

## 安装

```sh
npm install @auv-js/cli
```

也可以使用：`pnpm add @auv-js/cli`、`yarn add @auv-js/cli`、`bun add @auv-js/cli`

## README

# `@auv-js/cli`

安装匹配当前操作的 AUV 命令行可执行文件 系统与CPU架构. 可执行文件由特定平台交付 可选 npm 依赖性, 因此安装不会运行网络下载 `postinstall` 剧本.

```sh
pnpm add @auv-js/cli
pnpm exec auv --help
```

节点应用程序可以明确解决已安装可执行文件:

```ts
import { binaryPath } from '@auv-js/cli/binary'
import { startAuv } from '@auv-js/sdk/node'

const daemon = await startAuv({ binaryPath: binaryPath() })
```

在 macOS 上, 原生装订暴露了与 CLI 相同的帮助器设置模块 :

```ts
import {
  installMacosHelper,
  macosHelperStatus,
  openMacosHelperAccessibilitySettings,
  openMacosHelperBackgroundItemsSettings,
  uninstallMacosHelper,
} from '@auv-js/cli'

const before = await macosHelperStatus()
const installed = await installMacosHelper()

if (installed.state === 'requires-approval') {
  openMacosHelperBackgroundItemsSettings()
}
else if (installed.state === 'running') {
  openMacosHelperAccessibilitySettings()
}

// Removes only the helper app and its Accessibility decision. Enrollment is
// retained so a later reinstall does not require credential entry again.
await uninstallMacosHelper()
```

`installMacosHelper()` 验证和安装嵌入式应用程序 当前用户的 AUV 应用程序支持目录, 然后注册其嵌入式 通过 `SMAppService`。它不需要 `sudo` 也没有 管理员密码 。 发展约束力报告 `helperEmbedded=false`· ; 官方 macOS 发布绑定 载有相同的签名和公证辅助程序 作为CLI.

CLI 和每个捆绑的包 `@auv-js/cli` 是独立的前端 一个每个用户的助手。 任何声明协议范围包括此内容的助手 约束协议是可用的,无论它的版本. `installMacosHelper()` 仅当它比嵌入式帮助器年长或不支持时才替换它 绝不降级 如果已安装的助手放弃此选项 约束协议、状况报告 `frontend-outdated`: 更新此软件包 而不是帮助者.

`uninstallMacosHelper()` 等待服务管理部门停止任何飞行 帮助进程, 重新设置帮助包的可访问性决定, 并删除 只有已安装的应用程序。 它保留了入学和所有其他 AUV 应用程序 支持内容.

## 电子包装

不从内部执行二进制 `app.asar`在包装时,复制 路径返回 `binaryPath()` 进入一个无包装的、由应用程序拥有的地点并解决问题 在运行时复制路径 .

-   复制给 `YourApp.app/Contents/MacOS/auv`列表中 电子制造器 `mac.binaries` 因此,它被签为巢编码.
-   视窗: 复制到 `resources/bin/auv.exe` 结束 `extraResources`。 。 。 .
-   Linux: 复制包含路径的完整目录 `binaryPath()` 改为 `resources/bin` 结束 `extraResources`兄弟姐妹们 `lib/`, (中文(简体) ), `share/`,以及 `licenses/` 条目是可执行文件的一部分 运行时间捆绑; 只复制 `auv` 不支持.

电能主要过程应拥有儿童过程,并随之通过 绝对路径到 `startAuv()`。导入 `@auv-js/cli/binary` 装入时 不装入 NAPI 附加词。 如果应用程序还导入根 NAPI 运行时进入点, 保留 `*.node` 自动搜索和救援系统外的 软件包文件 本地模块/`asarUnpack` 支助。 使SDK独立于包装政策 因此浏览器和远程客户端消费者不会安装本地可执行文件.

### 运送自己的macOS助手

应用程序可以用它自己的名字、图标、捆绑来运送 macOS 帮助器 标识符,和开发者 ID 团队而不是官方 `AUV Helper`构建 带它 `crates/auv-device-helper-macos/package/package.sh` 联 合 国 `AUV_MACOS_HELPER_*` 覆盖、公证和锁定,并嵌入无包装物 应用程序捆绑中不重新签名的应用程序(例如) `YourApp.app/Contents/Library/Helpers/`) (中文(简体) ). 传出一条绝对的道路 守护进程和设置 :

```ts
import path from 'node:path'
import process from 'node:process'

import { installMacosHelper } from '@auv-js/cli'
import { startAuv } from '@auv-js/sdk/node'

const helperApp = path.join(process.resourcesPath, '..', 'Library', 'Helpers', 'Your Computer Use.app')

const status = await installMacosHelper({ helperApp })
const daemon = await startAuv({ binaryPath, platforms: { macos: { helperApp } } })
```

AUV 从该应用程序的签名读取捆绑标识符和团队ID,安装 抄本如下: `~/Library/Application Support/<bundle identifier>/`,则 守护进程只信任这个身份 。 CLI 等值为 `auv setup macos-helper install --helper-app <path>`见 [帮助设置引用](https://npmcn.com/docs/ai/references/session-api/2026-10-01-macos-helper-setup.md#shipped-helper-identity)。 。 。 .

支持的软件包目前覆盖macOS arm64/x64, glibc Linux arm64/x64,以及 Windows arm64/x64 (英语). 安装可选的依赖性 二进制; `binaryPath()` 报告该案件存在可起诉错误.

## 常见问题

### @auv-js/cli 是什么？

NAPI 绑定和平台匹配的 AUV 命令行可执行文件

### 如何安装 @auv-js/cli？

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

### @auv-js/cli 支持 TypeScript 吗？

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

### @auv-js/cli 支持 ESM 还是 CommonJS？

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

### @auv-js/cli 可以商用吗？

@auv-js/cli 使用 Apache-2\.0 许可。宽松许可：允许商业使用、修改和再分发，并附带明确的专利授权；分发时需保留许可与 NOTICE 文件，修改过的文件要注明改动。以上为概括，不构成法律意见，请以许可原文为准。

### @auv-js/cli 的下载量有多少？

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

### @auv-js/cli 还在维护吗？

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