在完成文章分析后，需要將生成的報告自動備份到飛書云盤，避免手動傳輸?shù)姆爆崱?/p>

整體架構(gòu)

上傳流程的架構(gòu)設(shè)計：

核心流程

整個上傳過程分為四個步驟：

步驟 1：初始化

• 輸入：環(huán)境變量（APP_ID、APP_SECRET、FEISHU_FOLDER_TOKEN）
• 處理：FeishuUploader.__init__() 從環(huán)境變量讀取憑證
• 輸出：配置完成的上傳器實例

步驟 2：身份認(rèn)證

• 輸入：APP_ID + APP_SECRET
• 處理：調(diào)用 POST /auth/v3/tenant_access_token/internal
• 輸出：tenant_access_token（有效期 2 小時）

步驟 3：文件上傳

• 輸入：文件路徑 + folder_token + tenant_access_token
• 處理：使用 MultipartEncoder 流式上傳到 POST /drive/v1/files/upload_all
• 輸出：成功時返回 file_token

步驟 4：結(jié)果處理

• 輸入：API 響應(yīng)
• 處理：檢查響應(yīng)碼，記錄成功/失敗日志
• 輸出：布爾結(jié)果（True/False）

關(guān)鍵代碼實現(xiàn)

FeishuUploader 類

這個類封裝了所有與飛書 API 的交互邏輯。

獲取訪問憑證

def _get_tenant_access_token(self) -> Optional[str]:
    url = f"{self.BASE_URL}/auth/v3/tenant_access_token/internal"
    payload = {"app_id": self.app_id, "app_secret": self.app_secret}
    response = requests.post(url, json=payload, timeout=10)
    # 成功時返回 tenant_access_token

邏輯說明：將 App ID 和 App Secret 發(fā)送到飛書認(rèn)證接口，從響應(yīng)中提取訪問憑證。

文件上傳

def upload_file(self, file_path: Path) -> bool:
    token = self._get_tenant_access_token()
    # 使用 MultipartEncoder 構(gòu)建表單
    form = {
        'file_name': file_name,
        'parent_type': 'explorer',
        'parent_node': self.folder_token,
        'size': str(file_size),
        'file': (file_name, f)
    }
    multi_form = MultipartEncoder(form)
    response = requests.post(url, headers=headers, data=multi_form, timeout=60)

邏輯說明：

1. 驗證文件存在且 folder_token 已配置
2. 獲取身份認(rèn)證憑證
3. 構(gòu)建包含文件元數(shù)據(jù)的表單
4. 流式上傳到飛書云盤 API

上傳觸發(fā)點

在 main.py 中，分析完成后自動觸發(fā)上傳：

if results and any(r.success for r in results):
    report_path = reporter.generate_summaries_report(results, grouped_urls)
    logger.info("匯總分析成功，正在上傳報告...")
    uploader = FeishuUploader()
    if uploader.upload_file(report_path):
        logger.info("自動上傳飛書成功。")
    else:
        logger.error("自動上傳飛書失敗。")

飛書平臺配置詳解

這是整個流程中最容易出錯的環(huán)節(jié)。很多開發(fā)者代碼寫好了，卻在權(quán)限配置上卡住。

前置條件

1. 擁有飛書賬號，且具有管理員權(quán)限（用于審批應(yīng)用）
2. 飛書云盤中已有目標(biāo)文件夾（用于存放上傳的報告）

配置流程概覽

階段一：創(chuàng)建飛書應(yīng)用

進(jìn)入開發(fā)者后臺

• 打開 飛書開放平臺
• 使用飛書賬號登錄
• 點擊「創(chuàng)建企業(yè)自建應(yīng)用」

填寫應(yīng)用信息

填寫完成后點擊「創(chuàng)建」。

記錄應(yīng)用憑證

創(chuàng)建成功后，進(jìn)入「憑證與基礎(chǔ)信息」頁面：

重要：請妥善保管這些憑證，后續(xù) API 認(rèn)證需要使用。

階段二：配置 API 權(quán)限

進(jìn)入權(quán)限管理

1. 在應(yīng)用管理頁面，進(jìn)入「開發(fā)配置」→「權(quán)限管理」
2. 點擊「開通權(quán)限」按鈕

搜索并添加所需權(quán)限

在「API 權(quán)限」標(biāo)簽頁下，搜索并添加以下權(quán)限：

推薦：使用 drive:file:upload，遵循最小權(quán)限原則。

階段三：發(fā)布應(yīng)用

創(chuàng)建版本

進(jìn)入「應(yīng)用發(fā)布」→「版本管理與發(fā)布」

點擊「創(chuàng)建版本」

填寫版本信息：

點擊「保存」

階段四：配置文件夾訪問權(quán)限

還需要配置文件夾權(quán)限，應(yīng)用才能上傳文件。

啟用機(jī)器人能力

1. 返回「開發(fā)者后臺」→ 選擇你的應(yīng)用
2. 進(jìn)入「應(yīng)用功能」→「機(jī)器人」
3. 點擊「啟用機(jī)器人」
4. 配置機(jī)器人信息（名稱、描述、頭像）
5. 發(fā)布新版本以激活機(jī)器人功能

添加應(yīng)用為文件夾協(xié)作者

有兩種方法可以授權(quán)：

方法 A：直接添加應(yīng)用到文件夾

1. 在瀏覽器或客戶端打開飛書云盤
2. 進(jìn)入目標(biāo)文件夾
3. 點擊右上角「 ... 」→「更多」→「添加文檔應(yīng)用」
4. 搜索你的應(yīng)用名稱
5. 選擇應(yīng)用，設(shè)置權(quán)限為「可編輯」
6. 點擊「確認(rèn)」

前提條件：應(yīng)用必須已開通至少一個云文檔 API 權(quán)限并已發(fā)布。

方法 B：通過群組添加應(yīng)用

1. 在飛書中創(chuàng)建一個新群組
2. 將應(yīng)用作為「機(jī)器人」添加到群組
3. 打開目標(biāo)文件夾 → 點擊「分享」
4. 邀請該群組作為協(xié)作者，權(quán)限設(shè)為「可編輯」

獲取文件夾 Token

1.在飛書云盤中打開目標(biāo)文件夾

2.從瀏覽器地址欄復(fù)制 URL：https://feishu.cn/drive/folder/fldcnXXXXXXXXXXXX

3. 提取 folder_token（/folder/ 后面的部分）：

folder_token = fldcnXXXXXXXXXXXX

階段五：配置環(huán)境變量

在項目根目錄創(chuàng)建或更新 .env 文件：

# 飛書配置
APP_ID=cli_xxxxxxxxxxxxx
APP_SECRET=xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx
FEISHU_FOLDER_TOKEN=fldcnXXXXXXXXXXXX

常見問題排查

以上就是Python實現(xiàn)文檔自動上傳至飛書云盤的詳細(xì)內(nèi)容，更多關(guān)于Python文檔上傳飛書云盤的資料請關(guān)注腳本之家其它相關(guān)文章！

最新評論