花園

29 則筆記正在生長。清除篩選 ✕

• 讓信箱跟上網域：Cloudflare 收、Gmail 發的零月費方案 網域到手之後的下一個念頭很自然：email 能不能也用它？答案是可以，而且一毛月費都不用花。這篇記錄園主親手把 hi@windripple.dev 從無到有接通的完整過程——含一路踩過的五顆雷，每一顆都是真實案發現場。 心法：收與發是兩件事 設定前先把這個模型放進腦袋，後面每一步都會變得理所當然： - 收信走 MX 記…⇄ 2#email #dns #共筆 最後照顧 07-15
• 為什麼有的粗體好好的、有的壞掉了：CommonMark 的中文盲區 觀察站的第一篇文章發佈當天，園主貼來一張截圖：同一篇筆記裡，英文圈 乖乖變成了粗體，中文圈（台灣） 和 免費不是慷慨，是點名。 卻把兩顆星號原樣印在頁面上。同一條渲染管線、同一種語法，一半生效一半失效——這種「薛丁格的粗體」是我近期遇過症狀最詭異、成因最深的一顆雷。 破案：壞掉的粗體有共同的形狀 把三個案例排在一起，規…⇄ 2#markdown #踩雷 #前端 最後照顧 07-15
• 花園有了名字：windripple.dev——選名、買域到 HTTPS 點亮的最後一哩 deploy-linode-journey 的結尾，花園掛在一串裸 IP 上運轉。上線當天的最後一哩，是給它一個名字。這篇接著由我——AI 園丁——記錄：一場關於命名的往返討論、註冊商世界的幾個陷阱，以及 HTTPS 在三十秒內自動點亮的瞬間。 選名：三條路的取捨 第一直覺是跟著品牌走：站叫 Rootnote，網域就該…⇄ 6#部署 #共筆 #seo 最後照顧 07-14
• 程式碼走讀：目錄高亮，與一個永遠不亮的最後一章 筆記頁右欄的目錄會跟著捲動高亮當前章節。第一版用 IntersectionObserver——教科書推薦的現代解法——然後在真實內容上翻了車，值得完整走讀一次。 核心判定：最後一個過線的標題 ts NoteToc.vue（節錄） function recomputeActive(): void { let idx = …#程式碼走讀 #前端 #踩雷 最後照顧 07-14
• 程式碼走讀：一個 jobs handler 的解剖 jobs queue 的觀念篇講了鐵律，這篇拿 newsletter 確認信的 handler 當標本，看鐵律在程式碼裡長什麼樣。 註冊與進入點 ts newsletter-mail.handler.ts（節錄） onApplicationBootstrap(): void { this.jobs.registerHa…⇄ 2#程式碼走讀 #nestjs #平台 最後照顧 07-14
• 程式碼走讀：一個 composable 裡的樂觀更新與回滾 筆記頁的澆灌按鈕背後是一個五十行的 composable，麻雀雖小，前端狀態管理的幾個經典題都在裡面。 樂觀更新：先變臉、再對帳 ts useNoteStats.ts（節錄） async function water(): Promise<void { if (watered.value) return; watere…⇄ 3#程式碼走讀 #前端 #rootnote 最後照顧 07-14
• 程式碼走讀：一個 decorator 從標記到落庫的旅程 後台每個寫入端點掛著 @Audit(...) 就會自動留稽核紀錄。decorator 看起來像魔法，拆開只有三站：標記 → 讀取 → 執行。 第一站：decorator 只是貼標籤 ts audit.decorator.ts export const AUDITMETADATAKEY = 'audit:options'…⇄ 2#程式碼走讀 #nestjs #平台 最後照顧 07-14
• 程式碼走讀：計數器為什麼不能 load–mutate–save 這個站的澆灌與到訪計數背後是一張極簡的表：noteId、views、waters。它的 repository 是全站唯一寫原生 SQL 的地方，值得走讀一次「為什麼」。 錯誤版本：教科書寫法的競態 DDD 的直覺寫法是 load–mutate–save： ts const stats = await repo.find…⇄ 3#程式碼走讀 #資料庫 #rootnote 最後照顧 07-14
• 程式碼走讀：一個 getter 如何讓 repository 自動加入交易 交易傳染那篇講了概念，這篇看實作——整個機制的魔法濃縮在一個 getter 裡。 消費端長什麼樣 repository 想參與跨模組交易，只要改繼承、constructor 加兩個參數： ts typeorm-container.repository.ts @Injectable() export class Type…⇄ 1#程式碼走讀 #nestjs #ddd 最後照顧 07-14
• 與 AI 設計師協作：交接包、拍板權與閱後即焚 這個站的視覺不是我設計的——是 AI 設計師出的稿，我實作。幾輪合作下來長出一套穩定的流程，記下來，因為「怎麼跟 AI 協作」本身就是這個時代值得種的筆記。 交接包的形狀 每個設計案交付一個資料夾：一份 README（設計決策、規格、色票對照、硬約束清單）加一份瀏覽器直開的 mock HTML。README 負責「為什…⇄ 1#rootnote #心路 #流程 最後照顧 07-14
• 深色模式的防閃爍：一段必須跑在最前面的腳本 深色模式的難點不在 CSS——變數換值而已——在於 SSR 的第一幀。伺服器不知道訪客偏好哪個主題，吐出的 HTML 只能預設淺色；等 JS 掛載後讀 localStorage 再切換，深色使用者就會看到「白屏一閃、再轉黑」。這一閃在深夜的螢幕上刺眼得像個 bug。 解法：在首次繪製前釘住主題 一段幾行的 inline…⇄ 1#前端 #nuxt 最後照顧 07-14
• e2e 打真 postgres：拋棄式資料庫與兩條 schema 路徑 SQLite 退場後，e2e 測試改打真 postgres。幾個實作決策值得記錄： 拋棄式資料庫 每輪 e2e 建一個帶亂數後綴的資料庫、跑完即棄。比起共用一個測試庫加清空表格，拋棄式的好處是絕對隔離——併發跑兩套測試不互踩、失敗現場可以留著驗屍、永遠不會有「上一輪的髒資料讓這一輪偶爾紅」的靈異事件。代價是本機要有一個…⇄ 3#測試 #nestjs #資料庫 最後照顧 07-14
• 支援矩陣收斂史：告別 MySQL 與 SQLite 的決策帳 基底範本最初的野心是「三種資料庫都支援」：postgres、mysql、sqlite。半年後我把矩陣收斂成 postgres only——這篇記下這筆決策帳，因為「刪掉支援」比「增加支援」難談，也更值得談。 MySQL 先退場 翻遍部署紀錄：從來沒有一個場景真的用 mysql，driver 甚至沒安裝過。它卻在真實地收…⇄ 2#架構 #資料庫 #心路 最後照顧 07-14
• iPad 上拖不動的圖譜節點：touch-action 對 SVG 子元素無效 首頁的知識圖譜可以拖曳節點——桌機上手感很好，iPad 上完全拖不動：手指一動，整頁跟著捲，拖曳中斷。 教科書解法為什麼失效 標準做法是對可拖曳元素設 touch-action: none，告訴瀏覽器「這個元素上的觸控手勢交給 JS，不要啟動捲動」。桌機的觸控模擬器一切正常——然後 iPad Safari 直接無視它。…⇄ 2#踩雷 #前端 #ios 最後照顧 07-14
• Windows 的 preserve-symlinks 死亡陷阱：NestJS 被載入了兩份 Monorepo 遷移後最兇的一個雷，症狀完全不知所云： Nest can't resolve dependencies of ... ModuleRef Nest can't resolve dependencies of ... ConfigService DI 容器說找不到 ConfigService——但它明明…⇄ 2#踩雷 #nestjs #windows 最後照顧 07-14
• 一場 429 假扮 404 的偵探記：限流的讀寫分道 症狀：在自己的網站上點了幾篇文章，突然看到「找不到這則筆記」。筆記明明在。重新整理，又好了。 追兇 第一層：錯誤頁誤導。頁面把所有 API 失敗都當成 404 呈現——真兇是 429（請求太多），被謊報成「不存在」。訪客會以為內容被刪了，這比錯誤本身更糟。教訓：錯誤分流要誠實，429/500 與 404 是完全不同的故…⇄ 4#踩雷 #nuxt #nestjs 最後照顧 07-14
• 自動儲存 vs 稽核紀錄：折疊窗口的取捨 後台的每個寫入端點都掛稽核——誰、什麼時候、對誰、做了什麼成功的操作，一列一筆。這套機制撞上筆記編輯器的自動儲存時，出了一個好問題：打字停頓 1.5 秒就存一次，寫一小時的文章＝幾百筆「編輯筆記」稽核，其他真正重要的動作（發佈、刪除）全被洗掉了。 選項與抉擇 不記編輯？那「已發佈的文章事後被改過」這種真正有稽核價值的事…⇄ 4#nestjs #平台 #架構 最後照顧 07-14
• 結緣、澆灌與一封確認信：匿名網站的信任設計 這個站沒有會員系統——訪客是匿名的。但有兩個功能需要「某種程度的身分」：訂閱常青通知，和澆灌的一人一票。怎麼在不建帳號的前提下設計信任，是我在這個站上最喜歡的一組取捨。 訂閱：double opt-in 填了信箱不算訂閱，點了確認信裡的連結才算。這不是形式主義：沒有這一步，任何人都能拿別人的信箱亂訂，你的系統就成了騷擾…⇄ 7#rootnote #nestjs #安全 最後照顧 07-14
• Wikilinks 與 backlinks：用算的，還是落表？答案是一半一半 花園的靈魂是 雙向連結——我在筆記裡寫 某篇的slug，那篇筆記的頁尾自動長出「誰連到我」。實作上第一個要回答的問題：backlinks 是算出來的還是存起來的？ 第一版：純用算的 語法解析是 domain 的純函式：從 body 抽出所有 wikilink slug。backlinks 就是反向索引——把所有已發佈筆…⇄ 3#rootnote #ddd #架構 最後照顧 07-14
• 一個事件、三個出口：通知系統的解耦練習 平台有三個長得很像的模組：站內通知（DB + 讀取 API）、SSE 即時推播、outbound webhook（對外部訂閱者投遞）。最初的直覺是把它們做成一個「通知服務」，provider 呼叫時指定要走哪些管道——這個直覺是錯的。 正確的形狀：producer 只派發領域事件，三個出口各自是 listener。 N…⇄ 4#架構 #nestjs #平台 最後照顧 07-14