@buoy-gg/shared-ui

中文文档
7.0.87发布于 2026/11/07TypeScriptESM + CJS近 30 天下载 8万

共享的UI组件、钩和公用事业

中文使用文档
文档目录4 节
  1. 安装
  2. 公共入境点
  3. 账户设置
  4. 自定义浮动工具

@ buoy- gg/ shared- ui

Buoy的"回放原生"工具使用的共享组件,颜色,钩子和公用设备. 在执行自定义工具或兼容的内部接口时使用此软件包. 要安装现有的工具套件,请从 @ buoy- gg/ 核心。 。 。 .

安装

npm install @buoy-gg/shared-ui

保持对等依赖性与您的其他Buoy包相兼容,包括许可证包. 这是 @buoy-gg 范围.

公共入境点

被保存的网页窗口保持了它们的上边缘,就像本地窗口一样.

导入目录
@buoy-gg/shared-ui主要组成部分和公用事业出口.
@buoy-gg/shared-ui/colors组件模块加载前用于初始化的调色板导出 .
@buoy-gg/shared-ui/uiUI组件和造型助手.
@buoy-gg/shared-ui/hooks共享钩.
@buoy-gg/shared-ui/utils实用功能.
@buoy-gg/shared-ui/dataViewer数据检查组件.
@buoy-gg/shared-ui/history与历史相关的出口.

例如,通过专用切入点读取共享调色板:

import { macOSColors } from "@buoy-gg/shared-ui/colors";

const panelBackground = macOSColors.background.card;

使用已安装的宣告来选择组件及其道具. 避免从私人来源进口。 一些组件和存储取决于账户状态或提供者上下文;导入一个原始不会初始化周围的工具生命周期.

跟着 自定义工具指南 以注册工具及其适配器。 在连接远程动作前用空数据、已知的人口状态以及所支持的应用程序主题验证您的面板 .

账户设置

AccountSetup 当Buoy需要核实账户时,请显示登录发射器。 本地和网络使用相同的启动器和账户卡,包括可复制的登录命令,连接反馈,以及支持链接. 网卡在发射台上方打开并用"逃出"(Escape),"取出"(Escape),"取出"(Escape),"取出"(取出)"(取出"取出"取出"),"取出"(取出"取出"出"出"出"出"出"出"出"出"出"出"出"出"出"出"出"出"出"出"出"出"出"出"出"出"出"出"出"出"出"出"出"出"出"出"出"出"出"出"出"出"出"出"出"出"出"出"出"出"出"出"出"出"出"出"出"出"出"出"出"出"出"出"出"出"出"出"出"出"出"出"出"出"出"出"出"出""出"出"出"""""""""""""""""""""". FreeAccountPrompt 以本地模式呈现卡片.

自定义浮动工具

FloatingTool 提供与 DevTools 气泡相同的拖曳、隐藏/恢复和位置行为。 使用 FloatingToolHost 与 openFloatingTool 以保持紧凑的自定义控制在导航器上挂起。 每个工具提供自己的内容和行动。 设定 dragFromSurface 使背景可拖动,同时按钮保持手势;默认只使用抓取.

见 自定义浮动工具指南 用于本土和浏览器集成,生命周期规则和实例. 浏览器消费者可以导入专用 @buoy-gg/shared-ui/floating 输入.

在浏览器面板中,头拖曳开始于非交互空间. 按钮,制表符,输入等可聚焦控制保持其指针输入. 窗口控制器有24个px命中区域.

Web 动作栏 尊重一个起底点 。 保存的斑点仍然取胜. 网页菜单和模式停留在工具窗口上方.

版本与发布记录

@buoy-gg/shared-ui 共发布 120 个版本,首次发布于 2026/01/04;过去 12 个月发布了 120 个版本。

版本发布日期距今
7.0.87latest2026/11/071 天前
7.0.862026/11/062 天前
7.0.852026/11/053 天前
7.0.842026/11/035 天前
7.0.832026/11/035 天前
7.0.822026/11/036 天前

其他发布通道:beta → 2.1.4-beta.2。

关于 @buoy-gg/shared-ui 的常见问题

@buoy-gg/shared-ui 是什么?

共享的UI组件、钩和公用事业

如何安装 @buoy-gg/shared-ui?

在项目目录运行 npm install @buoy-gg/shared-ui,或使用 pnpm add / yarn add / bun add。它还需要宿主项目提供 peer 依赖:react(*)、@buoy-gg/license(7.0.87)。npm 7 及以上与 pnpm 8 及以上默认会自动安装必需的 peer 依赖,Yarn 需要手动安装。

@buoy-gg/shared-ui 支持 TypeScript 吗?

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

@buoy-gg/shared-ui 支持 ESM 还是 CommonJS?

同时提供 ES Module 与 CommonJS 入口,import 和 require() 都可以使用,打包工具会自动选择合适的版本。

@buoy-gg/shared-ui 可以商用吗?

@buoy-gg/shared-ui 使用 未声明 许可。package.json 没有声明许可证。没有许可证的代码默认保留全部权利,商用前请联系作者或查看仓库中的 LICENSE 文件。以上为概括,不构成法律意见,请以许可原文为准。

@buoy-gg/shared-ui 的下载量有多少?

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

@buoy-gg/shared-ui 还在维护吗?

最新版本 7.0.87 发布于 2026/11/07(1 天前);至今共发布 120 个版本,其中过去 12 个月发布了 120 个;首次发布于 2026/01/04。发布频率只是参考信号:功能稳定的工具可能很少需要更新,建议结合源码仓库的 issue 和提交记录判断。