APP 快速上手

從零安裝桌面 APP 到完成第一個任務，大約需要 10 分鐘。

為什麼要用桌面 APP

Web 端是工作空間的「遙控器」，桌面 APP 是真正的「執行端」。只有 APP 端能：

• ✅ 讀寫本機檔案（整理目錄、產生報告、修改程式碼）
• ✅ 執行 Shell 命令（npm install、git 操作、執行腳本）
• ✅ 接入 IM 渠道（Telegram、釘釘、飛書、Teams 等 14+ 平台）
• ✅ 建立定時任務（每天自動跑、Cron 運算式、通知推送）
• ✅ 設定 LLM 模型（多家 API Key、能力標記）
• ✅ 安裝 MCP 工具（擴充 AI 能力）
• ✅ 沙箱執行（隔離執行不信任的程式碼）
• ✅ 管理帳戶記憶（查看、編輯、圖譜視覺化）

Web 端雖然介面更輕，但所有「動手做」的能力必須由至少一台 APP 節點提供。

第 1 步 · 下載與安裝

取得安裝套件

平台支援

第 2 步 · 啟動與登入

1. 在應用程式列表或 Launchpad 中找到 Workspace（macOS）/ Workspace（Windows）並啟動
2. 首次啟動顯示登入介面
3. 使用與 Web 端相同的企業帳戶登入（電子郵件/手機號碼/SSO）
4. 登入成功後，APP 自動註冊為節點到 Gateway

登入後預設進入 Work 對話頁面。左側選單依次是 Work / Search / 工作流 / 智能體，底部是 ⚙️ 設定 / 🌐 語言 / 🟢 使用者頭像。

第 3 步 · 設定一個 LLM 模型

Agent 需要至少一個 LLM 才能運作。桌面 APP 獨有「模型設定」功能 —— 你需要提供一個 API Key。

推薦首選：Claude Sonnet 4

1. 左下角點擊 ⚙️ 設定
2. 左側選單選擇 模型
3. 點擊 + 新增模型
4. 選擇供應商 Anthropic
5. 貼上你的 Anthropic API Key（從 https://console.anthropic.com 取得）
6. 選擇模型 claude-sonnet-4 或 claude-3-5-sonnet
7. 儲存

模型選型速查

詳細的選型建議和能力矩陣見 模型設定 和 支援的模型列表。

第 4 步 · 第一次對話

回到 Work（左側選單第一項）：

1. 輸入框下方顯示：
   • 節點名稱：Workspace (你的電腦名)
   • 模型：剛才設定的模型
   • 工作目錄：預設是你的主目錄（點擊可切換）
2. 輸入一個任務（例如 列出我桌面上的所有檔案）
3. 按 Enter 傳送

Agent 會：

• 自動呼叫 List Directory 工具
• 即時串流顯示執行過程
• 完成後輸出結果

第 5 步 · 試試真正的工具呼叫

試一些更複雜的任務來感受 Agent Loop：

簡單任務

                      
                      帮我在桌面创建一个 hello.txt 文件，内容是"Hello from Workspace"

                    

→ Agent 呼叫 Write File 工具，自動建立檔案

需要確認的命令（首次會彈窗）

                      
                      在桌面创建一个 demo 目录，初始化为 git 仓库

                    

→ Agent 呼叫 Bash（P1 級別工具，第一次會彈出權限確認視窗）
→ 看清命令後點「允許」或「總是允許」

多步任務（體驗 Agent Loop）

                      
                      帮我整理桌面文件：
1. 按扩展名分类（图片 / 文档 / 代码 / 其他）
2. 为每类创建子目录
3. 把文件移动到对应目录

                    

→ Agent 自動分解為多步：列檔案 → 分類 → 建立目錄 → 移動檔案
→ 你在對話中能看到每一步的工具呼叫

第 6 步 · 開啟自動化能力

到這一步你已經會用基礎能力。接下來是 APP 獨有的「超能力」：

🤖 定時任務（讓 Agent 定期自動跑）

設定 → 定時任務 → 新建。詳見 定時任務。

💬 IM 渠道（讓團隊在群裡用 AI）

設定 → 渠道 → 選擇 Telegram / 釘釘 / 飛書等，按步驟設定。詳見 渠道配置。

🧩 MCP 工具（擴充更多能力）

設定 → 工具 → MCP 工具區 → 新增 MCP 伺服器。詳見 工具管理。

🧠 預註冊子代理（設定專業角色）

設定 → 子代理 → 新建（如「程式碼審查員」、「文件編寫者」）。詳見 子代理管理。

🛡️ 執行時安全（調整工具權限級別）

設定 → 執行時安全 → 調整 Bash/Web Fetch 等工具的 P0/P1/P2 級別。詳見 執行時安全。

第 7 步 · 讓 AI 記住你

在對話中說：

                      
                      请记住，我偏好用 TypeScript 写代码，代码风格使用 2 空格缩进。

                    

Agent 會呼叫 memory_manage 工具寫入帳戶記憶。下次新建對話時，這個偏好會自動注入，Agent 自然就會按你的偏好回覆。

在 APP → 設定 → 記憶 中可以查看、編輯、刪除所有記憶，也支援圖譜視覺化查看知識點間的關聯。詳見 記憶管理。

常見問題

Q：Web 端怎麼知道 APP 已經在線

Web 端 → 空間管理 → Work 選單查看節點列表。你的 APP 應該顯示為 Agent 類型節點。如果看不到，檢查 APP 是否已登入且網路正常。

Q：讓團隊同事也能用我這台 APP

把 APP 節點設為 enterprise 範圍：

1. APP → 設定 → 執行時安全 → 節點
2. 把節點可見性改為 企業（enterprise）
3. 同組織的成員就能在自己的 Web 端看到並呼叫這台節點了

注意：設為 enterprise 意味著同事的任務可能會在你的電腦上執行，包括檔案讀寫和命令執行。請確認你信任團隊成員。

Q：APP 可以多開嗎

同一帳戶不建議多開 —— 會產生多個節點註冊，可能引起路由混亂。如果需要多裝置協作，每台裝置一台 APP。

Q：能不能離線使用

大部分功能需要連接 Gateway 和 LLM API，離線不可用。未來可能支援部分本機離線能力（如本機 LLM）。

下一步

• 想全面了解 APP 設定 → APP 設定總覽
• 想學高階用法 → 對話互動、子代理
• 想管理組織 → 空間管理總覽