釘釘文件寫入
釘釘文件寫入能力用於把產品內容、AI 生成結果或業務數據同步到釘釘知識庫文件中。它適合自動生成會議紀要、專案週報、客戶記錄、知識庫文章和流程歸檔。適合什麼場景
- 將產品中的記錄自動生成釘釘知識庫文件。
- 把 AI 生成的總結、方案或報告寫入釘釘文件。
- 根據業務狀態更新已有文件內容。
- 在團隊協作流程中，把重要資料沉澱到釘釘知識庫。
接入前需要準備
建立知識庫下的空白文件、更新文件內容、讀取知識庫列表屬於不同場景，所需權限和授權方式可能不同。啟用時請把目標流程描述清楚。
釘釘後台需要開通的權限
打開 釘釘開放平台 →「企業內部開發」→ 進入你的應用 →「權限管理」，按實際場景開通知識庫和文件權限。 釘釘文件寫入通常同時用到企業級 access_token 和用戶級 access_token。簡單判斷：接口路徑裡有/me/ 的，一般需要用戶授權；沒有 /me/ 的，通常使用企業應用憑證。
建議開通範圍
如果只是把內容寫入某個已有知識庫，通常先開通「已有知識庫下建立並寫入文件」這一組即可。目標知識庫還需要給執行寫入的釘釘用戶查看或編輯權限。
最小必需權限
釘釘「覆寫文件內容」屬於個人授權接口，後台可能不是以固定權限 code 的形式展示。配置時請在釘釘開放平台的文件應用權限中搜尋「文件寫入 / 覆寫文件 / 更新文件內容」等權限項，並確保執行寫入的釘釘用戶完成授權。
可選權限
如何在 superun 中啟用
1
點擊「釘釘文件寫入」
在「研發」→「技能庫」中打開「釘釘文件寫入」，點擊使用，並說明你希望產品在哪些流程中建立或更新文件。
2
按引導完成基礎配置
如果專案還沒有配置釘釘基礎插件，對話框會引導你填寫 Client ID、Client Secret 等應用憑證；如果已經配置過，會直接複用已有配置。
3
開通知識庫和文件權限
按照 superun 給出的權限清單，在 釘釘開放平台 開通知識庫讀寫、知識庫文件寫入等權限，並發佈應用。
4
確認知識庫和授權人
提供目標知識庫、文件歸檔位置和執行寫入操作的釘釘用戶授權方式。
5
測試建立和更新
完成權限配置後，先測試建立一篇文件，再測試後續內容更新。
常見限制
- 沒有知識庫讀寫權限時，可能無法列出目標知識庫或建立文件。
- 文件內容更新通常依賴用戶授權，不只是企業應用憑證。
- 如果目標知識庫或文件權限變更，需要重新檢查釘釘開放平台權限和可見範圍。
- 建立接口只負責建立空白文件，正文內容需要再走文件內容寫入或覆寫流程。