快速上手
Plexus 是资源侧:一个你自己的网关,为你机器上的工具提供访问入口。AI agent 只能通过这道默认拒绝访问、全程审计的边界来使用工具,不能直接用原始密钥访问。无论怎么部署,这套信任模型都不变。你首先要选的只是部署和接入方式:网关在哪里运行,以及谁能访问它。
那就在下面选一格——网关落在哪台机器上,网络够到多远。选完去看信任闭环, 学那件永远不变的事:一次调用如何被发现、授予、执行、撤销。
最快的入口:让你的 agent 帮你装好。 选好你的那一格,复制那段话,粘给 Claude Code 或 Codex——它会读 真实的 runbook、把整套配置跑完,边做边叙述,遇到需要你决定或批准的地方就停下来。
选好它跑在哪、谁能连到它
先分别选好两项:网关在哪台机器上运行,以及哪些设备能通过网络访问它。再复制提示词,粘贴到 Claude Code 或 Codex。它会克隆仓库,查阅实际的操作手册,完成安装配置。每逢需要你做决定或批准的步骤,都会停下来。
把这段提示词粘贴到 Claude Code 或 Codex,它会查阅实际的操作手册,完成安装配置。
你要帮我试用 **Plexus**。这是一个本地能力网关,让你(我的 AI agent)能够访问我 Mac 上的工具。访问必须经过受管控、默认拒绝、全程审计的边界,而不是由我直接把访问密钥或 shell 交给你。 现在就把它装好并运行起来。**按顺序操作,并保证幂等**(可安全重复运行),同时**用通俗的话讲清每一步**,让我跟得上,也能边看边了解 Plexus 如何工作。只要某一步需要我**做决定**或**批准**(在 Plexus 控制台点击 Approve),就**停下来问我**,绝不要自行猜测后继续。 1. 克隆 https://github.com/nemori-ai/plexus(如果已经有了,就用 cd 进入仓库),并阅读 **docs/getting-started.md**。 2. 完成安装,在回环地址上启动网关,并打开 /admin 控制台。运行内置的入门引导,开放演示用的两个文件夹:一个公开文件夹(demo-intro)和一个受保护文件夹(your-secret)。然后以 agent 身份连接,使用你自己的 agent 专属凭据,绝不要用我的管理员 connection-key。 3. 带我走一遍流程:先读取 demo-intro(直接通过),再读取 your-secret(**等待我在控制台批准**)。需要我操作时,把控制台 URL 给我。 最后用几行话概括我刚才看到的过程:两种凭据、刚才读取受保护文件夹为什么需要等待我批准,以及一次撤销如何切断你的访问。
接下来看唯一不变的一点: 看一遍信任闭环 →
每种场景共有的东西
两个角色,自始至终分清——机器换了、线变长了,这一点不变:
- 你是 admin。 你持有 connection-key,即管理凭据;它认证
/admin控制台。你绝不把它交给 agent。 - agent 拿它自己的凭据。 连接一个 agent 时,它 enroll 得到一份持久的按 agent 独立的 PAT, 用它调用——绝不用 connection-key。
够得着网关,agent 单凭这一点什么都拿不到:enroll 需要你铸的 code,调用需要你批准的 grant, execute 默认逐次批准——只有你在连接时为该 agent + capability 显式开启(默认关闭、双重确认), 它才搭常驻 grant——connection-key 也没有出现在任何 agent 可达的路由上。所以发布到局域网 或隧道,只是可达性变了,信任故事没有新篇。
平台
macOS(Apple Silicon 或 Intel)是首要目标;Apple Calendar / Reminders 源仅限 macOS。headless Linux 网关已端到端验证(Ubuntu + Bun,跑在 Docker 里),承载可跨平台移植的源——见 Linux runbook。
对心智模型还陌生?先读 核心概念:Connector → Source → Capability、来源、三个时钟、 自描述的 Floor——把这几个概念弄明白,其余的都好读。权威的信任边界在 安全模型。