QuickAgent - 指南

QuickAgent 使用手冊

QuickAgent 是一個本機優先的 AI 代理工作區。它把目標轉化為持久化的 Run，以工作區設定檔限制該 Run，在執行敏感操作前請求審核，並將經過驗證的結果保存在 Artifacts 中。

開始使用

開啟 設定 > AI，新增一個服務商並執行其連線測試。
開啟 設定 > 工作區設定檔。選擇可以使用哪些服務商、工具、連線、檔案根目錄、Knowledge 來源與 Memory 範圍。
選擇 新對話，選擇設定檔，並確認對話上方顯示的服務商目標。
描述您想要的結果。只新增本次 Run 所需的檔案、資料夾、媒體、Knowledge 或 Memory。
當出現計畫、核准、Critical 確認與資料傳送預覽時，請逐一檢視。
在時間軸中追蹤進度。在 Artifacts 中開啟完成的輸出，並在歷史.

小提示： 先從範圍較窄的工作區設定檔開始。只有當 QuickAgent 明確說明某項功能無法使用的原因時，再擴充它的工具或根目錄。

介面總覽

區域	用途
對話	對話內容、服務商目標、上下文匣、計畫、核准以及目前的 Run 時間軸。
Runs	所有已規劃、執行中、已暫停、已排程、失敗或已完成的任務。
核准收件匣	等待您決定的動作核准、Critical 與資料傳送審核。
Artifacts	由 Run 產生、經過驗證的檔案、報告、記錄、媒體、表格與操作清單。
自動化	排程、監控、Webhook、應用程式事件以及 Shortcut／App Intent 觸發器。
Skills	可重複使用的指示，帶有具型別的輸入、允許使用的工具、所需連線、風險等級與輸出。
連線	服務商、瀏覽器設定檔、檔案／VFS 根目錄、SSH、MCP、HTTP/SaaS、家庭橋接與通知管道。
Knowledge	已建立索引的資料夾、QuickNote 內容、網頁剪輯、PDF 與 Office 來源。
歷史	僅可附加的安全決策、工具動作、目標與時間戳記。
設定	外觀、語言、AI、工具、安全、工作區設定檔、快速鍵、權限、說明與 Pro。

服務商與工作區設定檔

當作業系統提供相容能力時，QuickAgent 可以使用系統 AI，也可以使用 Ollama、LM Studio 或 DeskLLM 等本機服務商、區域網路或自訂的 OpenAI 相容端點，以及 Anthropic 或 Gemini 等已設定的雲端服務商。可用性由即時的能力測試決定；僅有服務商名稱並不代表它已就緒。

工作區設定檔是 Run 的權限範圍。它會快照所選的服務商／模型、允許的工具、連線、檔案根目錄、Knowledge 來源、Memory 範圍、安全覆寫與預算。之後的組態變更會使該快照過期，並需要重新檢視。

目標規則： QuickAgent 絕不會在您不知情的情況下，從裝置端或本機服務商切換到雲端。目前的目標始終顯示在對話中，以及每一次資料傳送審核裡。

Run、審核與恢復

Run 控制

暫停會在持久化檢查點處請求協作式停止。
繼續會沿用同一個 Run 及已完成的工作。
停止取消服務商與工具的工作。已停止或結果不確定的外部影響不會被報告為成功。
重試僅在 QuickAgent 能夠確定安全的重試邊界時才可用。

安全級別

級別	含義
Safe	在當前配置檔案範圍內讀取、檢查或轉換。
Approve	審閱一次普通的寫入或外部操作。
請確認	審閱影響更大或更難復原的更改。
Critical	每次都需要強確認；規則永遠不會自動批准。

審核介面會顯示確切的目標、目的地、擬用參數、風險與復原狀態。如果您修改了參數，QuickAgent 會對修改後的操作重新進行校驗與風險檢查。

結果不確定時： 中斷之後，請先檢查目標系統。只有在重複執行該操作確實合適時，才選擇「我已確認 — 重試」。僅點選「繼續」絕不會重複執行結果不確定的外部操作。

多智慧體 Run

複雜目標可以使用規劃者、型別化的專職工作者、審閱者以及安全審閱者。時間線會顯示每一次交接、審閱、重試、回退與最終響應的邊界。工作者只會獲得 Skill 工具、工作區配置檔案工具、角色工具與當前可用工具這四者的交集。

全域性預算與各角色預算會限制呼叫次數、時間、成本、網路位元組數與 token。達到預算上限時 QuickAgent 會暫停，並顯示當前上限與建議上限，只有在您明確審閱後才會提高。已批准的預算與已完成的角色歷史在重啟後依然保留。

上下文、Knowledge 與 AI Memory

情境匣

可新增檔案、資料夾、圖片、影片影格、音訊、語音筆記、QuickNote 內容、Knowledge 或工作區 Memory。QuickAgent 會提取或摘要受支援的內容，並顯示某個附件是否會被直接傳送給服務商。

Knowledge

Knowledge 來源的索引與對話是分開的。一個 Run 只能搜尋其工作區配置檔案允許的來源，且引用會保留來源標識。

Memory

Memory 是有意為之的記錄，而不是自動儲存的聊天歷史。使用者、工作區、專案以及工具/連線範圍彼此獨立。每一次建立、編輯或刪除請求都會重新徵求審核，審核預覽會顯示範圍與擬寫入的確切內容。

工具與連線

即時目錄涵蓋檔案/VFS 操作；Office、PDF 與結構化資料；媒體與 OCR；瀏覽器與計算機操作；開發命令；SSH；MCP；HTTP 與 SaaS；智慧家居橋接；通知；排程；監控；以及自動化控制。已連線的 MCP 伺服器在透過 schema 校驗和 QuickAgent 風險重估後，可能會新增動態工具。

設定 > 工具 會說明某個工具為何已就緒或被禁用。常見原因包括缺少連線、缺少作業系統權限、平台不支援、工作區配置檔案限制、端點未測試或服務商能力不可用。

計算機操作： 螢幕捕獲與輔助功能/輸入控制是兩項獨立權限。請保持可見預覽與緊急「停止」按鈕可用。移動平台不提供同等的不受限桌面控制能力。

自動化

在平台支援的前提下，自動化可以由時間、檔案/資料夾、網頁、Webhook、郵件、日曆、網路、主機、裝置、感測器、位置、應用事件、Shortcut/App Intent、命令或手動觸發啟動。觸發器會建立一個普通的 Run；它不會繞過工作區配置檔案、審核、Critical 或資料傳送檢查。

桌面版監控僅在應用程序執行期間持續。
移動平台會在應用回到前台時補跑逾期的任務。
當需要由作業系統負責觸發時，請使用 Shortcut/App Intent 或可信的事件中繼。
排隊事件、暫停、取消與刪除都保持顯式操作，因此事件不會被靜默丟棄。

Skills 與 Skill Packs

一個 Skill 會儲存以結果為導向的提示詞、型別化變數、推薦服務商、允許使用的工具、所需連線與能力、最高風險等級以及預期的 Artifacts。使用前，QuickAgent 會顯示輸入與實際生效的權限；該預覽本身並不授予權限。

七個內建 Pack 為 Office、編碼、智慧家居、研究、瀏覽器自動化、個人事務與事故響應提供了實用的 Skills。您可以安裝、更新、解除安裝、自訂、複製、匯入與匯出 Skills。匯入的 JSON 會附帶信任、釋出者、簽名、權限、風險、平台與衝突預覽。「兩者都保留」會建立一個未簽名的本地衍生版本，而不會繼承另一位釋出者的信任狀態。

Artifacts、歷史與復原

Artifacts 會儲存輸出位元組、後設資料、版本、來源資訊、所屬 Run 以及操作清單。視平台能力而定，您可以開啟、分享、匯出或在檔案管理器中顯示它們。符合條件的操作會提供經審閱的復原；破壞性或結果不確定的工作絕不會被自動重放。

歷史為僅追加記錄。您可以按 Safe、Approve、Confirm 或 Critical 篩選，並在需要外部記錄時匯出審計日誌。

設定

通用： 外觀、語言、工作區配置檔案、快速鍵、說明與權限。
AI： 服務商、端點、模型、憑證與即時測試。
工具： 目錄就緒狀態、平台支援情況與設定說明。
安全： 審核規則、資料傳送行為、裝置認證與分範圍的 Memory 策略。
進階： 用於疑難排查的恢復與診斷功能。

鍵盤快速鍵

在 macOS 上，應用會在適當情況下將顯示的 Ctrl 快速鍵對應到平台的 Command 鍵。以應用內的快速鍵頁面為準，且支援自訂。

快速鍵	動作
`Ctrl` + `N`	新對話
`Ctrl` + `L`	聚焦輸入框
`Ctrl` + `Shift` + `Space`	暫停或繼續當前 Run
`Ctrl` + `.`	停止當前 Run
`Ctrl` + `1` … `9`	透過歷史開啟對話
`Ctrl` + `,`	開啟設定
`F1`	開啟「說明 & 隱私權」
`Esc`	關閉對話方塊或取消當前的非破壞性操作

平台說明

平台	重要限制
macOS	Debug 與 Release 均在沙盒中執行。檔案存取使用所選根目錄/安全範圍書籤。螢幕錄製與輔助功能是相互獨立的系統權限。本地程序與 Shortcut 整合仍需透過能力測試。
Windows	檔案、Office/PDF/資料、瀏覽器、開發、遠端與桌面控制功能取決於已安裝的執行時與權限。僅限 Apple 的整合不可用，並會顯示明確原因。
iPhone / iPad	檔案使用系統選擇器。相機、麥克風、語音、照片、本地網路與通知會在需要時請求授權。後台監控無法保證；請使用 Shortcuts/App Intents 或前台補跑。
Android	檔案與資料夾使用 Storage Access Framework。後台工作遵循 Android 的限制。基於輔助功能的輸入控制絕不會僅因宣告了某個服務就被視為已授權。
Web	對需要原生持久化的功能使用僅限會話的儲存，並會明確禁用不受支援的裝置、檔案根目錄、本地程序與後台能力。

技巧 & 訣竅

先從範圍較窄的工作區配置檔案開始，只有當 Run 提出具體需求時，再新增工具、連線或檔案根目錄。

為每個請求設定明確的結果、預期 Artifact 與審閱邊界，讓進展始終易於審計。

對可複用的已索引來源使用 Knowledge，對僅當前 Run 需要的材料使用上下文。

當外部操作結果不確定時，請先檢查目標位置再重試；「繼續」絕不會自動重複執行。

疑難排解

問題	檢查要點
服務商無法執行	開啟「設定 > AI」。檢查配置、認證、模型能力、端點可達性、超時與限流詳情，然後執行連線測試。
某個工具被禁用	開啟「設定 > 工具」並檢視即時原因。檢查當前平台、權限、連線測試、工作區配置檔案與所選根目錄。
某個 Run 看起來卡住了	開啟「Runs」與時間線。它可能處於暫停、等待輸入、等待審核、等待 Critical 確認、等待資料傳送審核或預算審核狀態。「停止」始終可用。
權限發生了變化	開啟「說明 > 概覽」或設定，然後開啟系統設定。返回後請重新測試受影響的連線或工具。
某個外部操作結果不確定	請檢查目標系統。除非您已確認重試是合適的，否則請讓該 Run 保持暫停或直接停止。
某個自動化沒有在後台觸發	移動作業系統無法保證任意的輪詢。請回到前台進行補跑，或配置 Shortcut/App Intent 或可信事件源。
某個 Artifact 無法開啟或匯出	請檢查其位元組內容是否仍然存在、平台是否支援該操作，以及所選目標位置的權限是否仍然有效。

隱私、權限與許可

QuickAgent 將對話、Runs、審核、Knowledge 後設資料、Skills 與設定儲存在本地。憑證使用平台提供的受保護儲存。內容只有透過您所配置的服務商或已連線服務才會離開裝置，且對外傳送都會提供帶目標資訊的預覽。

權限會在使用場景中按需請求：檔案/資料夾、照片、相機、麥克風、語音辨識、本地網路、通知、螢幕錄製以及輔助功能/輸入控制彼此獨立。移除某項權限會使相應能力不可用，而不會產生虛假的成功結果。

開啟 設定 > 說明 & 隱私權 可檢視當前平台能力對照表， 開源許可證 可檢視軟體包與內建原生元件的宣告。

免費版與 Pro 版： 所有智慧體功能在免費版中均可使用。七天試用期沒有廣告；之後行動版可能顯示廣告，桌面版可能顯示每日提醒。Pro 透過年度訂閱或終身購買移除這些提示。