feishu

用飞书官方开放平台 API 读/写飞书：读群消息（可筛 @我）、发消息、读与追加云文档、知识库、多维表格，外加一个能调任意接口的 api 原语

以 Pi package（技能形态）发布。技能本体在 skills/feishu/。

• 平台：全平台
• 许可：GPL-3.0-or-later（全文见 LICENSE）

安装

pi install git:gitea.vhkd.top/pi-hub/feishu.git@v0.1.0

装完 pi-skill list 能看到 feishu，pi-skill feishu check 会告诉还缺什么。

先准备什么

• node（运行环境），安装：brew install node；用内置 fetch 与 AbortSignal.timeout，无第三方依赖

常用命令

命令	说明
status	自检：应用凭据、应用身份 token、用户身份 token（真打一次接口验证，不只看缓存）
setup	写入应用凭据 app-id / app-secret（也可查当前配置）
login	浏览器里点一次授权，拿可自动续期的用户 token（本地 localhost 回调）
logout	清掉本机用户 token（应用凭据保留）
scopes	列出本技能申请的权限范围，便于去开发者后台对账
me	当前授权的人是谁
chat	chat list/info/members：我在哪些群、群资料、群成员（id 换人名）
message	message list/get/send/reply：按群读消息（--since/--mentions-me）、看单条、发消息、回复
hook	hook add/list/remove/send：群自定义机器人 Webhook——不需要应用审批就能往群里发消息的那条通道
doc	doc read/blocks/append/create：读云文档正文、看块结构、追加段落、新建文档
wiki	wiki node/spaces：知识库节点换真实文档 token、列可访问知识库
bitable	bitable tables/records/add：多维表格的表、记录、新增记录
search	search docs <关键词>：在云文档里搜（需要 drive 权限）
user	user get：按 open_id / 邮箱查人
url	url parse：飞书链接是什么类型、token 是哪个
api	通用原语：任意 METHOD/PATH/query/body，两种身份可切（理论上能操作一切飞书接口）

用法与对外契约见技能内的 SKILL.md 与 REFERENCE.md。