@buoy-gg/solid

中文文档
7.0.87发布于 2026/11/07TypeScriptES Module近 30 天下载 2627

运行 Buoy 在固态应用程序.

中文使用文档
文档目录5 节
  1. 安装并签名
  2. 设置
  3. 选项
  4. 固体储存和信号
  5. 入境点

固态起伏

Buoy运行在以Vite所建的Solid 1.9应用中,作为β. 你的应用保持所有固态. Buoy将React用于自己的屏幕并带去. 整个指南是 固态页面。 。 。 .

安装并签名

从您的应用程序文件夹中运行这些 :

npm install --save-dev @buoy-gg/core @buoy-gg/solid @buoy-gg/network
npx --package=@buoy-gg/core buoy login

以同样的方式增加更多的工具. 对所有Buoy包使用相同的版本. buoy login 写入 VITE_BUOY_KEY 到文件 Git 忽略.

设置

添加 Vite 插件 :

// vite.config.ts
import solid from 'vite-plugin-solid';
import { buoy } from '@buoy-gg/core/vite';

export default defineConfig({ plugins: [solid(), buoy()] });

打开 <Buoy /> 在路由器的根, 内部 QueryClientProvider数字 :

import { Buoy } from '@buoy-gg/solid';

function Layout(props) {
  return (
    <>
      {props.children}
      <Buoy />
    </>
  );
}

<Router root={Layout}>...</Router>

就这样. 插件会找到您的工具并添加早期的钩子 . 它让Buoy离开活生生的建筑. <Buoy /> 读出你的钥匙 然后在第一次渲染后开始Buoy. 它连接了固态路由器和固态查询器 当你有它们. 它会阻止Buoy,当它消失, 所以热重载是安全的.

选项

<Buoy /> 使用与 mountBuoy 从 @buoy-gg/core/web,加上这些:

Prop它会做什么
routes您的路由配置, 所以路由站点映射列出每个页面
load用Buoy装入应用程序设置 。 使用 dev 检查以删除文件
modules您自己的工具列表, 替换插件
enableInRelease开始Buoy的发行建筑。 设定 buoy({ enableInRelease: true }) 还有
onMountBuoy一起来就叫停机功能
onDestroyBuoy停站时打电话

startBuoy(options) 启动 Buoy 无组件. 它不能读固体语境,所以通过 queryClient 你自己来.

固体储存和信号

import { buoySolidSignal, buoySolidStore } from '@buoy-gg/solid/store';

<Buoy zustandStores={{
  todos: buoySolidStore([todos, setTodos]),
  count: buoySolidSignal([count, setCount]),
}} />

它们在Zustand工具中显示. 你可以在那里阅读和编辑它们. 编辑保存您没有更改的字段 .

入境点

导入持有
@buoy-gg/solid<Buoy />, (中文(简体) ), startBuoy
@buoy-gg/solid/register早钩子. Vite 插件为您添加
@buoy-gg/solid/routerconnectBuoyRouter,用于手动路由器链接
@buoy-gg/solid/storebuoySolidStore, (中文(简体) ), buoySolidSignal
@buoy-gg/solid/highlightsconnectBuoyHighlights,用于手举高亮

每个条目有一个 buoy-disabled 建造它什么也做不了. Vite 插件选中它为 prod 构建 .

版本与发布记录

@buoy-gg/solid 共发布 19 个版本,首次发布于 2026/10/21;过去 12 个月发布了 19 个版本。

版本发布日期距今
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 天前

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

@buoy-gg/solid 是什么?

运行 Buoy 在固态应用程序.

如何安装 @buoy-gg/solid?

在项目目录运行 npm install @buoy-gg/solid,或使用 pnpm add / yarn add / bun add。它还需要宿主项目提供 peer 依赖:solid-js(>=1.8 <2)。npm 7 及以上与 pnpm 8 及以上默认会自动安装必需的 peer 依赖,Yarn 需要手动安装。

@buoy-gg/solid 支持 TypeScript 吗?

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

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

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

@buoy-gg/solid 可以商用吗?

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

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

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

@buoy-gg/solid 还在维护吗?

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