飞书文档重建
将以下提示词粘贴到你的 AI 对话框中:
请根据 https://skillhub.cn/install/skillhub.md,安装 @user_f5b897d0/feishu-doc-rebuild。
技能介绍
要解决什么问题
飞书/Lark 里经常会遇到只读、禁止复制的共享文档:你能看全文,却不能把内容迁到自己的 wiki 里二次编辑,也不能批量改品牌名、项目代号或文档间链接。直接截图或手工重打既丢结构,也修不好内链。
这个技能走的是在已登录租户内用 API 重建,而不是试图绕过页面的只读限制去「复制粘贴」。
技能如何工作
整体是「抓取 → 重建 → 核对 →(可选)清理」的流水线:
- 环境:Chrome 用远程调试端口启动,且已登录目标租户,浏览器里至少有一个该租户页面打开。
- 配置:用 JSON 写明
docs(name+source_token)、replacements文案替换表、link_remap(旧 token → 新文档名)、output_dir。 - 抓取:
scripts/capture_source_docs.py --config拉取各源文档的 block 数据,并把图片落到本地。 - 重建:
scripts/rebuild_feishu_docs.py --config在 wiki/云文档里新建可编辑文档,按 block 插入内容、重新上传图片、执行文案替换、按映射重写文档内链接。 - 验证:对照
build/rebuild_results.json与build/verify_*.png,确认能打开、图片齐全、旧文案已替换。
实现上几个硬约束值得记住:请求都通过页面内 fetch 发出,带 _csrf_token 与 credentials: 'include';图片不能复用旧 token,必须下载后再上传;变更按约 300 个 block / 20 个图片 token 分批提交,每批后重读 root version 与 child count;用 rebuild_results.json 做断点续传,失败批次记入 failed_batch.json。遇到 HTTP 429 要指数退避,别连续轰接口。
适用边界与注意点
- 产出必须是飞书 wiki/云文档,不是 Word/DOCX;版式尽量对齐源文档,但视频、部分表格等可能只能占位,需在向用户汇报时单独说明。
- 删除旧 wiki 节点要用
scripts/cleanup_wiki.py:先拉实时树、用显式 keep-list 算删除集,默认 dry-run,只有用户明确同意且加--apply才真正删。 - 细节 payload、批量策略与踩坑见技能自带的
references/feishu-api.md、references/workflow.md。
使用场景
- 品牌或项目更名时,要把多份只读飞书文档迁到自有 wiki 并批量替换「金旋学科」等旧称谓
- 收到客户/合作方只读链接,需在己方租户内生成可编辑副本并保留标题层级与图片
- 文档套装内部互相引用,需按 link_remap 把旧 document token 链到新 wiki 文档名
- 抓取与重建中断后,要依据 rebuild_results.json 从失败批次继续补全 block 与图片
适合人员
- 负责知识库整理的运营:要把不可复制的培训/规范文档落到团队 wiki 并统一术语
- 飞书空间管理员:租户内大量只读外链资料需本地化、可编辑且可审计重建结果
- 交付/售前工程师:向客户交付文档包时需改文案与内链,不能依赖页面复制
- 写自动化脚本的工程同学:已用 Chrome 远程调试登录飞书,愿意用配置 JSON 驱动批量 capture/rebuild