# @buoy-gg/solid 中文文档

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

版本：7\.0\.87
npm 元数据更新时间：2026-11-07T01:57:41.864Z
中文译文更新时间：2026-11-08T20:25:27.074Z
软件包许可：未声明

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

原始 npm 页面：https://www.npmjs.com/package/%40buoy-gg/solid
原文对照：https://npmcn.com/package/%40buoy-gg/solid/?lang=original

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

- 包体积（解压后）：35.4 kB，25 个文件
- 模块格式：ES Module
- TypeScript 类型：包内自带
- 运行依赖：5 个
- peer 依赖：solid-js \>=1\.8 \<2
- 首次发布：2026-10-20T20:25:23.363Z
- 最新版本发布：2026-11-07T01:57:41.692Z
- 近 30 天下载量：2627（2026-10-09 至 2026-11-07，npm 官方下载统计）
- 已发布版本数：19（近 12 个月 19 个）

## 中文简介

运行 Buoy 在固态应用程序.

## 安装

```sh
npm install @buoy-gg/solid
```

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

## README

# 固态起伏

Buoy运行在以Vite所建的Solid 1.9应用中,作为β. 你的应用保持所有固态. Buoy将React用于自己的屏幕并带去. 整个指南是 [固态页面](https://buoy.gg/buoy/latest/docs/web/solid)。 。 。 .

## 安装并签名

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

```sh
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 插件 :

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

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

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

```tsx
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 })` 还有 |
| `onMount` | Buoy一起来就叫停机功能 |
| `onDestroy` | Buoy停站时打电话 |

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

## 固体储存和信号

```tsx
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/router` | `connectBuoyRouter`,用于手动路由器链接 |
| `@buoy-gg/solid/store` | `buoySolidStore`, (中文(简体) ), `buoySolidSignal` |
| `@buoy-gg/solid/highlights` | `connectBuoyHighlights`,用于手举高亮 |

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

## 常见问题

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