💻 AI NotebookLM v2 Windows 新環境部署與 AI 接力指南
本手冊引導您如何將專案移轉至 Windows 系統進行部署,並指引新環境的 AI 助理(Antigravity)如何自動化接力。
📂 1. Windows 本機環境準備
請確認您的 Windows 主機已安裝並設定妥當以下開發者工具:
- Python 3.10+:安裝時請務必勾選
Add Python.exe to PATH。 - Node.js (LTS 版本):用於執行
clasp與 Google Apps Script (GAS) 進行同步。 - Git:用於版本控制與下載最新的專案。
🛠️ 2. 專案解壓縮與目錄定位
- 將最新的專案壓縮檔
AI_NotebookLM_v3.01_Windows_Deploy.zip解壓縮至您的 Windows 工作目錄(例如:D:\Workspace\AI_NotebookLM)。 - 使用 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:
- 登入 clasp:
clasp login - 推送程式碼:
clasp push - 重新發行 Web App 部署:
clasp deploy -i AKfycbw9X3Y6MQ2XpvsS9BXuCZeZsVkrbT1VL0JkDkotrbs-omYG8OpuWpAl1fowiJa_QW1i -d "v2.01版 Windows Deploy"