安装与上手

飞书工具箱怎么安装:Chrome / Edge 商店与离线安装指南

通过 Chrome 应用商店或 Edge 加载项安装飞书工具箱;商店无法访问时,也可手动安装离线包,并排查常见安装问题。

6 分钟6 min read 发布于 2026/10/6Published 2026/10/6 更新于 2026/10/19Updated 2026/10/19
本页结构 On This Page
直接回答Short Answer

优先通过 Chrome 应用商店或 Edge 加载项一键安装并自动更新。商店无法访问时,先在 Chrome 或 Edge 的扩展管理页打开开发者模式,再选择包含 manifest.json 的完整解压目录加载;安装失败多半是选错目录、扩展被停用,或把飞书桌面客户端当成了网页版。

公司电脑上更常见的情况是商店入口暂时不可用,插件文件其实已经下载到了本机。Chrome、Edge 和大多数 Chromium 浏览器仍然允许加载解压后的扩展目录。

飞书工具箱已上架 Chrome 应用商店和 Edge 加载项,优先选择商店版,安装后可自动更新。商店无法访问时,可按下文手动安装离线包。

通过商店安装(推荐)

  1. 打开 Chrome 应用商店 或 Edge 加载项。
  2. 点击“添加至 Chrome”或“获取”,确认添加扩展。
  3. 将飞书工具箱固定到工具栏,打开普通网页即可使用。

商店无法访问时,可从 安装页 下载官网离线包。

先确认你拿到的是完整离线包

下载后的压缩包需要先解压。不要直接在压缩包里点文件,也不要只把 manifest.json 单独拖出来。

解压完成后,文件夹里至少应该能看到:

  • manifest.json
  • 扩展运行需要的前端文件和脚本
  • 一个固定的版本目录,例如 feishu-toolkit-v1.8.7

建议把文件夹放到一个长期不会自动清理的位置。放在“下载”目录也可以,但系统清理下载文件后,扩展会一起消失。

Chrome 手动安装

  1. 在地址栏打开 chrome://extensions/。
  2. 打开页面右上角的“开发者模式”。
  3. 点击“加载已解压的扩展程序”。
  4. 选择包含 manifest.json 的那一层文件夹。
  5. 安装完成后,把扩展固定到工具栏。

安装成功后,浏览器的扩展列表里会出现“飞书工具箱”。如果按钮菜单里有一堆未命名扩展,可以先在扩展管理页给需要的那个固定名称。

Edge 手动安装

Edge 的步骤基本相同,把地址换成 edge://extensions/ 即可。Edge 会显示自己的开发者模式提示,这不代表扩展有问题。

安装后建议先打开任意普通网页试一次“复制整页为 Markdown”。它能工作,说明扩展已经加载成功,不必先登录飞书。

常见报错与处理

提示找不到 manifest.json

你选到了上一级文件夹。重新点击“加载已解压的扩展程序”,进入解压目录,选择那个直接包含 manifest.json 的文件夹。

点了图标没反应

先确认当前页面是浏览器里的飞书网页版,而不是飞书桌面客户端。扩展只能读取浏览器标签页,不能注入桌面客户端。

如果在普通网页里也没反应,到扩展管理页查看是否被停用,再点一次“重新加载”。

提示扩展已损坏或版本不兼容

删除旧版本后,用完整的新压缩包重新解压和加载。不要在新版本目录上直接覆盖旧文件,尤其不要把不同版本的脚本混在一起。

为什么每次启动都提示开发者模式

这是浏览器对手动安装扩展的统一提醒。商店版不会出现这条提示。如不希望看到这条提示,可改用商店版。

怎么更新

手动安装的扩展不会自动更新。更新时:

  1. 下载新的完整压缩包并解压到新目录。
  2. 在扩展管理页移除旧版本。
  3. 重新加载新目录。
  4. 打开扩展首页确认版本号已经变化。

升级前可以先记录当前配置。已经完成的导出文件不受扩展更新影响。

安装完成后先做一次小测试

找一篇不含敏感信息的文档,导出 Markdown,把文件和图片一起换一个文件夹,再断网打开。标题、表格、代码块和图片都正常,才说明安装、导出、保存三条链路都通了。

这篇测试文档通过后,再处理真实资料。

哪些情况不建议手动安装

如果企业电脑完全禁止开发者模式,或者浏览器策略只允许商店扩展,手动安装可能无法完成。这种情况下不要为了绕开策略去修改公司设备设置,优先使用商店版或联系管理员评估。

扩展的安装方式不会改变文档处理位置。安装完成后,转换和打包仍在浏览器本地进行。