安装
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 的具体安装命令与名称,官方证据中均未说明;在承担高风险任务前,建议先在官方文档或仓库中核实这些点,不要以「未找到说明」推断为「没有风险」。