MagicFrog 是一个自部署的 AI 工作台，面向多台计算机：你自己的机器、服务端托管创建的云电脑，以及你用 CLI 登记的真实机器。
整个系统是单个服务端程序加一个数据文件；所有浏览器与系统操作都显式绑定到一台目标计算机。
你得到什么
- 一个由你掌控的控制面。 单文件
magicfrog-server加一个 SQLite 文件是主要部署形态；Docker Compose 是同一服务端的可选容器路径。参见自部署。 - 本地与云端 agent 并存。 内置 Pi agent 运行在你的机器上，服务端 agent 运行在云电脑上，两边互不代理。参见任务与 agent。
- 每个工具都必须携带 computerId。 浏览器、shell、文件与桌面操作只要没有指明目标，一律失败即关闭；句柄始终绑定它所在的机器。参见 Computer ID 路由。
- 一台服务器上的云电脑。 服务端只在自己所在的主机上创建 Linux 与 Windows 云电脑。这是产品边界，不是可调参数。参见云电脑。
- 登记真实机器。
magicfrog enroll把已有笔记本、服务器或 VM 配对登记，设备凭据与账号登录相互独立。注销登记绝不触碰原机数据。参见设备登记。 - 自带密钥。 Anthropic、OpenAI 与任意 OpenAI 兼容端点。没有捆绑订阅，也没有厂商目录。参见 Provider。
- 插件市场。 MCP 服务器、插件与 skills 共用一个目录，网页端浏览后把安装任务送到桌面端。参见市场。
- 触发器、语音、记忆与统一事件收件箱。 定时任务与观察脚本都绑定明确目标；语音只走你自己的端点；记忆按账户、用户、agent、任务与设备分层；所有任务的人为决策汇入同一个队列。参见触发器、语音、记忆与事件收件箱。
各部分如何拼合
工作台（桌面或网页）
|
v
控制面 —— 一台服务器，一个数据文件
|── 你面前的机器（local）
|── 服务端创建的云电脑（Linux / Windows）
|── 你用 CLI 登记的真实机器
└── 网络出口：直连 | frp 隧道 | 客户端代理接下来去哪
- 自部署：拉起控制面与 owner 账号。
- Provider：用你自己的密钥接入模型。
- 登记一台机器：用 CLI 登记真实计算机或 VM。
- Computer ID 路由：每个工具都遵守的目标契约。
- 管理控制台：账号、计算机与审计的 owner 控制台。