Agent Skills
返回列表
飞书文档重建

飞书文档重建

办公效率 更新于 2026.08.29

将以下提示词粘贴到你的 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