# @bendyline/gilde 中文文档

规范地址：https://npmcn.com/package/%40bendyline/gilde/

版本：0\.3\.7
npm 元数据更新时间：2026-11-07T17:38:45.281Z
中文译文更新时间：2026-11-07T22:03:11.964Z
软件包许可：MIT

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

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

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

- 包体积（解压后）：159 MB，53286 个文件
- 模块格式：ES Module
- TypeScript 类型：未声明
- 运行依赖：0 个
- 首次发布：2026-07-23T05:04:53.003Z
- 最新版本发布：2026-11-07T17:38:44.917Z
- 近 30 天下载量：4312（2026-10-08 至 2026-11-06，npm 官方下载统计）
- 已发布版本数：112（近 12 个月 112 个）

## 中文简介

Gilde目录:用于Gezel的模型清单、工具、工艺书、角色和项目类型.

## 安装

```sh
npm install @bendyline/gilde
```

也可以使用：`pnpm add @bendyline/gilde`、`yarn add @bendyline/gilde`、`bun add @bendyline/gilde`

## README

# gi

权力的公开目录 [宝石](https://github.com/bendyline/gezel)。浏览它在 [**gezelgilde.com (中文(简体) )**](https://gezelgilde.com/),或将其作为数据使用:

```
npm install @bendyline/gilde
```

软件包是原始的JSON, Markdown, 以及没有运行时间的执行 依赖性。 包括释放的人 `data/`,导出计划,以及 消费者需要核实生成的家庭 对照其输入; 仓库工具和 CI 文件不发布. 编目索引是建筑文物:它们被Git所忽略,重新生成 以 `npm run build`,并在每个 npm 包/ publish 之前自动生成.

## 里面的东西

| 类别 | 路径 | 这是什么 |
| --- | --- | --- |
| 工艺书 | 数据/工艺手册-模板/ | 步入任务游戏本 胶卷可以跟随, 每一个有 eval 侧车(`test.json`(中文(简体) ) |
| 聊天模式 | 数据/聊天模式/ | 本地模型显示:引擎源 (lama.cpp / MLX / ds4),被子修订和sha256s,调制默认 |
| 作用 | 数据/地策-平板/ | Gezel 角色模板 – the `about.md` 给一个果子酱的品行 |
| 项目类型 | 数据/项目类型/ | 项目脚手架(任务、大约、页数、嵌入式工艺书) |
| 图像模型 | 数据/图像模型/ | 图像生成模型显示 |
| 连接器类型 | 数据/连接器类型/ | 外部服务的连接器定义 |
| 视频模型 | 数据/视频模型/ | 视频生成模型显示 |
| 工具集 | 数据/工具集/ | 手订的第一党工具 |
| 社区工具 | 数据/社区/工具集/ | 从MCP登记册自动进口,只允许许可,由 `tools/lib/community-policy.mjs` ——机器人管理,未经审查 |
| 作者来源 | 撰写/ | 生成目录的可复制源材料;运行时惰性 |

每个项目都遵循相同的布局:

```
data/<category>/<shard>/<id>/manifest.json          identity: name, description, tags, license
data/<category>/<shard>/<id>/versions/<semver>/...  released content, never mutated after release
data/<category>/raw-index.json                      built listing: item files verbatim (not tracked)
data/<category>/index.json                          built legacy listing for older gezel builds (not tracked)
```

地点 `<shard>` 是 id 的前两个字符.

Chat-model 介绍是只使用 Gilde-: 在下面添加一个作者的配方 `authoring/chat-models/`运行 `npm run build-chat-model`,并承诺新的 身份和版本有效载荷。 见 `authoring/chat-models/README.md` 对食谱合同.

## 捐款

新的手书、模型更新、角色——欢迎各方作出贡献

人类和他们的人工智能特工都一样 开始

[捐款额](https://npmcn.com/package/%40bendyline/gilde/CONTRIBUTING.md)如果你是人工智能探员,

[一般事务人员(其他职等)](https://npmcn.com/package/%40bendyline/gilde/AGENTS.md) 是写给你的合约.

每个公关都经过CI验证. 本地运行相同的检查 :

```
npm run check         runs all validation checks below
npm run validate      structural + schema validation of the whole tree
npm run build         regenerates the ignored catalog indexes
npm run lint-models   completeness lint for chat-model manifests
npm run fix           rewrites non-canonical JSON and regenerates the indexes
                      (check never writes — run fix, then re-run check)
```

验证是故意的依赖灯:平地节点24+ `ajv`, (中文(简体) ),

对JSON Schemas在计划/(源于Gezel的)

(笑声) (掌声) (笑声) (掌声) (笑声) (掌声) (掌声) (掌声) (掌声) (掌声) (掌声) (掌声) (掌声) (掌声) (掌声) (掌声) (掌声) (掌声) (掌声) (掌声) (掌声) (掌声) (掌声) (掌声) (掌声) (掌声) (掌声) (掌声) (掌声) (掌声) (掌声) (掌声) (掌声) (掌声) (掌声).

## 构建 Gezel 应用程序

App是一个项目类型,由自定义页面、项目设置和任何角色组成, 手书、脚本和它需要的数据。 读取公众 [应用程序编写指南](https://github.com/bendyline/gezel/blob/main/docs/handboek/technical/building-ai-apps-inside-gezel.md), (中文(简体) ), [aPI 指南](https://github.com/bendyline/gezel/blob/main/docs/handboek/technical/gezel-page-apis.md),以及 [页面样式指南](https://github.com/bendyline/gezel/blob/main/docs/handboek/technical/gezel-app-page-style-guide.md)。 。 。 . 对于此仓库的独立演示要求, 请使用 [作者类型页面](https://npmcn.com/package/%40bendyline/gilde/docs/page-authoring.md)。主机页面接收共享字体; 在档案、引渡和数据查询方面,它们使用相同的API范围.

## 尝试本地工程页面

从寄存器根中运行独立的页面库 :

```
npm run demos
```

然后打开 [http://127.0.0.1:4173/ (中文(简体) )](http://127.0.0.1:4173/)。主页 链接到每个最新的项目类型的网络体验。 每页都确认 它位于Gezel之外,使用当地样本数据,并可由 重新装入。 要选择不同的地址 :

```
npm run demos -- --host 127.0.0.1 --port 8080
```

## 许可证发放

编目结构和工具是MIT. 每一个模型条目都带有

拥有上游 `license` 字段——在您运送一个模型之前检查它. 社区

工具箱条目在进口时被过滤为许可.

## 常见问题

### @bendyline/gilde 是什么？

Gilde目录:用于Gezel的模型清单、工具、工艺书、角色和项目类型\.

### 如何安装 @bendyline/gilde？

在项目目录运行 npm install @bendyline/gilde，或使用 pnpm add / yarn add / bun add。

### @bendyline/gilde 支持 TypeScript 吗？

该包的 package\.json 没有声明类型入口。需要类型提示时，可以在 npm 上查找社区维护的 @types/bendyline\_\_gilde 是否存在。

### @bendyline/gilde 支持 ESM 还是 CommonJS？

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

### @bendyline/gilde 可以商用吗？

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

### @bendyline/gilde 的下载量有多少？

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

### @bendyline/gilde 还在维护吗？

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