概览

MagicFrog 是一个自部署的 AI 工作台，面向多台计算机：你自己的机器、服务端托管创建的云电脑，以及你用 CLI 登记的真实机器。

一个服务端二进制文件，一个 SQLite 数据库，所有浏览器与 OS 工具都显式绑定到一台目标计算机。

你得到什么

• 一个由你掌控的控制面。 单文件 magicfrog-server 加一个 SQLite 文件是主要部署形态；Docker Compose 是同一服务端的可选容器路径。参见自部署。
• 本地与云端 agent 并存。 内置 Pi agent 运行在你的机器上，服务端 agent 运行在云电脑上。每个 run 只有一个 runtime owner，两个位置互不代理。参见任务与 agent。
• 每个工具都必须携带 computerId。 浏览器、shell、文件与桌面操作只要没有指明目标，一律失败即关闭；句柄始终绑定它所在的机器。参见 Computer ID 路由。
• 一台服务器上的云电脑。 服务端只在自己所在的主机上创建 Linux 与 Windows 云电脑。这是 LITE 边界，不是可调参数。参见云电脑。
• 登记真实机器。 magicfrog enroll 把已有笔记本、服务器或 VM 配对登记，设备凭据与账号登录相互独立。注销登记绝不触碰原机数据。参见设备登记。
• 自带密钥。 Anthropic、OpenAI 与任意 OpenAI 兼容端点。没有捆绑订阅，也没有厂商目录。参见 Provider。
• 插件市场。 MCP 服务器、插件与 skills 共用一个目录，网页端浏览后把安装任务送到桌面端。参见市场。
• 触发器、语音、记忆与统一事件收件箱。 定时任务与观察脚本都绑定明确目标；语音只走你自己的端点；记忆按账户、用户、agent、任务与设备分层；所有任务的人为决策汇入同一个队列。参见触发器、语音、记忆与事件收件箱。

各部分如何拼合

工作台（桌面或网页）
        |
        v
控制面  -- computerId 路由 -->  local provider
   |  SQLite                       docker provider
   |  单主机                       windows provider
   |                               enrolled daemon（主动出站）
   +-- 出口：direct | frp | 客户端代理

接下来去哪

1. 自部署：拉起控制面与 owner 账号。
2. Provider：用你自己的密钥接入模型。
3. 登记一台机器：用 CLI 登记真实计算机或 VM。
4. Computer ID 路由：每个工具都遵守的目标契约。
5. 管理控制台：账号、计算机与审计的 owner 控制台。