先在 Chrome 或 Edge 的扩展管理页打开开发者模式，再选择包含 manifest.json 的完整解压目录加载；安装失败多半是选错目录、扩展被停用，或把飞书桌面客户端当成了网页版。
公司电脑上更常见的情况是商店入口暂时不可用，插件文件其实已经下载到了本机。Chrome、Edge 和大多数 Chromium 浏览器仍然允许加载解压后的扩展目录。
下面的步骤按当前可用版本写。商店上架后可以一键安装，但离线安装、版本替换和“点了没反应”的排查方法不会失效。
先确认你拿到的是完整离线包
下载后的压缩包需要先解压。不要直接在压缩包里点文件，也不要只把 manifest.json 单独拖出来。
解压完成后，文件夹里至少应该能看到：
manifest.json- 扩展运行需要的前端文件和脚本
- 一个固定的版本目录，例如
feishu-toolkit-v1.8.5
建议把文件夹放到一个长期不会自动清理的位置。放在“下载”目录也可以，但系统清理下载文件后，扩展会一起消失。
Chrome 手动安装
- 在地址栏打开
chrome://extensions/。 - 打开页面右上角的“开发者模式”。
- 点击“加载已解压的扩展程序”。
- 选择包含
manifest.json的那一层文件夹。 - 安装完成后，把扩展固定到工具栏。
安装成功后，浏览器的扩展列表里会出现“飞书工具箱”。如果按钮菜单里有一堆未命名扩展，可以先在扩展管理页给需要的那个固定名称。
Edge 手动安装
Edge 的步骤基本相同，把地址换成 edge://extensions/ 即可。Edge 会显示自己的开发者模式提示，这不代表扩展有问题。
安装后建议先打开任意普通网页试一次“复制整页为 Markdown”。它能工作，说明扩展已经加载成功，不必先登录飞书。
常见报错与处理
提示找不到 manifest.json
你选到了上一级文件夹。重新点击“加载已解压的扩展程序”，进入解压目录，选择那个直接包含 manifest.json 的文件夹。
点了图标没反应
先确认当前页面是浏览器里的飞书网页版，而不是飞书桌面客户端。扩展只能读取浏览器标签页，不能注入桌面客户端。
如果在普通网页里也没反应，到扩展管理页查看是否被停用，再点一次“重新加载”。
提示扩展已损坏或版本不兼容
删除旧版本后，用完整的新压缩包重新解压和加载。不要在新版本目录上直接覆盖旧文件，尤其不要把不同版本的脚本混在一起。
为什么每次启动都提示开发者模式
这是浏览器对手动安装扩展的统一提醒。商店版不会出现这条提示。当前如果想使用测试版，只能接受这条提示，或者等商店版上线。
怎么更新
手动安装的扩展不会自动更新。更新时：
- 下载新的完整压缩包并解压到新目录。
- 在扩展管理页移除旧版本。
- 重新加载新目录。
- 打开扩展首页确认版本号已经变化。
升级前可以先记录当前配置。已经完成的导出文件不受扩展更新影响。
安装完成后先做一次小测试
找一篇不含敏感信息的文档，导出 Markdown，把文件和图片一起换一个文件夹，再断网打开。标题、表格、代码块和图片都正常，才说明安装、导出、保存三条链路都通了。
这篇测试文档通过后，再处理真实资料。
哪些情况不建议手动安装
如果企业电脑完全禁止开发者模式，或者浏览器策略只允许商店扩展，手动安装可能无法完成。这种情况下不要为了绕开策略去修改公司设备设置，优先等商店版或联系管理员评估。
扩展的安装方式不会改变文档处理位置。安装完成后，转换和打包仍在浏览器本地进行。