飞书文档下载工具

基于 DrissionPage 的飞书文档自动下载工具，支持通过浏览器扩展程序自动下载飞书文档。

功能特性

• 🚀 自动访问飞书文档并下载
• 🔌 支持加载浏览器扩展程序
• 📊 实时监听控制台日志和网络请求
• ⚙️ 可配置下载路径和超时时间
• 📝 详细的日志记录

依赖项

• Python >= 3.12
• DrissionPage == 4.1.0.17
• loguru >= 0.7.3

安装

1. 克隆仓库

git clone <repository_url>
cd feishu-doc-download

2. 安装依赖

uv sync

或使用 pip：

pip install drissionpage==4.1.0.17 loguru>=0.7.3

配置

编辑 config.json 文件：

{
  "extension_dir": ".extension",
  "download_timeout": 120,
  "target_url": "https://y03l2iufsbl.feishu.cn/docx/XfL4di0YNosjoGxjfMtcGKKPnkg?from=from_copylink",
  "download_path": "./downloads"
}

配置项说明：

• extension_dir: 浏览器扩展程序目录路径
• download_timeout: 等待下载按钮出现的超时时间（秒）
• target_url: 目标飞书文档 URL
• download_path: 文件下载保存路径

使用

1. 确保浏览器扩展程序已放在 .extension 目录下
2. 运行主程序：

python main.py

3. 程序将自动：
   • 启动 Chrome 浏览器
   • 加载扩展程序
   • 访问目标 URL
   • 查找并点击下载按钮
   • 将文件保存到指定目录

目录结构

.
├── main.py          # 主程序入口
├── worker.py        # 工作任务模块
├── config.json      # 配置文件
├── listener/        # 监听模块
│   ├── console.py   # 控制台监听
│   └── network.py   # 网络请求监听
├── utils/           # 工具模块
├── .log/            # 日志目录
├── .extension/      # 浏览器扩展目录
└── downloads/       # 下载文件目录

日志

程序运行时会产生以下日志文件：

• .log/runtime.log: 运行时日志
• .log/console.log: 控制台监听日志
• .log/network.log: 网络请求监听日志

注意事项

• 首次运行需要确保已安装 Chrome 浏览器
• 扩展程序目录应包含完整的扩展程序文件
• 下载路径会自动创建，如果不存在的话

License

MIT