# @gudhub/core 中文文档

规范地址：https://npmcn.com/package/%40gudhub/core/

版本：1\.1\.162
npm 元数据更新时间：2026-10-09T14:30:58.047Z
中文译文更新时间：2026-11-17T02:54:28.101Z
软件包许可：ISC

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

原始 npm 页面：https://www.npmjs.com/package/%40gudhub/core
原文对照：https://npmcn.com/package/%40gudhub/core/?lang=original
项目主页：https://bitbucket.org/AAtlas/gudhub#readme
源码仓库：https://bitbucket.org/AAtlas/gudhub

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

- 包体积（解压后）：8.4 MB，106 个文件
- 模块格式：ES Module
- TypeScript 类型：未声明
- Node.js 要求：22\.22\.2
- 运行依赖：8 个
- 首次发布：2021-12-02T10:47:36.302Z
- 最新版本发布：2026-10-09T14:30:57.828Z
- 近 30 天下载量：95188（2026-10-17 至 2026-11-15，npm 官方下载统计）
- 已发布版本数：256（近 12 个月 50 个）

## 中文简介



## 安装

```sh
npm install @gudhub/core
```

也可以使用：`pnpm add @gudhub/core`、`yarn add @gudhub/core`、`bun add @gudhub/core`

## README

![GudHub logo](https://bitbucket.org/AAtlas/gudhub-documentation/raw/master/gudhub-images/Group%20217.png)

[![npm version](https://img.shields.io/website?up_color=blue&up_message=GudHub&url=https%3A%2F%2Fgudhub.com%2F)](https://app.gudhub.com/) [![npm version](https://img.shields.io/website?color=117C19&label=docs&up_message=GudHub%20Documentation&url=https%3A%2F%2Fgudhub.com%2Fdocs%2F)](https://app.gudhub.com/docs/)

[![npm version](https://img.shields.io/npm/v/@gudhub/core?color=0EA017)](https://www.npmjs.com/package/@gudhub/core) [![npm downloads](https://img.shields.io/npm/dm/@gudhub/core?color=EE9A11)](https://www.npmjs.com/package/@gudhub/core)

# 几内亚

我不是一个图书馆来简化与GudHub API的工作. 此外,该图书馆还设有各种设施,以便更好地与下列机构一起运作: `items`, (中文(简体) ), `fields` 财务报告和审定财务报表 `apps`来啊!

-   [几内亚](https://npmcn.com/package/%40gudhub/core/#readme-gudhub)
    -   [npm 软件包](https://npmcn.com/package/%40gudhub/core/#readme-npm-package)
    -   [发布 gudhub lib 到 npm](https://npmcn.com/package/%40gudhub/core/#readme-publishing-gudhub-lib-to-npm)
        -   [发展](https://npmcn.com/package/%40gudhub/core/#readme-development-gudhub-lib)
    -   [初始化](https://npmcn.com/package/%40gudhub/core/#readme-initialization)
    -   [用户](https://npmcn.com/package/%40gudhub/core/#readme-utils)
        -   [json 构造器( )](https://npmcn.com/package/%40gudhub/core/#readme-jsonconstructor)
        -   [json to 项目( )](https://npmcn.com/package/%40gudhub/core/#readme-jsontoitems)
        -   [使用项目参考文献居中](https://npmcn.com/package/%40gudhub/core/#readme-populatewithitemref)
        -   [合并项目( )](https://npmcn.com/package/%40gudhub/core/#readme-mergeitems)
        -   [项目比较( )](https://npmcn.com/package/%40gudhub/core/#readme-compareitems)
        -   [获取日期( C)](https://npmcn.com/package/%40gudhub/core/#readme-getdate)
        -   [makeNestedList () (中文(简体) )](https://npmcn.com/package/%40gudhub/core/#readme-makenestedlist)
    -   [App 处理器](https://npmcn.com/package/%40gudhub/core/#readme-app-processor)
        -   [获取 AppInfo ()](https://npmcn.com/package/%40gudhub/core/#readme-getappinfo)
        -   [获取 App ()](https://npmcn.com/package/%40gudhub/core/#readme-getapp)
        -   [获取 AppsList ()](https://npmcn.com/package/%40gudhub/core/#readme-getappslist)
    -   [认证](https://npmcn.com/package/%40gudhub/core/#readme-authentication)
        -   [登录( c)](https://npmcn.com/package/%40gudhub/core/#readme-login)
        -   [登录( c)](https://npmcn.com/package/%40gudhub/core/#readme-logout)
        -   [注册( )](https://npmcn.com/package/%40gudhub/core/#readme-signup)
        -   [获取用户ById ()](https://npmcn.com/package/%40gudhub/core/#readme-getuserbyid)
        -   [获取用户列表 ()](https://npmcn.com/package/%40gudhub/core/#readme-getuserslist)
        -   [获取用户工作空间( )](https://npmcn.com/package/%40gudhub/core/#readme-getuserworkspace)
        -   [更新用户( )](https://npmcn.com/package/%40gudhub/core/#readme-updateuser)
        -   [获取Token ()](https://npmcn.com/package/%40gudhub/core/#readme-gettoken)
        -   [更新Token ()](https://npmcn.com/package/%40gudhub/core/#readme-updatetoken)
        -   [更新Avatar( )](https://npmcn.com/package/%40gudhub/core/#readme-updateavatar)
        -   [获取 Storage () 用户](https://npmcn.com/package/%40gudhub/core/#readme-getuserfromstorage)
        -   [保存用户TOStorage ()](https://npmcn.com/package/%40gudhub/core/#readme-saveusertostorage)
        -   [获取Version ()](https://npmcn.com/package/%40gudhub/core/#readme-getversion)
    -   [项目处理器](https://npmcn.com/package/%40gudhub/core/#readme-items-processor)
        -   [获取项目( )](https://npmcn.com/package/%40gudhub/core/#readme-getitems)
        -   [添加新项目( )](https://npmcn.com/package/%40gudhub/core/#readme-addnewitems)
        -   [更新项目( )](https://npmcn.com/package/%40gudhub/core/#readme-updateitems)
        -   [删除项目( )](https://npmcn.com/package/%40gudhub/core/#readme-deleteitems)
    -   [字段处理器](https://npmcn.com/package/%40gudhub/core/#readme-field-processor)
        -   [获取字段( )](https://npmcn.com/package/%40gudhub/core/#readme-getfield)
        -   [更新字段( )](https://npmcn.com/package/%40gudhub/core/#readme-updatefield)
        -   [删除字段( )](https://npmcn.com/package/%40gudhub/core/#readme-deletefield)
        -   [获取 FieldModels ()](https://npmcn.com/package/%40gudhub/core/#readme-getfieldmodels)
        -   [获取 FieldValue ()](https://npmcn.com/package/%40gudhub/core/#readme-getfieldvalue)
        -   [设置 FieldValue ()](https://npmcn.com/package/%40gudhub/core/#readme-setfieldvalue)
    -   [文件处理器](https://npmcn.com/package/%40gudhub/core/#readme-file-processor)
        -   [获取文件( )](https://npmcn.com/package/%40gudhub/core/#readme-getfile)
        -   [获取Files( )](https://npmcn.com/package/%40gudhub/core/#readme-getfiles)
        -   [上传文件 ()](https://npmcn.com/package/%40gudhub/core/#readme-uploadfile)
        -   [上传 FileFromString ()](https://npmcn.com/package/%40gudhub/core/#readme-uploadfilefromstring)
        -   [是 FileExists () (中文(简体) )](https://npmcn.com/package/%40gudhub/core/#readme-isfileexists)
        -   [更新 FileFromString ()](https://npmcn.com/package/%40gudhub/core/#readme-updatefilefromstring)
        -   [复制文件( )](https://npmcn.com/package/%40gudhub/core/#readme-duplicatefile)
        -   [下载 FileFromString ()](https://npmcn.com/package/%40gudhub/core/#readme-downloadfilefromstring)
        -   [删除文件( )](https://npmcn.com/package/%40gudhub/core/#readme-deletefile)
    -   [文档处理器](https://npmcn.com/package/%40gudhub/core/#readme-document-processor)
        -   [创建文档 ()](https://npmcn.com/package/%40gudhub/core/#readme-createdocument)
        -   [获取文档( )](https://npmcn.com/package/%40gudhub/core/#readme-getdocument)
        -   [获取文档( )](https://npmcn.com/package/%40gudhub/core/#readme-getdocuments)
        -   [删除文档( )](https://npmcn.com/package/%40gudhub/core/#readme-deletedocument)
    -   [管道服务](https://npmcn.com/package/%40gudhub/core/#readme-pipeservice)
        -   [日期( )](https://npmcn.com/package/%40gudhub/core/#readme-on)
        -   [发射( )](https://npmcn.com/package/%40gudhub/core/#readme-emit)
        -   [销毁()](https://npmcn.com/package/%40gudhub/core/#readme-destroy)

## npm 软件包

软件包名称是 `@gudhub/core`这是一个私人包裹,所以 `.npmrc` 文件必须在根文件夹中才能从中加载 **无**。这意味着,如果你有 `@gudhub/core` 包裹中。 json 用于 `GudHubClient`,则 `.npmrc` 文件也应在根文件夹中.

## 发布 gudhub lib 到 npm

为了发布新版"GudHub Lib",您必须:

1.  更改版本 `package.json`
2.  将您的更改提交到仓库 `master` 分支
3.  运行 `npm publish` 命令,将发布新版本到 **无**

### 发展

如果你想开发 **GudHub 图书馆** 在另一种环境中,如: **宽度**,您需要做到以下几点:

1.  你应该去 `gudhub` 文件夹并运行到那里 `npm init @gudhub/core` 命令,它将安装 _@ gudhub/ 核心_ 将软件包输入您的全球环境
2.  那你得再加一点 `@gudhub/core` 给您的 `package.json` 作为依赖.
3.  运行后, 软件包将从本地计算机下载 `npm run dev` 或者说 `npm install` 命令

## 初始化

有几种方法可以初始化古德Hub. 最简单的方法就是将gudhub初始化,没有争论. 在这种情况下,只有提款机可以使用.

```js
import {GudHub} from '@gudhub/core';
const gudhub = new GudHub();
```

第二种方式是将GudHub以授权密钥初始化. 这是你项目中最常用的GudHub方法. 你只需要通过 `auth_key` 作为争论. 在此情况下,您将能够与 GudHub 数据合作,并使用以下所列的所有方法.

```js
import {GudHub} from '@gudhub/core';
const auth_key = 'JLKHKJSKJhkjsclkdjcijIOIoiuSTg';
const gudhub = new GudHub(auth_key);
```

第三种方法是以附加参数来初始化GudHub. 用于开发在Node.js上的服务器应用,并用于本地服务器的测试. 在下面的例子中,可以看到如何初始化 GudHub(在例子中可以看到默认的参数).

```js
import {GudHub} from '@gudhub/core';
const auth_key = 'JLKHKJSKJhkjsclkdjcijIOIoiuSTg';
const gudhub = new GudHub(auth_key,{
    server_url : "https://app.gudhub.com/GudHub", 
    wss_url : "wss://app.gudhub.com/GudHub/ws/app/", 
    initWebsocket : false
});
```

| 参数名称 | 说明 | 默认值 |
| --- | --- | --- |
| _服务器url_ | 所有请求都会发送到这个 URL | [https://app.gudhub.com/ GudHub 页面存档备份,存于互联网档案馆](https://app.gudhub.com/GudHub) |
| _无效_ | url 设置网络连接 | wss://app.gudhub.com/ GudHub/ws/app/ (中文(简体) ) |
| _输入Websocket_ | 在这里,我们可以关闭 websoket 连接 | 虚假 |

## 用户

### json 构造器( )

通过这种方法,您可以按照计划获得json.

```js
gudhub.jsonConstructor(scheme, item, variables)
```

更多信息,请访问 [json 在 GudHub 上的构造器](https://app.gudhub.com/docs/utils/json-constructor/json-constustor-overview/)。 。 。 .

### json to 项目( )

这种方法将 json 转换为 gudhub 项 。 转换基于 `fieldMap`。在生成项目后,您可以发送项目创建新项目.

```js
gudhub.jsonToItems(json, fieldsMap);
```

更多信息,请访问 [json 在 GudHub 上的构造器](https://app.gudhub.com/docs/utils/json-to-item/jsontoitem-overview/)。 。 。 .

### 使用项目参考文献居中

这种方法用源项的项目来更新目的项。 使用 src FieldIdToCompare 和 destFeldIdToCompare 来检查 sorce Projects Ref 和 src FeldId ToCompare 之间的连接 。 检测到连接后, 将项目 ref 保存到 dest FieldFor Ref .

```js
gudhub.populateWithItemRef(sorceItemsRef, srcFieldIdToCompare, destinationItems, destFieldIdToCompare, destFieldForRef, APPID)
```

更多信息,请访问 [gudHub 的项目参考文献](https://app.gudhub.com/docs/utils/populate-with-item-reference/)。 。 。 .

### 合并项目( )

当前的方法将所有字段替换为目标值 项目按价值分列 如果目的项目没有吸附项目所在的字段,它们将在目的项目中被创建.

```js
gudhub.mergeItems(sorceItems, destinationItems, mergeByFieldId);
```

更多信息,请访问 [合并 GudHub 上的项目](https://app.gudhub.com/docs/utils/merge-items/)。 。 。 .

### 项目比较( )

这种方法将吸附项目领域与目的地领域进行比较。 这意味着,如果 sorce 项目具有与目的相同值的字段,则项目将被描述为"同 项",即使目的 项目有附加字段,但项目没有.

```js
gudhub.compareItems(sorceItems, destinationItems, fieldToCompare);
```

更多信息,请访问 [比较 GudHub 上的项目](https://app.gudhub.com/docs/utils/compare-items/)。 。 。 .

### 获取日期( C)

此方法将根据指定的命名空间返回日期 。 名称空格应采用字符串格式

```js
gudhub.getDate(date_type);
```

更多信息,请访问 [在 GudHub 上获得约会](https://app.gudhub.com/docs/utils/date-utils/#get-date)。 。 。 .

### makeNestedList () (中文(简体) )

这种方法创造了无穷之巢的田地列表. 它需要一系列的字段,取决于它们的ID为每个字段制作附件.

```js
gudhub.makeNestedList(arr, 'id', 'parent_id', 'children_property', 'priority')
```

更多信息,请访问 [在 GudHub 上制作监视列表](https://app.gudhub.com/docs/utils/nested-list/)。 。 。 .

## App 处理器

### 获取 AppInfo ()

这是空数组返回应用程序的方法 : `field_list`, (中文(简体) ), `items_list`, (中文(简体) ), `file_list`, (中文(简体) ), `views_list`。需要这样的简单数据来渲染 App 图标,并在 App 中做一些简单的更新,比如: 当不需要完整 app 数据时, 更新 App 名称图标权限等

```js
gudhub.getAppInfo(app_id);
```

更多信息,请访问 [获取 GudHub 上的 AppInfo](https://app.gudhub.com/docs/core-api/app-processor/#getappinfo)。 。 。 .

### 获取 App ()

这种方法是用来通过指定其ID作为参数的应用程序.

```js
gudhub.getApp(app_id);
```

更多信息,请访问 [在 GudHub 上获取 App](https://app.gudhub.com/docs/core-api/app-processor/#getapp)。 。 。 .

### 获取 AppsList ()

这种方法在登录后被调用以获取用户应用程序列表. 它没有争论. _获取App列表_ 返回用户共享的应用程序列表.

```js
gudhub.getAppsList();
```

更多信息,请访问 [在 GudHub 上获取 App](https://app.gudhub.com/docs/core-api/app-processor/#getappslist)。 。 。 .

## 认证

### 登录( c)

这种方法用于访问账户。 它可以用登录和密码或认证密钥调用,无论是否附加参数.

```js
gudhub.login(data);
```

更多信息,请访问 [登录 GudHub](https://app.gudhub.com/docs/core-api/auth-core-api/#login-with-username-and-password)。 。 。 .

### 登录( c)

当用户从账户中日志出时使用这种方法.

```js
gudhub.logout(token);
```

更多信息,请访问 [在 GudHub 上登录](https://app.gudhub.com/docs/core-api/auth-core-api/#logout)。 。 。 .

### 注册( )

这种方法用于在GudHub中注册一个用户账户.

```js
gudhub.signup(user);
```

更多信息,请访问 [在 GudHub 注册](https://app.gudhub.com/docs/core-api/auth-core-api/#signup)。 。 。 .

### 获取用户ById ()

这种方法让用户从用户列表中可以访问应用程序.

```js
gudhub.getUserById(userId);
```

更多信息,请访问 [在 GudHub 上获取用户符号](https://app.gudhub.com/docs/core-api/auth-core-api/#getuserbyid)。 。 。 .

### 获取用户列表 ()

这种方法在搜索过程中被叫作用户共享. 即当您在搜索框中输入关键词时, GudHub 将显示所有名字与该词相匹配的用户.

```js
gudhub.getUsersList(keyword);
```

更多信息,请访问 [在 GudHub 上获取用户列表](https://app.gudhub.com/docs/core-api/auth-core-api/#getuserslist)。 。 。 .

### 获取用户工作空间( )

这种方法用于获取属于当前用户工作空间的用户列表. 返回的用户被缓存在存储中.

```js
gudhub.getUserWorkspace();
```

更多信息,请访问 [获取 GudHub 上的用户工作空间](https://app.gudhub.com/docs/core-api/auth-core-api/#getuserworkspace)。 。 。 .

### 更新用户( )

这是用于更新用户账户数据的方法.

```js
gudhub.updateUser(userData);
```

更多信息,请访问 [更新 GudHub 上的用户](https://app.gudhub.com/docs/core-api/auth-core-api/#updateuser)。 。 。 .

### 获取Token ()

这种方法用于获取当前符号.

```js
gudhub.getToken();
```

更多信息,请访问 [获取 GudHub 上的数据](https://app.gudhub.com/docs/core-api/auth-core-api/#gettoken)。 。 。 .

### 更新Token ()

这种方法在更新符号时称为.

```js
gudhub.updateToken(auth_key)
```

更多信息,请访问 [关于 GudHub 的更新](https://app.gudhub.com/docs/core-api/auth-core-api/#updatetoken)。 。 。 .

### 更新Avatar( )

当用户更改其账户相片时使用这种方法.

```js
gudhub.updateAvatar(imageData);
```

更多信息,请访问 [在 GudHub 上更新Avatar](https://app.gudhub.com/docs/core-api/auth-core-api/#updateavatar)。 。 。 .

### 获取 Storage () 用户

这种方法用于在共享过程中从用户列表中获取所需的用户.

```js
gudhub.getUserFromStorage(id);
```

更多信息,请访问 [gudHub 上的用户](https://app.gudhub.com/docs/core-api/auth-core-api/#getuserfromstorage)。 。 。 .

### 保存用户TOStorage ()

这种方法允许您在用户列表中添加新的用户.

```js
gudhub.saveUserToStorage(saveUser);
```

更多信息,请访问 [在 GudHub 上保存用户tostrage](https://app.gudhub.com/docs/core-api/auth-core-api/#saveusertostorage)。 。 。 .

### 获取Version ()

使用这种方法来查找当前版本的"古德Hub".

```js
gudhub.getVersion();
```

更多信息,请访问 [获取 GudHub 上的版本](https://app.gudhub.com/docs/core-api/auth-core-api/#getversion)。 。 。 .

## 项目处理器

### 获取项目( )

这种方法用于获取当前应用程序的项目.

```js
await gudhub.getItems(app_id, trash);
```

更多信息,请访问 [获取 GudHub 上的项目](https://app.gudhub.com/docs/core-api/item-processor/#getitems)。 。 。 .

### 添加新项目( )

使用此方法在项目列表中添加新项目 .

```js
await gudhub.addNewItems(app_id, itemsList);
```

更多信息,请访问 [添加关于 GudHub 的新项目](https://app.gudhub.com/docs/core-api/item-processor/#addnewitems)。 。 。 .

### 更新项目( )

这种方法用于更新某些项目.

```js
await gudhub.updateItems(app_id, itemsList);
```

更多信息,请访问 [更新 GudHub 的项目](https://app.gudhub.com/docs/core-api/item-processor/#updateitems)。 。 。 .

### 删除项目( )

由于此方法, 您可以从您的应用程序中删除一个或多个项目 .

```js
await gudhub.deleteItems(app_id, itemsIds);
```

更多信息,请访问 [删除 GudHub 上的项目](https://app.gudhub.com/docs/core-api/item-processor/#deleteitems)。 。 。 .

## 字段处理器

### 获取字段( )

由于这种方法,您可以从相关应用程序中获取字段.

```js
await gudhub.getField(app_id, field_id);
```

更多信息,请访问 [获取 GudHub 上的字段](https://app.gudhub.com/docs/core-api/field-processor/#getfield)。 。 。 .

### 更新字段( )

这种方法允许您更新当前应用程序的字段模型.

```js
await gudhub.updateField(app_id, fieldModel);
```

更多信息,请访问 [更新 GudHub 上的字段](https://app.gudhub.com/docs/core-api/field-processor/#updatefield)。 。 。 .

### 删除字段( )

该方法用于从应用程序中删除字段.

```js
await gudhub.deleteField(app_id, field_id);
```

更多信息,请访问 [删除 GudHub 上的字段](https://app.gudhub.com/docs/core-api/field-processor/#deletefield)。 。 。 .

### 获取 FieldModels ()

这种方法用于获取一个字段模型列表.

```js
await gudhub.getFieldModels(app_id);
```

更多信息,请访问 [获取 GudHub 上的 FieldModels](https://app.gudhub.com/docs/core-api/field-processor/#getfieldmodels)。 。 。 .

### 获取 FieldValue ()

这种方法负责从所期望的领域获得价值.

```js
await gudhub.getFieldValue(app_id, item_id, field_id);
```

更多信息,请访问 [获取 GudHub 上的 FieldValue 值](https://app.gudhub.com/docs/core-api/field-processor/#getfieldvalue)。 。 。 .

### 设置 FieldValue ()

这种方法被叫作在所期望的领域中设定值.

```js
await gudhub.setFieldValue(app_id, item_id, field_id, field_value);
```

更多信息,请访问 [设置 GudHub 上的字段值](https://app.gudhub.com/docs/core-api/field-processor/#setfieldvalue)。 。 。 .

## 文件处理器

### 获取文件( )

这种方法被称为从应用程序获取文件.

```js
gudhub.getFile(app_id, file_id);
```

更多信息,请访问 [在 GudHub 上获取文件](https://app.gudhub.com/docs/core-api/file-manager/#getfile)。 。 。 .

### 获取Files( )

这种方法要求从当前应用程序中获取文件列表.

```js
gudhub.getFiles(app_id, filesId);
```

更多信息,请访问 [在 GudHub 上获取文件](https://app.gudhub.com/docs/core-api/file-manager/#getfiles)。 。 。 .

### 上传文件 ()

目前的方法允许上传文件. 它通过表格传输文件.

```js
await gudhub.uploadFile(fileData, app_id, file_id)
```

更多信息,请访问 [上传 GudHub 上的文件](https://app.gudhub.com/docs/core-api/file-manager/#uploadfile)。 。 。 .

### 上传 FileFromString ()

这是允许将不同文件以 Base64 格式上传到应用程序的方法.

```js
await gudhub.uploadFileFromString(fileObject);
```

更多信息,请访问 [上传 GudHub 上的 FileFrom String](https://app.gudhub.com/docs/core-api/file-manager/#uploadfilefromstring)。 。 。 .

### 是 FileExists () (中文(简体) )

由于此方法, 您可以检查此应用程序中是否有以下 ID 文件 .

```js
await gudhub.isFileExists(app_id, file_id)
```

更多信息,请访问 [在 GudHub 上为 FileExists](https://app.gudhub.com/docs/core-api/file-manager/#isfileexists)。 。 。 .

### 更新 FileFromString ()

当前的方法允许更新某些文件的数据和名称.

```js
await gudhub.updateFileFromString(data, file_id, file_name, extension, format)
```

更多信息,请访问 [更新 GudHub 上的 FileFromString 格式](https://app.gudhub.com/docs/core-api/file-manager/#updatefilefromstring)。 。 。 .

### 复制文件( )

这种方法用于创建文件的复制.

```js
await gudhub.duplicateFile(files)
```

更多信息,请访问 [gudHub 上的复制文件](https://app.gudhub.com/docs/core-api/file-manager/#duplicatefile)。 。 。 .

### 下载 FileFromString ()

使用这种方法从文件列表中下载文件 .

```js
await gudhub.downloadFileFromString(app_id,file_id)
```

更多信息,请访问 [下载 GudHub 上的 FileFromString](https://app.gudhub.com/docs/core-api/file-manager/#downloadfilefromstring)。 。 。 .

### 删除文件( )

由于这种方法文件可以从应用程序中删除.

```js
gudhub.deleteFile(app_id, file_id);
```

更多信息,请访问 [删除 GudHub 上的文件](https://app.gudhub.com/docs/core-api/file-manager/#deletefile)。 。 。 .

## 文档处理器

### 创建文档 ()

这种方法要求在某些应用程序中创建一个新文档.

```js
gudhub.createDocument(documentObject);
```

更多信息,请访问 [在 GudHub 上创建文档](https://app.gudhub.com/docs/core-api/document-manager/#createdocument)。 。 。 .

### 获取文档( )

从应用程序文档列表中获取所需文档的方法 .

```js
gudhub.getDocument(documentAddress);
```

更多信息,请访问 [获取 GudHub 上的文档](https://app.gudhub.com/docs/core-api/document-manager/#getdocument)。 。 。 .

### 获取文档( )

这种方法是用来从应用程序中获取一系列文档的.

```js
gudhub.getDocuments(documentsAddresses);
```

更多信息,请访问 [获取 GudHub 上的文档](https://app.gudhub.com/docs/core-api/document-manager/#getdocuments)。 。 。 .

### 删除文档( )

由于此方法, 您可以从应用程序中删除文档 .

```js
gudhub.deleteDocumentApi(documentAddress);
```

更多信息,请访问 [删除 GudHub 上的文档](https://app.gudhub.com/docs/core-api/document-manager/#deletedocument)。 。 。 .

## 管道服务

### 日期( )

这是要求订阅的方法.

```js
gudhub.on(event, address, myFunction);
```

更多信息,请访问 [在GudHub上进行](https://app.gudhub.com/docs/core-api/pipe-server/#on)。 。 。 .

### 发射( )

这是GudHub本身使用的方法. 这需要获得现有的订阅.

```js
gudhub.on(event, address, myFunction);
```

更多信息,请访问 [在 GudHub 上释放](https://app.gudhub.com/docs/core-api/pipe-server/#emit)。 。 。 .

### 销毁()

这种方法用于破坏额外的订阅和优化进程.

```js
gudhub.destroy('gh_app_views_update', address, myFunction);
```

更多信息,请访问 [在 GudHub 上销毁](https://app.gudhub.com/docs/core-api/pipe-server/#destroy)。 。 。 .

## 常见问题

### 如何安装 @gudhub/core？

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

### @gudhub/core 支持 TypeScript 吗？

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

### @gudhub/core 支持 ESM 还是 CommonJS？

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

### @gudhub/core 需要什么版本的 Node\.js？

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

### @gudhub/core 可以商用吗？

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

### @gudhub/core 的下载量有多少？

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

### @gudhub/core 还在维护吗？

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

