> For the complete documentation index, see [llms.txt](https://docs.maiagent.ai/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.maiagent.ai/work/desktop.md).

# MaiAgent Desktop 桌面版

MaiAgent Desktop 桌面版的下載安裝、登入與組織切換，以及 Chat、Cowork、Meet 三種模式的用法、本機檔案存取的安全邊界與版本更新。

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

* **Chat**：和網頁版 MaiGPT 一樣的 AI 對話，對話紀錄兩邊共用。
* **Cowork**：指定電腦上的一個資料夾，讓 AI 讀取、整理、產出這個資料夾裡的檔案；修改檔案或執行指令前會先問過你。
* **Meet**：錄下實體或線上會議，即時轉錄、產生摘要，紀錄會存進 [AI 會議記錄](/work/meeting-records.md)。

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

## 誰可以使用 <a href="#who-can-use" id="who-can-use"></a>

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

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

* Meet 另外需要組織已開通會議記錄功能。
* 可用的模型、技能、工具與連接器，和網頁版 MaiGPT 一樣依角色設定，見 [MaiGPT 角色使用權限](/org/roles/maigpt-role-permissions.md)；權限的設定方式見 [角色權限](/org/roles/role-permission.md)。
* 即時轉錄、匯入音檔與生成摘要會使用組織的 Credits，見 [Credits](/others/credits.md)。

## 下載與安裝 <a href="#download-and-install" id="download-and-install"></a>

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

{% stepper %}
{% step %}

### 下載安裝檔 <a href="#download-installer" id="download-installer"></a>

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

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

{% step %}

### 安裝 <a href="#install" id="install"></a>

* **macOS**：開啟下載的 `.dmg`，把 MaiAgent Desktop 拖進「應用程式」資料夾，再從「應用程式」開啟。
* **Windows**：執行 `Setup.exe`，安裝完成後 App 會自動開啟，並建立開始功能表捷徑。
  {% endstep %}

{% step %}

### 首次開啟的安全性提示 <a href="#first-launch-security" id="first-launch-security"></a>

* **macOS**：正式安裝檔已經過 Apple 簽章與公證。若出現「無法打開，因為無法檢查是否包含惡意軟體」，代表這個安裝檔沒有通過公證；請不要自行繞過，改從下載頁重新下載最新版，仍無法開啟就聯絡組織管理員。
* **Windows**：若出現 SmartScreen「Windows 已保護您的電腦」，請先向組織 IT 確認安裝檔是從上述官方下載頁取得，再點選「其他資訊」→「仍要執行」繼續安裝。
  {% endstep %}
  {% endstepper %}

## 登入與切換組織 <a href="#sign-in" id="sign-in"></a>

1. 開啟 App，在登入畫面輸入<mark style="color:blue;">電子郵件</mark>與<mark style="color:blue;">密碼</mark>，按<mark style="color:blue;">登入</mark>。帳號密碼與網頁版相同（見 [如何登入平台](/start/login.md)）。
2. 登入畫面右上角可切換介面語言：English、繁體中文、简体中文、日本語、한국어；登入後可從左下角使用者選單的<mark style="color:blue;">語言</mark>更改。
3. 忘記密碼時點<mark style="color:blue;">忘記密碼？</mark>，會在瀏覽器開啟網頁版的重設密碼頁（見 [忘記密碼](/start/forget-password.md)）。

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

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

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

## 首次設定系統權限 <a href="#system-permissions" id="system-permissions"></a>

第一次登入後，若還有系統權限沒開，會看到<mark style="color:blue;">開始之前，先把權限設定好</mark>畫面。這些權限只有 Meet 錄音會用到，Chat 與 Cowork 不需要。

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

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

暫時不想設定就按<mark style="color:blue;">稍後再設定</mark>；之後側邊欄下方會提醒還有幾項未設定，按<mark style="color:blue;">繼續設定</mark>即可回來。

## 三種模式 <a href="#modes" id="modes"></a>

側邊欄上方的分頁切換模式：<mark style="color:blue;">Chat</mark>、<mark style="color:blue;">Cowork</mark>、<mark style="color:blue;">Meet</mark>。App 開啟時預設在 Cowork。

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

### Chat：和網頁版共用的 AI 對話 <a href="#chat-mode" id="chat-mode"></a>

按<mark style="color:blue;">新對話</mark>開始。對話清單包含你在網頁版 MaiGPT 的對話，兩邊都能接著聊；可用<mark style="color:blue;">在對話中搜尋訊息</mark>找舊對話。

對話功能與網頁版相同：<mark style="color:blue;">選擇模型</mark>（送出第一則訊息後就不能換）、<mark style="color:blue;">思考力度</mark>，以及輸入框「＋」選單裡的<mark style="color:blue;">附加檔案</mark>、<mark style="color:blue;">技能</mark>、<mark style="color:blue;">工具</mark>、<mark style="color:blue;">連接器</mark>、<mark style="color:blue;">Deep Research</mark>（依角色權限顯示）。詳細用法見 [AI 對話](/work/maigpt/chat.md)、[Canvas](/work/maigpt/canvas.md)、[Deep Research](/work/maigpt/deep-research.md) 與 [連接器](/work/maigpt/connectors.md)。

### Cowork：讓 AI 處理本機資料夾 <a href="#cowork-mode" id="cowork-mode"></a>

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

1. **確認工作資料夾**：輸入框上方會顯示<mark style="color:blue;">此對話綁定資料夾：</mark>與路徑。預設是你個人主資料夾下的 `MaiAgent` 資料夾（不存在時會自動建立）。
2. **需要時換資料夾**：送出第一則訊息之前，可按<mark style="color:blue;">變更資料夾</mark>改成別的資料夾；你選的資料夾也會成為之後新任務的預設。送出訊息後，資料夾就固定不能再換。
3. **描述任務**：例如「把這個資料夾裡的報價單整理成一張 Excel 總表」。AI 需要修改檔案或執行指令時，會停下來等你核准（見下一節）。

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

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

### Cowork 的存取範圍與安全邊界 <a href="#cowork-safety" id="cowork-safety"></a>

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

| AI 的動作                                                                                                                                                  | 執行方式                                               |
| ------------------------------------------------------------------------------------------------------------------------------------------------------- | -------------------------------------------------- |
| <mark style="color:blue;">列出目錄</mark>、<mark style="color:blue;">讀取檔案</mark>、<mark style="color:blue;">尋找檔案</mark>、<mark style="color:blue;">搜尋內容</mark> | 自動執行                                               |
| <mark style="color:blue;">編輯檔案</mark>、<mark style="color:blue;">寫入檔案</mark>、<mark style="color:blue;">執行指令</mark>、<mark style="color:blue;">執行腳本</mark> | 先顯示<mark style="color:blue;">此操作需要你的核准</mark>，等你決定 |

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

* <mark style="color:blue;">核准</mark>：只允許這一次。
* <mark style="color:blue;">一律核准</mark>：同一種動作在 App 重新啟動前都不再詢問，所有任務都適用。
* <mark style="color:blue;">拒絕</mark>：不執行，AI 會收到你拒絕的結果。2 分鐘內沒有回應，也會視為拒絕。

Desktop 對本機存取的限制：

* **檔案範圍**：列出、讀取、搜尋、編輯、寫入檔案只能在綁定的資料夾內進行；即使在資料夾內，`.ssh`、`.aws`、`.gnupg`、`.kube`、`.docker`、`.config`、`.env`、`.npmrc`、`.netrc`、`.credentials` 這類常見憑證檔案與資料夾也一律拒絕存取。
* **指令範圍**：<mark style="color:blue;">執行指令</mark>從綁定的資料夾開始執行，但使用的是你這台電腦帳號的權限，可以碰到資料夾以外的地方。Desktop 只會擋下少數明顯具破壞性的指令（例如刪除整個系統根目錄、格式化磁碟、把網路下載的內容直接交給終端機執行），所以核准前請看清楚指令內容。
* **資料流向**：AI 讀到的檔案內容與指令輸出，會作為對話內容送回 MaiAgent 給 AI 處理。不想讓 AI 看到的檔案，不要放在工作資料夾裡。
* **Chat 不碰本機**：Chat 模式的對話沒有綁定資料夾，AI 無法存取你電腦上的檔案；要給 AI 看的檔案請用<mark style="color:blue;">附加檔案</mark>上傳。

{% hint style="warning" %} <mark style="color:blue;">一律核准</mark>會讓同類動作在 App 重新啟動前都直接執行。對<mark style="color:blue;">執行指令</mark>和<mark style="color:blue;">執行腳本</mark>，建議每次確認內容後再按<mark style="color:blue;">核准</mark>。
{% endhint %}

### Meet：錄音並產生會議記錄 <a href="#meet-mode" id="meet-mode"></a>

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

**即時轉錄**：

1. 按<mark style="color:blue;">即時轉錄</mark>，在<mark style="color:blue;">設定即時轉錄</mark>視窗填寫<mark style="color:blue;">會議名稱</mark>，選擇<mark style="color:blue;">錄音來源</mark>：<mark style="color:blue;">麥克風</mark>（實體會議）、<mark style="color:blue;">系統音訊</mark>（線上會議，錄電腦播放的聲音）或<mark style="color:blue;">兩者（雙軌）</mark>（混合會議）。
2. 選擇<mark style="color:blue;">ASR 模型</mark>與<mark style="color:blue;">來源語言</mark>，需要時開啟<mark style="color:blue;">即時翻譯</mark>。
3. 按<mark style="color:blue;">開始轉錄</mark>立即錄音；想先寫議程或筆記，可按<mark style="color:blue;">建立工作區</mark>，之後再開始。
4. 錄音中可<mark style="color:blue;">暫停錄音</mark>、<mark style="color:blue;">繼續錄音</mark>，結束時按<mark style="color:blue;">停止錄音</mark>。

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

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

右側 MaiGPT 面板可以針對這場會議提問；開啟<mark style="color:blue;">帶入本次會議摘要</mark>後，回答會參考已生成的摘要。

{% hint style="warning" %}
Notes 分頁的筆記只是草稿（編輯器會標示「草稿（未儲存至雲端）」），不會存進會議記錄，關閉 App 後就會消失。需要保留的筆記，請先用<mark style="color:blue;">匯出</mark>存成檔案。
{% endhint %}

**匯入音檔**：按<mark style="color:blue;">匯入音檔</mark>，在<mark style="color:blue;">匯入一次性音檔</mark>視窗按<mark style="color:blue;">選擇音檔</mark>（支援 mp3、wav、m4a、aac），再按<mark style="color:blue;">開始匯入</mark>，系統會在背景完成轉錄。

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

#### 與 AI 會議記錄的關係 <a href="#meeting-records-integration" id="meeting-records-integration"></a>

Desktop 建立的會議就是一般的 [AI 會議記錄](/work/meeting-records.md)：網頁版的會議列表也看得到，「<mark style="color:blue;">來源</mark>」欄顯示 <mark style="color:blue;">Desktop</mark>，可見範圍同樣依 [會議存取權限](/work/meeting-records/access-control.md)。差別是 Desktop 能錄「系統音訊」，網頁版只錄麥克風。錄音另存一份在你的電腦，可在會議記錄的更多操作中選<mark style="color:blue;">在 Finder 中顯示</mark>（Windows 為<mark style="color:blue;">在資料夾中顯示</mark>）找到檔案。

#### 開會提醒 <a href="#meeting-reminders" id="meeting-reminders"></a>

* **開會偵測（僅 macOS）**：Zoom、Microsoft Teams 或瀏覽器裡的線上會議開始使用麥克風時，Desktop 會跳出小視窗，可選<mark style="color:blue;">開始會議記錄</mark>（開啟錄音設定）、<mark style="color:blue;">暫時不要</mark>或<mark style="color:blue;">關閉會議偵測</mark>。之後可從左下角使用者選單的<mark style="color:blue;">開會偵測提醒</mark>重新開關。
* **行事曆提醒**：若你已透過<mark style="color:blue;">連接器</mark>授權 Google 或 Microsoft 行事曆，會議開始前約 10 分鐘會出現<mark style="color:blue;">會議準備提醒</mark>，按<mark style="color:blue;">準備會議</mark>會用行事曆資訊建立這場會議的工作區，或按<mark style="color:blue;">略過</mark>。

## 更新版本 <a href="#updates" id="updates"></a>

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

想立即檢查：

* **macOS**：選單列「MaiAgent Desktop」→<mark style="color:blue;">檢查更新…</mark>
* **Windows**：按 Alt 叫出選單列 →<mark style="color:blue;">說明</mark>→<mark style="color:blue;">檢查更新…</mark>

已是最新版時會顯示<mark style="color:blue;">目前已是最新版本。</mark>對話框（文字跟隨作業系統語言）。目前安裝的版本號顯示在登入畫面最下方。

## 常見問題 <a href="#faq" id="faq"></a>

### Q：建立對話時提示「沒有 MaiGPT 使用權限」？ <a href="#faq-no-maigpt-permission" id="faq-no-maigpt-permission"></a>

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

### Q：Meet 顯示「目前無法使用會議記錄」或「會議記錄尚未開通」？ <a href="#faq-meeting-access" id="faq-meeting-access"></a>

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

### Q：錄音只有我的聲音，收不到其他與會者？ <a href="#faq-no-system-audio" id="faq-no-system-audio"></a>

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

### Q：公司平常用 SSO 登入網頁版，可以用 Desktop 嗎？ <a href="#faq-sso" id="faq-sso"></a>

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


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter, and the optional `goal` query parameter:

```
GET https://docs.maiagent.ai/work/desktop.md?ask=<question>&goal=<endgoal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is optional and describes the broader end goal you are ultimately trying to accomplish on behalf of the user. GitBook uses it to tailor the answer towards what is most useful for that goal.

The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.