夜雨聆风
配置完这个,飞书文档可以直接丢给Claude对话
SKILL 002 · FEISHU-DOCX
配置完这个，飞书文档可以直接丢给 Claude 对话
「一天一个 Claude Skill」系列 · 第 2 期
我在飞书知识库里存了大半年的内容——会议记录、产品文档、培训手册，几十篇。
每次要用，要么手动复制粘贴，要么截图让 Claude 看。
配了这个 Skill 之后，流程变了：
把飞书链接丢给 Claude，说「帮我总结这个文档的关键信息」
// 它直接读，直接回答。
feishu-docx 是一个 pip 包，两步配置，一次授权。支持 docx / wiki / bitable，文字内容全部能读到。
Setup Protocol
配置全流程 · 20 分钟
安装 + 填入凭据
pip install feishu-docx
feishu-docx config set \
--app-id 你的AppID \
--app-secret 你的AppSecret
AppID 和 AppSecret 去飞书开放平台创建自建应用，免费，2 分钟搞定。
⚡ 权限要一次全开，少了会报错
文档类：docx:document docx:document:readonly drive:drive
知识库：wiki:wiki wiki:wiki:readonly wiki:node:read
开完权限记得点 发布版本，不发布不生效。
OAuth 授权
// 只做一次
feishu-docx auth
输出授权链接 → 浏览器打开 → 登录飞书 → 点允许 → 跳转 127.0.0.1:9527 即完成。
⏱ 60 秒超时。命令跑起来立刻去浏览器，别等。
直接用
# 输出到终端，直接丢给 Claude（推荐）
feishu-docx export "飞书链接" --stdout
# 保存为 Markdown 文件
feishu-docx export "飞书链接" -o ./output
Use Cases
我每周在用的 3 个场景
会议记录 → 待办清单
开完会，把链接直接发给 Claude：
帮我读这个飞书文档，提取所有 action item，
按负责人分类，每条标注截止日期（如果有提到的话）
https://xxx.feishu.cn/docx/xxx
原来要自己翻记录整理，现在 30 秒出结果。
产品文档 → 200 字汇报摘要
帮我把这个需求文档总结成 200 字以内，
用”背景 + 核心方案 + 预期效果”的结构，
给领导汇报用，不要技术细节
https://xxx.feishu.cn/wiki/xxx
跨文档找矛盾
帮我对比这两个飞书文档，
找出描述不一致或矛盾的地方，列出来
文档1：https://xxx.feishu.cn/wiki/xxx
文档2：https://xxx.feishu.cn/wiki/yyy
// Error Log
踩坑记录
权限要一次全开
只开 docx 权限读 wiki 直接报错 99991672，然后要重新开权限、重新发布、重新授权。直接全开省事。
auth 有 60 秒超时
弹出链接后去倒杯水，回来大概率超时了。超时了重新运行命令，生成新链接。
图片内容读不到
图片只能得到占位符，文字是完整的。文档主要是截图的话帮助有限。
2h
access_token
到期自动续期
30d
refresh_token
才需要重新授权
TOOL · 安装命令一键复制
feishu-docx 三端安装命令
Windows / Mac / Linux 的安装命令，在小程序里搜索 feishu-docx 直接复制，不用手敲。
微信搜索小程序
skill技能助手
你飞书里存了什么？
欢迎评论区聊聊
你配完之后最想处理哪类文档
