> ## Documentation Index
> Fetch the complete documentation index at: https://docs.aihubmix.com/llms.txt
> Use this file to discover all available pages before exploring further.

# 聯結器：GitHub、Gmail 與其他應用

> 聯結器讓雲端會話以你的身份訪問 GitHub、Gmail 等服務。本頁說明連線、Gmail 許可權檔位、授權失效與重新連線、發信確認、訪問許可權管理和斷開。

**聯結器**是你授權給 AIHubMix Cloud 的第三方帳號。連線後，雲端會話可以以你的身份讀寫這些服務，例如拉取 GitHub 倉庫、搜尋 Gmail。授權在瀏覽器中完成，不需要填寫 token。

聯結器只管「账号」；Agent 的能力擴充套件（外掛、MCP、Skills）在[外掛 / MCP / Skills](https://docs.aihubmix.com/zh-Hant/cloud/integrations/plugins-mcp-skills.md)裡管理。

## 適用範圍

桌面客戶端、網頁版和手機網頁都支援。聯結器只用於雲端會話，不改動你本機的配置；每個聯結器連線一個帳號。

## 入口

* 「设置 › 集成 › 连接器」。
* 新建專案選「从 GitHub 导入」但還沒連線 GitHub 時，點「前往连接 GitHub」。

## 聯結器頁

頁面分為「代码」（GitHub）、「邮件」（Gmail）、「已连接的应用」「可连接的应用」幾組。每行顯示名稱和狀態：

| 狀態 | 你可以 |
| - | - |
| 未連線 | 點「连接」 |
| 「● 已连接 · 账号」 | 點「管理」檢視訪問許可權或斷開 |
| 「● 授权已失效 · 账号」 | 點「重新连接」。通常是你在服務方撤銷了授權 |

能連線哪些應用以頁面顯示為準。

## 連線應用

1. 在應用一行點「连接」（Gmail 需要先選擇許可權檔位，見下文）。
2. 瀏覽器開啟該服務的授權頁，在上面完成授權。沒看到頁面時點「重新打开浏览器」。
3. 完成後回到 AIHubMix Cloud，該應用顯示為已連線。

授權沒有完成時會提示「授权未完成」並寫明原因，點「重试」或「重新连接」再來一次。如果提示已經連著另一個帳號，要換帳號請先斷開現有連線。

## GitHub

GitHub 授權後可以匯入倉庫建專案、在雲主機上拉取程式碼、推送分支、建立 PR，會話中也能讀取 Issue、PR 和搜尋程式碼。能訪問哪些倉庫和組織，在 GitHub 中管理：在管理頁點「在 GitHub 管理」可以追加組織或倉庫。

斷開 GitHub 後，已有的雲端環境將無法拉取程式碼、推送分支或建立 PR，環境裡的檔案會保留。

## Gmail

Gmail 有兩個許可權檔位，並且 Agent 發信前**一定**會在會話裡徵求你的同意。每個 AIHubMix 帳號只能連線一個 Google 帳號。

| 檔位 | Agent 能做什麼 |
| - | - |
| 讀取併傳送郵件（預設） | 搜尋、閱讀郵件，也可以代你發信 |
| 僅傳送郵件 | 只能代你發信，不能搜尋或閱讀郵件 |

* **更改許可權**：在 Gmail 管理頁點「更改授权范围」，選擇新檔位後點「前往 Google 授权」。
* **重新連線**：授權失效時點「重新连接」，沿用當前檔位。
* 如果你選了「读取并发送邮件」，但在 Google 授權頁面沒有勾選讀取許可權，Gmail 行會顯示「仅发送」，Agent 暫時不能讀取郵件。點「更改授权范围」重新授權並勾選讀取許可權即可。

### 發信前確認

Agent 要發郵件時，會先在會話裡顯示「发送邮件前需要你确认」，列出發件人、收件人、主題和正文。點「发送」或「不发送」。管理頁裡的許可權開關不能跳過這一步確認；連線 Outlook 後發信同樣需要確認。

## 聯結器管理與訪問許可權

已連線的應用都可以點「管理」開啟「连接器管理」，檢視已連線帳號、訪問許可權，以及「断开连接」。

### 訪問許可權

訪問許可權列表來自該帳號在服務方的實際授權，不同應用、不同帳號看到的專案不同。

* 已授權的許可權可以用開關停用或啟用；儲存成功後才生效。關閉某項許可權後，會話呼叫該能力時會被攔下。
* 灰色不可切換的項，是此帳號未授予、不可修改，或需要重新連線的許可權。要擴大授權範圍需要重新授權。
* 儲存失敗或讀取授權資訊失敗時，點「重新读取」後再試。

### 斷開連線

1. 在管理頁點「断开连接」。
2. 在確認彈窗裡點「断开连接」。斷開後雲端任務將無法再訪問此應用，之後可以隨時重新連線。

斷開失敗時連線仍然保留，點「重新读取」後再試。

## 注意與限制

* 每個聯結器只連線一個帳號；要換帳號先斷開。
* 聯結器只對雲端會話生效，不改動本機配置。
* 能看到哪些許可權、能否修改，由服務方的實際授權決定。

## 常見問題

### 需要把 GitHub token 填進來嗎？

不需要。所有聯結器都透過瀏覽器授權。

### GitHub 或 Gmail 顯示「授权已失效」怎麼辦？

通常是在服務方撤銷了授權。點行內的「重新连接」即可，Gmail 沿用之前的檔位。

### 斷開 GitHub 會刪掉我的專案嗎？

不會。雲端環境裡的檔案會保留，只是無法再拉取程式碼、推送分支或建立 PR。

### Agent 會不經我同意就發郵件嗎？

不會。無論檔位和許可權開關如何，發信前都會在會話裡請你確認。

## 相關

* [外掛 / MCP / Skills](https://docs.aihubmix.com/zh-Hant/cloud/integrations/plugins-mcp-skills.md)
* [使用者介入](https://docs.aihubmix.com/zh-Hant/cloud/sessions/user-intervention.md)
* [專案](https://docs.aihubmix.com/zh-Hant/cloud/projects/projects.md)


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.