# @bendyline/gezel-service 中文文档

规范地址：https://npmcn.com/package/%40bendyline/gezel-service/

版本：1\.2\.13
npm 元数据更新时间：2026-11-05T04:09:34.382Z
中文译文更新时间：2026-11-08T09:38:00.950Z
软件包许可：MIT

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

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

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

- 包体积（解压后）：115 MB，1093 个文件
- 模块格式：ESM + CJS
- TypeScript 类型：包内自带
- Node.js 要求：\>=24\.0\.0
- 运行依赖：48 个
- peer 依赖：node-pty ^1\.1\.0，kokoro-js ^1\.2\.1，@huggingface/transformers ^4\.3\.1
- 首次发布：2026-08-11T14:00:46.068Z
- 最新版本发布：2026-11-05T04:09:34.048Z
- 近 30 天下载量：1830（2026-10-08 至 2026-11-06，npm 官方下载统计）
- 已发布版本数：26（近 12 个月 26 个）

## 中文简介

Gezel服务(gezeld):一个本地守护进程,它运行你的Gezels,他们的聊天,任务,和模型,有一个HTTP API和web UI.

## 安装

```sh
npm install @bendyline/gezel-service
```

也可以使用：`pnpm add @bendyline/gezel-service`、`yarn add @bendyline/gezel-service`、`bun add @bendyline/gezel-service`

## README

# @bendyline/gezel-服务

`gezeld`,则 [格泽尔](https://github.com/bendyline/gezel) 服务。 一个本地的 HTTP 拥有聊天会话的服务,通往 LLM 提供者的路线,管理记忆, 任务和工程,并读取和写出全部内容 `~/.gezel/`。 。 。 .

这就是 `@bendyline/gezel-cli` 在幕后运行。 直接安装 只有您正在嵌入 Gezel 或单独运行服务时.

```bash
npm install @bendyline/gezel-service
npx -p @bendyline/gezel-service gezeld
```

`gezeld` 在前景中运行,并通过环境配置 变量(参见 [环境](https://npmcn.com/package/%40bendyline/gezel-service/#readme-environment)(三); `npx -p @bendyline/gezel-service gezeld --help` 列出他们。 总是命名 `@bendyline/` 软件包 `npx`: 一个赤裸的 `npx gezeld` 在您安装的文件夹外, 请求 npm 提供不相关的软件包 .

## 里面的东西

-   Hono HTTP API 在回放、无记名托肯认证上
-   `Store` ——所有磁盘状态的单一读/写路径
-   `ChatManager` - 会议周期、持久性、提供者 -- -- 状态恢复
-   供应商:副驾驶、OpenAI、Anthropic、lama.cpp、MLX、ds4和a 用于测试的决定性模拟器
-   每段 MCP 桥, 跨越 Stdio 和可流的 HTTP
-   记忆(sqlite-vec),历史,任务,使用跟踪,引擎下载
-   **捆绑的网络用户界面** 时间 `dist/ui/`这样 `gezel start --web` 满座 仅安装节点的浏览器界面, 没有其它要获取的

## 入境点

| 子路径 | 目录 |
| --- | --- |
| `@bendyline/gezel-service` | `startService()` 服务类型 |
| `@bendyline/gezel-service/handboek` | Handboek 渲染助手 |
| `@bendyline/gezel-service/gezapp` | AI App (英语:`.gezapp`验证、包装和阅读,不开始服务 |
| `@bendyline/gezel-service/native-release` | 被钉住的本地引擎发布及其存档摘要,作为数据 |
| `@bendyline/gezel-service/media` | 用于构建知识目录的图像、音频和视频嵌入 |
| `@bendyline/gezel-service/packaging` | 搭建时间辅助器,为Electron App推出被钉住的本地引擎 |
| `@bendyline/gezel-service/dist/bin/gezeld.js` | 服务可执行文件, 也安装为 `gezeld` 命令。 为您启动 Gezel 的工具, 如 CLI 和应用程序 SDK , 启动此文件 |

```ts
import { startService } from '@bendyline/gezel-service';

const { port, clientToken, stop } = await startService({ home: '/tmp/gezel-home' });
console.log({ port, clientToken });
await stop();
```

## 可选同伴

基 npm 安装出一些大块或原生块. 云供养者, 本地引擎, HTTP API, MCP, UI, 任务, 和文件特性不工作 他们。 仅在部署需要时安装 :

| 软件包 | 需要时间 |
| --- | --- |
| `@huggingface/transformers@^4.3.1` | 进程内存嵌入 |
| `kokoro-js@^1.2.1` | Kokoro 文本对语音 |
| `node-pty@^1.1.0` | 交互终端;没有它,打开终端报告 `node-pty` 失踪了,其他的都继续工作 |

```bash
npm install @huggingface/transformers@^4.3.1 kokoro-js@^1.2.1
```

npm 消费者还应在应用程序根上添加两个覆盖 `package.json` (npm忽略了依赖关系宣布的覆盖). `kokoro-js` 1.2.1 仍然宣布变形器。js `^3.5.1`; 没有覆盖 npm 在服务4.x 1旁边安装一个秒, 3.x 复制件, 以及服务 kokoro 的抗震器是用自己的副本建造的. `adm-zip` 0.6.1是第一个 发表其咨询意见:

```json
{
  "overrides": {
    "adm-zip": "0.6.1",
    "kokoro-js": { "@huggingface/transformers": "^4.3.1" }
  }
}
```

桌面安装器和可调试的节点分布已经包含 此 ML 运行时间与已审查的覆盖 。 两种路径都使用一个变形器 4.x / ONNX 运行时行而不是安装独立的 3.x 和 4.x 堆栈.

## 本地发动机

On-device推论需要本地引擎二进制. 它们不是捆绑的—— 服务在第一次使用时下载 `native-v*` 释放情况 [Gezel 仓库](https://github.com/bendyline/gezel/releases/),核查 释放的 `SHA256SUMS` 对抗此套件中包含的文摘 信任任何个人档案散列。 设定 `GEZEL_LLAMA_SERVER_BIN` (和 兄弟姐妹)指向自己的建筑,或者 `GEZEL_NATIVE_BIN_DIR` 以美元计 包含全部内容的目录.

云供养者不取此相.

## 共享语音模型

语音对文本(Whiper)和文字对语音(Kokoro)的重量来自被钉住的 目录中 `@bendyline/gezel/speech-models`,该模块的节点模块 `@bendyline/gezel` 其他桌面应用程序也可以使用的软件包 。 每个文件都是 以修订、尺寸和SHA-256为支柱,并在使用前加以核实.

-   每个用户保存一次经核实的文件,单位: `<GEZEL_HOME>/engines/speech-assets/<sha256>`。每个应用程序都保留自己的 安装与这些文件的硬链接(或复制,不另加) 下载, 当它们处于不同的音量时, 因此两个应用程序永远不会下载 同一型号两次,删除一个应用程序的安装永不中断 另一个.
-   跨进程下载和清理协调;删除缓存文件 只有在没有安装时才使用.
-   搜索还发现 Gezel 的旧模型文件夹中已经存在的模型, in 只有读取的模范住宅(`GEZEL_READONLY_MODEL_HOMES`),并在桌面中 app的全机资产文件夹. 它从来没有读过机器服务 私人国家.
-   没有下载自己:健康检查从不找模型 旧的 Kokoro 导出更新只当您再次拉出模型时进行 .
-   一个必须保存文件的应用程序可以提供 `SpeechAssetStore` (单位:千美元) `root` 联 合 国 `null`,它关闭共享.

## 环境

| 变量 | 效果 |
| --- | --- |
| `GEZEL_HOME` | 国家目录( 默认) `~/.gezel`(中文(简体) ) |
| `GEZEL_PORT` | 听听这个口号 默认: 6228 当它是自由的, 否则是一个自由端口 |
| `GEZEL_LOG_LEVEL` | `debug` | `info` | `warn` | `error` | `silent` |
| `GEZEL_MOCK_PROVIDER=1` | 决定提供者,不需要证书 |
| `GEZEL_SKIP_SYSTEM_BOOTSTRAP=1` | 跳过先启动的背景下载 |
| `GEZEL_DISABLE_FIRST_USE_GRACE=1` | 把新鲜的家当作一个固定的安装:背景索引从头半个小时开始,而不是等待出来,还有一个随时可以聊天的模式,从第一天开始就报道了安静的夜晚。 可用于测试和自动运行 |
| `GEZEL_EMBEDDED_INFERENCE_ONLY=1` | 开始 `gezeld` 当一个应用程序运行时 `@bendyline/gezel-inference`'表面(聊天,应答,嵌入,知识,模型管理)位于服务回回听器后方,没有产品API,秘密存储,设备身份,远程对接或局域网服务. 应用程序SDK设置为 `inferenceOnly` 儿童托管服务 |
| `GEZEL_DAEMON_LOG_FILE=1` | 将服务输出写入 `<home>/logs/service-YYYY-MM-DD.log` (10个MB卷,保存了7天). 启动时CLI和应用程序SDK设置 `gezeld` 一、导 言 |
| `GEZEL_NATIVE_ENGINE_VERSION` | 覆盖被钉住的本地释放 |

## 稳定

公众API 在semver下. HTTP API 单独版本于 `/api`· ; 首选项 `@bendyline/gezel-client` {\\fn黑体\\fs22\\bord1\\shad0\\3ahbe\\4ah00\\fscx67\\fscy66\\2chffffff\\3ch808080}我直接叫它来.

## 文档

-   [仓库和完整文件](https://github.com/bendyline/gezel)
-   [通知和第三方许可证](https://github.com/bendyline/gezel/blob/main/NOTICE.md) (在本包中也作为 `dist/NOTICE.md`(中文(简体) )

麻省理工学院

## 常见问题

### @bendyline/gezel-service 是什么？

Gezel服务\(gezeld\):一个本地守护进程,它运行你的Gezels,他们的聊天,任务,和模型,有一个HTTP API和web UI\.

### 如何安装 @bendyline/gezel-service？

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

### @bendyline/gezel-service 支持 TypeScript 吗？

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

### @bendyline/gezel-service 支持 ESM 还是 CommonJS？

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

### @bendyline/gezel-service 需要什么版本的 Node\.js？

package\.json 的 engines 字段要求 Node\.js \>=24\.0\.0。版本不符时 npm 默认只给出警告，开启 engine-strict 后会拒绝安装。

### @bendyline/gezel-service 可以商用吗？

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

### @bendyline/gezel-service 的下载量有多少？

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

### @bendyline/gezel-service 还在维护吗？

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