安裝
nac-web upgrade適合誰
- 適合想把大型、長期任務交給 AI 代理完成,但又不放心讓代理失控的使用者:nac 是 Arcee 開源的代理執行框架,採用執行緒與回合(thread-and-episode)架構——中央編排器負責規劃與拆解工作,但它本身不能執行命令、不能編輯檔案,只能啟動執行緒;每個執行緒結束後會回傳一個「episode」,也就是結構化的工作摘要,告訴你它到底做了什麼。
- 適合已經在使用其他代理工具(harness)、想接入 nac 的使用者:官方描述 nac 提供可攜式的 onboarding skill 與 MCP 整合,把官方提供的接入片段貼進你所選的代理工具,即可安裝 nac、完成設定並連接 MCP。
- 不適合直接當作命令列執行器:編排器無法替你跑命令或改檔案,執行都發生在被啟動的執行緒中。
- 證據未說明其支援的具體代理用戶端清單、平台相容性與資源需求,這些屬於未知。
3 分鐘完成第一次嘗試
推薦主路徑:官方安裝器 → 裝置碼登入 → 本地儀表板。
- 前提:證據未說明前置依賴與安裝器的可複製命令,請以官方 README 中的安裝說明為準;安裝完成後,
nac-web會被安裝器放入$HOME/.local/bin,如有需要請把該目錄加入PATH。 - 選擇模型認證——這是啟動工作階段前必須完成的步驟(也可以稍後在儀表板中進行)。官方推薦路徑是 Arcee 裝置碼登入,可取得 Latest Open 與 Arcee Trinity 模型:
nac-web arcee-auth login
- 從你的專案目錄啟動儀表板。成功訊號:儀表板可存取,認證已完成、可以選擇模型。
後續更新:nac 內建原生升級功能,可安裝最新穩定版:
nac-web upgrade
備選認證方式(僅作次要說明):nac-web codex-auth login 用 ChatGPT 帳號經 OAuth 取得 OpenAI 模型;或匯出目錄提供商的 API key(如 OPENAI_API_KEY)。注意:登入涉及你的帳號憑證;啟動工作階段前必須先選定模型認證方式。首次嘗試建議只發起一個低風險、結果可觀察的任務,並優先使用唯讀性質的動作;episode 中的工作由執行緒執行,真實任務可能包含寫入操作,重要副作用發生前應有確認環節。
使用案例
-
委派一個長期任務並回收結構化結果:在本地儀表板中,用已認證的模型(推薦 Arcee 裝置碼登入後的 Latest Open 或 Arcee Trinity 模型)啟動工作階段,發起一個任務。編排器會把工作拆解並啟動執行緒;執行緒結束後回傳 episode——一份結構化摘要,說明它完成了什麼。可期待結果:你不必盯著全過程,透過 episode 了解每段工作的成果。
-
把 nac 接入你現有的代理工具:官方提供了可攜式 onboarding skill 與 MCP 整合,把官方提供的接入片段貼進你所選的代理工具,即可安裝 nac、完成設定並連接 MCP。證據未給出針對具體代理用戶端的逐步細節,你所用代理的具體表現需以實際接入結果為準,可確認到的是這一官方提供的接入能力。
使用邊界
- 讀寫性質:編排器本身只做規劃與啟動執行緒,不執行命令、不編輯檔案;實際執行發生在執行緒內,因此真實任務可能包含寫入操作與命令執行——首次嘗試建議從結果可觀察的任務開始,重要副作用發生前應有確認環節。
- 認證要求:啟動工作階段前必須完成模型認證(推薦
nac-web arcee-auth login裝置碼登入;或nac-web codex-auth login;或匯出如OPENAI_API_KEY之類的目錄提供商 API key)。證據未說明是否有免費額度或計費,屬未知。 - 本地元件:
nac-web由安裝器放入$HOME/.local/bin,儀表板在本地執行,屬於本地狀態寫入;證據未提供解除安裝路徑說明。 - 官方明確限制:編排器不能執行命令或編輯檔案,只能透過執行緒取得 episode 形式的結構化結果。
- 尚未確認的關鍵資訊:具體支援哪些代理用戶端、模型呼叫的費用與配額、執行緒執行的環境隔離與權限邊界、可攜式 onboarding skill 的具體安裝命令與名稱,官方證據中均未說明;在承擔高風險任務前,建議先在官方文件或儲存庫中核實這些點,不要以「未找到說明」推斷為「沒有風險」。