外掛說明
AI 外掛將 AI 功能直接整合至 WordPress 管理及編輯體驗中。
需要使用 WordPress 區塊編輯器。不支援 Classic Editor 外掛及其他非區塊編輯器的編輯體驗。
內含功能:
這個外掛以 AI Building Blocks for WordPress 計畫為基礎,整合 AI Client 程式庫與 Abilities API,提供一致的使用體驗。它既是內容創作者的實用工具,也是開發者可參考的實作。
現有功能:
- 能力總管 – 可在專屬管理畫面瀏覽及操作已註冊的 AI 能力。
- AI 請求記錄 – 記錄 AI 請求,以提供可觀測性及偵錯資訊。
- 替代文字產生 – 為圖片產生具描述性的替代文字,以改善無障礙功能。
- 留言審核 – 根據毒性偵測與情緒分析自動審核留言,並為每則留言評定價值分數。
- AI Connector 核准 – 外掛或佈景主題必須先取得網站管理員明確核准,才能使用這個網站已設定的 AI Connector。
- 內容分類 – 建議相關的標籤與分類,以利整理內容。
- 內容長度調整 – 縮短、擴充或改寫選取的區塊內容。
- 內容摘要 – 將長篇內容濃縮成便於掌握的摘要。
- 內容翻譯 – 可在文章編輯器中,將段落及標題區塊翻譯為選取的語言,並可選擇是否翻譯文章標題。
- 自訂能力 – 將外掛的通用 WordPress 能力集中由單一開關控制是否啟用。
- 控制台小工具 – AI 狀態及 AI 能力小工具,並提供可註冊新小工具的架構。
- 編輯備註 – 逐一檢閱文章內容區塊,並加入備註,提供無障礙、可讀性、文法及 SEO 改善建議。
- 編輯內容更新 – 自動將編輯備註套用至內容。
- 內容摘要產生 – 自動為文章建立精簡摘要。
- 實驗架構 – 可選擇加入的機制,讓你只啟用想使用的 AI 功能。
- 準則 – 讓能力遵循全站的編輯標準。
- 圖片產生與編輯 – 可在編輯器中根據文章內容產生及編輯圖片,也可透過媒體庫操作。
- 金鑰加密 – 使用內附的 libsodium 加密功能,將靜態儲存的 AI 供應商 API 金鑰加密。讀取時會自動解密,寫入時則會重新加密。停用此實驗功能或停用外掛後,金鑰會還原為純文字。
- 中繼描述產生 – 產生中繼描述建議,並將建議整合至各種 SEO 外掛。
- 多供應商支援 – 可搭配 OpenAI、Google 與 Anthropic 等供應商的 AI Connector 外掛使用。
- 代稱產生 – 在永久連結彈出式視窗或發佈前面板中,取得適合 SEO 的文章永久連結代稱建議,再編輯並套用想使用的項目。
- 建議回覆 – 在 [留言] 畫面及 [活動] 小工具加入「建議回覆」操作,讓審核人員能快速產生留言回覆建議。
- 標題產生 – 按一下即可為文章產生標題建議。非常適合用來發想標題,或為內容找到合適的語氣。
- 自動完成 – 輸入時提供符合情境的即時建議。
供應商設定:
AI 外掛本身不含供應商憑證或供應商實作。若要使用 AI 功能,請至少安裝並啟用一個 AI Connector 外掛,再前往 Settings -> Connectors 設定其憑證。在 AI Connector 完成安裝及驗證,並能執行所需操作前,相關功能可能會顯示為無法使用。
供應商連接器外掛包括 Anthropic、Google、OpenAI 及其他外掛。
即將推出:
我們正積極開發新功能,以強化你的 WordPress 工作流程:
- AI 試驗場 – 試用不同的 AI 模型及供應商。
- 內容助理 – Gutenberg 中由 AI 輔助的寫作及編輯功能。
- 網站代理 – 使用自然語言管理 WordPress。
- 工作流程自動化 – 由 AI 驅動的工作自動化。
這是實驗性外掛;隨著我們蒐集社群意見,功能可能會有所變更。
發展藍圖:
你可以在 WordPress AI GitHub 專案看板的篩選檢視中,查看外掛目前的開發藍圖。
開發者專區
AI 外掛的設計可供研究、擴充,並在其基礎上進一步開發。無論你是外掛開發者、代理商或主機服務供應商,都可以進行以下工作:
擴充外掛:
- 建立自訂實驗功能 – 使用
Abstract_Feature基底類別,建立自己的 AI 功能。 - 預先設定供應商 – 主機服務商及代理商可設定 AI Connector 外掛,讓使用者不必自行準備 API 金鑰。
- 能力總管 – 測試及探索已註冊的 AI 能力(啟用實驗功能後可用)。
- 註冊自訂能力 – 串接 Abilities API 以加入新的 AI 功能。
- 覆寫預設行為 – 使用篩選器自訂提示、回應及使用者介面元素。
- 完整的 hook 支援 – 整個程式碼庫均提供可供自訂使用的篩選器及動作。
即將推出的開發者工具:
- AI 試驗場 – 試用不同的 AI 模型與提示詞。
- MCP (Model Context Protocol) – 在 WordPress 工作流程中整合並測試 Model Context Protocol 的功能。
- 擴充供應商 – 支援以額外或替代的 AI 供應商進行實驗。
開始使用:
- 閱讀參與貢獻指南,瞭解如何設定開發環境
- 前往 WordPress Slack 的 #core-ai 參與討論
- 瀏覽 GitHub 儲存庫,瞭解實驗功能的建置方式
- 參與討論,交流外掛後續該如何改進。
歡迎參與貢獻!無論你想建立新的實驗、改善現有功能,或協助撰寫文件,都可前往我們的 GitHub 儲存庫參與。
螢幕擷圖
![功能:圖片產生與編輯。文章編輯器側邊欄顯示 [產生精選圖片] 按鈕,以及已產生的精選圖片預覽,並包含替代文字、標題及內容說明。](https://ps.w.org/ai/assets/screenshot-1.gif?rev=3607988)
![編輯器實驗功能:替代文字產生。圖片區塊設定顯示 [產生替代文字] 按鈕及產生的替代文字。](https://ps.w.org/ai/assets/screenshot-4.gif?rev=3607988)


![編輯器實驗功能:留言審核。[活動] 小工具的 [近期留言] 區段顯示情緒及毒性分數。](https://ps.w.org/ai/assets/screenshot-7.png?rev=3607988)

![編輯器實驗功能:內容摘要。文章編輯器側邊欄顯示 [產生 AI 摘要] 按鈕,以及 [內容摘要] 區塊中產生的內容摘要。](https://ps.w.org/ai/assets/screenshot-10.gif?rev=3607988)

![編輯器實驗功能:內容摘要產生。文章編輯器側邊欄顯示 [產生內容摘要] 按鈕及產生的內容摘要。](https://ps.w.org/ai/assets/screenshot-14.gif?rev=3729610)


![編輯器實驗功能:標題產生。文章編輯器在文章標題欄位上方顯示 [產生] 按鈕,並在互動視窗中顯示標題建議。](https://ps.w.org/ai/assets/screenshot-17.gif?rev=3729610)







![管理介面實驗功能:AI 請求記錄。記錄 AI 請求,以供可觀測性及偵錯使用。可在 [工具] 中檢視詳細記錄。](https://ps.w.org/ai/assets/screenshot-25.png?rev=3729610)


![管理介面實驗功能:建議回覆。在 [留言] 畫面及 [活動] 小工具加入「建議回覆」操作,讓審核人員能快速產生留言回覆建議。](https://ps.w.org/ai/assets/screenshot-28.gif?rev=3729610)


安裝方式
- 將外掛檔案上傳到
/wp-content/plugins/ai目錄,或直接透過 WordPress 外掛畫面安裝外掛。 - 在 WordPress 的 [外掛] 畫面啟用這個外掛。
- 安裝並啟用至少一個 AI Connector 外掛,接著前往
Settings -> Connectors設定其認證資訊。 - 前往
設定 -> AI,並啟用你想使用的功能或實驗性功能。 - 開始試用各項 AI 功能!若要使用 [標題產生] 實驗功能,請編輯文章並點進標題欄位。欄位上方應會顯示
Generate/Regenerate按鈕。按一下該按鈕,請求完成後,標題建議會顯示在互動視窗中。選擇喜歡的標題,再按一下Select按鈕,即可將其插入標題欄位。
常見問題集
-
這個外掛有什麼用途?
-
這個外掛將 AI 寫作及編輯工具直接整合至 WordPress,同時也提供參考實作,供想要建立自有 AI 功能的開發人員使用。
-
在正式網站使用這個外掛安全嗎?
-
這是實驗性外掛,因此建議先在測試環境中試用。隨著我們蒐集社群意見,功能可能有所變動。所有 AI 功能都需由使用者選擇啟用並手動觸發;未經你的核准,不會自動執行任何操作。
-
支援哪些 AI 供應商?
-
這個外掛可搭配 Anthropic(Claude)、Google(Gemini)、OpenAI 及其他供應商的 AI Connector 外掛使用。請安裝並啟用所需的 AI Connector 外掛,再前往
Settings -> Connectors完成設定。 -
需要 API 金鑰才能使用這些功能嗎?
-
是,目前必須為已設定的 AI Connector 外掛提供自己的 API 金鑰,例如 OpenAI、Google AI 或 Anthropic。
-
費用是多少?
-
外掛本身免費,但仍需支付所選 AI 供應商的 API 用量費用。費用因供應商及用量而異。多數供應商會提供免費試用額度供你開始使用。也可使用部分在本機執行、採用開放原始碼且免費的供應商(例如 Ollama)。
-
沒有程式設計知識也能使用嗎?
-
當然可以!這個外掛專為內容創作者和網站管理員而設計。設定好 AI Connector 後,就能直接在文章編輯器中使用 AI 功能。
-
這個外掛支援 Classic Editor 嗎?
-
不支援。
AI 外掛目前僅支援區塊編輯器(亦稱 Gutenberg)。此外掛的設計以現代化的編輯器 API、區塊式內容工作流程,以及 WordPress 核心(包括 Gutenberg)持續發展中的編輯功能為基礎。
自 WordPress 5.0 於 2018 年推出以來,區塊編輯器一直是 WordPress 的預設編輯體驗,至今仍是編輯器積極開發的主要焦點。將開發資源集中在區塊編輯器,能讓此專案更快推出新功能、實驗及整合,同時避免在多種編輯體驗中維護平行實作的複雜性。
雖然 Classic Editor 外掛仍有相當龐大的安裝量,Core AI 團隊仍決定優先在區塊編輯器生態系中推動創新及實驗。目前沒有新增 Classic Editor 官方支援的計畫。
-
哪裡可以取得協助或回報問題?
-
你可以在 WordPress Slack 的 #core-ai 頻道提問,或到 GitHub 儲存庫回報問題。
使用者評論
參與者及開發者
變更記錄
1.4.0 – 2026-10-05
新增
- 執行留言審核時,會依每則留言的內容是否充實、是否符合該文章的主題,計算價值分數,提供介於 0 至 1 的相關性指標。這項分數會顯示在留言畫面的新欄位中(#681)。
- 新增實驗功能 Markdown 資訊提供,在
/feed/markdown/提供 Markdown 資訊提供(適用於所有資訊提供情境),並透過?output_format=markdown提供個別文章與頁面的 Markdown 版本(#855)。 - 內容翻譯失敗時,使用者可手動重試(#941)。
- 限制留言審核批次分析佇列的大小(#972)。
- 新增嵌入向量的儲存與建立、讀取、更新、刪除(CRUD)層(新的
wpai_embeddings資料表),可為每個向量一併記錄提供者與模型(#976)。 - 為內容翻譯實驗功能新增 9 種預設目標語言(#986)。
- 為內容翻譯能力新增指引分類支援(#987)。
- 新增
Vector_Math與Vector_Ranker類別,讓使用者能對向量執行相似度與排名查詢(#993)。 - 為自動完成建議請求新增載入指示器(#1029)。
- 將替代文字產生功能與圖片區塊的裝飾性圖片設定整合(#1031)。
變更
- 將最低支援的 WordPress 版本提高至 7.0.3(#1001)。
- 內容分類通知的錯誤訊息改為顯示具體的分類法標籤,不再使用籠統的用語(#916)。
- 文章標題過短時顯示通知,並停用標題翻譯(#967)。
- 將嵌入向量程式碼更新為
PHP AI Client 的最新版本(#975)。 generate_embeddings輔助函式現在必須指定
嵌入模型。請傳入model(模型 ID 或ModelInterface
執行個體);若使用模型 ID,還須傳入提供該模型的provider。這項
變更會破壞相容性,已開始使用這個函式的人需要調整程式碼(#975)。- 將設定中的垂直刪節號圖示改為工具圖示(#1001)。
- 將
core/read-content與core/read-users能力重新命名為core/content-query與core/users-query。舊名稱目前仍可作為已淘汰的別名使用(#1002)。 - 將
gpt-image-2.5-flare設為預設的 OpenAI 圖片產生模型(#1023)。 - 將
core/read-settings能力重新命名為core/settings-get。舊名稱目前仍可作為已淘汰的別名使用(#1087)。
已淘汰
- 淘汰
ai/get-post-details能力。請改用core/content-query的單篇文章模式(#1002)。
移除
修正
- 確保內容調整長度互動視窗中的內容產生完成後,焦點會移至接受按鈕(#917)。
- 核心重新驗證 API 金鑰時,將預設請求逾時時間從 5 秒延長至 30 秒。這是為了改善驗證請求逾時時,核心會刪除 API 金鑰的問題(#947)。
- 將已啟用 SEO 外掛的偵測結果快取並設定存留時間(TTL),且在任何外掛啟用或停用時立即使快取失效,讓 Meta 描述的中繼資料鍵查詢不必在每次請求都重新掃描已啟用的外掛(#973)。
- 改善內容翻譯的載入動畫,保留現有的文字與背景色彩(#977)。
- 修正
@wordpress/dataviews從私用 API 允許清單移除後,設定頁面在 Gutenberg 23.9 以上版本無法轉譯的問題(#989)。 - 確保指引整合改從
wp_knowledge文章類型讀取已發佈的指引資料,而不是已移除的wp_guideline,讓指引可在最新版 Gutenberg 中使用。我們不會將舊文章類型與分類法的資料移轉至新版本,因此先前在舊版 Gutenberg 中設定過指引的人,需要重新新增這些指引(#988)。 - 匯入核心加上前置詞的 PSR
EventDispatcher,供內附的EmbeddingBuilder使用(#1005)。 - 文字游標位於末尾時,為自動完成產生的文字預留空間(#1008)。
- 更新設定頁面容器的
min-height,讓它涵蓋整個檢視區域的高度(#1013)。 - 將
@wordpress/dataviews套件更新為最新版本,修正可收合卡片的焦點樣式(#1035)。 - AI 請求記錄現在會將提供者的 HTTP 錯誤回應(4xx/5xx)記錄為
error,並附上狀態碼與訊息,不再記錄為success;Gemini 文字產生請求也不再被誤標為Metadata(#1040)。 - 行內留言表單處於快速編輯模式時,隱藏「建議回覆」按鈕(#1049)。
- 修正區塊編輯器啟用「顯示範本」模式時,編輯備註只檢查範本區塊的問題(#1053)。
- 啟用顯示範本時,將產生的摘要插入文章內容中(#1055)。
- 將內容分類建議膠囊按鈕的焦點樣式與核心 Button 元件統一(#1060)。
- 連接器核准功能不再因將核心的連接器金鑰檢查誤判為提供者外掛或 Gutenberg 發起的請求,而阻擋該檢查(#1070)。
- 能力的輸入屬性列出多種類型時,能力總管不再當掉(#1073)。
- 正規化內容時,保留 HTML 實體與短代碼之間的文字,同時仍對以實體編碼表示的標籤進行編碼(#1077)。
- 避免啟用能力時,儲存一般設定會在
options.php發生驗證錯誤(#1080)。 - 確保 Markdown 資訊提供中的文章標題、網站說明及內容摘要不再含有 HTML 實體(#1086)。
- 確保在資訊提供未註冊的情況下重建重新寫入規則後,Markdown 資訊提供不會出現 404 錯誤(#1110)。
安全性
- 確保在允許批次審核留言之前,先檢查
moderate_comments權限,再逐一檢查每則待審核留言的edit_comment權限(GHSA-pjw7-q94g-4q34)。 - 強化 Playground 預覽發佈工作流程,改從觸發該流程的執行紀錄取得提取要求與提交的中繼資料(#978)。
- 強化後台畫面的 JSON 資料解析(#991)。
1.3.0 – 2026-08-18
新增
- 新增實驗功能:內容翻譯;可直接在文章編輯器中,將段落與標題區塊翻譯成選取的語言,也可選擇一併翻譯文章標題(#747)。
- 新增實驗功能:代稱產生;提供有利於 SEO 的永久連結建議,可將建議值設為代稱(#897, #932)。
- 新增實驗功能:自訂能力。將外掛的自訂 WordPress 能力(
ai/get-post-details、ai/get-post-terms、core/read-settings、core/read-users、core/read-content)整合至一個需主動啟用的開關;啟用後,就能透過 Abilities API 一次使用全部能力。提醒目前使用這些能力的人:必須先啟用這項新實驗功能,才能繼續使用這些能力(#881)。 - 新增開發人員工具:匯入及匯出不含敏感資料的 AI 設定(#734)。
- 刪除外掛時清除外掛資料(#692)。
- 新增 AI 專屬的網站狀態整合與狀態測試(#734)。
- 新增
wpai_content_classification_available_terms、wpai_content_classification_min_confidence與wpai_content_classification_candidate_pool_size篩選器,讓內容分類功能有更多可調整的選項(#633)。 - 新增提示詞範本擴充點,讓其他開發人員能輕鬆透過篩選器調整提示詞及提示詞建構物件(#770)。
- 從 PHP AI Client 引入嵌入向量程式碼,並依條件載入,讓 AI 外掛使用者開始運用嵌入向量產生功能(#892, #946)。
- 提供公開的
WordPress\AI\log_ai_request()API,讓 MCP 伺服器與使用能力的程式能在 AI 請求記錄中記錄請求(#914)。
變更
- 將所有中繼資料鍵的前置詞從
ai_改為wpai_。請注意,這也會變更ai_generated、ai_generated_summary與ai_note中繼資料的前置詞;若你直接使用這些鍵,請改用以wpai_開頭的名稱(#867)。 - 將 3 個預設提供者的優先選用模型更新為較新的模型(#913)。
- 將 WordPress 相容性測試版本提高至 7.1(#934)。
- 提升內容分類實驗功能產生的
分類與標籤建議的相關性(#633)。 - 檢視潤飾後的內容時,編輯更新功能現在會連結至視覺化內容修訂畫面;如果無法使用視覺化內容修訂,則改用傳統內容修訂畫面(#861)。
- 重新排列設定中的實驗性功能清單;將相關實驗功能分組,並依英文字母順序排列編輯器實驗功能(#871)。
- 改善產生、接受或關閉分類建議時的鍵盤焦點處理(#873)。
- 能力總管的提供者篩選下拉式選單現在也包含自訂提供者;總覽統計則依能力來源計數,因此自訂提供者的能力仍會歸入原本的核心、外掛或佈景主題類別(#884)。
- 產生標題後,將焦點移至產生標題的文字區域(#901)。
core/read-users能力現在會傳回依顯示名稱 A 到 Z 排序的集合(#948)。
已淘汰
- 在 0.2.1 版加入的
AI_Service類別與get_ai_service()輔助函式,將於下一個主要版本移除。外掛中沒有任何地方使用它們;實驗性功能與能力都是直接呼叫wp_ai_client_prompt()(#905)。 wpai_meta_description_result_temperature篩選器已不再使用,將於下個版本移除(#913)。
移除
- 所有請求都不再設定自訂 temperature 值(#913)。
修正
- AI 請求記錄的 REST 端點現在會註冊
operation篩選參數,讓它出現在 REST 結構定義中;傳入非字串值時會傳回 400,而不再引發嚴重錯誤(#758)。 - 修正產生建議回覆後,行內回覆文字區域未取得焦點的問題(#877)。
- 修正啟用 Yoast SEO 時,套用至頁面與自訂文章類型的 Meta 描述建議在儲存後遺失的問題(#886)。
- 改善請求記錄中提供者與模型詳細資訊的無障礙體驗及鍵盤操作(#889)。
- 改善建議回覆語氣下拉式選單的鍵盤與焦點處理(#907)。
- 同步行內與互動視窗中內容摘要產生按鈕的產生狀態(#908)。
- 確保加密實驗功能偵測呼叫端時,正確辨識發起呼叫的外掛,而不是承載這項功能的外掛(#909)。
- 同步側邊欄與區塊工具列中重新產生摘要按鈕的載入狀態(#912)。
- 調整內容長度時保留行內 HTML(#915)。
- 批次操作完成後,排序清單或切換分頁時不再重複執行該操作(#928)。
- 讓編輯更新也能套用至將可編輯文字儲存在
value屬性中的區塊(#930)。
安全性
- 確保從 LLM 取得並轉譯的內容,以及傳送給 LLM 的內容,都經過適當的資料過濾(#950)。
- 在批次產生替代文字與摘要之前,加入適當的 nonce 檢查(GHSA-hfp9-55vw-ccjc)。
- 傳入自訂圖片網址給替代文字產生能力時,確保該網址可公開存取、指向允許的圖片類型,而且實際下載的最終網址與最初驗證的網址一致(GHSA-v2wx-9j88-4rqq)。
1.2.0 – 2026-07-14
新增
- 新增實驗功能:建議回覆;讓留言審核者能在後台快速產生留言回覆(#724)。
- 在開發人員工具中新增「進階設定」選項,用來顯示或隱藏功能與實驗性功能的額外設定選項(#842)。
- 在文章與頁面清單中新增「產生 AI 摘要」批次操作,可一次為多篇文章產生摘要(#650)。
- 新增
core/read-content能力,提供安全的單篇文章與查詢模式(包含 include 及需主動選用的欄位),讓內容可供唯讀存取(#739)。 - 新增
core/read-users能力,可依 ID、電子郵件、登入名稱或 nicename 取得單一使用者,也可取得經過篩選與分頁的使用者集合;敏感欄位需主動選用,並受權限限制(#774)。 - 啟用連接器核准功能後,如果尚未核准任何 AI 連接器,會在後台顯示行內通知,提醒網站管理員核准 AI 外掛的使用權限(#830)。
- 新增
wp_ai_client_default_request_timeout篩選器,讓預設請求逾時時間可以調整。圖片產生請求也使用此篩選器設定逾時時間(#862)。
變更
修正
- 儲存 AI 設定後還原焦點位置(#812)。
- 為 AI 首頁的功能卡片圖片新增具描述性的替代文字,改善螢幕閱讀器的無障礙體驗(#819)。
- 避免在前台載入自動完成的資源檔案(#820)。
- 使用 Escape 鍵關閉自動完成建議時,不應觸發新的建議請求(#840)。
- 修正自動完成的預覽文字位置,以及過期建議與空白區塊預留位置文字重疊的問題(#847)。
- 修正使用標題產生功能時,編輯器 iframe 的 body 尚未就緒而導致
MutationObserver當掉的問題(#849)。 - 遵循指定設定項目中明確指定的
show_in_abilities值;WordPress 核心宣告此標記後,便交由核心處理(#852)。 - 在
core/read-settings建立初始設定快照之前,先註冊這些設定(#856)。
較早的更新記錄可在 CHANGELOG.md 檔案中找到。
