STEP1: 更新前務必取得備份 #

將目前已修改為可運作狀態的 openai.php 儲存為檔案。例如：以 openai.php-dify 等名稱複製至本機。

建議對整個 WordPress 或外掛程式資料夾進行完整備份,以便在發生問題時可以還原。

STEP2: 更新 AI Engine #

從 WordPress 管理畫面的「外掛程式」更新 AI Engine (Meow Apps),或透過 SFTP/SSH 等方式覆寫新版本。

更新後請確認外掛程式已啟用。

STEP3: 由於 openai.php 會被初始化,需重新套用 #

• • 方法A: 手動反映差異

參考修改前(已確認運作)的 openai.php-dify,在新的 openai.php 的對應位置(build_url()、build_headers() 等)進行新增・覆寫修正。

由於 AI Engine 的更新可能新增了變更,請注意不要完全替換。僅手動重現差異部分。

• • 方法B: 使用補丁檔案或 Git

事先使用 diff / git 建立修改內容的補丁。

更新後以 patch < openai.patch 的方式套用,重新進行相同變更。這是半自動化最可靠的方法。

• • 更新後的 openai.php
    • 檔案路徑:
      wp-content/plugins/ai-engine/classes/engines/openai.php

更新後,此檔案應該已被替換為最新狀態。

STEP4: 確認 Dify 用的修正是否已重新套用 #

確認原始碼中修改部分(例: build_url() 的 endpoint = ‘https://您的DIFY位址/e/xxxxxx’ 等)是否正確保留。

• 測試:
  1. 啟用 WordPress 的除錯模式,實際傳送聊天訊息並確認 debug.log。
  2. 若對 Dify 的請求目標為 https://您的DIFY位址/e/xxxx/chat/completions 即為成功。

必要時重新調整 model 設定或 Bearer Key 設定(管理畫面的 API Key 或篩選器)。

STEP5: 如有問題請重新檢查版本差異 #

若 AI Engine 的更新改變了內部規格,可能需要微調修改位置。

• 確認官方的更新紀錄 (changelog) 或檔案差異。特別是 openai.php 有重大變更時,差異可能產生衝突。
• 若無法順利運作,請嘗試還原先前的備份來釐清原因。

總結 #

• 備份 (更新前儲存已修改的 openai.php)
• 更新 AI Engine (外掛程式管理畫面等)
• 重新套用
  • 手動插入 openai.php 的差異
  • 或使用補丁檔案・Git 自動套用
• 運作確認 (確認請求是否傳送至 Dify 用端點)