# @gea-ai/agent-extension-feishu 中文文档

规范地址：https://npmcn.com/package/%40gea-ai/agent-extension-feishu/

版本：0\.2\.261114-alpha\.0
npm 元数据更新时间：2026-11-15T02:05:56.595Z
中文译文更新时间：2026-11-16T01:27:13.772Z
软件包许可：Apache-2\.0

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

原始 npm 页面：https://www.npmjs.com/package/%40gea-ai/agent-extension-feishu
原文对照：https://npmcn.com/package/%40gea-ai/agent-extension-feishu/?lang=original
项目主页：https://musegea.com/developers
源码仓库：https://github.com/bmrlab/gea

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

- 包体积（解压后）：162 kB，21 个文件
- 模块格式：ES Module
- TypeScript 类型：包内自带
- 运行依赖：5 个
- peer 依赖：@gea-ai/agent-sdk 0\.2\.261114-alpha\.0
- 首次发布：2026-10-14T14:55:16.527Z
- 最新版本发布：2026-11-15T02:05:56.357Z
- 近 30 天下载量：3824（2026-10-16 至 2026-11-14，npm 官方下载统计）
- 已发布版本数：25（近 12 个月 25 个）

## 中文简介

Feishu bot 频道包装为 GEA 代理扩展

## 安装

```sh
npm install @gea-ai/agent-extension-feishu
```

也可以使用：`pnpm add @gea-ai/agent-extension-feishu`、`yarn add @gea-ai/agent-extension-feishu`、`bun add @gea-ai/agent-extension-feishu`

## README

# `@gea-ai/agent-extension-feishu`

用于GEA代理的Feishu Bot频道,可选扩展,增加 (原始内容存档于2018-10-12). Party Feishu Business Connector and instruction Skill.

```bash
npm install @gea-ai/agent-extension-feishu @gea-ai/agent-sdk
```

独立使用频道 `agent.ts`数字 :

```ts
import { defineAgent } from "@gea-ai/agent-sdk";
import { feishuChannel } from "@gea-ai/agent-extension-feishu/channel";

export default defineAgent({
  name: "Feishu assistant",
  slug: "feishu-assistant",
  model: "<configured-model-id>",
  channels: [feishuChannel()],
});
```

`feishuChannel()` 返回一个正常的 SDK 频道定义。 用进去 `channels` 或从发现时导出 `channels/*.ts` 文档。 SDK收集其隐藏 GEA身份连接器和主机环境自动要求. 它支持 `feishu` 财务报告和审定财务报表 `gea` 身份模式、接收消息和发送答复,但不添加业务 工具或技能. 配置 `FEISHU_APP_ID`密语 `FEISHU_APP_SECRET` 财务报告和审定财务报表 `FEISHU_ALLOWED_SENDERS` (单位:千美元)`*` 或 JSON 密码 `{ tenantKey, openId }[]`。“WebSocket”为 默认; `{ transport: "http" }` 还要求 `FEISHU_VERIFICATION_TOKEN`。 。 。 .

要添加 Feishu 商业工具及集成技能, 请使用扩展 :

```ts
// extensions/feishu.ts
export { default } from "@gea-ai/agent-extension-feishu";
```

扩展再利用 `feishuChannel()` 并增加下列业务能力.

业务电话使用曝光 `{alias}__call` 带有 lark- cli 的工具 `argv` 和可选 `stdin`。该平台在其沙盒中执行官方CLI,并管理 连接器的加密状态. 代理选择 `--as bot` 或者说 `--as user` 每个 商业指挥。 计算机和Bash是可选的,不安装lark-cli.

托管频道通话使用应用程序配置的Feishu bot Certain. `--as user` 要求消息发送者自己对同一应用程序的授权登录; 3; 缺少授权返回发送者的链接。 频道是正常的 聊天回复,所有证书都留在电脑之外. 独立连接器 引用保留现有的连接授权流 .

机器人接受私人文本和丰富文本(`post`(b) 明确提及 这个应用程序的机器人。 分组回复创建或继续触发信件 主题。 成员分享这个话题的对话,而每个电话保留其实际 发件人授权. 普通的分组信件和空的只提及信件 不要启动代理运行。 HTTP召回和WebSocket输入都使用此策略. 丰富的文本保留了标题,段落,链接,引用和代码作为Agent输入. 不支持的消息类型或嵌入式介质收到明确请求重新发送 ;这些信件不会启动代理运行或提交部分摘要.

所有频道都可以宣布SDK的通用 `requirePlatformUser` 政策。 飞须用 同一政策; 东道主执行录取,历史 阅读和执行。 托管的全球环境评估需要一名主计长 `channel-user-policy-v1`· ; 不支持的主计长显然失败。 本地默认和明确 `false` 政策 支持没有GEA登录的bot消息和回复。 当地 `true` 政策和无效 政策价值观遭到拒绝。 环境选择需要升级本地 App 服务器; 选择器保持隐私, 不通过 `ctx.env`。 。 。 .

独立频道和扩展都接受固定 `{ requirePlatformUser: true }` 或者说 `{ requirePlatformUser: false }` 选项,或诸如 `{ requirePlatformUser: { env: "REQUIRE_PLATFORM_USER", default: false } }`关闭 `requirePlatformUser` 选择模式 通过环境配置。 设定 `FEISHU_REQUIRE_PLATFORM_USER=true` 需要 GEA 用户在每次访问前的授权 运行并将 LLM 使用量归属于该用户 。 没有匹配器, 配置 `CHANNEL_GEA_CLIENT_ID` 财务报告和审定财务报表 隐藏 `CHANNEL_GEA_CLIENT_SECRET` gEA OAuth 客户端 `openid agents:invoke offline_access` 项目/代理环境. 显示使用的环境值 `false`; 无效值或失败的 GEA 授权永远不会 默然降级. 在主办全球环境评估时,重复活动保留其原始身份 决定。 本地外部模式使用未经主机验证的 Feishu 主机 身份收据,不发放GEA补助金.

要识别发件人而不另加GEA登录,请声明平台用户匹配者. 没错 一个普通同步函数,在被绑定的状态中作为普通代理工作代码运行 工人:

```ts
feishuChannel({
  platformUserMatcher: (sender, candidate) =>
    sender.openId === candidate.account.accountId,
});
```

主机验证飞翔事件,选择候选的GEA帐号并询问 匹配者可以接受或拒绝每个用户; 它仍然检查用户当前成员 和权限。 选手之前跑过 `requirePlatformUser`拒绝或 失败给出了私人指导,永远不能回到OAuth或外部身份. 与 `transport: "http"` 主机验证回调签名, 因此也配置 隐藏 `FEISHU_ENCRYPT_KEY`. 为退休本土选手建造的包件必须是: 以当前 SDK 重建并重新部署。 没有匹配者, `requirePlatformUser` 独自决定身份 `true` 使用 OAuth 条目。 Feishu商业用户同意 继续分开.

两种模式都使用同一种运输和卡. GEA 团体历史仍分开 从外部模式的历史, 和飞书业务 `--as bot|user` 授权 独立。 主机升级需要重建代理和新频道 在升级的主机上安装。 两个入场点都有着相同的身份流.

[开发者文档](https://musegea.com/developers/agent-development)

与 `platformUserMatcher`, SDK 不生成身份 OAuth 连接器 或者说 `CHANNEL_GEA_CLIENT_ID` 编号 : `CHANNEL_GEA_CLIENT_SECRET` 所需经费。 已验证 事件使用频道安装、其绑定的工程和匹配的激活 组织成员。 拆除设施、拆除项目装订和拆除 成员宣布授权无效。 更新东道主和主计长(内部赠款) 能力 `channel-native-user-grant-v1`一起重建探员 新设 `channel-user:` 校长不继承历史 `channel-oauth:` 私营 会话或连接;旧赠款保留其原始验证. 明确 没有匹配器和商务连接器授权的OAuth是不变的.

## 本地开发与主机预览

当地 `gea agent dev`,使用明确的发展条目 `feishuChannel()` 财务报告和审定财务报表 **没有** `platformUserMatcher`配置一个开发 Feishu 应用程序和发件人授权列表 `FEISHU_REQUIRE_PLATFORM_USER` 未定或虚. 消息然后使用本地/外部发送者身份,而不是经过验证的平台身份. 支持默认的 WebSocket 接收器; 真正的连接和交付 仍然需要有效的飞须证书.

本地 Dev 硬拒绝匹配者声明,包括何时 `requirePlatformUser: false`:当地东道主缺乏经过核实的入侵,候选人 账户、成员和项目授权链。 测试匹配者为纯 函数使用本地合成输入。 测试全部授权、装入/装入 匹配器启用的条目并运行主机预览安装。 留着 发布条目并检查其匹配者描述符后再上传到 本地声明不是意外运出。 本地预览页面或更改 环境标题不提供主机授权.

如果运行时启动失败 `channel-object/converge` 403, 升级 CLI 及其捆绑的运行时间在一起。 独立运行时验证此请求 而不是一个进程-全局机密. 不要将共享运行时全球秘密设定为工作。 提供者证书或 WebSocket 聚合后失败需要单独诊断;聚合成功 单凭一己之力无法证实飞翔的发送/接收.

## 常见问题

### @gea-ai/agent-extension-feishu 是什么？

Feishu bot 频道包装为 GEA 代理扩展

### 如何安装 @gea-ai/agent-extension-feishu？

在项目目录运行 npm install @gea-ai/agent-extension-feishu，或使用 pnpm add / yarn add / bun add。它还需要宿主项目提供 peer 依赖：@gea-ai/agent-sdk（0\.2\.261114-alpha\.0）。npm 7 及以上与 pnpm 8 及以上默认会自动安装必需的 peer 依赖，Yarn 需要手动安装。

### @gea-ai/agent-extension-feishu 支持 TypeScript 吗？

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

### @gea-ai/agent-extension-feishu 支持 ESM 还是 CommonJS？

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

### @gea-ai/agent-extension-feishu 可以商用吗？

@gea-ai/agent-extension-feishu 使用 Apache-2\.0 许可。宽松许可：允许商业使用、修改和再分发，并附带明确的专利授权；分发时需保留许可与 NOTICE 文件，修改过的文件要注明改动。以上为概括，不构成法律意见，请以许可原文为准。

### @gea-ai/agent-extension-feishu 的下载量有多少？

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

### @gea-ai/agent-extension-feishu 还在维护吗？

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

