WordPress 自動筆記外掛


之前看到新聞說有學校禁止學生使用 ChatGPT(小雀),看到當下只覺得應該沒這麼嚴重吧,只要老師好好指導學生使用它的方法與範圍,善用這個工具絕對能讓學習的效率提升,但最近才發現我太天真了,人的天性往往會讓事情變得不單純。

起因是這陣子收到一封在校學生的合作來信,表明自己對於 WordPress 網站開發有一定的能力,希望可以跟我一起合作接案,可以收到這樣的來信讓我非常興奮,如果以前自己念大學的時就有機會跟業界人士共事,這樣的成長速度絕對比自學來得快千百倍。

抱持著不能誤人子弟的心情仔細看了信件內文,雖然作品要能夠接案還有一段距離,但能感受到他對於相關工具有一定的掌握度,然而讀完了全文以後我內心開始糾結,不知道是不是這陣子我用太多小雀了,讓我可以輕易辨識出這封信有很高機率是用小雀寫出來的。

主要的特徵有大量的中國用字,像是編碼、鏈接、創建,然後每一個段落重複出現相同的句子,文末的結尾很唐突,讓我很想要輸入「繼續」請他寫完,整體的感覺就像是我告訴小雀一些關鍵字,然後用它產生這一篇文章。

當下我好像可以體會教授看到學生交上來是這樣報告時的心情,雖然內容沒有錯誤,語意上完全可以閱讀,但就會開始懷疑學生到底花了多少心思在這件事情上面,如果今天是要交辦客戶或是專案給他我一定會抖抖的,會讓我不信任他的程式碼品質以及投入程度,用小雀產出堪用的程式碼很方便,但要能用在專案中的又是另外一回事了。

另一方面,由於他的信件讓我對於在寫內容時用字精確有不同的領悟:身邊有不少朋友都會覺得文字只要可以傳達意思、能夠溝通就好,是哪一國的用法根本沒有差,往往這時候只能訴諸政治意識形態,最後只會讓彼此的討論沒有交集。

你有用過小雀就知道,雖然一直跟它講要用繁體中文回答,但它還是三不五時會跑出簡體中文或是中國用字的繁體寫法,我想原因應該是簡體中文的訓練資料比繁中多上太多,因此出現簡中的機率很高,因此在寫文字的時候,如果你的用字不精準,很容易就會被人懷疑你寫的內容是用機器人產出的,這對於你努力塑造出來的專業形象會有大的殺傷力。

AI 提供的資料應該只是輔助,即使是小雀今天已經升級到可以寫出完美的繁體中文,也不應該將它作為最終產出的內容,因為這樣就等於是把身為人的價值隱藏在機器後面了。

因此從現在開始好好選字吧,萬一不經意的用錯字也虛心接受他人指教,或是去查字典找到正確的用法再寫出來,在 AI 大量生產內容的年代,要保有自我只能靠著這些細節的累積,這才是能在 AI 時代創造出差異化的不二法門。

一、在 wp_insert_post() 中處理程式碼文字提示

區塊編輯器可以使用 Markdown 語法,但當我想用 wp_insert_post() 來建立文章時,內容中帶有程式碼的區塊卻無法正確顯示,依舊會是以純文字的方式呈現,雖然有第三方外掛可以將程式碼區塊做反白提示,但礙於要達成自動化的目標有些問題無法克服:

1.Code Syntax Block

​https://tw.wordpress.org/plugins/code-syntax-block/​

這支外掛可以讓區塊編輯器內建的程式碼區塊以不同的樣式來呈現語法,並且還可以顯示行數以及程式碼說明,能比預設的程式碼區塊有更明顯的樣式:

在區塊編輯器中切換到「程式碼編輯器」,就可以看到該區塊的 HTML 語法,只要將語法放在 wp_insert_post() 的參數之中,就可以建立帶有程式碼內容的文章:

事實上 Jetpack 也有 Markdown 的區塊工具,但不可行的原因在於我想要寫入的內容格式不固定,我沒有辦法精確的掌握到寫入程式碼的開頭跟結尾,唯一能辨識的就只有 Markdown 語法中標記程式碼的符號。

雖然可以用這個符號來替換成區塊編輯器的註解,但處理起來需要花點時間,於是換個角度想何不直接寫入 Markdown 更快,但嘗試結果區塊編輯器無法直接認得 Markdown,都還是要增加區塊註解才能辨識。

2.WP Githuber MD

​https://tw.wordpress.org/plugins/wp-githuber-md/​

於是索性停用區塊編輯器,改用 Terry 大大開發的 WP Githuber MD Markdown 編輯器,但發現到使用 wp_insert_post() 寫入 Markdown 後,我必須要手動進入後台再點擊一次更新按鈕,才能在前台看到程式碼提示以及段落的排版,不然在預設情況下會全部擠在一行無法閱讀,這對於想要全自動化的我來說還差了一點。

3.WP Editor.md

​https://tw.wordpress.org/plugins/wp-editormd/​

最後換成了這一套就可以直接透過 wp_insert_post() 來寫入 Markdown 並且帶有段落以及程式碼的提示效果,但衍伸的另外一個問題是我的內容有網址連結,我希望系統可以自動判斷當內容中帶有 http 的純文字時可以自動加上 標籤。

在跟規則運算式奮戰了好一陣子後,才發現原來 WordPress 有內建超方便的 make_clickable() 可以搞定這件事,只要使用勾點 the_content 就可以將文字轉換為連結,完整程式碼:https://oberonlai.blog/wordpress-code-syntax/​

最後我目前採用的解決方案就是使用 WP Editor.md + wp_insert_post() 來寫入帶有 Markdown 的文字內容。

二、WordPress 自動筆記外掛

這禮拜花了幾小時實作了一個小外掛,目的是想要結合 OpenAI API 以及 WordPress 的排程功能,自動在每天半夜十二點幫我寫筆記,筆記內容是每天介紹一個 WooCommerce 函式的說明並附上程式碼範例,並帶有該函式的原始說明連結。

會想要做這個外掛的起因是每次寫程式在卡關時,都會查到原來 WordPress/WooCommerce 有這些內建的函式可以使用,如果可以早點知道的話就可以省下很多卡關的時間,因此想讓自己每天可以多認識一個函式,就能多一點解決問題的知識。

相較於 WordPress Code Reference 都有提供函式的具體使用範例,WooCommerce 的文件就少了這一塊,因此想說就可以請 ChatGPT 幫忙寫出這些函式的具體用法,之後就可以整理成程式碼片段來用。

有了這個想法後我就開始實作,OpenAI API 很好接,申請 API Key 用 wp_remote_request() 打不用十分鐘就搞定了,但產出實際內容後才發現原來 ChatGPT 是這麼不受控的傢伙 Orz,程式碼如下:https://oberonlai.blog/wordpress-openai-ai/​

1. 回答重複的內容

我的提示語是這樣下的:「介紹 WooCommerc 函式的用法,格式為函式名稱、函式說明、程式碼範例、註解、參考連結,使用繁體中文且不要重複」,我希望透過格式名稱去把它回答的內容拆解為陣列,我預期它每一次都會介紹不一樣的函式。

但試了幾次之後發現到 wc_get_product() 出現頻率最高,其次是 wc_get_order(),看來這是網路上大家最常問的兩個函式,理論上我應該可以把它講過的內容再餵給它以避免重複,但又怕一整個使用量爆表,最後還是覺得應該要先把完整的函式列表整理出來,然後隨機選取後請它介紹。

但 WooCommerce Code Reference 的分類方式不太好整理函式列表,而且除了函式外還有類別以及勾點,還好小程丟給我這個網站,剩下的可能就是要手動更新資料:https://wp-kama.com/plugin/woocommerce/function​

2. 回答格式不固定

我預期的回答內容會是這樣:

-

函式名稱:wc_get_products()

函式說明:透過使用 wc_get_products() 函式,可以取得 WooCommerce 後台系統中所有的商品。此函式具有完整的快取支援,可提高程式執行效率,並可用在任何需要儲存商品資料的情境。

程式碼範例:…

-

雖然得到的格式幾乎都正確,但有時候冒號會變成半形、冒號後面的文字會換行、程式碼沒有用 Markdown 的程式碼語法包住等等,於是我就要不停的根據它回答的格式做內容判斷,因為我想要拿它的函式名稱作為文章標題,格式不固定讓我有點困擾。

3. 回答內容的正確性

最嚴重的問題還是回答內容的正確性時好時壞,我遇過它寫出來的程式碼範例根本就沒有包含它所介紹的函式,或是解釋的說明完全不相關,附上的參考連結也常常 404,更不用說所處可見的簡體中文用字與用法。

實作後我對於使用 OpenAI API 自動寫筆記的想法有點冷卻了,最大原因在於我還是必須要人工去審核產出的結果,除了要先確認範例程式碼可否運作,還要檢查參考連結是否有誤,或是我應該換個想法,坦然接受現階段小雀的能力就是只能產出這樣的內容,反正我的目的是學習,有能力糾正錯誤也是很重要的一環,實際測試一陣子後再看看吧~

三、WooCommerce Notify 的開發循環

以前在接案時總是有個幻想,希望可以好好的專注在一個產品的開發,盡自己最大的努力把它做到最好,想不到回過神來現在的我已經走在這條路上:每天處理客戶反應的臭蟲、新增客戶想要的功能、改善自己覺得沒寫好的地方。

這樣的努力帶來了良好的循環,這個月的營業額創下新紀錄,於是開始無法抑制自己內心的慾望,有點落入了靠增加新功能來帶動銷售的想法,而且還睽違已久的加了班,想盡快把客戶想要的功能加進去。

只能說產品開發是一連串的取捨,要專注在產品的核心功能還是開發支線加入一些客戶想要但事實上不那麼核心的功能?還好我還滿想享受這樣的過程,畢竟這不就是我一直以來的幻想嗎?XD

本週更新項目:

1. 新增 WooCommerce 結帳頁 LINE 登入按鈕的文字設定

提供給站長自訂 LINE 登入按鈕的文字,可以用行銷文案來增加顧客使用 LINE 登入的轉換率。

2. 加入訂單推播判斷

之前的作法是我沒有先檢查該訂單是否帶有顧客的 LINE User ID 就直接推播,因此會造成 API 回傳錯誤訊息,客戶擔心這些沒成功寄出的推播會不會算進 Messaging API 的使用量,因此這此更新多加了判斷,避免在沒有 LINE User ID 的情況下去呼叫 Messaging API。

3. 增加訂單內 LINE User ID 顯示

讓站長可以判斷該訂單的客戶是否有使用 LINE 登入,以利後續的行銷追蹤與客戶服務。

4. 新增綠界物流編號參數

在推播管理中增加綠界物流編號參數,讓站長可以發送物流通知以利顧客追蹤到貨狀況。

5. 排除 Nextend Social Login 取得 LINE User ID 錯誤

WordPress 知名的 Nextend Social Login 外掛付費版也有提供 LINE 登入功能,WooCommerce 推播通知會自動取得透過該外掛進行 LINE 登入的 User ID,但在資料庫的語法上我手殘多加了一個底線,因此無法正確取得 Nextend Social Login 的 LINE User ID,這次的更新修復了這個錯誤。

感謝每一位有對 WooCommerce 推播通知外掛提供意見回饋的朋友,雖然聽起來很陳腔濫調,但真的是因為有你們的回饋我才有動力繼續開發下去,對開發者來說最痛苦的莫過於閉門造車寫了一堆沒人用的工具,希望這支外掛在未來也能幫得上你的忙!

-

最後我還是沒有回信給那位學生,想不出來要寫什麼才不會讓他覺得我在說教,希望他有訂閱我的電子報XD。下週連假不確定是否出刊,要看姨甥女們有沒有來我們家玩了 :p,祝大家清明連假愉快,一路交通順暢!

WordPress 開發日常

Read more from WordPress 開發日常

之前朋友約出來喝咖啡時他分享下一個階段的 AI 可能會發展成監督式的 AI,也就是當 AI 自己在跑的時候,會有另外一個 AI 來檢查它現在做的每一件事情是否都真的有往正確的方向推進。 當下聽到覺得這個 idea 很棒,但具體要怎麼實作完全沒有概念,更不用說這樣子 token 消耗的成本會不會變成兩倍?而且監督 AI 的 AI 需要有什麼能力?該以哪一種方式來進行監督?然後又該如何把找出的問題回報給原本的 AI 呢? 這一切問題在我最近研究 Claude Code 以外的工具時意外發現了解決方案,那就是之前我拿來做為 Discord Bot 的 AI 引擎 OMP。 OMP 是 PI 的分支,想理解什麼是 OMP 可以先從 PI 開始理解,PI 是一套開源且輕量化的 Coding CLI,也是跟 Claude Code 一樣跑在終端機的寫程式 Agent。 相較於 Claude Code 的封閉,PI 完全開源,並且支援多家不同的模型,PI 強調有需要什麼工具再自己額外安裝,就不會像 Claude Code 一樣原廠給你什麼就只能用什麼。 而 OMP 是 PI 的分支,它的概念跟...

之前分享我請 AI 設計的一套專門用來管理手邊待辦清單的專案管理軟體,邊用的時候我就在邊思考著:當我新增這些任務之後,我還是要回到終端機去把這些任務的描述、相關的文件以及完成的目標告訴 AI,然後等它跑完之後我再驗收,再回到我的計時軟體裡面來記錄是已完成還是該暫停。 如果可以在開立任務的時候,就能直接指派 AI 來做這件事情,是不是就可以少一個重複描述、開發需求的流程?剛好有了這個想法之後,就在 YouTube 上面看到一個叫做 Auto Claude 的專案。 它把 Claude 直接跟看板軟體整合,並且可以在裡面詢問 AI 關於專案的細節以及產生開發藍圖,也能設定專案的亮點與相關資訊。 我看到後驚為天人,覺得這似乎是另外一種理想的 AI 開發軟體,本想直接下載裝起來用,但請 Claude 研究後發現它有一些問題,於是就想說自己來開發,順便理解關於整個 Loop Engineering 的概念。 Claude Orchestrator 這次一樣是使用 Glaze 來開發,請它建立好專案的環境之後,然後再回到終端機去接手後續的多工並行。我的做法是先請 AI 去參考 Auto...

常常在社群媒體上看到各種自動化工具的廣告,從早期的 n8n 開始到現在 AI Agent 自動完成任務,這些工具跟流程都很棒。但是回到使用者本身,我們真的知道自己有哪些工作是可以被自動化或是應該「自動化」的嗎? 這就讓我回想起以前給自己的工作要求,那就是要把手上所做的每一件事情都記錄下來,並且可以明確看到每項任務的執行時間以及頻率,這樣事後才有辦法做回顧,我把這樣的理念也應用到承接專案的層面上。 這也是為什麼我有一些專案都是採取時薪計價的開發模式,因為我需要讓客戶知道他的預算都花在哪些項目,來藉此把資源用在合適的任務上。 我最早使用的即時軟體叫做 Ora,這是一套結合看板管理、敏捷開發流程、時數統計,甚至還有內建聊天討論串的一套強大工具。 它長期都是免費的,付費方案是團隊成員超過計算,所以我都是使用它來進行與客戶的專案管理,它的介面十分清楚且一目瞭然,可以縱觀地知道是哪一類型的任務花最多時間,也可以細看到具體是在處理哪一個問題所消耗的時數。 但當某天我打開準備使用它的時候,發現它被另外一套專案管理軟體 ClickUp...