Cosmic-light

Cosmic-light 是什麼？

Cosmic-light 是 Windows「Dynamic Island」控制中心，將一目了然的狀態、媒體控制、天氣視覺化、行事曆事件與 AI 聊天介面整合至單一螢幕 UI。介面從桌面上的「島嶼」元素展開，並設計為在需要時呈現相關資訊。

專案建置為本機優先應用程式：使用本機儲存來保存對話脈絡，並加密 AI 功能的 API 金鑰。它也包含 system-bridge Python 腳本，用以存取媒體與天氣等資料。

Dynamic Island UI（底部或中間）：將島嶼置於螢幕上，並在互動時智慧展開。
一目了然首頁檢視：顯示時間、日期與目前活躍視窗狀態。
媒體控制與 Spotify/系統音訊整合：提供播放/暫停/下一首/上一首與音量控制，包含即時音訊視覺化與曲目中繼資料（含專輯封面與進度）。
智慧媒體圖示：偵測輸入來源（例如 Spotify、YouTube、Chrome）與輸出裝置（例如耳機、喇叭）。
即時天氣視覺化：呈現即時粒子效果（雨、雪、雲、星星），並顯示溫度、風速、濕度與降雨機率等數據，包含警示式惡劣天氣通知。
智慧行事曆與 Google Calendar 同步：使用 iCal 隱密網址同步事件，事件開始前 5 分鐘自動展開島嶼，並包含互動式月曆檢視。
AI 聊天（本機優先）：內建聊天介面，包含「Gemini Mode」（Google Gemini）與「Perplexity Mode」（網路搜尋帶引用/來源）。對話記錄儲存於本機。
加密 API 金鑰：加密設定中新增的 API 金鑰，提升安全性。

安裝先決條件：使用 Node.js v20+ 與 Python v3.10+。
設定專案：
- 複製儲存庫。
- 使用 npm install 安裝前端依賴。
- 使用 pip install -r requirements.txt 安裝後端依賴。
本機執行：使用 npm run dev 啟動應用程式。
開啟與設定：
- 點擊 Dynamic Island 展開它。
- 使用 Settings（齒輪圖示）設定 AI API 金鑰（Gemini 和/或 Perplexity）與 Google Calendar 同步。
（選用）建置安裝程式：執行 npm run build 以產生獨立 Windows .exe，安裝程式置於 release/ 目錄。

執行 Cosmic-light 需要什麼？ 應用程式需要 Node.js v20 或更高版本，系統橋接腳本需要 Python v3.10 或更高版本。
如何啟用 AI 聊天功能？ 開啟應用程式設定並新增您的 Gemini API Key 和/或 Perplexity API Key。專案註明至少需啟用其中一個。
Google Calendar 同步如何運作？ 在 Google Calendar 設定中產生或複製「iCal 隱密網址」（iCal 格式），並貼至應用程式的 Settings > Google Calendar。
資料儲存位置？ 專案採用 本機優先 方式：對話記錄儲存於本機，設定中新增的 API 金鑰會加密。
能否變更島嶼位置？ 可以。設定包含定位選項，可將島嶼置於螢幕 底部或中央，並支援選擇島嶼顯示的顯示器。

系統級小工具框架：改用桌面小工具/啟動器系統，在螢幕上彙整小工具（天氣、行事曆、媒體）；工作流程不同，因為展開行為與「島嶼」呈現可能非內建。
媒體控制器應用程式：專用媒體控制工具可提供播放與音量控制加上視覺化效果，但可能不包含相同天氣/行事曆/AI 整合佈局。
行事曆 + 天氣桌面整合：獨立行事曆與天氣整合專注於特定資料來源；通常不會將 AI 聊天介面與 Dynamic Island 展開模式整合成單一控制中心。
本機聊天機器人應用程式：通用聊天客戶端或本機 AI 前端可取代島嶼的 AI 面板，但會失去島嶼整合的行事曆/媒體/天氣 UI 脈絡。