@buoy-design/cli

中文文档
0.8.20发布于 2026/11/09MITTypeScriptES Module构建来源已验证近 30 天下载 1877

赶在船前赶上设计漂移

中文使用文档
文档目录10 节
  1. 快速启动
  2. 发现什么
  3. 图标
  4. 修正命令
  5. 救援工作流程
  6. 信任水平
  7. AI 一体化
  8. 0 配置
  9. 遥测
  10. 链接

阿约布依

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

快速启动

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 命令为设计漂移建议并应用修正:

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

救援工作流程

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

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 编码工具合作良好:

# 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 组合从一个安装的接线,而不是绑定在您身上.

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和安静的输出从不发送.

版本与发布记录

@buoy-design/cli 共发布 125 个版本,首次发布于 2025/12/30;过去 12 个月发布了 125 个版本。最新版本附带 npm provenance 构建来源证明,可追溯到公开的 CI 构建记录。

版本发布日期距今
0.8.20latest2026/11/09今天
0.8.192026/11/09今天
0.8.182026/11/09今天
0.8.172026/11/09今天
0.8.162026/11/091 天前
0.8.152026/11/081 天前

关于 @buoy-design/cli 的常见问题

@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 和提交记录判断。