feishu-bot — feishu-机器人

飞书操作技能 (feishu-ops)

支持飞书文档的完整 CRUD 以及单元格精细操作，同时支持发送消息给个人和群聊。

凭证配置

所有操作需要 应用_id 和 应用_secret，位于技能目录的 scripts/config.json：

{ "应用_id": "命令行工具_xxxxx", "应用_secret": "xxxxx" }

若无配置文件，脚本会报错并提示创建。

文档操作 创建文档 python scripts/feishu_doc.py 创建 "文档标题"

成功返回：{"doc_令牌": "xxx", "doc_url": "https://feishu.cn/doc/xxx"}

删除文档 python scripts/feishu_doc.py 删除

写入/追加文档内容 # 全量写入（覆盖） python scripts/feishu_doc.py write "## 标题\n这是内容"

# 追加段落 python scripts/feishu_doc.py 应用end "新追加的段落"

读取文档 python scripts/feishu_doc.py read

精细操作：单元格读写

飞书文档的 blocks API 支持按 block_id 精确操作。使用前需先 read 文档获取 block 树结构。

# 查询指定 block 内容 python scripts/feishu_doc.py 查询-block

# 更新指定 block 的文本内容 python scripts/feishu_doc.py 更新-block "新的文本内容"

# 在文档末尾追加一个段落 block python scripts/feishu_doc.py 应用end-block "段落文本"

表格操作：表格为复合 block。先用 read 获取表格 block_id，再遍历表格内部 cell blocks 进行读写。

消息操作 发送文本消息给用户

需要目标用户的 open_id（可用 搜索_user.py 查询）。

python scripts/feishu_msg.py 发送-user "消息内容"

发送文本消息到群

需要目标群的 chat_id（可用 搜索_chat.py 查询）。

python scripts/feishu_msg.py 发送-chat "消息内容"

查询群聊消息 python scripts/feishu_msg.py 获取-messages [page_size]

返回群内消息列表，自动正确显示中文内容。

发送文件到群

需要先安装 SDK：

pip 安装 lark-oAPI

发送本地文件到群：

python scripts/feishu_msg.py 发送-file <本地文件路径>

例如发送到龙虾测试群：

python scripts/feishu_msg.py 发送-file oc_2c6df8f6e06e88d34729baacc124b89e "C:\\Users\\10430\\桌面\\采购数据.xlsx"

查询用户 open_id python scripts/feishu_msg.py 搜索-user <姓名关键词>

查询群聊 chat_id python scripts/feishu_msg.py 搜索-chat <群名关键词>

常用工作流

创建文档并写入内容：

创建 获取 doc_令牌 write 或 应用end-block 写入内容 read 确认内容

更新表格中第R行第C列：

read 获取文档 block 树 找到目标表格的 block_id 遍历表格 rows/cells，用 更新-block 更新目标单元格

发消息给同事：

搜索-user 查找 open_id 发送-user 发送消息 脚本索引 脚本 功能 scripts/feishu_doc.py 文档 CRUD + block 精细操作 scripts/feishu_msg.py 消息发送 + 用户/群查询 + 获取消息 + 文件发送（需 lark-oAPI SDK） scripts/config.json 凭证配置 references/API_ref.md 完整 API 参数说明