第 12 站維護區v2 階段：回到教師決定的循環閘門：老師核定
維護與交接
Codex｜維護與交接
每一輪更新的最後一站：比對來源、只更新受影響的副本、讀回確認，再把交接寫下來，讓下一輪照同一套規則走。
這一站在整條流程的位置
本站：第 12 站，屬於維護區。
相連的站：沒有從其他站進來的線；資料往第 04、06、07 站去。
維護區：每一輪更新的最後，在這一區比對、更新、讀回並寫下交接，讓下一輪沿用同一套規則。
老師的決定
哪些更新可以進入正式使用，以及遇到缺漏時，要在哪裡停下來。
為什麼要這樣分
這樣做，可以把「改了什麼」「哪些副本過期了」「下次怎麼接手」，變成查得到的紀錄。
這一站的界線
地圖把整個結構都畫了出來，但這不代表所有服務都已經全自動，也不代表所有待辦都已經通過。
紀錄說明2026-09-13 的維護結果是 no-op（這一輪檢查後沒有需要改的內容，所以什麼都沒有寫入）；還沒核准的候選版本，沒有拿去覆寫既有的雲端硬碟副本。
工具做的事
這一站由誰動手、各做什麼：
- 老師
核准版本、處理衝突，決定下一輪要做什麼。
- Agent
比對來源，維護檔案 ID 與來源 ID 這兩種編號，再檢查、更新，最後讀回確認。
Agent 是會依照指示自己讀檔案、寫檔案、執行程式的 AI 工具；v2 稱為 Coding Agent，例如 Codex。
- ChatGPT
依照新的交接紀錄，繼續備課與其他簡單的工作。
- 讀進來的資料
- 工作規則、來源登錄、原稿版本、核准狀態，以及上一次的交接。
- 寫出來的成果
- 受影響的閱讀副本、筆記本來源的狀態、變更紀錄與 HANDOFF.md（交接紀錄）。
- 最後的結果
- 工具做完工作後，結果交回老師檢視，再成為下一輪工作的依據。
留下的檔案
v2 標示的位置：Textbook/01_sources/notebooklm/。下表每一列是一個資料夾、檔案、平台紀錄或閘門；縮排的列，屬於上一個資料夾或項目。
| 名稱 | 類型 | 白話說明 |
|---|---|---|
notebooklm_source_registry.csv位置：Textbook/01_sources/notebooklm/notebooklm_source_registry.csv | 檔案 | 來源登錄表是一個 CSV（可以用試算表打開的純文字表格）檔，對照正式來源、雲端硬碟的檔案 ID（雲端硬碟替每個檔案編的固定編號；檔案內容改了，編號不變）、筆記本的來源 ID（筆記本替每一筆來源編的編號，和雲端硬碟的檔案 ID 是兩個不同的編號）、版本與狀態。 |
notebooklm_drive_source_manifest.csv位置：Textbook/01_sources/notebooklm/notebooklm_drive_source_manifest.csv | 檔案 | 每週來源的清單：文件 ID、SHA-256 雜湊值（由檔案內容算出來的一串「指紋」，內容只要改一個字，指紋就不同）、字數，以及最近一次同步的時間。 |
maintenance-run.json位置：Textbook/01_sources/notebooklm/maintenance-run.json | 檔案 | 這一輪執行的結果，存成 JSON（程式常用的資料紀錄格式；JSONL 是一行一筆紀錄的版本）檔。沒有變更時，只留下 no-op 的紀錄，不必產生重複的文件。 |
maintenance-change-log.jsonl位置：Textbook/01_sources/notebooklm/maintenance-change-log.jsonl | 檔案 | 逐次的變更紀錄，一行一筆，讓之後的工作知道哪些內容已經更新。 |
老師核准與來源衝突檢查v2 名稱：教師核准／來源衝突檢查 | 閘門 | 如果目前沒有老師的核准，就保留既有的閱讀副本，不做更新。 |
用 MCP 列出、更新、讀回來源v2 名稱：MCP：列出 → 更新 → 讀回 | 平台或工具 | 依已授權的範圍，用 MCP（讓 AI 工具可以操作其他服務的一種連接方式。用在筆記本上的是社群開發的非官方工具，依賴沒有公開的介面；Google 官方提供給程式使用的筆記本介面，也就是 API，目前只開放給企業版）列出來源、更新，再讀回確認。這份地圖只做說明，不會實際執行 MCP 操作。 |
| Textbook/HANDOFF.md | 檔案 | 正式記錄完成了什麼、還沒完成什麼，以及下一道閘門在哪裡。 |
從哪裡來、往哪裡去
從哪裡來
地圖上沒有從其他站進來的線。
往哪裡去
往 第 06 站 雲端硬碟閱讀副本「受控更新」（授權後的操作）
先比對內容與核准狀態；更新時，仍然沿用同一個雲端硬碟檔案 ID。
往 第 07 站 Gemini Notebook 助教「MCP／刷新／讀回」（來源 ID 對應）
依照筆記本的來源 ID 操作來源，檢查內容是不是最新、有沒有重複，再留下交接紀錄。
往 第 04 站 教材原稿「比對正式原稿」（取用來源）
負責維護的一方讀取正式原稿與來源登錄；副本沒有經過審查，不能自動覆蓋正式原稿。
首頁列出的三條路徑（「一份週教材」、「一份課堂逐字稿」、「一輪分組與互評」）都沒有經過這一站。
深入看
下面的連結會另開分頁，前往 v2 已經發布的實例頁。實例頁保留原文，有些是英文或程式碼。
來源登錄表（CSV）全文・去識別
同一列對應來源代號、雲端硬碟文件、筆記本來源、檔案位置、語言、雜湊值與狀態。表中的 approved 欄位，不能單獨用來判斷教材已經獲得老師正式核准。
產生閱讀副本的程式（Python）全文・去識別
把每週原稿、詞彙表、評量與資源整理成閱讀副本，排除只給老師看的段落，並保留既有的 ID 欄位。這支程式不負責登入、寫入 Google 文件或同步筆記本。
一次維護工作的完整紀錄（JSON）全文・去識別
2026-09-13 實際一次執行的讀回、差異、核准、同步與下一步；可以分辨「檢查完成」和「真的寫入」的差別。
維護變更紀錄（JSONL）全文・去識別
一行一筆事件：來源更新、清理，以及沒有變更時的歷程，讓下一次接手的 Agent 知道發生過什麼。
教材專案的最新交接節錄（原檔第 1–75 行）
前段記錄最新的維護、來源與核准狀態，示範下一次工作先讀什麼、哪些事情仍然不能做。
第 1 週：交給下一個審查 Agent 的指令全文・去識別
十二項具體的檢查指令，包括核對主張、字數、No AI 規則、英文文風，以及不能自行放行。
筆記本來源更新：操作與維護紀錄全文・去識別
說明雲端硬碟檔案 ID 和筆記本來源 ID 的差別、單向更新來源的做法、更新步驟、衝突處理與讀回。
收錄範圍說明
- notebooklm_drive_source_manifest.csv：「深入看」提供的是實際產生這份清單的程式，以及相關的完整來源登錄表；這兩種登錄檔不是同一個檔案。