@gea-ai/agent-extension-feishu

中文文档
0.2.261114-alpha.0发布于 2026/11/15Apache-2.0TypeScriptES Module近 30 天下载 3824

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

中文使用文档

@gea-ai/agent-extension-feishu

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

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

独立使用频道 agent.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 商业工具及集成技能, 请使用扩展 :

// 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登录,请声明平台用户匹配者. 没错 一个普通同步函数,在被绑定的状态中作为普通代理工作代码运行 工人:

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 授权 独立。 主机升级需要重建代理和新频道 在升级的主机上安装。 两个入场点都有着相同的身份流.

开发者文档

与 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 共发布 25 个版本,首次发布于 2026/10/14;过去 12 个月发布了 25 个版本。

版本发布日期距今
0.2.261114-alpha.0latest2026/11/15今天
0.2.261113-alpha.02026/11/133 天前
0.1.261111-alpha.12026/11/123 天前
0.1.261111-alpha.02026/11/124 天前
0.1.261106-alpha.02026/11/069 天前
0.1.261102-alpha.22026/11/0213 天前

关于 @gea-ai/agent-extension-feishu 的常见问题

@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(今天);至今共发布 25 个版本,其中过去 12 个月发布了 25 个;首次发布于 2026/10/14。发布频率只是参考信号:功能稳定的工具可能很少需要更新,建议结合源码仓库的 issue 和提交记录判断。