图片与文件附件

文档内的所有图片、文件附件均会在导出的时候，以本地文件的方式导出，并组织好文档内的链接关系。基本上你不用在意这个事情。

所有文档内的图片、附件都将导出文档所在目录的 assets 文件夹内，并根据文件的类型实现扩展名。

yaml

dist
├── docs
│   ├── assets
├── .cache
├── docs.json

性能优化

由于 Feishu Pages 每次导出均会从头开始导出整个飞书知识库，当知识库内容非常多的时候，可能需要等待很久。尤其是其中的图片、文件这些往往尺寸都是较大的，需要下载很久。

于是 Feishu Pages 在设计之初就对这类文件做了缓存的设计，已经导出过的文件会在 dist/.cache 目录有个缓存，如果之前已经导出过，将不会再次下载，可以有效节约时间。

方法 A

这个设计如果在 GitHub Actions 或 GitLab CI 上面用，你可能需要注意配置一下，将这个 dist/.cache 目录缓存到 CI 的 Cache 里面，这样每次执行可以重复利用之前已经导出过的文件。

例如 GitHub Actions Cache，更多详见 https://github.com/actions/cache

yaml

steps:
  - uses: actions/checkout@v3

  - uses: actions/cache@v3
    with:
      path: dist/.cache
      key: cache-dist

  - name: Feishu Pages Export
    env:
      FEISHU_APP_ID: ${{ secrets.FEISHU_APP_ID }}
      FEISHU_APP_SECRET: ${{ secrets.FEISHU_APP_SECRET }}
      FEISHU_SPACE_ID: ${{ secrets.FEISHU_SPACE_ID }}
    uses: longbridgeapp/feishu-pages@main

方法 B

你也可以更简单，每一次将导出的 dist 始终存储下来，例如把导出后的内容直接提交到 Git 仓库里面，每次重新导出，拉出上一次的，这样 dist/.cache 目录始终能重复利用。

图片与文件附件 ​

性能优化 ​

方法 A ​

方法 B ​

图片与文件附件

性能优化

方法 A

方法 B