為什麼作品集最後需要筆記，而不只是作品卡片

作品卡片和筆記都可以放在同一個網站裡，但它們不是同一種證明。

卡片適合讓讀者快速知道「這是什麼、可以去哪裡看」；筆記則適合回答「為什麼這樣做、過程中怎麼取捨、哪些結果真的被驗證」。如果把所有說明都塞進卡片，作品列表會變得難以掃讀；如果只留下卡片，又會讓很多重要判斷只能靠讀者猜。

主要判斷是：作品卡片負責讓成果被找到，筆記負責讓方法和限制被理解；兩者不是長短不同的同一頁，而是承擔不同的公開證明任務。

作品卡片先解決「找到它」

目前作品頁的卡片有相對固定的內容：作品名稱、日期、圖片、技術標籤，以及前往展示頁或專案頁的連結。這些欄位適合快速比較和選擇，也讓讀者不用打開每一個作品才能知道它是否值得繼續看。

卡片可以支持的判斷通常很窄：

• 這個作品在網站的作品集合裡。
• 它有一個名稱、圖像和基本分類。
• 讀者可以前往實際展示或公開專案連結。
• 頁面提供的日期和標籤是目前資料裡明確的資訊。

這些資訊已經有用，但它們不會自動說明架構、需求、失敗路徑或後續維護。圖片能讓人看見結果，不能替畫面背後的判斷作證。

筆記處理「怎麼形成」

筆記的責任不同。它可以把一個看似簡單的結果拆成讀者能追蹤的問題：

• 當時要解決的是什麼問題？
• 哪些需求被保留下來，哪些沒有被做進去？
• 為什麼選擇這個資料模型、路由或互動方式？
• 工具和測試實際檢查了什麼？
• 還有哪些地方沒有被量測，或需要由人主觀確認？

這種內容不必替每個作品都寫一篇完整案例研究。只要某個判斷對其他頁面、內容流程或開發工作有可帶走的意義，就可以獨立成為一篇筆記；反過來，如果只有一張圖片和一個外部連結，卡片可能已經足夠。

目前的公開筆記談的是網站重構、內容發布、多語路由、驗證和 AI 協作。它們不只是作品卡片的延伸說明，而是把開發過程裡可以公開、可以查證的方法整理出來。

卡片和筆記的證據強度不一樣

同一個作品可能同時出現在作品頁和筆記裡，但兩個入口不能互相代替：

入口	比較適合證明	不應該直接推出
作品卡片	作品存在、基本名稱、圖片、外部入口	架構品質、使用者成果或完整開發過程
公開筆記	已記錄的判斷、限制、實作和驗證範圍	商業成效、所有裝置都沒問題或所有讀者都理解
真實展示頁	某個連結在目前狀態可以被開啟	內部資料模型和未展示的錯誤處理
程式或測試結果	被檢查的條件在該範圍內成立	沒有被測的裝置、部署或使用情境

把筆記加入網站，不是把「作品存在」升級成「作品一定成功」。它只是提供更多可讀的證據，讓讀者知道結論是從哪裡來，也知道結論沒有延伸到哪裡。

不要把作品卡片變成小型文章

如果每張卡片都塞入背景、決策、技術細節、限制和一長串結果，列表會失去原本的功能。讀者無法快速比較作品，手機畫面也會被大量同層級文字撐長。

比較穩定的分工是：

• 卡片保留辨識作品所需的最低資訊。
• 需要完整背景時，連到真實展示頁、專案頁或公開筆記。
• 筆記只處理一個主要問題，不把所有作品資訊再複製一次。
• 沒有足夠素材的作品，不硬寫成完整案例研究。

這樣做不是要把內容拆得越細越好，而是讓讀者知道每個入口的閱讀成本。卡片用來瀏覽，筆記用來理解；兩者應該互相指路，不要互相競爭同一段內容。

筆記也不能替作品補造結果

筆記比卡片長，不代表它可以承擔更多沒有證據的敘述。若目前只有實作程式、畫面和建置檢查，就只能說明這些內容；沒有使用者研究，就不能補上讀者喜好；沒有流量或合作資料，就不能補寫商業成效。

同樣地，作品卡片上的日期、標籤和連結也不應該被筆記重新包裝成另一種故事。作品名稱是什麼、連結是否存在、某個功能是否真的掛載，都要回到實際資料和使用點確認。

公開筆記的價值不在於把結果說得更大，而在於把判斷的範圍寫得更清楚。

什麼時候值得從作品延伸一篇筆記

可以先問幾個問題：

1. 這個作品是否有一個不只對作者自己有用的判斷？
2. 這個判斷能不能用實作、資料或輸出驗證支持？
3. 如果只看作品卡片，讀者是否會錯過重要的取捨？
4. 文章能否只回答一個主要問題，而不是把整個專案重新寫一遍？
5. 哪些內容可以公開，哪些仍然屬於私人資料或未確認範圍？

如果答案都是否，先保留卡片就好。沒有必要為了讓 Notes 看起來有內容，替每一個作品製造一篇沒有新證據的文章。

如果答案是肯定的，文章也可以不依賴作品卡片才能成立。它應該讓讀者讀完後帶走一個判斷方式，而不是只記得某個專案的名稱。

目前這個網站把兩種入口放在一起

從作品頁可以快速瀏覽網站與系統類作品、內容與視覺作品，也可以查看獨立標示的 AIGC 角色視覺；從 Notes 可以讀到架構、內容工程、介面和 AI 協作的公開紀錄。這兩條入口描述的不是同一份資料：一條偏向「做過什麼」，另一條偏向「怎麼判斷和怎麼交付」。

這樣的分工也保留了一個限制：不是每篇筆記都需要對應一個單一作品，不是每個作品都必須有筆記。內容是否成立，要看它能不能回答一個清楚的讀者問題，而不是看網站上是否還有一張卡片可以被填滿。

作品卡片讓讀者找到成果，公開筆記讓讀者理解形成成果的過程。當兩者各自保留自己的證據範圍，網站才不必靠一種頁面假裝自己能回答所有問題。

紀錄範圍

本文根據目前作品頁的卡片資料、外部入口、Notes 內容模型與既有頁面契約整理。它區分作品展示和方法紀錄的責任，不把作品畫面、建置通過或文章內容延伸成使用者反應、搜尋成效、商業結果或完整案例研究。