# @ever-works/zapier-plugin 中文文档

规范地址：https://npmcn.com/package/%40ever-works/zapier-plugin/

版本：1\.0\.18
npm 元数据更新时间：2026-11-03T09:06:14.288Z
中文译文更新时间：2026-11-14T01:42:42.882Z
软件包许可：AGPL-3\.0

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

原始 npm 页面：https://www.npmjs.com/package/%40ever-works/zapier-plugin
原文对照：https://npmcn.com/package/%40ever-works/zapier-plugin/?lang=original
项目主页：https://github.com/ever-works/ever-works/tree/main/packages/plugins/zapier#readme
源码仓库：https://github.com/ever-works/ever-works

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

- 包体积（解压后）：418 kB，6 个文件
- 模块格式：ESM + CJS
- TypeScript 类型：包内自带
- 运行依赖：1 个
- peer 依赖：@ever-works/plugin ^1\.2\.16
- 首次发布：2026-06-06T08:20:23.785Z
- 最新版本发布：2026-11-03T09:06:13.829Z
- 近 30 天下载量：2629（2026-10-14 至 2026-11-12，npm 官方下载统计）
- 已发布版本数：15（近 12 个月 15 个）

## 中文简介

Zapier 自动化管道插件 - 工作生成过程中触发 Zapier 动作

## 安装

```sh
npm install @ever-works/zapier-plugin
```

也可以使用：`pnpm add @ever-works/zapier-plugin`、`yarn add @ever-works/zapier-plugin`、`bun add @ever-works/zapier-plugin`

## README

# @ever-works/zapier-plugin (英语)

Zapier 自动化管道插件 - 工作生成过程中触发 Zapier 动作

## 插件元数据

| 外地 | 数值 |
| --- | --- |
| 身份证 | `zapier` |
| 类别 | `pipeline` |
| 能力 | `pipeline`, (中文(简体) ), `form-schema-provider` |
| 作者 | 永远工作团队 |
| 许可证 | AGPL-3.0 导弹 |
| 内建 | 对 |
| 可自动启用 | 没有 |

## Zapier插件是做什么的?

这个插件让 Ever Works 将工作生成管道委托给 [扎皮尔](https://zapier.com/),工作流程自定义平台与数千个应用程序的连接器. Ever Works没有运行内置管线,而是在每代人的请求中,通过官方的Zapier SDK,引用了Zapier动作.

您选择任何 Zapier 动作( 搜索、 创建、 或防火和遗忘) , 将其连接到您的 Zapier 认证, 插件会用工作环境有效载荷执行此动作 。 Zapier返回动作结果, Ever Works 以两种形状之一转换成管道输出:结构化 `{ items: [...] }` 用于自定义 Zaps 的合同,或一种本地记录模式,即通过可配置的字段映射将原始 Zapier 输出投射到工作项目上。 副作用动作(发送电子邮件,发送消息,创建任务)也支持并用零项完成.

## 为什么用它?

-   触发任何Zapier的集成 跨越上千个应用程序而不写连接器代码.
-   三种执行形状——结构化项目,有场地映射的原生记录,或火与被遗忘的副作用——以匹配不同的使用案例.
-   重新使用已有的 Zapier 认证, 应用程序连接, 以及您已经维护的 Zaps .
-   换入不同的动作或再映射字段而不触碰 Ever Works 代码.
-   在生产中使用长寿的OAuth客户端证书和短寿的访问符来进行本地开发.

## 怎样在永生工作

当选择此插件为活动管道时, 平台会通过官方引用 Zapier 动作 `@zapier/zapier-sdk`,通过 `appKey`, (中文(简体) ), `actionType` (搜索/创建/etc.)和 `actionKey`与你的Zapier认证对齐 行动在扎皮尔的基础设施上展开,并回报其结果. 根据配置的结果形状,插件或期望结构化 `{ items: [...] }` JSON 对象, 使用您的字段映射将原始记录字段投放到工作项目上, 或将动作视为不产生项目的副作用 。 结构化产出被分析为Ever Works管道产出(工作草案、项目清单、类别、标签)。 所需产出计划见Ever Works文件.

## 开始

1.  报名到 [(原始内容存档于2018-10-21). zapier.com](https://zapier.com/) 并识别您想要 Ever Works 触发的动作(注意其 `app_key`, (中文(简体) ), `action_type`,以及 `action_key`) (中文(简体) ).
2.  在 Zapier UI 中,连接您想要动作使用的认证并复制其认证ID .
3.  运行 `npx zapier-sdk create-client-credentials` 用于生产的秘密值,或 `npx zapier-sdk login` 为当地发展获得一种短暂的准入标志.
4.  在 Ever Works 中打开 Zapier 插件设置并粘贴客户端 ID + 客户端 secret 或者访问符 。 救赎.
5.  在那个 **生成** ,设置动作引用(`app_key`, (中文(简体) ), `action_type`, (中文(简体) ), `action_key`, (中文(简体) ), `authentication_id`)和结果形状,然后触发运行.

## 设置

-   `clientId` — 长寿 OAuth 客户端ID from `npx zapier-sdk create-client-credentials`建议生产.
-   `clientSecret` (单位:千美元)**隐藏**)——长寿客户秘密配对 `clientId`。创建期间只显示一次.
-   `accessToken` (单位:千美元)**隐藏**——短生无记名符从 `npx zapier-sdk login`仅用于地方发展.
-   `baseUrl` ——覆盖Zapier SDK基址(为SDK默认留空).

认证需要任一 `accessToken` _或者说_ 两者 `clientId` 财务报告和审定财务报表 `clientSecret`。生成器还额外暴露了每个运行的选项,包括动作参考(应用键、动作类型、动作键、认证ID),结果形状(`structured` / 本地记录 / `side-effect`),本地记录的实地映射,以及动作超时.

## 解决问题

| 症状 | 可能的原因是 | 修补 |
| --- | --- | --- |
| 世代从不开始/留在 `0%` | `zapier` 未选择此工程的运行中的管道插件 | 打开工作 **插件** → `pipeline` 能力和设置 `zapier` 作为活动管道;或 设置为全球管道默认 **设置 — 插件** |
| 步骤失败 `No AI / search / screenshot provider configured` | 管道依赖于无法启用或没有证书的能力插件 | 启用并配置工作或全球匹配能力插件( AI 提供者、 搜索、 截图、 内容提取器) |
| 步骤输出看起来错误/ 通用 | Form-field 调制未设置; 使用与工程域不符的默认管道 | 打开 **生成表单** 为工作设置特定域(类别、目标关键词、源 URL),并重运行受影响的步骤 |
| Webhook 返回时 `404` 编号 : `Not Found` | 假想 / Zap 未启用或 Webhook URL stale | 在Zapier自动化仪表板中 **活动**,将一个新鲜的webhook URL复制到插件设置中,并触发测试运行 |
| 主机重启后管道无法恢复 | 检查站没有继续存在(今天只有标准管道维持检查站) | 取消被卡住的运行并重新触发生成; 因为生产可靠性更可取 `standard-pipeline` |

## 地方发展

这个插件船与Ever Works平台一起内置. 从单列波根进行本地研究:

```bash
pnpm install
pnpm --filter @ever-works/zapier-plugin build
pnpm --filter @ever-works/zapier-plugin test
```

## 文档

-   [工程文档](https://docs.ever.works/)
-   [Ever 工程仓库](https://github.com/ever-works/ever-works)
-   [插件系统](https://npmcn.com/package/plugin/README.md)
-   [扎皮尔主页](https://zapier.com/)
-   [Zapier SDK 文档](https://docs.zapier.com/sdk)

## 许可证

AGPL-3.0 导弹

## 常见问题

### @ever-works/zapier-plugin 是什么？

Zapier 自动化管道插件 - 工作生成过程中触发 Zapier 动作

### 如何安装 @ever-works/zapier-plugin？

在项目目录运行 npm install @ever-works/zapier-plugin，或使用 pnpm add / yarn add / bun add。它还需要宿主项目提供 peer 依赖：@ever-works/plugin（^1\.2\.16）。npm 7 及以上与 pnpm 8 及以上默认会自动安装必需的 peer 依赖，Yarn 需要手动安装。

### @ever-works/zapier-plugin 支持 TypeScript 吗？

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

### @ever-works/zapier-plugin 支持 ESM 还是 CommonJS？

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

### @ever-works/zapier-plugin 可以商用吗？

@ever-works/zapier-plugin 使用 AGPL-3\.0 许可。最严格的 Copyleft：除分发外，通过网络向用户提供基于它的服务也需要开源对应源码。闭源 SaaS 使用前务必评估。以上为概括，不构成法律意见，请以许可原文为准。

### @ever-works/zapier-plugin 的下载量有多少？

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

### @ever-works/zapier-plugin 还在维护吗？

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