MaiAgent Desktop 桌面版

MaiAgent Desktop 桌面版的下載安裝、登入與組織切換，Chat、Cowork、Meet 三種模式的用法，本機檔案與瀏覽器操作的安全邊界、Output 檔案、連接器設定與版本更新。

MaiAgent Desktop 是 MaiAgent Work 的桌面應用程式，支援 macOS 與 Windows。用你平常登入 MaiAgent 的帳號登入後，同一個視窗就能：

• Chat：和網頁版 MaiGPT 一樣的 AI 對話，對話紀錄兩邊共用。

• Cowork：指定電腦上的一個資料夾，讓 AI 讀取、整理、產出這個資料夾裡的檔案；修改檔案或執行指令前會先問過你。

• Meet：錄下實體或線上會議，即時轉錄、產生摘要，紀錄會存進 AI 會議記錄。

適合常和本機檔案打交道（報表、文件、資料整理），或經常開線上會議、需要錄下其他與會者聲音的員工。

誰可以使用

Desktop 沿用你在網頁版的帳號、組織與角色權限，不需要另外開通帳號。

功能	需要的角色權限
Chat、Cowork	MaiGPT 權限（組織擁有者不受限）
Meet：查看會議記錄、生成摘要	會議列表權限
Meet：開始錄音	即時轉錄權限
Meet：匯入音檔	即時轉錄權限＋會議列表權限

• Meet 另外需要組織已開通會議記錄功能。

• 可用的模型、技能、工具與連接器，和網頁版 MaiGPT 一樣依角色設定，見 MaiGPT 角色使用權限；權限的設定方式見 角色權限。

• 即時轉錄、匯入音檔與生成摘要會使用組織的 Credits，見 Credits。

下載與安裝

作業系統	要下載的安裝檔
macOS（Apple Silicon，M 系列晶片）	檔名結尾是 -arm64.dmg
macOS（Intel 處理器）	檔名結尾是 -x64.dmg
Windows（x64）	檔名結尾是 Setup.exe

1

下載安裝檔

前往下載頁 https://github.com/Playma-Co-Ltd/maiagent-desktop-releases/releases/latest，在 Assets 區塊下載對應作業系統的安裝檔。這個網址永遠指向最新版。

同一頁的 .zip、.nupkg、RELEASES 是 App 自動更新用的檔案，不需要下載。

2

安裝

• macOS：開啟下載的 .dmg，把 MaiAgent Desktop 拖進「應用程式」資料夾，再從「應用程式」開啟。

• Windows：執行 Setup.exe，安裝完成後 App 會自動開啟，並建立開始功能表捷徑。

3

首次開啟的安全性提示

• macOS：正式安裝檔已經過 Apple 簽章與公證。若出現「無法打開，因為無法檢查是否包含惡意軟體」，代表這個安裝檔沒有通過公證；請不要自行繞過，改從下載頁重新下載最新版，仍無法開啟就聯絡組織管理員。

• Windows：若出現 SmartScreen「Windows 已保護您的電腦」，請先向組織 IT 確認安裝檔是從上述官方下載頁取得，再點選「其他資訊」→「仍要執行」繼續安裝。

登入與切換組織

1. 開啟 App，在登入畫面輸入電子郵件與密碼，按登入。帳號密碼與網頁版相同（見 如何登入平台）。

2. 登入畫面右上角可切換介面語言：English、繁體中文、简体中文、日本語、한국어；登入後可從左下角使用者選單的語言更改。

3. 忘記密碼時點忘記密碼？，會在瀏覽器開啟網頁版的重設密碼頁（見 忘記密碼）。

登入狀態會加密保存在這台電腦，下次開啟不必重新登入。要登出時，點左下角使用者選單 →登出；若正在錄音，Desktop 會先結束錄音再登出。

切換組織：側邊欄左上角顯示目前的組織名稱。你屬於多個組織時，點它就能切換；Desktop 會記住你上次選的組織。Chat、Cowork 的對話與 Meet 的會議記錄，都只顯示目前組織的內容。

Desktop 的登入畫面只提供電子郵件與密碼登入，沒有 SSO 選項；它連線的是 MaiAgent 雲端服務，也就是 admin.maiagent.ai 的同一組帳號。

首次設定系統權限

第一次登入後，若還有系統權限沒開，會看到開始之前，先把權限設定好畫面。這些權限只有 Meet 錄音會用到，Chat 與 Cowork 不需要。

權限	用途	平台
麥克風	在會議中錄下你的聲音	macOS、Windows
螢幕與系統音訊錄製	擷取電腦播放出來的其他與會者聲音	macOS 需授權；Windows 顯示不需另外授權
瀏覽器開會偵測	認出開著的會議分頁（Google Meet、Teams、Zoom、Webex），主動提議錄製	僅 macOS

每一項按允許即可。先前拒絕過的權限，系統不會再詢問，要按打開系統設定（Windows 為打開 Windows 設定）手動開啟，回來後按重新檢查。剛授權的權限要重新啟動 App 才生效，可按立即重新啟動。

暫時不想設定就按稍後再設定；之後側邊欄下方會提醒還有幾項未設定，按繼續設定即可回來。

三種模式

側邊欄上方的分頁切換模式：Chat、Cowork、Meet。App 開啟時預設在 Cowork。

模式	做什麼	會不會動到你電腦上的檔案
Chat	一般 AI 對話，和網頁版 MaiGPT 相同	不會
Cowork	AI 在你指定的資料夾裡讀寫檔案、執行指令	會，限定在綁定的資料夾，且修改前要你核准
Meet	錄音、即時轉錄、會議摘要	只會在本機另存一份錄音

Chat：和網頁版共用的 AI 對話

按新對話開始。對話清單包含你在網頁版 MaiGPT 的對話，兩邊都能接著聊；可用在對話中搜尋訊息找舊對話。

對話功能與網頁版相同：選擇模型（送出第一則訊息後就不能換）、思考力度，以及輸入框「＋」選單裡的附加檔案、技能、工具、連接器、Deep Research（依角色權限顯示）。訊息上的操作也相同：編輯已送出的訊息讓 AI 重新回覆（之後的訊息會被刪除）、分支對話（從某則訊息另開一條對話接著聊）、讚／倒讚、展開參考來源與查看原文。詳細用法見 AI 對話、Canvas、Deep Research 與 連接器。

側邊欄的對話操作

滑鼠移到側邊欄的對話或任務上，點右側出現的更多圖示會打開操作選單，Chat 與 Cowork 都一樣：

• 重新命名：改對話名稱，網頁版會同步看到。

• 批量刪除：進入多選模式，勾選多個對話後一次刪除。

• 刪除：永久刪除這個對話，無法復原。

Meet 的會議記錄另有 在 Finder 中顯示，見 會議記錄清單。

Output 檔案：下載 AI 產出的檔案

AI 用 Code Interpreter 或在 Cowork 中產出檔案（Excel、簡報、PDF、圖片等）並交付給你時，訊息下方會出現一張「已產出 N 個檔案」卡片，列出每個檔案的名稱與大小，按 下載 就存到你電腦的「下載項目」資料夾（同名檔案會自動加上編號），完成後右下角跳出「已下載」提示。

同一個對話產出過的所有檔案，也可以從訊息區右上角的下載圖示（帶有檔案數量）打開 Output 檔案 側欄一次瀏覽：側欄可拖曳調整寬度，上方的 重新整理 會重新讀取這個對話的輸出檔案清單。Cowork 任務中 AI 直接寫進工作資料夾的檔案，在資料夾裡就看得到，不需要另外下載。

Cowork：讓 AI 處理本機資料夾

按新任務開始。每個任務都綁定一個本機資料夾，AI 會在這個資料夾裡列出、讀取、搜尋檔案，並在你核准後編輯、建立檔案或執行指令與腳本。

1. 確認工作資料夾：輸入框上方會顯示此對話綁定資料夾：與路徑。預設是你個人主資料夾下的 MaiAgent 資料夾（不存在時會自動建立）。

2. 需要時換資料夾：送出第一則訊息之前，可按變更資料夾改成別的資料夾；你選的資料夾也會成為之後新任務的預設。送出訊息後，資料夾就固定不能再換。

3. 描述任務：例如「把這個資料夾裡的報價單整理成一張 Excel 總表」。AI 需要修改檔案或執行指令時，會停下來等你核准（見下一節）。

Desktop 內建 Python 與 Node.js 執行環境，AI 執行腳本時會自動安裝需要的套件，不必自己先裝。

Cowork 任務只能在 Desktop 繼續。在網頁版打開同一個任務時，會看到此對話僅能在 Desktop 繼續，可以瀏覽紀錄但不能輸入；按在 Desktop 開啟會直接跳到 Desktop 的這個任務。在另一台電腦打開任務時，若原本的資料夾不存在，Desktop 會暫時改用預設工作資料夾，並顯示提示。

Cowork 的存取範圍與安全邊界

AI 每次動作都會在對話中顯示為一張卡片：

AI 的動作	執行方式
列出目錄、讀取檔案、尋找檔案、搜尋內容	自動執行
編輯檔案、寫入檔案、執行指令、執行腳本	先顯示此操作需要你的核准，等你決定
瀏覽網頁：開啟網址、讀取頁面內容、點擊、輸入文字、按鍵、選取選項、填表、拖曳、切換分頁、截圖、在頁面執行 JavaScript 讀取資料、關閉瀏覽器	自動執行
瀏覽網頁：把你電腦上的檔案上傳到網頁、在瀏覽器中執行 AI 寫的程式	先顯示此操作需要你的核准，等你決定

需要核准時，卡片會列出 AI 要做的內容，你可以選：

• 核准：只允許這一次。

• 一律核准：同一種動作在 App 重新啟動前都不再詢問，所有任務都適用。

• 拒絕：不執行，AI 會收到你拒絕的結果。2 分鐘內沒有回應，也會視為拒絕。

Desktop 對本機存取的限制：

• 檔案範圍：列出、讀取、搜尋、編輯、寫入檔案只能在綁定的資料夾內進行；即使在資料夾內，.ssh、.aws、.gnupg、.kube、.docker、.config、.env、.npmrc、.netrc、.credentials 這類常見憑證檔案與資料夾也一律拒絕存取。

• 指令範圍：執行指令從綁定的資料夾開始執行，但使用的是你這台電腦帳號的權限，可以碰到資料夾以外的地方。Desktop 只會擋下少數明顯具破壞性的指令（例如刪除整個系統根目錄、格式化磁碟、把網路下載的內容直接交給終端機執行），所以核准前請看清楚指令內容。

• 資料流向：AI 讀到的檔案內容、指令輸出與網頁內容，會作為對話內容送回 MaiAgent 給 AI 處理。不想讓 AI 看到的檔案，不要放在工作資料夾裡。

• Chat 不碰本機檔案：Chat 模式的對話沒有綁定資料夾，AI 無法存取你電腦上的檔案；要給 AI 看的檔案請用附加檔案上傳。

瀏覽器操作

角色的 MaiGPT 使用權限有開啟 Browser Tool 時（見 MaiGPT 角色使用權限），AI 可以操作瀏覽器完成「到某個網站查資料、填表單、下載報表」這類任務：

• 用的是你電腦上安裝的瀏覽器：Desktop 會另外開一個瀏覽器視窗來操作，依序找 Google Chrome、Microsoft Edge、Chromium、Brave（Windows 為 Chrome、Edge）。你可以在旁邊看著它動作，也可以隨時關掉視窗中止。

• 只能開 http:// 與 https:// 網址，其他協定一律拒絕。

• 網頁內容會送給 AI：AI 讀取頁面、截圖的結果會作為對話內容送回 MaiAgent；頁面很長時只會送前面一段。不要讓 AI 操作含有你不想外流資料的頁面。

• 上傳檔案與執行程式要核准：這兩種動作與檔案寫入一樣會先停下來問你，也可以選一律核准。

• 對話中這些動作統一顯示為瀏覽網頁卡片，展開可看到實際的網址與操作。

一律核准會讓同類動作在 App 重新啟動前都直接執行。對執行指令、執行腳本與瀏覽器的上傳檔案、執行程式，建議每次確認內容後再按核准。

Meet：錄音並產生會議記錄

切到Meet後，主畫面是 Meeting Copilot，有即時轉錄與匯入音檔兩個入口；側邊欄是會議記錄清單，也可從清單上方的新增錄音、匯入音檔開始。

即時轉錄：

1. 按即時轉錄，在設定即時轉錄視窗填寫會議名稱，選擇錄音來源：麥克風（實體會議）、系統音訊（線上會議，錄電腦播放的聲音）或兩者（雙軌）（混合會議）。

2. 選擇ASR 模型與來源語言（有些模型可一次選多種語言，上限依模型而定）。

3. 需要即時翻譯時，在即時選項點翻譯打開面板：開啟啟用即時翻譯，勾選目標語言（繁體中文、繁體中文（香港）、簡體中文、英文、日文、韓文、泰文、印尼文、越南文，可多選，上限依畫面提示；已選為來源的語言不會出現），再選翻譯模型。至少選一種目標語言翻譯才會啟用，按鈕上會顯示「譯：語言」摘要。這些即時選項會在開始錄音前寫入會議記錄。

4. 按開始轉錄立即錄音；想先寫議程或筆記，可按建立工作區，之後再開始。

5. 錄音中可暫停錄音、繼續錄音，結束時按停止錄音。

錄音中切到別的地方：

• 在 Desktop 裡切到 Chat、Cowork 或其他會議時，右下角會出現一個小面板，顯示會議名稱、錄音時間與波形，可直接暫停／繼續、停止，或按左側的麥克風圖示回到這場會議。

• 切到別的應用程式時，螢幕上會留一個小型的浮動錄音視窗（永遠在最上層），同樣有狀態燈、波形與暫停／停止按鈕；連點兩下視窗即可回到 MaiAgent 會議記錄。這個視窗和開會偵測的提示共用，錄音中不會被關掉。

會議畫面有三個分頁，右側另有 MaiGPT 面板：

分頁	內容	匯出格式
Notes	你自己的會議筆記	Markdown、TXT
Transcript	逐字稿	TXT、SRT、JSON、複製純文字
Summary	AI 摘要：錄音結束後選擇模型與知識庫，需要時用指示補充要求，再按生成摘要	Markdown、PDF

右側 MaiGPT 面板可以針對這場會議提問；開啟帶入本次會議摘要後，回答會參考已生成的摘要。

Notes 分頁的筆記只是草稿（編輯器會標示「草稿（未儲存至雲端）」），不會存進會議記錄，關閉 App 後就會消失。需要保留的筆記，請先用匯出存成檔案。

匯入音檔：按匯入音檔，在匯入一次性音檔視窗按選擇音檔（支援 mp3、wav、m4a、aac），選擇來源語言，再按開始匯入，系統會在背景完成轉錄。

匯入音檔可以額外開啟語者辨識，把逐字稿標成 Speaker A／B／C：點語者打開面板，開啟啟用語者辨識、選擇語者辨識模型，人數提示預設自動偵測（不指定人數），已知與會人數時可改選「約 N 人」，避免多人音檔被低估。有些 ASR 模型不支援語者辨識（按鈕會變灰並說明原因），也有些模型的轉錄服務會自動標記語者、不需另外設定。即時轉錄不提供語者辨識。

會議記錄清單

側邊欄的會議記錄清單依時間排列，往下捲會載入更多；上方的搜尋框可依名稱過濾已載入的會議。清單上可以做的事：

• 單筆操作：在會議上按右鍵（或點更多圖示）選在 Finder 中顯示（Windows 為在資料夾中顯示）打開本機錄音檔的位置、重新命名、批量刪除、刪除。刪除的是雲端的會議記錄，網頁版也會一起消失，無法復原。

• 批次刪除：按清單標題旁的選取會議記錄進入多選模式，勾選後按刪除已選會議記錄；也有全選／取消全選與取消選取。有幾筆刪不掉時會提示數量，並保留那幾筆的選取狀態。

• 行事曆資訊：由行事曆提醒建立的會議，滑鼠移到該筆上會浮出活動資訊：時間、Google Meet／Microsoft Teams 或地點、主辦人、內部與外部與會者，並可直接開啟會議連結。

用「兩者（雙軌）」錄線上會議時建議戴耳機：喇叭外放時，其他與會者的聲音會被麥克風重複收音，逐字稿可能出現重複段落。開始錄音前，請確認已取得所有與會者同意。

與 AI 會議記錄的關係

Desktop 建立的會議就是一般的 AI 會議記錄：網頁版的會議列表也看得到，「來源」欄顯示 Desktop，可見範圍同樣依 會議存取權限。差別是 Desktop 能錄「系統音訊」，網頁版只錄麥克風。錄音另存一份在你的電腦，可在會議記錄的更多操作中選在 Finder 中顯示（Windows 為在資料夾中顯示）找到檔案。

開會提醒

• 開會偵測（僅 macOS）：Zoom、Microsoft Teams 或瀏覽器裡的線上會議開始使用麥克風時，Desktop 會跳出小視窗，可選開始會議記錄（開啟錄音設定）、暫時不要或關閉會議偵測。之後可從左下角使用者選單的開會偵測提醒重新開關。

• 行事曆提醒：若你已透過連接器授權 Google 或 Microsoft 行事曆（見下節），會議開始前約 10 分鐘會出現會議準備提醒，按準備會議會用行事曆資訊建立這場會議的工作區，或按略過。

連接器設定

連接器讓 AI 代你讀取 Google 行事曆、Notion、Slack 等外部服務。Desktop 的連接器和網頁版 MaiGPT 是同一套，授權一次兩邊都能用，可用的連接器由組織管理員決定（見 連接器、管理連接器（管理員））。Desktop 另外提供一頁集中管理：

1. 點左下角使用者選單 →連接器。

2. 左側列出目前組織可用的連接器，已授權的帶綠色盾牌圖示；右上角可重新整理連接器。

3. 點選一個連接器，右側顯示提供者、目前成員、組織、授權狀態與授權範圍（最多顯示 4 項，點「+N」可查看全部授權範圍），以及依狀態出現的按鈕：

狀態	可以做什麼
未連線	按連線，在瀏覽器完成該服務的授權後回到 Desktop 即完成
已連線	按中斷連線取消授權；要縮小授權範圍，也是先中斷再重新連線
授權已過期或被撤銷	按重新連線重新授權
你的角色尚未獲得此連接器的使用權限	按申請開放，送出後顯示已送出申請；管理員開放後你會收到「連接器已啟用」通知，再回來連線
此連接器已被目前組織停用	無法操作，請洽組織管理員

行事曆提醒需要 Google 或 Microsoft 行事曆的連接器處於已連線狀態。

更新版本

Desktop 會自動更新：開啟後約 10 秒檢查一次，之後每 4 小時檢查一次，有新版就在背景下載。下載完成後，側邊欄左下角會出現新版本已就緒，按重新啟動即可套用；不按的話，下次開啟 App 時會自動套用。

想立即檢查：

• macOS：選單列「MaiAgent Desktop」→檢查更新…

• Windows：按 Alt 叫出選單列 →說明→檢查更新…

已是最新版時會顯示目前已是最新版本。對話框（文字跟隨作業系統語言）。目前安裝的版本號顯示在登入畫面最下方。

常見問題

Q：建立對話時提示「沒有 MaiGPT 使用權限」？

目前組織沒有開放你使用 MaiGPT。若你屬於多個組織，先從左上角切換到有權限的組織；否則請組織管理員為你的角色開啟 MaiGPT 權限。

Q：Meet 顯示「目前無法使用會議記錄」或「會議記錄尚未開通」？

前者代表你的角色缺少 會議列表權限 或 即時轉錄權限，後者代表組織尚未開通會議記錄功能。畫面上的複製提醒內容會複製一段請求說明，可直接傳給組織管理員。

Q：錄音只有我的聲音，收不到其他與會者？

錄音來源要選系統音訊或兩者（雙軌）。macOS 需要在「系統設定 → 隱私權與安全性 → 螢幕與系統音訊錄製」允許 MaiAgent，並重新啟動 App；設定視窗出現系統音訊警告時，可按前往設定直接開啟該頁，或按改用純麥克風開始先只錄麥克風。

Q：公司平常用 SSO 登入網頁版，可以用 Desktop 嗎？

Desktop 只支援電子郵件＋密碼登入。若你的帳號沒有設定過密碼，請先洽組織管理員確認登入方式。