@bendyline/gezel-client

中文文档
1.2.13发布于 2026/11/05MITTypeScriptES Module构建来源已验证近 30 天下载 2525

Gezel键入了HTTP + SSE客户端并运行时间发现.

中文使用文档
文档目录3 节
  1. 人工连接
  2. 入境点
  3. 稳定

@bendyline/gezel-客户端

输入的 HTTP 客户端 宝石 守护进程 (单位:千美元)gezeld) (中文(简体) ). 环绕每个服务端点——宝石、项目、会话、聊天 流线、任务、记忆、模型、引擎和使用.

npm install @bendyline/gezel-client

随着Gezel在你的电脑上运行:

import { connectToLocalGezel } from '@bendyline/gezel-client/node';

const { client, close } = await connectToLocalGezel();
try {
  const { gezels } = await client.listGezels();
  console.log(gezels.map((gezel) => gezel.name));

  const session = await client.createChatSession({
    gezelId: gezels[0]!.id,
    projectId: 'default',
  });
  await client.sendToChatSession(session.id, 'hello');
  for await (const event of client.streamSessionEvents(session.id)) {
    if (event.type === 'delta') process.stdout.write(event.content);
  }
} finally {
  await close();
}

没有可以配置的地址、密码或证书 。 格泽尔听 127.0.0.1 在发射时它选择的端口上,在TLS之上,并附有它制造的证书 并接受一个标志 也可以改变每次发射 这个 将全部三个写入 ~/.gezel/runtime/ (单位:千美元)$GEZEL_HOME/runtime/ 用于另一个 只有你才能读到. connectToLocalGezel() 读取他们,相信 一个证书,然后跟随 Gezel 穿过一个重新启动: 查找 旧的地址不见了,或者旧的代号拒绝了,再次读取文件并发送 再来一次 当Gezel不运行时,它会抛出 DaemonNotRunningError,其 消息说要打开应用程序或运行 gezel start。 。 。 .

过 { home } 到达Gezel家,而不是默认.

这个连接到你,与访问 gezel 命令已经。 让一个应用 你给别人使用Gezel,使用 @bendyline/gezel-app-sdk 相反:一个人批准一次,它只获得它所要求的访问.

人工连接

A 类 GezelClient 需要Gezel自己的证书才能拿到 节点的内置 fetch 拒绝自签名证书 DEPTH_ZERO_SELF_SIGNED_CERT, (中文(简体) ), 所以通过一个相信它的运输工具:

import { GezelClient } from '@bendyline/gezel-client';
import { createTrustingFetchFromPath } from '@bendyline/gezel-client/node';

const client = new GezelClient({
  baseUrl, // https://127.0.0.1:<the port in runtime/port>
  token, // the contents of runtime/auth-token
  fetch: await createTrustingFetchFromPath(certPath), // runtime/cert.pem
});

Gezel 重新启动时, 所有三个值都会停止 connectToLocalGezel() 手柄给你.

入境点

子路径目录
@bendyline/gezel-clientGezelClient 及其请求/答复类型
@bendyline/gezel-client/node只有节点的帮助 : connectToLocalGezel() 因为Gezel已经运行, discoverOrSpawn() 用于查找或启动本地守护进程, TLS 传输 createTrustingFetch() 编号 : createTrustingFetchFromPath()

discoverOrSpawn() cLI 和 VS 代码扩展名如何定位运行 守护进程( 或启动一个) 。 它解决了守护进程进入点 require.resolve('@bendyline/gezel-service/dist/bin/gezeld.js')这样 @bendyline/gezel-service 必须安装在它旁边的产卵道.

稳定

公众API 在semver下. 这是驱动 gezel 守护进程的支持方式 从你自己的代码中——比用手调用HTTP API更可取.

麻省理工学院

版本与发布记录

@bendyline/gezel-client 共发布 26 个版本,首次发布于 2026/08/11;过去 12 个月发布了 26 个版本。最新版本附带 npm provenance 构建来源证明,可追溯到公开的 CI 构建记录。

版本发布日期距今
1.2.13latest2026/11/053 天前
1.2.122026/11/044 天前
1.2.112026/10/2811 天前
1.2.102026/10/2712 天前
1.2.92026/10/2712 天前
1.2.82026/10/2415 天前

关于 @bendyline/gezel-client 的常见问题

@bendyline/gezel-client 是什么?

Gezel键入了HTTP + SSE客户端并运行时间发现.

如何安装 @bendyline/gezel-client?

在项目目录运行 npm install @bendyline/gezel-client,或使用 pnpm add / yarn add / bun add。

@bendyline/gezel-client 支持 TypeScript 吗?

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

@bendyline/gezel-client 支持 ESM 还是 CommonJS?

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

@bendyline/gezel-client 需要什么版本的 Node.js?

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

@bendyline/gezel-client 可以商用吗?

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

@bendyline/gezel-client 的下载量有多少?

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

@bendyline/gezel-client 还在维护吗?

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