飞书案例库本地接入流水线
将以下提示词粘贴到你的 AI 对话框中:
请根据 https://skillhub.cn/install/skillhub.md,安装 @user_814dbe54/feishu-case-library。
技能介绍
要解决的问题
团队在飞书多维表格(Base)和 Wiki 里维护案例库、素材清单时,前端站点往往需要同一份结构化数据和可落地的视频文件,而不是手工导出 Excel 或反复在飞书里点下载。直接调用飞书开放接口或 lark-cli 时,还容易踩代理、Git Bash 路径、--output 相对路径,以及附件下载 403 等坑——这些在 SKILL 里是按实战结论写死的。
技能如何工作
本技能描述一条从链接解析到本地可用的可执行流水线:用 lark-cli 分页读取 Base(--limit/--offset 对齐 record_id_list 与附件 {file_token,name,size}),用 docs 拉全量 Wiki 并按 ## 切条;再生成三个根目录 JS 常量——feishu_cases_data.js(品类聚合列表)、feishu_wiki_cases.js(Wiki 全文不截断)、feishu_videos_full.js(含 record_id 与 file_token 的完整清单)。
在现有 server.js 上扩展 POST /api/feishu-download,按品类批量走 drive +preview --type source_file(或 mp4_480p)流式回传 NDJSON 进度;GET /api/local-videos 扫描本地 videos/。前端模式包括品类 Tab、确认下载条数/清晰度、本地视频区与播放器;姊妹项目只需复制三份数据 JS 并引入。
适用边界与注意点
授权走 device-flow(二维码 + device_code),执行前要 unset 代理;lark-cli 需用完整 node.exe 路径调 run.js。原始附件三通道常 403,应走 preview 通道而非改 OAuth scope。静态服务中文路径需 decodeURIComponent,生成 JS 后建议用 new Function() 校验语法;批量下载建议设 MAX_DL_LIMIT 并由用户确认条数。
使用场景
- 本地案例展示站要从指定飞书 Base 分页拉全记录,并按品类生成列表页用的聚合 JSON/JS
- Wiki 里按二级标题拆开的提示词案例要整段入库,供站内搜索或弹窗阅读,而不是 WebFetch 只抓到前几段
- 运营确认品类与条数后,需通过后端批量把 Base 附件落成 `videos/` 下 mp4,并实时展示下载进度
- 已有 Node 静态站只想加「飞书案例」入口,复制三份数据文件与下载 API 即可复用同一套交互
适合人员
- 维护「提示词宇宙」类站点的全栈,要把 500+ 条飞书视频案例与 Wiki 条目标进自有域名项目
- 负责飞书 Base/Wiki 内容治理的运营开发,要让自己建的表和文档直接驱动官网列表与下载,而不是二次录入
- 在 Windows + Git Bash 环境接飞书 OpenAPI,已被 lark-cli 路径与代理 10809 报错卡住需要按步骤排坑的工程师
- 要做内网案例库演示、需原分辨率素材又遇到 drive 下载 403,需改走 preview 通道的实现者