💻 AI NotebookLM v2 Windows 新環境部署與 AI 接力指南

本手冊引導您如何將專案移轉至 Windows 系統進行部署,並指引新環境的 AI 助理(Antigravity)如何自動化接力。

📂 1. Windows 本機環境準備

請確認您的 Windows 主機已安裝並設定妥當以下開發者工具:

  1. Python 3.10+:安裝時請務必勾選 Add Python.exe to PATH
  2. Node.js (LTS 版本):用於執行 clasp 與 Google Apps Script (GAS) 進行同步。
  3. Git:用於版本控制與下載最新的專案。

🛠️ 2. 專案解壓縮與目錄定位

  1. 將最新的專案壓縮檔 AI_NotebookLM_v3.01_Windows_Deploy.zip 解壓縮至您的 Windows 工作目錄(例如:D:\Workspace\AI_NotebookLM)。
  2. 使用 VS Code 開啟該資料夾,並開啟終端機(Terminal)。

📦 3. 安裝 Python 依賴套件

在終端機中,切換至 v2 目錄並執行:

cd v2
pip install -r requirements.txt
💡 註記:這會自動安裝 Flask、requests、openpyxl、google-genai 等執行本地伺服器所需的 Python 依賴。

🚀 4. 啟動 Windows 地端服務

在 Windows 檔案總管中,直接雙擊執行:

👉 v2/FALO_Runtime.bat

此批次檔會自動進行環境檢測,並在背景以 Port 8765 啟動地端 Python 伺服器,隨後會自動為您開啟瀏覽器載入主控制網頁(index.html)。

🤖 5. 致新環境 AI 助理 (Antigravity) 的接力指令

當您在 Windows 上啟動 Antigravity 時,請直接複製以下這段內容發送給它,它將會自動讀取核心檔案、檢測本地狀態並自動就緒:

<USER_REQUEST>
我們現在轉移到了 Windows 環境,這是一個 AI NotebookLM v2 專案。
請你:
1. 閱讀本地的 [windows_deployment_guide.md](file:///v2/docs/windows_deployment_guide.md) 理解 Windows 部署架構。
2. 閱讀 [student_guide.md](file:///v2/docs/student_guide.md) 與 [refactor_notes.md](file:///v2/docs/refactor_notes.md) 掌握核心業務邏輯。
3. 執行 v2/environment_check.py 驗證本地環境是否正常,並列出地端伺服器(runtime_server.py)的現行狀態。
4. 如果需要重新與 Google Apps Script (GAS) 對接,請教我如何使用 clasp 指令登入並推送。
</USER_REQUEST>

☁️ 6. 雲端 GAS 重新對接說明 (適用於開發者與 AI)

若在新 Windows 上需要更新雲端 GAS:

  1. 登入 clasp:clasp login
  2. 推送程式碼:clasp push
  3. 重新發行 Web App 部署:clasp deploy -i AKfycbw9X3Y6MQ2XpvsS9BXuCZeZsVkrbT1VL0JkDkotrbs-omYG8OpuWpAl1fowiJa_QW1i -d "v2.01版 Windows Deploy"
Falo x Force Cheng 2026/6/15