# @buoy-design/cli 中文文档

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

版本：0\.8\.20
npm 元数据更新时间：2026-11-08T21:32:51.292Z
中文译文更新时间：2026-11-09T18:44:41.801Z
软件包许可：MIT

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

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

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

- 包体积（解压后）：2.4 MB，472 个文件
- 模块格式：ES Module
- TypeScript 类型：包内自带
- 运行依赖：18 个
- 首次发布：2025-12-30T03:20:13.973Z
- 最新版本发布：2026-11-08T21:32:50.948Z
- 近 30 天下载量：1877（2026-10-09 至 2026-11-07，npm 官方下载统计）
- 已发布版本数：125（近 12 个月 125 个）

## 中文简介

赶在船前赶上设计漂移

## 安装

```sh
npm install @buoy-design/cli
```

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

## README

# 阿约布依

在飞船前抓住设计漂移 Buoy扫描了您的代码库, 找出AI生成的代码与您设计系统的不同之处 .

## 快速启动

```bash
npx ahoybuoy show all
```

此扫描您的工程而不需要配置 .

## 发现什么

-   **硬码颜色** 喜欢 `#3b82f6` 而不是设计符号
-   **魔法数** 喜欢 `padding: 17px` 而不是间隔变量
-   **AI 生成代码** 无视你的团队模式

## 图标

| 命令 | 目的 |
| --- | --- |
| `buoy show all` | 扫描组件、 符号和漂移 |
| `buoy drift check` | 承诺前漂移验证 |
| `buoy drift fix` | 预览或应用漂移修正 |
| `buoy rescue` | 测量、修理、警卫和证明改进 |
| `buoy dock` | 配置项目( 代理、 钩等) |
| `buoy ahoy` | 云态特征(login, GitHub bot, 计费) |

## 修正命令

这个 `buoy drift fix` 命令为设计漂移建议并应用修正:

```bash
buoy drift fix                    # Preview fixable issues
buoy drift fix --dry-run          # Show detailed diffs
buoy drift fix --apply            # Apply high-confidence fixes
buoy drift fix --confidence=high  # Require high-confidence matches
```

## 救援工作流程

对于现有的密码库,救援将命令变成一个可审查的旅程:

```bash
buoy rescue plan
# Review .buoy/rescue/runs/<run-id>/report.html
buoy rescue apply --run <run-id> --approve
buoy rescue guard --run <run-id> --reason "Reviewed legacy baseline"
buoy rescue report --run <run-id>
```

应用需要干净的 Git 工作树并创建新 `buoy/<run-id>` 树枝. Buoy从未承诺,推动,合并,或上传源代码. 隐蔽的改变留下 需要审查,以及 `buoy rescue rollback` 恢复本地备份.

### 信任水平

| 职等 | 分数 | 说明 |
| --- | --- | --- |
| **准确** | 100% | 与设计符号完全匹配的值 |
| **高级** | 95-99% (中文(简体) ) | 非常接近匹配,可以自动应用 |
| **介质** | 70-94% | 接近匹配, 建议审查 |
| **低级** | < 70% | 需要大量人工审查 |

## AI 一体化

Buoy与 AI 编码工具合作良好:

```bash
# Set up AI agents with design system context
buoy dock agents

# Generate CLAUDE.md context
buoy dock context
```

## 0 配置

Buoy自动检测您的框架( React, Vue, Svelte, Angular, Astro) 并扫描标准路径 。 启动时不需要配置 .

## 遥测

默认关闭。 Buoy在第一次漂移导致一个互动终端后,曾经问过它能否发送匿名使用pings. 说不就再也不问了.

如果您选择加入, 它会发送事件名称(`cli_first_run`, (中文(简体) ), `cli_drift_found`, (中文(简体) ), `cli_check_clean`, (中文(简体) ), `cli_hint_shown`, (中文(简体) ), `cli_login_started`)与计数,CLI版本,以及你的OS. 从不文件路径,仓库名称,代码,或账户细节. 随机编号 `~/.buoy/config.json` 组合从一个安装的接线,而不是绑定在您身上.

```bash
buoy ahoy telemetry          # show the setting and the exact payload
buoy ahoy telemetry off      # or on
```

`BUOY_TELEMETRY=0`, (中文(简体) ), `DO_NOT_TRACK=1`,或 `CI` 在环境中,不管设置如何,都会禁用它。 JSON和安静的输出从不发送.

## 链接

-   [文档](https://buoy.design/docs)
-   [GitHub 图像](https://github.com/ahoybuoy/buoy)

## 常见问题

### @buoy-design/cli 是什么？

赶在船前赶上设计漂移

### 如何安装 @buoy-design/cli？

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

### @buoy-design/cli 支持 TypeScript 吗？

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

### @buoy-design/cli 支持 ESM 还是 CommonJS？

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

### @buoy-design/cli 可以商用吗？

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

### @buoy-design/cli 的下载量有多少？

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

### @buoy-design/cli 还在维护吗？

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