在大多數 Dify 插件開發中，我們習慣于讓插件返回結構化文本、字典或 JSON 數據。但隨著應用場景拓展，例如翻譯文件、生成報表、處理數據分析結果等，我們需要讓插件支持“直接返回文件對象”給用戶，而不是讓用戶復制粘貼文本再手動保存。

本文將基于實戰經驗，詳細介紹如何在 Dify 插件中通過 blob 模式返回文件對象（如 .txt、.xlsx 文件），并結合代碼示例給出落地方式。

---

一、為什么要返回文件對象？

Dify 默認返回文本、結構化數據，但文件對象輸出具有更廣泛的應用場景：

場景	說明
文件翻譯	輸入一個 PDF/Word/Excel，插件直接返回翻譯后的同格式文件
報表輸出	生成匯總數據并導出為 Excel 下載
合約處理	提取信息后將結構化內容回寫為 Word 并下載