開源人工智慧工作空間平臺

Overlay 是一個開源的 AI 工作空間應用，整合多個最先進的模型提供者，核心特色是能讓使用者與最優秀的模型互動，並以單鍵設置 OpenClaw 雲端實例。該專案基於 Next.js 和 Convex 建構，結合公開行銷網站與認證後的 AI 工作區，已開源供社群貢獻。

核心功能模組

Overlay 圍繞聊天、筆記、記憶、知識庫、專案、媒體生成與托管電腦工作流等核心功能設計：

• 與多個模型提供者的聊天互動
• 筆記、記憶、檔案與專案語境的存取與管理
• 「Ask」與「Act」工作流，支援工具呼叫能力
• 影像與影片生成
• 透過 Composio 整合外部工具
• 使用 Stripe 管理訂閱與授權
• 托管電腦工作階段的佈建與互動

技術堆疊與架構

應用採用 Next.js 15（App Router）搭配 Convex 後端，提供即時狀態管理與伺服器端整合。認證透過 WorkOS、計費由 Stripe 處理，AI 能力由 Vercel AI SDK 及 OpenAI、Anthropic、Google、Groq、xAI 與 OpenRouter 等提供者 SDK 驅動。文件編輯與轉譯使用 TipTap、react-markdown 與 KaTeX，確保豐富的內容編輯與渲染體驗。

儲存庫結構清晰，包含 convex/ 後端邏輯、src/app/ Next.js 頁面與 API 路由、src/components/ UI 元件、src/lib/ 共用程式碼（認證、模型、工具、Stripe 輔助函式）。

應用介面與工作流

認證後的應用涵蓋 /app/chat、/app/notes、/app/memories、/app/knowledge、/app/projects、/app/outputs、/app/integrations、/app/voice 與 /app/computer 等專用頁面。「Ask」與「Act」工作流整合多層工具：Overlay 原生工具、Composio 工具整合，以及啟用時的 AI Gateway 與 Perplexity 搜尋。模型目錄支援文字聊天、影像生成與影片生成模型，並標記推理、視覺、搜尋與成本等能力元資料。

開發環境與部署

專案要求 Node.js 20+，使用分離的 Convex 開發與正式環境。本地開發需配置環境變數（WorkOS、Stripe 測試憑證），後端變更需同時推送至兩個 Convex 部署以保持同步。提供完整的命令集支援開發伺服器運行、生產構建、程式碼檢查與模型路由驗證。

安全性設計

儲存庫實踐嚴格的安全政策：工作階段 cookie 經加密與簽署、傳輸 token 採短效期且加密儲存、提供者密鑰匯出隔離在專用環境變數後、電腦佈建要求明確的 SSH 密鑰與允許 CIDR 配置。聊天與電腦等高風險介面的敏感日誌被標記隱藏。GitHub Actions 整合 gitleaks 進行密鑰掃描，並阻止看起來含有密鑰的 NEXT_PUBLIC_* 變數。使用者提供的 systemPrompt 被視為低優先級擴展，無法覆蓋操作員指令。

開發與貢獻預期

專案聲明處於活躍演進階段，預期產品特定架構、認證、計費與工具整合將隨著系統強化與更廣泛開源協作準備而變化。貢獻者應避免提交實際密鑰、token 或客戶資料，公開文件應保持預留位置，並理解 NEXT_PUBLIC_* 值為公開內容。新增後端邏輯應優先在 convex/ 中實現，對應 web 處理器在 src/app/api/ 中。