TeamSync AI Desktop

桌面版使用量監控工具,透過 Magic Link 登入後顯示 /portal/api/usage/series 數據。

最快上手

npx aihub-desktop

第一次執行會自動下載 Electron runtime(~100MB,放在 npm cache),之後啟動約 1 秒內。

或全域安裝後直接執行:

npm install -g aihub-desktop
aihub-desktop

開發模式(clone repo 改 code)

# 安裝依賴
npm install

# 開發模式執行
npm start

# 打包成安裝檔(.exe / .dmg / AppImage)
npm run dist        # 會產生 dist/ 資料夾

檔案結構

aihub-desktop/
├── package.json
├── bin/
│   └── aihub-desktop.js   # npx 入口(spawn electron)
└── src/
    ├── main.js               # Electron 主程序(IPC、session、fetch)
    ├── preload.js            # 安全橋接(contextBridge)
    ├── index.html            # 登入 UI
    ├── widget.html           # 浮動 widget UI
    └── assets/icon.png       # 應用圖示

登入流程

1. 輸入 email → 打 POST /portal/api/auth/send
2. 去信箱點 magic link
3. App 每 2 秒 polling checkSession 直到登入成功
4. 自動跳轉儀表板

注意事項

• main.js 裡的 PORTAL_ORIGIN 設為 https://ai.teamsync.com.tw,可視需要修改
• Session cookie 存在 Electron 預設 session,關掉 app 後仍保留(下次不需重新登入)
• 如果 GET /portal/api/auth/me 端點不存在,checkSession 會永遠回傳 loggedIn: false → 可改成 polling fetchUsage 看是否 200 來判斷