使用指南 · Getting Started
10 分钟,把你的飞书文档
安全送入公众号草稿箱。
本指南包含:浏览器扩展安装、飞书自建应用创建、飞书文档授权协作、微信公众号凭证获取及白名单配置。 本地离线存证,保障隐私不泄露。
第一步:安装浏览器扩展
飞书发布助手是一个 Chrome 浏览器扩展程序。目前由于还未上架官方 Web Store(上架中),需先采用开发者模式进行本地离线安装:
离线扩展程序压缩包
获取最新版本的 Zip 压缩文件,并解压至本地。
- 01点击上方按钮下载最新版 zip 安装包。
- 02解压到一个你 绝对不会误删 的安全文件夹下(解压后请勿再次移动该文件夹路径)。
- 03在 Chrome 地址栏访问:
chrome://extensions,并开启右上角的「开发者模式」。 - 04点击左上角「加载已解压的扩展程序」按钮,选择刚才解压得到的文件夹加载。
- 05加载后,点击浏览器右上角的“拼图”图标,将 飞书发布助手 固定到工具栏。
第二步:创建飞书自建应用
为了使浏览器扩展能够安全地读取当前飞书文档的内容,你需要创建你个人的飞书企业自建应用,并获取专属的 App ID 和 App Secret:
- 01打开 飞书开放平台开发者后台,点击“创建企业自建应用”。如果看到的是个人应用,建议去 飞书管理后台 创建一个企业,然后再去创建企业自建应用。

- 02填写应用名称和基础信息,完成自建应用的创建。

- 03创建完成后,在“凭证与基础信息”页面复制你的
App ID和App Secret并存入浏览器扩展的设置面板中。
- 04进入左侧的“权限管理”,依次搜索并勾选开启以下 4 项文档读取权限:
- 查看新版文档:
docx:document:readonly。读取文档正文内容与结构。 - 查看知识空间节点信息:
wiki:node:read。解析 Wiki 链接。 - 查看、评论和导出电子表格:
sheets:spreadsheet:readonly。解析嵌入表格。 - 下载云文档中的图片和附件:
docs:document.media:download。下载图片素材。

- 查看新版文档:
- 05进入左侧的“版本管理与发布”页面,点击“创建版本”,填写版本号与更新说明,保存后点击“申请发布”。


重要提示:在权限管理中勾选权限后,必须通过「版本管理与发布」成功发布应用新版本。如果只是勾选而不发布版本,配置的权限是无法在 API 调用中生效的。
第三步:授权飞书文档协作者
飞书的云文档具有严格的权限隔离。即使自建应用开启了读取权限,如果被抓取的文档是非公开的,你仍需要在文档端将该应用添加为只读协作者:
- 01打开你要同步的飞书文档(或它所属的 Wiki 知识空间/文件夹),点击右上角的 「分享」或「权限」 按钮。

- 02在协作者输入框中输入你创建的 自建应用名称(如:“飞书发布助手”)。

- 03选中该应用,赋予其 「阅读」权限,点击确认即可完成授权。

第四步:获取微信公众号凭证
微信公众号提供官方的草稿创建 API,需要填入 AppID 和 AppSecret。
- 01直接登录微信开发者一站式工作台:developers.weixin.qq.com/platform。

- 02在左侧菜单进入「我的业务与服务 → 我的业务」,选中你的公众号。

- 03在公众号的详情页中,直接在同一页复制你的
AppID和AppSecret。如果密钥被隐藏,需点击「重置」以重新生成。
- 04将复制到的凭证存入飞书助手侧边栏的微信设置框中。
第五步:微信 IP 白名单与 API 代理
微信为了防范安全隐患,会强制校验 API 请求出口的 IP。必须在微信开发者平台将请求 IP 录入白名单中。
方案 A · 录入公网出口 IP
- 01在浏览器打开 ip.sb,记下当前网络显示的公网 IP。
- 02进入微信开发者平台 → 公众号详情 → 开发管理 → IP 白名单,添加该 IP 并保存。
如果你的家庭宽带 IP 经常发生变动,可能每次变动都需要登录微信重填,较为繁琐。
方案 B (推荐) · 部署免费 API 代理中转
你可以利用 Cloudflare Workers 极速部署一个中转代理服务。该 Worker 拥有较为固定的 IP 出口。
- 01参考 微信 API 代理部署指南 将开源的代理脚本部署至你个人的 Cloudflare Worker 账户。
- 02将该 Worker 服务的出口 IP 录入公众号后台的 IP 白名单中。
- 03在助手扩展设置中开启「启用 API 代理」并填入你的 Worker 访问 URL(例如:
https://my-proxy.workers.dev)。
第六步:开始同步与排版
- 01在常用浏览器中,打开你要发布的飞书文档网页。
- 02点击右上角固定的 飞书发布助手 图标,展开侧边栏。
- 03侧边栏会自动载入当前文档地址。选择你喜爱的微信排版配色主题,并设定文章封面(支持手动上传、或直接从公众号素材库选择)。
- 04点击 「保存至公众号草稿箱」。稍等 5~10 秒,待任务完成显示「成功」。
- 05点击任务旁边的“去草稿箱”跳转,直接在微信公众号后台完成最终发布!