BUILD LOG / 2026.07.29

這個網站,怎麼一步一步做出來。

這裡不是逐字聊天紀錄。我整理的是自己怎麼決定網站要說什麼、 用哪些工具把想法做成畫面,以及每一步最後留下了什麼。

PROJECT TRACE● SHIPPED
0731AIEXCHANGE / BUILD STORY00 → 07

從原始任務到正式站回歸測試

  1. 01想法決定主線
  2. 02工具各有任務
  3. 03實作故事與介面
  4. 04驗證正式站再測
01 / THE START

最初不是從版型開始。

「AI 的能力正在快速普及。真正重要的是能否發現值得解決的問題、 提出不同的想法、判斷什麼值得做,並設計可靠的驗證方式。」

Jimmy 在需求訪談中定下的核心主張
原始狀態

內容很多,主線還沒站穩。

原網站已經有 CLI、Codex、Skills 和 TempoTerm,也有三個個人案例。 問題不是沒有內容,而是工具、故事、Demo、隱私與現場節奏同時擠在一起。

第一個決定

先知道為什麼,再談用什麼。

首頁改講三次判斷;工具搬到獨立頁。每個新增功能都要回答: 它幫觀眾理解了什麼,還是只是看起來很厲害?

02 / COMPLETE FLOW

從第一份需求,
到可以公開的網站。

每一步都有一個問題、實際用到的工具和可檢查的輸出。這是這次真正走過的製作路線。

  1. 00
    這場分享真正要留下什麼?

    先寫清楚,不急著改

    原始任務先定義聽眾、60 分鐘分享情境、公開範圍、三個案例與不能跨過的隱私界線。

    TOOLS
    • 原始任務
    • Markdown
    OUTPUT

    一份可追溯的改版任務,而不是一句「幫我做漂亮一點」。

  2. 01
    現有網站哪些要保留,哪些真的壞了?

    完整盤點 repository

    閱讀頁面、元件、資料、CSS、測試、靜態匯出與部署設定,先理解原本設計系統,再決定修改範圍。

    TOOLS
    • Codex
    • rg
    • Git
    OUTPUT

    確認保留原有工具教學,主線改成個人實作故事。

  3. 02
    缺少的事實,會不會改變故事或公開方式?

    一次只問一題

    用需求訪談逐步確認核心觀點、案例篇幅、作品嵌入、口頭 Demo、已知限制與提問方式。

    TOOLS
    • Grill Me
    • 對話紀錄
    OUTPUT

    把模糊偏好變成可以實作、可以驗收的決定。

  4. 03
    怎麼避免做著做著又偏回工具展示?

    把討論寫成規格

    整理內容規格、資訊架構、案例定位、公開與私人內容分界、測試條件及建議提交順序。

    TOOLS
    • Markdown
    • Humanizer zh-TW
    OUTPUT

    docs/content-spec.md 成為內容與工程共同依據。

  5. 04
    正式站能不能穩定建置與輸出?

    先穩住工程底座

    集中品牌與路由設定,整理 Vinext/Vite 靜態匯出流程,修正 metadata、資產與快取設定。

    TOOLS
    • TypeScript
    • Vinext
    • Vite
    • Node.js
    OUTPUT

    同一份程式可以本機開發,也可以輸出成 Hugging Face Static Space。

  6. 05
    每個畫面能不能說明一個判斷?

    重寫故事與介面

    重排首頁敘事,讓 PDF、畢業學分與 00981A 分別對應停止、問題發現與可靠驗證;工具教學移到獨立頁。

    TOOLS
    • React 19
    • CSS
    • 內容規格
    OUTPUT

    案例不再只是作品列表,而是三次不同的決策。

  7. 06
    觀眾看到 Demo 時,會不會誤以為結果已被認證?

    把限制放進成品

    加入外部嵌入告知、桌機建議、學分審查限制、投資資訊免責與私人資料掃描。

    TOOLS
    • React 元件
    • Node test
    • 敏感資訊掃描
    OUTPUT

    限制不是藏在頁尾,而是放在使用者做決定之前。

  8. 07
    測試通過,是否等於公開網站真的可用?

    測試、部署、再從正式站重點一次

    執行型別、Lint、內容、靜態連結與瀏覽器測試;推送 GitHub 和 Hugging Face 後,再以正式網址操作。

    TOOLS
    • TypeScript
    • ESLint
    • Playwright
    • GitHub Actions
    • Hugging Face
    OUTPUT

    找出 Static Space 的無副檔名路由問題,修正後重新部署與點擊驗證。

03 / MY PRODUCTION LOGIC

先決定怎麼說,
才決定怎麼做。

這七個想法決定了內容順序、案例篇幅、Demo 方式與畫面。它們比逐題列出我回答過什麼更接近真正的製作過程。

  1. 01先講人的判斷

    AI 工具很快會普及,我想談的是怎麼找到問題、決定值不值得做,以及怎麼驗證。

    WHY

    如果首頁只列工具,觀眾記得的會是產品名稱,不是我真正想分享的工作方法。

    ON SITE

    首頁先放三次實作判斷,工具教學另開「工具實驗室」。

  2. 02案例不平均分配

    畢業學分與 00981A 是我會在現場完整 Demo 的核心;PDF 翻譯用來說明為什麼有些點子應該停。

    WHY

    每個專案的價值不同。硬把篇幅切成三等份,反而看不出我在哪裡投入最多判斷。

    ON SITE

    兩個核心案例有完整作品、限制與流程;PDF 案例保留停止理由。

  3. 03真實問題要有起點

    00981A 是我爸每天都要找資料、拉表格,問我能不能用 AI 處理之後,才慢慢做出來的。

    WHY

    這個背景比「我做了一套自動化」更能說明,為什麼我願意把流程做完整。

    ON SITE

    案例從家裡的重複工作開始,再往資料取得、比對、Excel、PDF 與寄送展開。

  4. 04作品要能直接操作

    我希望觀眾看到完整網站,不只是一張截圖;現場也會用自己的帳號操作。

    WHY

    真正的 Demo 才看得到流程,但外部服務、登入資料與適用範圍也必須先說清楚。

    ON SITE

    完整嵌入 Hugging Face Space,載入前顯示外部資料流、已知限制與桌機建議。

  5. 05原型不能假裝成熟

    畢業學分工具還可能有分類錯誤,尚未經教務處認證,也沒有適用所有學生。

    WHY

    把限制寫在成果後面,很容易讓觀眾先把原型誤認成正式系統。

    ON SITE

    限制放在載入按鈕之前,並明寫正式畢業資格仍以學校與系所審核為準。

  6. 06互動只做現場需要的事

    提問環節是帶大家停下來想一下,不需要輸入框,也不需要網站保存答案。

    WHY

    多一個可輸入功能,會把注意力從現場分享拉到操作表單。

    ON SITE

    留下 30 秒思考提示,移除輸入、複製與保存功能。

  7. 07保留原本的視覺性格

    我比較喜歡原來的大字、黑白灰與工作流畫面,不想為了改版換成另一套常見模板。

    WHY

    這套排版和分享主題本來就相合,真正需要改的是內容重心和局部互動。

    ON SITE

    沿用原設計系統,調整資訊層級、案例篇幅與 TempoTerm 動態,不重做品牌外觀。

04 / PROBLEMS WE HIT

遇到問題時,
先留下證據。

錯誤訊息只是表面。真正的修正要能說明原因,也要有一個會先失敗、修完再通過的檢查。

01已解決

正式站顯示 Entry not found

看到什麼
/lab 與 /tempo 在本機路由正常,部署到 Hugging Face 後卻是 404。
真正原因
Static Space 不會自動把無副檔名路徑解析成資料夾裡的 index.html。
怎麼處理
保留來源路由,公開導覽、canonical 與 sitemap 統一改成 /lab.html、/tempo.html。
如何確認
HTTP 200,再從首頁實際點擊兩個入口確認。
02持續注意

完整嵌入與登入資料風險

看到什麼
畢業學分網站需要登入,直接載入容易讓訪客忽略資料會送到外部 Space。
真正原因
主網站無法替另一個服務保證它如何處理帳密與修課資料。
怎麼處理
載入前顯示資料流與限制;使用者確認後才建立 iframe,並保留完整外部頁面。
如何確認
初始 HTML 不含 iframe;點擊後才載入指定 Hugging Face 網域。
03已解決

原始應用與靜態輸出不是同一種路由

看到什麼
開發環境使用 /lab,公開檔案則需要 lab.html 與 lab/index.html。
真正原因
應用路由與純靜態主機的檔案解析規則不同。
怎麼處理
用單一匯出腳本產生首頁、資料夾路由與相容別名,測試每個實際檔案都存在。
如何確認
靜態連結測試逐一解析 href 與 src 的目的地。
04持續注意

AI 很容易把未確認內容補得太完整

看到什麼
案例規則、正確率與隱私描述若只靠推測,會讓原型看起來比實際成熟。
真正原因
缺少資料時,流暢文字常讓不確定內容被誤認為事實。
怎麼處理
只使用訪談、素材與可檢查檔案;不確定的地方直接寫限制,不自行補數字。
如何確認
測試掃描未填欄位、誇大安全宣稱、敏感格式與必要免責文字。
05已解決

部署更新後,資產快取不能一起失效

看到什麼
每次同步靜態輸出都可能覆蓋 Hugging Face 專用設定,讓快取策略失效。
真正原因
部署資料夾同時包含建置產物和 Space repository 的控制檔。
怎麼處理
同步時保留 repository metadata,再驗證長效快取 header 仍存在。
如何確認
匯出測試確認 _headers 與 immutable 資產規則。
05 / TOOL LEDGER

每個工具,
都有明確任務。

這裡只列實際參與建站的工具,並寫清楚它做了什麼、留下什麼。Antigravity CLI、Skills 與 TempoTerm 是網站介紹的內容,不等於這次全部都有拿來建站。

  1. 01

    整理想法與需求

    Grill Me 一次追問一個會改變網站的問題;確認後整理成內容規格,再檢查繁中語氣。

    • Grill Me
    • 內容規格
    • Humanizer zh-TW
    留下什麼

    核心主張、案例權重、公開邊界與 docs/content-spec.md。

  2. 02

    盤點與修改程式

    Codex 讀取 repository、修改檔案並執行檢查;rg 找出路由與文案來源;Git 留下每次修改。

    • Codex Desktop
    • rg
    • Git
    留下什麼

    可追溯的程式變更、差異檢查與分段提交。

  3. 03

    建立網站介面

    React 組合案例與互動元件,TypeScript 管理資料結構,CSS 延續原本視覺,Vinext 與 Vite 負責建置。

    • React 19
    • TypeScript
    • Vinext
    • Vite
    • CSS
    留下什麼

    可在桌機與手機閱讀、可輸出成純靜態檔案的網站。

  4. 04

    檢查內容與操作

    檢查型別、程式品質、必要文案、靜態連結、敏感資訊與真實瀏覽器操作。

    • tsc
    • ESLint
    • Node test
    • Playwright
    留下什麼

    自動化測試結果、桌機與手機畫面,以及正式站點擊紀錄。

  5. 05

    建置與公開

    GitHub 保存原始碼並自動建置 Pages;同一份靜態輸出同步到 Hugging Face,最後用正式網址重測。

    • GitHub Actions
    • GitHub Pages
    • Hugging Face Static Space
    • HTTP
    留下什麼

    兩個公開網站、部署紀錄,以及主機路由問題的修正證據。

06 / TRACEABLE WORK

討論會改變。
Git 留下每次選擇。

規格、工程、內容、測試、視覺與正式站修正分開提交。回頭看紀錄時,可以知道每次改動在處理哪一件事。

git log --onelinePUBLIC REPOSITORY
  1. cf9220f把訪談整理成內容與實作規格
  2. 2f6b165穩定建置、路由與靜態匯出
  3. 2b96663加入個人歷程與三個案例
  4. c09a361擴充內容、匯出與瀏覽器驗證
  5. dede057恢復原本視覺並簡化提問環節
  6. ecd43b1修正 Hugging Face 公開頁面連結
這頁刻意沒有公開什麼?

帳號、密碼、Token、Cookie、真實學生資料、本機路徑,以及不公開的講者筆記。 「完整過程」指的是完整決策與驗證脈絡,不是把私人對話和敏感資料原封不動貼上網。

07 / WHAT I KEEP

這次我最想留下的,不是某個框架版本。

先把問題問清楚。
做完,再證明它真的能用。