使用指南 · Getting Started

10 分钟,把你的飞书文档
安全送入公众号草稿箱。

本指南包含:浏览器扩展安装、飞书自建应用创建、飞书文档授权协作、微信公众号凭证获取及白名单配置。 本地离线存证,保障隐私不泄露。

第一步:安装浏览器扩展

飞书发布助手是一个 Chrome 浏览器扩展程序。目前由于还未上架官方 Web Store(上架中),需先采用开发者模式进行本地离线安装:

离线扩展程序压缩包

获取最新版本的 Zip 压缩文件,并解压至本地。

下载 Chrome 浏览器插件
  1. 01点击上方按钮下载最新版 zip 安装包。
  2. 02解压到一个你 绝对不会误删 的安全文件夹下(解压后请勿再次移动该文件夹路径)。
  3. 03在 Chrome 地址栏访问:chrome://extensions,并开启右上角的「开发者模式」。
  4. 04点击左上角「加载已解压的扩展程序」按钮,选择刚才解压得到的文件夹加载。
  5. 05加载后,点击浏览器右上角的“拼图”图标,将 飞书发布助手 固定到工具栏。

第二步:创建飞书自建应用

为了使浏览器扩展能够安全地读取当前飞书文档的内容,你需要创建你个人的飞书企业自建应用,并获取专属的 App IDApp Secret

  1. 01打开 飞书开放平台开发者后台,点击“创建企业自建应用”。如果看到的是个人应用,建议去 飞书管理后台 创建一个企业,然后再去创建企业自建应用。步骤1:打开开发者后台
  2. 02填写应用名称和基础信息,完成自建应用的创建。步骤2:创建企业自建应用
  3. 03创建完成后,在“凭证与基础信息”页面复制你的 App IDApp Secret 并存入浏览器扩展的设置面板中。步骤3:获取 App ID & App Secret
  4. 04进入左侧的“权限管理”,依次搜索并勾选开启以下 4 项文档读取权限:
    • 查看新版文档: docx:document:readonly。读取文档正文内容与结构。
    • 查看知识空间节点信息: wiki:node:read。解析 Wiki 链接。
    • 查看、评论和导出电子表格: sheets:spreadsheet:readonly。解析嵌入表格。
    • 下载云文档中的图片和附件: docs:document.media:download。下载图片素材。
    步骤4:开启文档查看权限
  5. 05进入左侧的“版本管理与发布”页面,点击“创建版本”,填写版本号与更新说明,保存后点击“申请发布”。步骤5:创建版本与发布步骤6:申请发布应用并等待审核
重要提示:在权限管理中勾选权限后,必须通过「版本管理与发布」成功发布应用新版本。如果只是勾选而不发布版本,配置的权限是无法在 API 调用中生效的。

第三步:授权飞书文档协作者

飞书的云文档具有严格的权限隔离。即使自建应用开启了读取权限,如果被抓取的文档是非公开的,你仍需要在文档端将该应用添加为只读协作者:

  1. 01打开你要同步的飞书文档(或它所属的 Wiki 知识空间/文件夹),点击右上角的 「分享」或「权限」 按钮。步骤7:点击文档分享
  2. 02在协作者输入框中输入你创建的 自建应用名称(如:“飞书发布助手”)。步骤8:搜索并邀请自建应用
  3. 03选中该应用,赋予其 「阅读」权限,点击确认即可完成授权。步骤9:添加应用为只读协作者

第四步:获取微信公众号凭证

微信公众号提供官方的草稿创建 API,需要填入 AppIDAppSecret

  1. 01直接登录微信开发者一站式工作台:developers.weixin.qq.com/platform步骤10:微信开发者一站式工作台首页
  2. 02在左侧菜单进入「我的业务与服务 → 我的业务」,选中你的公众号。步骤11:我的业务-公众号
  3. 03在公众号的详情页中,直接在同一页复制你的 AppIDAppSecret。如果密钥被隐藏,需点击「重置」以重新生成。步骤12:复制 AppID/AppSecret
  4. 04将复制到的凭证存入飞书助手侧边栏的微信设置框中。

第五步:微信 IP 白名单与 API 代理

微信为了防范安全隐患,会强制校验 API 请求出口的 IP。必须在微信开发者平台将请求 IP 录入白名单中

方案 A · 录入公网出口 IP

  1. 01在浏览器打开 ip.sb,记下当前网络显示的公网 IP。
  2. 02进入微信开发者平台 → 公众号详情 → 开发管理 → IP 白名单,添加该 IP 并保存。
如果你的家庭宽带 IP 经常发生变动,可能每次变动都需要登录微信重填,较为繁琐。

方案 B (推荐) · 部署免费 API 代理中转

你可以利用 Cloudflare Workers 极速部署一个中转代理服务。该 Worker 拥有较为固定的 IP 出口。

  1. 01参考 微信 API 代理部署指南 将开源的代理脚本部署至你个人的 Cloudflare Worker 账户。
  2. 02将该 Worker 服务的出口 IP 录入公众号后台的 IP 白名单中。
  3. 03在助手扩展设置中开启「启用 API 代理」并填入你的 Worker 访问 URL(例如:https://my-proxy.workers.dev)。

第六步:开始同步与排版

  1. 01在常用浏览器中,打开你要发布的飞书文档网页。
  2. 02点击右上角固定的 飞书发布助手 图标,展开侧边栏。
  3. 03侧边栏会自动载入当前文档地址。选择你喜爱的微信排版配色主题,并设定文章封面(支持手动上传、或直接从公众号素材库选择)。
  4. 04点击 「保存至公众号草稿箱」。稍等 5~10 秒,待任务完成显示「成功」。
  5. 05点击任务旁边的“去草稿箱”跳转,直接在微信公众号后台完成最终发布!

飞书发布助手微信公众号同步工具完全免费。如在使用中遇到任何排版变形、或者飞书自建应用接口权限问题,欢迎在微信中联系作者进行提报与交流,感谢支持!