快速開始 — Mock 模式¶

無需 Google 帳號、無 API 費用、無任何認證。

本文檔帶您完成基礎環境設定，並體驗 Time Compass 的三項核心功能。

Note

關於「執行」：本指南中的「執行指令」表示： 1. 複製下方框框內的完整指令 2. 貼到終端機中 3. 按下 Enter 鍵執行

準備工作¶

在開始前，請確認：

uv 是本專案的依賴管理工具。若已安裝，可直接跳到 Step 1.2。

開啟 PowerShell 終端機
執行安裝指令：
```
powershell -ExecutionPolicy ByPass -c "irm https://astral.sh/uv/install.ps1 | iex"
```
您會看到：終端機顯示安裝進度 (這步可能需要一點時間)
重啟 PowerShell 終端機（完全關閉再開啟）
驗證 uv 已安裝，執行：
```
uv --version
```
您會看到：類似 uv 0.4.0 的版本號(可能更高)
請切換到專案根目錄，執行：
```
uv sync
```
您會看到：終端機顯示下載與安裝進度

啟動本地排程規劃 Web 介面。

執行 Planner Studio：
```
uv run python scripts/run_planner_studio.py
```
您會看到：終端機顯示 Planner Studio 關鍵字、與可開啟的 URL
Ctrl+點擊 終端機輸出的 URL 開啟瀏覽器您會看到：終端機顯示類似以下內容：
```
✨ Planner Studio is LIVE with real data!
🔗 URL: http://127.0.0.1:8766/planner/dev-data-xxxxxxxxxx
```
Ctrl+點擊該網址，瀏覽器將自動開啟 Planner Studio 介面(或著手動複製到瀏覽器)
驗證 Mock 模式，確認：
✅ URL 路徑包含 dev-data-（表示 Mock 模式）
✅ 右側提示區域顯示「Mock 測試模式」
✅ 上方切換按鈕可切換多個排程方案（至少 5 種）
關閉服務，回到終端機、按 Ctrl+C 您會看到：服務停止，終端機恢復

✅ Planner Studio 體驗完成！

在 IDE（如 VS Code、Claude Desktop）中原生呼叫 MCP 工具。

下一站: 點擊👉 MCP 環境建置指南，內含安裝與體驗方法。