← 全部技能

feishu

v0.1.0

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

什么时候用要读某个飞书群的最近消息或 @我的消息并据此总结/干活,要给群或某人发飞书消息、回复某条消息,要读某篇云文档正文、往文档追加内容(如填周报),要读多维表格记录或新增记录,要查知识库节点、搜云文档、把 open_id 换成人名时

组合应用 由多个技能协作完成 全平台

怎么装

一次装齐 按顺序执行 3 条

1pi install git:gitea.vhkd.top/pi-hub/skill-interface@v0.1.4依赖
2pi install git:gitea.vhkd.top/pi-hub/cdp-page-control@v0.1.4依赖
3pi install git:gitea.vhkd.top/pi-hub/feishu@v0.1.0本体
Pipi install git:gitea.vhkd.top/pi-hub/feishu@v0.1.0

装完跑 pi-skill feishu check。

先准备什么

node运行环境

用内置 fetch 与 AbortSignal.timeout,无第三方依赖

brew install node

要先配什么

appId 必配

飞书自建应用的 App ID(开发者后台 → 凭证与基础信息)

你飞书自建应用的 App ID 是多少?

appSecret 必配 私密

飞书自建应用的 App Secret(与 App ID 成对,等同密钥)

你飞书自建应用的 App Secret 是多少?

redirectUrl 可选

OAuth 回调地址,必须与开发者后台「安全设置 → 重定向 URL」登记的一致

本地回调用哪个地址?(需与开发者后台登记的一致)

常用命令

status自检:应用凭据、应用身份 token、用户身份 token(真打一次接口验证,不只看缓存)
setup写入应用凭据 app-id / app-secret(也可查当前配置)
login浏览器里点一次授权,拿可自动续期的用户 token(本地 localhost 回调)
logout清掉本机用户 token(应用凭据保留)
scopes列出本技能申请的权限范围,便于去开发者后台对账
me当前授权的人是谁
chatchat 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:读云文档正文、看块结构、追加段落、新建文档
wikiwiki node/spaces:知识库节点换真实文档 token、列可访问知识库
bitable会改状态bitable tables/records/add:多维表格的表、记录、新增记录
searchsearch docs <关键词>:在云文档里搜(需要 drive 权限)
useruser get:按 open_id / 邮箱查人
urlurl parse:飞书链接是什么类型、token 是哪个
api通用原语:任意 METHOD/PATH/query/body,两种身份可切(理论上能操作一切飞书接口)