AilePro Desktop 使用手冊(現況校對版)
狀態:已完成
最後更新:2026-09-03
Jira:無
範圍:依目前 Web/Tauri 程式碼,整理登入、工作臺、聊天、客服、任務、備忘錄、桌面能力與服務號管理行為。
非目標:不把規格文件中的待確認/待實作項目當成已提供功能;不描述未由目前程式碼驗證的 Linux 發佈、權限模型或產品承諾。
長期文件:無。本文件是 Demo/交付記錄;穩定的產品契約仍以
docs/specs/desktop-web-requirements/為準。
本手冊只描述目前程式碼可觀察到的行為。規格中的「待確認」「待實作」能力不代表目前已支援;若與畫面實際狀態不一致,應以程式碼與服務端回應為準。
目錄
- 01 快速入門
- 02 工作臺與全域導覽
- 03 團隊建立與加入
- 04 多人與社團
- 05 聊天室訊息與發送
- 06 通訊錄
- 07 全域搜尋
- 08 客服進線處理
- 09 內部協作聊天
- 10 任務管理
- 11 備忘錄
- 12 桌面效率工具
- 13 服務號管理
- 14 常見問題
- 15 設定、回報、說明與登出
01 快速入門
支援平台與安裝
- 桌面發佈平台: 目前 CI 產出 Windows NSIS
.exe,以及 macOS.app、.dmg與.pkg。目前沒有 Linux 發佈工作,不應將 Linux 寫成正式支援平台。 - 瀏覽器版: Web 與 Tauri 共用
apps/web工作臺,但瀏覽器的檔案、通知、錄音與更新能力由瀏覽器權限決定。 - 桌面視窗: Tauri 預設為
1200 × 760邏輯像素,最小寬高為1200 × 720,可調整大小。 - 首次使用: 以手機版 Aile 完成帳號註冊/綁定並加入團隊,再從 Desktop 或 Web 登入。Desktop/Web 與手機端共用帳號、租戶資料與權限。
登入
登入卡片可切換「掃一掃登入」與「電子郵件登入」,預設為 QR Code:
- 掃一掃登入: 使用手機版 Aile 掃描畫面上的 QR Code,並在手機上確認授權。QR Code 下方固定顯示「請使用手機版 Aile 掃描上方 QR Code 登入」。
- 電子郵件登入: 輸入已綁定且已驗證的電子郵件,取得驗證碼後輸入 4–8 位數字。此流程只支援既有帳號,不提供郵箱註冊、綁定、密碼或手機號碼登入。
QR 登入會顯示生成、等待掃碼、已掃碼待確認、已授權、手機拒絕、過期或失敗等固定狀態。QR Code 有效期為 180 秒;過期、被拒絕或檢查失敗時可重新生成。切換到電子郵件模式會暫停 QR 輪詢,切回後可繼續原 QR 工作階段。
啟動狀態
| 狀態 | 行為 |
|---|---|
| 未登入 | 顯示登入卡片,不展示團隊或業務資料。 |
| 有 remembered-login | 可能顯示上次帳號、頭像與「繼續登入」;也可選擇「切換使用者」回到 QR 登入。 |
| 登入恢復中 | 顯示載入狀態,帳號與團隊資料完成恢復前不展示工作臺。 |
| 已登入且有團隊 | 進入工作臺,載入目前租戶、入口角標與可恢復的入口狀態。 |
| 沒有團隊 | 不進入完整工作臺;提示使用手機版 Aile 建立或加入團隊,並保留登出等必要操作。 |
| 會話失效/未授權 | 清理工作區與即時連線,直接回到 QR 登入頁,不先顯示 remembered-login。 |
版面與窄視窗
工作臺是三欄佈局:全域欄、列表欄與主工作區。列表與主工作區各自滾動,右側主頁/詳情以工作區內面板呈現。
- 全域欄約 60px,放置團隊入口、主要入口、角標與快速設定。
- 列表欄約 340–400px;Web 在
1200px以下會壓縮列表欄。 - Web
body最小寬度為 900px;小於 900px 時顯示「目前視窗過窄,建議使用 900px 以上寬度。」提示。 - Tauri 進入主頁或聊天室前會確保主視窗寬度至少 1200px;不會靠縮小視窗來容納右側面板。
02 工作臺與全域導覽
主要入口
全域欄目前依權限與帳號狀態顯示:
- 通訊錄
- 內部協作
- 商務號(必須同時存在
bossServiceNumberId,且目前使用者是 owner) - 外部客戶服務
- 內部員工服務
- 任務
- 備忘錄
通用「應用」入口在目前 workspace-shell.tsx 中被隱藏,不是一般一級導覽按鈕。Desktop Frame AIFF 會直接成為條件式 rail 圖示;可見圖示受高度限制,超出的項目收進「更多」。
入口切換會保留各入口的選取項目、列表位置與尚未關閉的聊天窗格;切換團隊時才會按新租戶清理並重新載入。點擊「通訊錄」時,右側預設開啟目前使用者的個人聊天室並展開個人主頁。入口不可用或權限不足時會隱藏,而不是顯示未實作的禁用卡片。
角標與工作區狀態
- 角標只在數量大於 0 時顯示;超過 99 顯示
99+。 - 內部協作、商務號、外部/內部服務與任務角標會在工作臺初始化時載入,不需要先開啟入口。
- 團隊抽屜會顯示其他團隊的未讀提示;切換團隊後清除舊租戶的選取、搜尋、角標與暫存定位。
- 目前沒有獨立的「主頁儀表板卡片」工作區;登入後主區直接由目前入口渲染空態、列表、聊天室或詳情。
- 目前沒有 Web 版「即時通訊連線異常」橫幅;不要將規格中的待實作提示寫成已上線功能。
AIFF 應用位置
- Frame: 以 Desktop rail 圖示開啟,主區使用 AIFF 工作區/Stage。
- Room Extend: 顯示在聊天室 Header 的更多應用選單。
- Room MessageMenu: 顯示在訊息右鍵選單;前兩個直接列出,其餘收進「更多應用」。
- Tauri 優先使用 child-webview;瀏覽器依嵌入政策使用 iframe 或外開。無法開啟時顯示錯誤,不以空白頁冒充成功。
03 團隊建立與加入
團隊抽屜
點擊全域欄頂部團隊頭像開啟團隊抽屜。抽屜提供目前團隊、其他團隊、加入/建立團隊,以及設定、回報問題、幫助與登出。點擊遮罩、按 Esc 或關閉按鈕可關閉抽屜。
建立團隊
桌面建立流程是兩步向導:
- 團隊基本資料: 必填團隊頭像、名稱、簡稱、說明、行業大類、行業小類與規模。團隊名稱至少 2 個字;欄位長度與產業選項依畫面驗證。
- 聯絡資料: 必填城市、地址與網址;統一編號與團隊代表號為可選欄位。
建立前可返回上一步;在建立流程中按取消、關閉、遮罩或 Esc 都會先顯示「團隊尚未創建完成,確定要取消嗎?」。提交失敗會保留表單內容供重試。成功後 由服務端建立團隊並自動切換回工作臺;新團隊的帳號角色以服務端回應為準。需要注意的是,目前前端送出資料時會把「統一編號」同時映射到 unifiedNumber 與 representativeNumber;畫面上的「團隊代表號」欄位目前未映射到建立請求,不能把它描述成已正確保存的電話欄位。
加入團隊
- Desktop/Web 的加入流程只接受邀請碼,不提供掃碼加入。
- 邀請碼會先去除前後空白;無效、過期或權限不足時保留輸入並顯示錯誤。
- 加入成功後,如果服務端可解析新團隊,流程會盡量自動切換;若無法解析或未切換,會提示「加入團隊成功,請手動切換團隊」。
- 帳號沒有任何團隊時,請先使用手機版 Aile 建立/加入,再回 Desktop/Web 重新登入。
切換與隔離
團隊抽屜列出團隊頭像、名稱、說明與未讀數。切換中會停用團隊按鈕;失敗時保留原團隊。成功切換後,列表、聊天室窗格、搜尋結果、草稿定位、角標與租戶 scoped 本機資料按新團隊重新初始化,不讀取其他團隊的本機歷史或快取。