企业官网建设流程全解析

AgentDock 是面向 AI Agent 的独立工具运行层，让 AI 在真实设备上安全地操作文件、命令、Git、浏览器与任务。搭配自托管中心服务 NexusDock，你可以在一次对话中统筹多台电脑与服务器——Mac mini、Windows 主机和几台云 VPS 同时在线，无需再来回切换 SSH 会话或维护一堆 MCP 连接。本文给出从配对到跨设备实战的完整路径 🚀

为什么需要“一次对话管多台设备”？

🖥️ 典型的痛点场景：

• 代码写在本地 Mac，依赖构建却要跑在 Linux VPS 上；
• 部署命令发到了 A 服务器，但日志却散落在 B 服务器；
• AI 客户端里配了五六条 MCP 连接，分不清工具到底连到哪台机器。

AgentDock 的设计是：一个实例对应一个真实运行环境。它本身不提供聊天界面、也不做模型推理，只专注一件事——让 AI 在明确的权限边界内操作真实环境，并返回结构化、可追踪、可验证的结果（详见 README.zh-CN.md）。

多设备协同的关键在于 NexusDock 这一自托管中心服务：它把多台 AgentDock、长期记忆和 Workflow 集中到一个入口。配对后，AI 客户端只需配置 NexusDock 的统一/mcp地址，执行时按node_id把工具调用路由到目标设备 ✅

只有一台设备、也不需要共享记忆时，直接连接本机 AgentDock 即可，不必额外部署 NexusDock。

快速上手：三步完成设备配对

配对逻辑实现在 cmd/agentdock/command_nexus.go，设备身份凭据由 internal/nexusbridge/identity.go 以 0600 权限安全落盘。

第 1 步：每台设备部署一个 AgentDock

普通用户直接下载官方安装包即可（支持 macOS、Windows、Linux 服务、Docker），不需要源码和 Go 工具链。

第 2 步：在 NexusDock 上生成一次性配对码

在 Web 控制台为每台设备添加节点，获得一次性配对码。

第 3 步：在各设备上执行配对命令

agentdock nexus pair \ --endpoint <你的NexusDock地址> \ --code "一次性配对码" \ --name "Mac mini"

配对成功后会显示node_id，设备凭据保存在数据目录的nexus/device.json：

agentdock nexus status # AgentDock 已配对到 <地址>，node_id=...，Device Token 已保存

⚠️Linux 服务部署注意：systemd 的 Core 往往不以当前终端账号运行，手动配对时要以服务用户身份执行并显式指定数据目录，否则凭据可能落错位置。参考 core-skills/agentdock-user-guide/references/linux.md 的官方示例：

sudo -u agentdock agentdock nexus pair \ --endpoint <NexusDock地址> --code "配对码" \ --agentdock-home /srv/agentdock/.agentdock sudo systemctl restart agentdock sudo -u agentdock agentdock nexus status \ --agentdock-home /srv/agentdock/.agentdock

接入 AI 客户端：一条统一 MCP 地址搞定全部设备

每台 AgentDock 配好后，AI 客户端（ChatGPT、Claude、Codex 等）只需要接入 NexusDock 的统一 MCP 地址，例如https://<你的NexusDock域名>/mcp。支持 OAuth 的客户端直接授权，其他客户端使用 NexusDock 的 MCP Access Token。

连接建立后，Nexus 桥接（实现见 internal/nexusbridge/client.go）会自动完成：

• 握手上报每台设备的工具清单、版本与能力（Capabilities）；
• 心跳保活，断线后按指数退避自动重连；
• 远程工具调用按request_id精确路由，支持中途取消，单次调用 panic 只结束当前请求，不会带崩整个设备守护进程。

对话中先让 AI 调用agentdock_context确认“当前工具实际连到哪一个实例、设备是否在线”，再下达具体操作，是最稳妥的工作习惯。

实战：三个高频跨设备工作流

场景一：一次盘点所有设备状态

“帮我看看我每一台设备的状态和工具数量。”

AI 会汇总出类似上面配图中的表格：Mac mini、Windows PC、Ali VPS、BR VPS、SM VPS 各自的系统、在线状态、AgentDock 版本与工具数，一眼掌握全局 📋

场景二：本地写代码 + VPS 构建部署

“在 Mac 上完成这次提交，然后在 Ali VPS 上跑一遍构建并部署，部署完在 BR VPS 上确认反代配置生效。”

• 本地 Mac 节点：读写文件、Git 提交；
• Ali VPS 节点：执行构建命令、管理 Docker 服务；
• BR VPS 节点：检查反向代理配置、端口和真实运行状态。

三个节点的工具调用全部在同一次对话里完成，执行发生在各自真实的机器上。长命令支持会话化观察、输入与停止，输出带超时和脱敏边界。

场景三：跨设备共享长期记忆与 Workflow

这是 NexusDock 最“杀手级”的价值 👇

🧠 Recall 长期记忆：NexusDock 提供集中式 Recall 工作区，所有配对设备共享同一份中心记忆——长期项目上下文、运行手册、经验记录、私密笔记。AI 客户端通过以下工具直接操作（规格定义见 internal/app/specs_recall.go）：

没有 NexusDock 时，每台设备的 Agent 记忆彼此不可见；接入后，Mac 上总结的排障经验，VPS 上的会话也能直接检索引用。

🔄 Workflow 可复用模板：NexusDock 集中保存 Workflow 模板，通过workflow_template_manage（传输实现见 internal/tool/task/nexus_transport.go）提供match、get_many等动作。多步骤开发、部署、排障、迁移任务会先匹配模板，再用task_manage持久化执行进度——中断后可恢复，跨设备也能继续推进。

安全边界与实战注意

🔒 多设备协同不等于把钥匙随便交出：

• 公网必须带认证：配对端点要求 HTTPS，Device Token 只存本机nexus/device.json（0600），nexus status不会输出 Token 明文；
• 设备间能力隔离：实际文件、命令、浏览器操作始终由目标设备自己的 AgentDock 执行，NexusDock 负责中心管理、共享记忆与跨设备路由；
• 确认目标再动手：多设备时先确认node_id，避免把“改配置”发到错误的机器；
• 凭据不进截图：Token、OAuth 密码、配对码不要出现在公开聊天或 Issue 中；
• 离线即降级：某台设备离线时，其工具调用会明确报错而不是静默路由到其他设备。

此外，Cloud 资源库（Skill/Plugin 跨设备导出与远程安装）仍在开发中，相关设计见 docs/cloud-resource-library-device.md，目前设备端以本地控制面为主，远程能力以官方实际开放为准。

小结

✅ 一句话回顾这套多设备协同架构：

• 每台设备部署AgentDock：统一的文件、命令、Git、Skill、MCP、浏览器与任务能力；
• 自托管NexusDock作为中心：统一/mcp入口、设备路由、Recall 共享记忆与 Workflow 模板；
• agentdock nexus pair一步配对，AI 客户端一条连接统筹所有设备。

从“多终端来回切换”到“一次对话统筹全设备”，这套组合让 AI 真正拥有了一双能触达你所有机器的手。更多平台细节与排障流程，建议让 AI 直接加载内置的用户指南 core-skills/agentdock-user-guide/SKILL.md 来处理 📖