# 平台概述

## 什麼是 Neotask？

**Gateway** 是驅動 Neotask 的核心引擎。它是一個管理所有事情的長期執行服務：代理程式工作階段、訊息整合、工具執行、排程自動化和裝置連接。

把它想成所有 Neotask 桌面應用程式、行動應用程式和網頁儀表板都連接的大腦。當您透過這些介面互動時，Gateway 在幕後進行繁重的工作。

## 架構

Neotask 使用輪輻模型：

- **Gateway** 是中心樞紐, , 一個在您的機器上（或雲端中）執行的 WebSocket 伺服器。它管理所有代理程式工作階段、在頻道之間路由訊息、協調工具執行並持久化狀態。
- **用戶端**（桌面應用程式、行動應用程式、網頁儀表板或終端機）連接至 Gateway 並透過它傳送/接收訊息。
- **節點**（iOS、Android、macOS 上的伴侶應用程式）向在 Gateway 上執行的代理程式暴露裝置功能, , 相機、畫布、螢幕錄製、位置和語音。
- **頻道**（WhatsApp、Telegram、Discord、Slack 等）是 Gateway 連接用於傳送和接收訊息的訊息傳輸。

所有 AI 操作都透過 Gateway → LLM 提供者管道進行。桌面應用程式從不直接呼叫 LLM。

## 主要功能

### 多頻道訊息
同時連接 20 個以上訊息平台。您的代理程式可以在 WhatsApp、Telegram、Discord、Slack、Signal、iMessage、Google Chat、Microsoft Teams、Matrix、IRC 等平台上傳送和接收訊息, , 全部來自單一 Gateway 實例。請參閱[頻道](channels.md)。

### 多代理程式系統
執行多個隔離代理程式，每個代理程式都有自己的工作空間、個性、模型設定和頻道綁定。自動將來自特定頻道、伺服器或聯絡人的入站訊息路由至正確的代理程式。請參閱[代理程式](agents.md)。

### 透過節點提供裝置功能
將 iOS、Android 和 macOS 伴侶應用程式作為「節點」連接，向代理程式暴露裝置硬體。代理程式可以拍照、錄製影片、擷取螢幕、獲取 GPS 位置、渲染互動式畫布，並透過自然語言執行系統命令。請參閱[伴侶應用程式](companion-apps.md)。

### 瀏覽器自動化
代理程式可以控制完整的 Chromium 瀏覽器, , 開啟頁面、點擊元素、填寫表單、截圖、擷取內容、上傳檔案和執行 JavaScript。支援多個瀏覽器設定檔以進行帳戶隔離。請參閱[工具與功能](tools-capabilities.md)。

### 畫布與 A2UI
代理程式到 UI（A2UI）系統讓代理程式在已連接裝置上渲染互動式視覺內容。代理程式可以呈現網頁、推送結構化 UI 更新、在畫布上下文中執行 JavaScript，並擷取顯示內容的快照。請參閱[工具與功能](tools-capabilities.md)。

### 靈活的模型支援
使用任何主要 LLM 提供者, , Anthropic（Claude）、OpenAI（GPT）、Google（Gemini）、Together AI、Moonshot、OpenRouter 等。設定模型備援鏈、別名和每代理程式模型覆蓋。透過 Ollama 或 vLLM 執行本機模型。請參閱[模型與提供者](models-providers.md)。

### 外掛與技能生態系統
使用外掛擴展 Neotask，添加新頻道、工具、RPC 方法和功能。在[技能目錄](/skills)中瀏覽可用技能。建立您自己的技能來教導代理程式新的工作流程。請參閱[外掛與技能](plugins-skills.md)。

### 排程與自動化
使用 cron 表達式、單次提醒或基於間隔的觸發器排程代理程式喚醒。代理程式可以執行自動化任務、向頻道發送結果或發佈到 webhook。請參閱[自動化](automation.md)。

### 語音互動
使用喚醒詞透過語音啟動您的代理程式。通話模式支援連續語音對話，配備即時語音轉文字和文字轉語音（ElevenLabs、OpenAI）。macOS 上的 Swabble daemon 提供始終開啟的裝置端語音偵測。請參閱[語音](voice.md)。

### 工作階段智能
工作階段每天自動重置，在接近上下文限制時壓縮，並在重新啟動後持久存在。記憶體搜尋讓代理程式使用向量相似性從以前的對話中回憶資訊。請參閱[工作階段與記憶體](sessions-memory.md)。

### 自託管且私密
所有東西都在您的基礎設施上執行。您的訊息、API 金鑰和代理程式資料不會離開您的機器，除非您明確設定外部服務。Gateway 預設綁定至 localhost, , 零外部網路暴露。

### 沙盒執行
在具有可設定資源限制、網路策略和檔案系統限制的隔離 Docker 容器中執行代理程式命令。每代理程式沙盒設定檔讓您精確控制每個代理程式可以存取的內容。請參閱[安全性](security.md)。

## 一切如何結合在一起

1. **您**透過 Neotask 桌面應用程式、行動伴侶應用程式，或直接透過 WhatsApp 或 Telegram 等訊息平台與代理程式互動。
2. **Gateway** 接收您的訊息，將其路由至正確的代理程式，並啟動 AI 輪次。
3. **代理程式**使用設定的 LLM（Claude、GPT 等）處理您的請求，呼叫所需的工具（瀏覽器、畫布、檔案操作、shell 命令），並生成回應。
4. **回應**透過同一頻道發送回給您，或者如果已設定，在不同頻道上公告。
5. **狀態**（工作階段轉錄、代理程式設定、排程工作）在本機持久化，使所有內容在重新啟動後仍能存活。