編輯器的溫室工程：自動儲存、補全與一個吃字的 bug

後台的筆記編輯器是全頁雙欄：左邊寫、右邊同管線預覽。它是我在這個專案裡對「寫作手感」投資最重的地方，幾個工程點值得記。

自動儲存：debounce 之外的三個細節

打字停頓 1.5 秒送一次 PATCH，這是基本款。魔鬼在邊角：

• flush 時機——發佈前、離開頁面前，必須先把未儲存的變更沖出去，而且並發呼叫要共用同一趟 in-flight 請求，不然「儲存中又觸發儲存」會打架。這裡曾有一個吃字 bug：flush 迴圈裡取值的時間點不對，最後一段輸入被舊快照蓋掉——自動儲存最不可原諒的罪就是弄丟使用者的字。
• 儲存指示要誠實——「編輯中…／儲存中…／已儲存 · N 秒前／未儲存（點擊重試）」四態。失敗不能安靜，要變成可點擊的重試入口。
• 順帶的副作用：這個高頻 PATCH 後來還逼出了稽核的折疊窗口。

[[ 補全

輸入 [[ 彈出筆記選單，游標位置用 textarea 座標庫算出來、浮層跟著游標走，下半屏自動翻到上方。slug 清單吃全量筆記快取——個人站的量級，這裡不需要搜尋 API。

Slug 的鎖

標題打字時 slug 自動跟著生成（kebab 化）；一旦發佈過，slug 在 UI 層鎖死——它已經是對外的 URL，canonical 與外部連結都指著它。「改標題不改網址」是發佈後的預設姿態。

這個編輯器教我的事：寫作工具的品質不在功能清單，在於挫折的缺席——字不會丟、預覽不會騙、儲存不用想。做到「感覺不到它存在」，才是溫室該有的樣子。