Codex 學習旅程｜Harper's Notes

核心原則

先把 Codex 當成一位很能幹但需要邊界清晰的協作者：它可以幫你寫、整理、分析、改網站、做文件，但你要知道它正在處理哪個文件夾、能不能改動重要資料、改完如何驗證。

清晰每個項目有固定位置、固定命名、固定輸出入口。

安全重要資料先備份，敏感資料少暴露，修改前知道影響範圍。

可追蹤 保留變更記錄、版本、教程和問答摘要。

可複用 把常用流程做成模板，下次不用重想一遍。

第 1 課：你的 Codex 用途地圖

Codex 對你最有價值的地方，不是單次幫忙，而是逐步變成一套個人工作系統。下面六類就是我們後續學習與實作的主線。

Harper's Notes 網站 管理 NAS 網站、發布新頁面、整理入口、備份和檢查改動。

孩子學習資料 整理筆記、題目、閱讀清單，也可以逐步開發學習輔導系統。

投資資料 處理報表、提取數據、核對持倉、生成摘要和可視化頁面。

文章與研究 收集資料、搭建提綱、整理引用、形成長文或研究筆記。

家庭資料庫 管理電影、音樂、書籍、生活記錄，讓資料有入口和更新流程。

職業知識 收集專業信息、建立主題檔案、做深入學習和定期複盤。

接下來我們會先把這六類拆成文件夾和項目邊界，再學如何安全地讓 Codex 讀、改、生成和發布內容。

建議的電腦文件夾部署

正式學習時，我們會一步步把你的 Codex 工作方式整理成幾個固定區域。

Projects：真正要長期維護的項目，例如 Harper's Notes、投資工具、家庭資料庫。
Inbox：臨時丟給 Codex 分析的文件，處理後要歸檔或刪除。
Exports：Codex 生成的文件、表格、簡報、圖片和網頁。
Backups：重要網站和數據的手動備份，尤其在大改之前使用。
Playground：允許 Codex 試驗的小沙盒，不放唯一重要資料。

第一課建議從「如何建立安全的 Codex 工作區」開始，先把日常文件和長期項目分開。

第 2 課：文件夾應該放在哪裡？

不同項目可以分散在本機、NAS、iCloud Drive、OneDrive 等位置，但每個長期項目都應該有一個清楚的「主目錄」。主目錄是 Codex、其他 AI 工具和你自己共同認定的工作入口。

本機硬盤 適合正在開發、需要頻繁修改、需要速度和穩定性的項目。

NAS 適合網站發布、家庭共享資料、媒體庫和長期保存內容。

iCloud / OneDrive 適合文檔同步和跨設備閱讀，不建議作為高頻代碼修改的唯一工作區。

工作沙盒 適合讓 AI 先試驗、生成草稿、整理臨時文件，再人工或自動發布。

Harper 網站的建議模式

Harper 網站目前位於掛載到本機的 NAS 盤，並由 Codex、Openclaw、Hermes 等工具共同維護。這種模式可行，但建議把它視為「發布區」，不要把所有試驗都直接做在發布區。

發布區：保留 `/Volumes/web/harper/` 作為網站正式運行位置。
工作區：在本機建立一個 Harper 網站工作副本，用來讓 AI 試改、整理和預覽。
備份區：每次大改前，把關鍵文件或整個網站做一份有日期的備份。
交接記錄：多個 AI 工具共同維護時，要保留最近改了什麼、誰改的、為什麼改。

簡單說：NAS 可以是共同工作區，但更理想的是「本機先工作、檢查後發布到 NAS」。這樣速度更快，也更容易回滾。

第 3 課：Harper 網站本機工作區

Harper 網站已經有正式運行中的 NAS 站點。下一步不是直接大改正式站，而是在本機建立一個共享 AI 工作區，讓 Codex、Openclaw、Hermes 可以在同一套規則下協作。

已建立本機工作區：
/Users/nick/Documents/Codex/AI-Workspaces/harper-site-workspace/

目前結構

site/：從 NAS 複製出的輕量網站副本，用來安全試改。
drafts/：草稿、試驗內容和臨時整理。
exports/：準備發布或交付的完成品。
backups/：重要修改前的本機備份。
handoff-log/：多 AI 協作時的交接記錄。
scripts/：同步、備份和發布輔助腳本。

副本策略

正式 NAS 站點約 943MB，其中大部分是音樂文件。工作區目前採用輕量副本，只複製網站可維護部分，排除大型媒體文件、回收站和舊歸檔。

保留首頁、PHP 文件、筆記、專題頁、小型資源。
排除 music/files/，避免把大量媒體文件拉進工作區。
排除 _trash/ 和 _archive/，避免舊文件干擾日常維護。
正式發布仍以 /Volumes/web/harper/ 為準。

第 4 課：從本機安全發布到 NAS

Harper 網站現在有兩個位置：本機工作區用來準備修改，NAS 正式站用來對外運行。安全發布的核心，是不要直接跳到最後一步，而是固定走「備份 → 預演 → 發布 → 記錄」。

先備份正式站大改前，把 NAS 上目前可運行的版本保存到本機備份區。

預演發布先列出將會新增或覆蓋哪些文件，不真正改動 NAS。

正式發布確認文件列表合理後，再把本機工作區的成果同步到 NAS。

寫交接記錄記下改了什麼、為什麼改、如何檢查，方便多 AI 工具接手。

已建立的輔助腳本

backup-live-site.sh：把 NAS 正式站的輕量版本備份到本機。
publish-to-nas-dry-run.sh：預演發布，顯示將要變更的文件。
publish-to-nas.sh：正式發布本機 site/ 到 NAS。

正式發布腳本目前不會自動刪除 NAS 上的文件。刪除屬於高風險操作，應該單獨列出、單獨確認。

第 5 課：發布前如何檢查

工作區的價值，不只是「有一份副本」，而是讓每次發布前都有機會檢查。對 Harper 網站來說，檢查可以分成四層：自動檢查、差異預覽、人工確認、發布後復查。

自動檢查確認首頁、筆記、Codex 學習頁等關鍵文件都存在。

差異預覽發布前先看本機工作區和 NAS 正式站之間會有哪些變更。

人工確認重要頁面要打開看看，確認入口、文字和排版沒有明顯錯誤。

發布後復查同步到 NAS 後，再確認正式站上的頁面和入口都正常。

已建立的檢查腳本

check-workspace.sh：檢查本機工作區的關鍵文件、目錄和 Codex 學習入口。
compare-with-live.sh：比較本機工作區與 NAS 正式站，預覽將會變更的文件。

目前本機沒有可用的 PHP 命令，所以完整 PHP 預覽暫時不是基礎流程。之後如果安裝 PHP，我們可以加上本機預覽伺服器。

第 6 課：多 AI 協作交接規則

Harper 網站可能同時由 Codex、Openclaw、Hermes 和你自己維護。這種模式可以成立，但需要一個共同習慣：每次接手前先看狀態，每次重要修改後留下交接。

先讀狀態 進入工作區後，先讀 README 和 PROJECT_STATUS，了解目前規則。

再看交接 查看 handoff-log 裡最新記錄，避免重複工作或覆蓋別人的修改。

小步修改 一次只做一個清楚目標，改完就檢查，不把多件事混在一起。

留下記錄 重要修改後說清楚改了什麼、檢查了什麼、下一步是什麼。

已建立的交接文件

PROJECT_STATUS.md：目前項目狀態、規則、限制和下一步。
handoff-log/TEMPLATE.md：交接記錄模板。
handoff-log/：每次重要修改後存放記錄。

給其他 AI 的一句話：請先閱讀 Harper 工作區的 README.md、PROJECT_STATUS.md 和 handoff-log 最新記錄，再開始修改。

第 7 課：本機工作區才是修改源頭

這一課來自一次真實糾錯：之前 Codex 學習頁的第 4 至第 6 課被先寫在臨時目錄，再直接發布到 NAS，沒有同步回 Harper 本機工作區。這不符合我們剛建立的安全流程。

修正後的規則：所有 Harper 網站相關修改，先進入本機工作區 site/，再從本機工作區發布到 NAS。

正確流程

修改源頭：`/Users/nick/Documents/Codex/AI-Workspaces/harper-site-workspace/site/`
正式發布：`/Volumes/web/harper/`
臨時目錄：只能作為草稿或過渡，不作為長期源頭。
每次發布前：確認本機工作區版本是最新版本。

這次修正

已把最新 Codex 學習頁同步回本機工作區。
已新增 `scripts/publish-codex-learning.sh`，專門從本機工作區發布學習頁到 NAS。
已新增交接記錄，說明這次流程偏差和修正方式。

第 8 課：把學習項目和案例項目分開

這次學習旅程一開始是為了系統學 Codex，但因為 Harper 網站是一個真實場景，我們很快深入到網站工作區、發布流程和多 AI 協作。這是好案例，但它不應該吞掉整個 Codex 學習項目。

Codex 學習項目 負責課程、方法、模板、問答整理和通用工作方式。

Harper 網站項目 負責網站本體、NAS 發布、頁面維護和網站交接記錄。

案例關係 Harper 網站是 Codex 學習的第一個實戰案例，不是整個學習項目。

發布關係 Codex 學習內容先在學習項目中維護，再發布到 Harper 網站展示。

新的主項目位置

Codex 學習總項目：`/Users/nick/Documents/Codex/AI-Workspaces/codex-learning/`
Harper 網站項目：`/Users/nick/Documents/Codex/AI-Workspaces/harper-site-workspace/`
Codex 學習發布頁：`/Volumes/web/harper/codex-learning/`

修正後：Codex 學習內容的源頭是 `codex-learning/`，Harper 網站只是發布目的地和第一個案例。

第 9 課：項目分類模板

在讓 Codex 建立、整理、發布或分析一個長期項目前，先判斷它是哪一類項目。分類不是為了貼標籤，而是為了決定源頭在哪裡、輸出去哪裡、哪些內容可以讓 AI 改、哪些內容需要先備份或確認。

學習項目 保存課程、筆記、案例、模板和練習記錄，例如 Codex 學習總項目。

網站項目 維護網站源文件、發布腳本、備份和正式頁面，例如 Harper's Notes。

數據項目 處理表格、原始數據、清洗結果、報告和圖表，例如投資資料。

研究項目 整理資料來源、閱讀筆記、提綱、引用和長文草稿。

媒體／資料庫項目 管理電影、音樂、書籍、家庭資料和索引，不把大型媒體混進小型代碼工作區。

職業知識項目 沉澱專業主題、常用流程、參考資料、檢查清單和定期複盤。

分類時問七個問題

這個項目要保存什麼，或產出什麼？
Codex 應該先改哪個位置，也就是唯一源頭在哪裡？
完成品應該發布或共享到哪裡？
哪些文件可以讓 Codex 直接修改？
哪些文件修改前需要備份、預演或人工確認？
改完後要用什麼方式檢查結果？
下一個 AI 或未來的自己接手前，必須先讀什麼？

已新增模板：`templates/project-classification.md`。下一步練習：先套用在 Codex 學習項目，再套用在 Harper 網站項目。

第 10 課：新項目啟動流程

建立新項目時，不要從隨機空白文件夾或大批量搬文件開始。更穩的方式，是先用一段啟動提示詞讓 Codex 讀取新項目指引，確定項目位置、分類、安全邊界和第一個小任務。

啟動提示詞已放在：
/Users/nick/Documents/Codex/NEW_PROJECT_STARTER_PROMPT.md

標準順序

先說項目想法用普通話描述你要保存、整理或產出的內容。

讀取新項目指引讓 Codex 先讀 `templates/new-project-guide.md`，不要憑記憶開工。

起草分類文件先生成 `project-classification.md`，確認源頭、輸出、可改範圍和檢查方式。

建立最小結構確認後再建 README、PROJECT_STATUS、分類文件和 handoff-log。

只做一個小任務例如建立文件索引、寫第一版 README，或整理一個安全樣本。

統一位置

長期 Codex 項目建議統一放在：

/Users/nick/Documents/Codex/AI-Workspaces/

這樣就不會因為直接新建空白項目而散落到 Documents 根目錄，也方便未來在 Codex App 中指定已有文件夾作為工作區。

最小項目結構

README.md：說明這個項目是什麼、不是什麼、接手前要讀什麼。
PROJECT_STATUS.md：記錄當前狀態、規則、風險和下一步。
project-classification.md：定義項目類型、唯一源頭、輸出位置和 AI 安全邊界。
handoff-log/：保存重要修改、發布和交接記錄。

已新增檢查清單：`templates/new-project-startup-checklist.md`。下一步可以選一個真實候選項目，只做分類草稿，不搬動真實資料。

第 11 課：投資資料項目干跑

這一課把新項目啟動流程套用到第一個真實候選項目：投資資料。因為投資資料可能包含帳戶、持倉、交易、稅務和身份信息，所以第一步只做分類草稿，不讀取、不搬移、不整理任何真實財務文件。

已新增草稿：`notes/project-classification-investment-data-draft.md`

為什麼先干跑

投資資料是數據項目，但可能連到研究筆記、專業知識和報告輸出。
原始券商文件、稅務記錄和帳戶資料不應該在沒有邊界時交給 AI 處理。
先定義唯一源頭、輸出位置、備份位置和檢查方式，再決定是否建立真實工作區。
先用假數據和樣本格式設計流程，確認安全後再處理真實資料。

建議項目位置

/Users/nick/Documents/Codex/AI-Workspaces/investment-data-workspace/

最小結構

README.md：說明投資資料項目的目標和不能做的事。
PROJECT_STATUS.md：記錄目前是否允許引入真實資料。
project-classification.md：明確 AI 可讀、可改、不可碰的範圍。
handoff-log/：記錄每次引入資料、生成報告或修改流程的原因和檢查結果。

第一個安全任務

確認是否真的建立投資資料工作區。即使建立，也先用假數據設計資料字典和報告模板，不直接處理原始帳戶文件。

第 12 課：Codex 任務說明模板

從這一課開始，學習路線回到更通用的 Codex 使用能力。不是每一個未來項目都要單獨做成教程；更重要的是學會把任何模糊需求，轉成 Codex 可以安全執行、可以驗證、可以交接的任務說明。

已新增模板：`templates/codex-task-brief-template.md`

五個必填部分

目標說清楚要完成的結果，而不只是「整理一下」或「幫我弄一下」。

工作位置 指定項目文件夾或具體文件，避免 Codex 在錯誤位置工作。

可改範圍 說明哪些文件可以改，哪些只能讀，哪些不能碰。

輸出要求 說明要生成 Markdown、網頁、表格、腳本、摘要還是檢查清單。

檢查方式 要求 Codex 說明如何確認文件存在、鏈接正常、腳本通過或內容完整。

交接要求 如果任務會延續，要求更新 PROJECT_STATUS 或 handoff-log。

一句話原則

如果你想說「幫我弄一下」，先補四句：在哪裡工作、能改什麼、產出什麼、怎麼檢查。

第 13 課：動手前審閱 Codex 的計劃

任務說明解決的是「我要什麼」，計劃審閱解決的是「Codex 準備怎麼做」。對重要文件、多步任務、發布、搬移、刪除和敏感資料來說，審閱計劃比事後補救輕鬆得多。

已新增清單：`templates/codex-plan-review-checklist.md`

什麼時候先要計劃

任務可能修改很多文件。
任務可能搬移、重命名、覆蓋或刪除文件。
任務涉及 NAS、正式網站、財務資料、家庭記錄或專業歸檔。
任務會改變項目結構或新增自動化腳本。
任務可能由另一個 AI 或未來的自己接手。

好計劃要說清楚

先看什麼 列出要檢查的文件和目錄。

會改什麼 列出可能修改的文件，不把範圍說得太泛。

不碰什麼 明確保護正式站、原始資料、敏感文件和不相關目錄。

怎麼檢查 說明完成後用搜索、預覽、腳本或人工核對來驗證。

常用提示詞

「請先給我一個執行計劃，不要馬上修改文件。計劃裡請說明你會檢查什麼、可能修改什麼、不會碰什麼、執行順序、檢查方式，以及哪些步驟需要我確認。」

一句話原則：重要任務不是只批准目標，而是批准計劃。

第 14 課：Codex 改完後如何驗證文件變化

不要只停在「Codex 說完成了」。重要任務完成後，要確認三件事：改了什麼、預期結果是否真的出現、是否有意外改動。這一步能把 AI 協作從「相信回覆」變成「檢查結果」。

已新增清單：`templates/codex-change-verification-checklist.md`

五層驗證

文件存在 確認新文件或輸出在正確文件夾，名稱正確。

內容搜索 用關鍵詞、標題、錨點或鏈接確認內容真的寫進去了。

改動摘要 讓 Codex 列出修改了哪些文件、每個文件改了什麼。

功能檢查 網站要預覽，腳本要運行，表格要核對，發布頁要復查。

安全檢查 確認沒有未批准的刪除、搬移、覆蓋、發布或敏感文件讀取。

未驗證項 要求 Codex 說清楚哪些地方沒有檢查，留下的風險是什麼。

常用提示詞

「請驗證剛才的修改，告訴我修改了哪些文件、每個文件主要改了什麼、你用什麼方式確認改動已經生效、哪些地方沒有驗證，以及是否有意外改動或剩餘風險。」

一句話原則：重要任務的最後回覆應該包含 Changed、Verified、Not verified 和 Next。

安全使用守則

讓 Codex 修改網站或資料前，先說明目標、位置和不能碰的範圍。
涉及 NAS、網站、財務、家庭資料時，先建立備份或只做小步修改。
不要把密碼、私鑰、完整身份資料直接貼進聊天。
大批量刪除、搬移、覆蓋文件前，要求 Codex 先列出將要操作的文件。
每次重要修改後，要求它說明改了什麼、如何驗證、還有什麼風險。

學習路線

整理工作區建立清晰文件夾、命名規則和備份習慣。

學會提出任務把「幫我弄一下」變成 Codex 能準確執行的需求。

安全修改網站學會預覽、備份、發布、回滾和記錄。

建立個人知識庫把問答、教程和工作成果定期整理成網頁。

進階自動化讓 Codex 幫你做定期整理、檢查和提醒。

更新記錄

2026-05-31 · 第 14 課

新增改動後驗證流程：確認改了哪些文件、預期內容是否存在、是否有意外改動、功能是否正常，以及哪些地方尚未驗證。新增改動驗證清單。

2026-05-30 · 第 13 課

新增動手前計劃審閱：重要任務先看 Codex 準備檢查什麼、修改什麼、不碰什麼、按什麼順序做，以及如何驗證。新增計劃審閱清單。

2026-05-30 · 第 12 課

回到通用教程路線，新增 Codex 任務說明模板。後續重點不再是為每個計劃項目各做一課，而是學會目標、位置、範圍、輸出、檢查和交接這套通用任務表達方式。

2026-05-30 · 第 11 課

新增投資資料項目干跑：先建立分類草稿，明確原始財務文件、帳戶資料和稅務記錄的安全邊界；下一步只決定是否建立真實工作區，不處理真實投資資料。

2026-05-30 · 第 10 課

新增新項目啟動流程：先使用根目錄啟動提示詞，讓 Codex 讀取新項目指引，統一把長期項目建立在 AI-Workspaces 下，先分類、再建最小結構、最後只做一個小任務。

2026-05-30 · 第 9 課

新增項目分類模板，將長期項目分為學習、網站、數據、研究、媒體／資料庫和職業知識六類。分類後再決定源頭、輸出、AI 可修改範圍、檢查方式和交接規則。

2026-05-30 · 第 8 課

建立獨立的 Codex 學習總項目：`/Users/nick/Documents/Codex/AI-Workspaces/codex-learning/`。Harper 網站被定位為第一個實戰案例和發布展示渠道，而不是整個學習項目本身。

2026-05-30 · 第 7 課

修正 Codex 學習頁更新流程：本機工作區 `site/` 才是 Harper 網站修改源頭，NAS 是發布區。已同步最新學習頁回工作區，並新增 `publish-codex-learning.sh`。

2026-05-30 · 第 6 課

建立多 AI 協作交接規則。新增 `PROJECT_STATUS.md`、`handoff-log/TEMPLATE.md` 和交接記錄，讓 Codex、Openclaw、Hermes 接手前有共同上下文。

2026-05-30 · 第 5 課

新增發布前檢查流程：自動檢查、差異預覽、人工確認、發布後復查。新增 `check-workspace.sh` 和 `compare-with-live.sh`，目前工作區檢查已通過。

2026-05-30 · 第 4 課

建立 Harper 網站安全發布流程：備份正式站、預演發布、正式發布、寫交接記錄。新增三個輔助腳本，並採用不自動刪除 NAS 文件的保守發布策略。

2026-05-30 · 第 3 課

建立 Harper 網站本機共享 AI 工作區，位置為 `/Users/nick/Documents/Codex/AI-Workspaces/harper-site-workspace/`。已複製輕量網站副本，並加入 README、交接記錄和刷新腳本。

2026-05-30 · 第 2 課

整理文件夾存放位置策略：項目可以分散在本機、NAS 和雲盤，但每個長期項目要有清楚主目錄。Harper 網站建議採用「本機工作區 + NAS 發布區 + 備份區 + 交接記錄」模式。

2026-05-30 · 第 1 課

確認 Codex 的六個核心用途：Harper's Notes 網站、孩子學習資料、投資資料、文章研究、家庭資料庫、職業知識。後續課程會圍繞這些真實場景展開。

2026-05-30

建立 Codex 學習旅程初始頁。下一步：規劃本機文件夾、NAS 網站發布流程與安全備份規則。