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

整體架構(gòu)

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

核心流程

整個(gè)上傳過(guò)程分為四個(gè)步驟：

步驟 1：初始化

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

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

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

步驟 3：文件上傳

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

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

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

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

FeishuUploader 類(lèi)

這個(gè)類(lèi)封裝了所有與飛書(shū) API 的交互邏輯。

獲取訪問(wèn)憑證

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)
    # 成功時(shí)返回 tenant_access_token

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

文件上傳

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)

邏輯說(shuō)明：

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

上傳觸發(fā)點(diǎn)

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

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

飛書(shū)平臺(tái)配置詳解

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

前置條件

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

配置流程概覽

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

進(jìn)入開(kāi)發(fā)者后臺(tái)

• 打開(kāi) 飛書(shū)開(kāi)放平臺(tái)
• 使用飛書(shū)賬號(hào)登錄
• 點(diǎn)擊「創(chuàng)建企業(yè)自建應(yīng)用」

填寫(xiě)應(yīng)用信息

填寫(xiě)完成后點(diǎn)擊「創(chuàng)建」。

記錄應(yīng)用憑證

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

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

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

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

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

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

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

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

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

創(chuàng)建版本

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

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

填寫(xiě)版本信息：

點(diǎn)擊「保存」

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

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

啟用機(jī)器人能力

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

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

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

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

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

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

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

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

獲取文件夾 Token

1.在飛書(shū)云盤(pán)中打開(kāi)目標(biāo)文件夾

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

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

folder_token = fldcnXXXXXXXXXXXX

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

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

# 飛書(shū)配置
APP_ID=cli_xxxxxxxxxxxxx
APP_SECRET=xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx
FEISHU_FOLDER_TOKEN=fldcnXXXXXXXXXXXX

常見(jiàn)問(wèn)題排查

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

最新評(píng)論