01
目标机器路由
每个工具调用点名目标机器。IP 不是身份，会话不是身份——机器编号才是；路由开销约五毫秒。
数字不是成绩单，是边界——每一个都能在文档或产物里核对。
6
道安全机制逐条可核验，合规报告直接引用
15
页核心文档，部署与用法完整覆盖
54
页文档语料，从安装到运维全流程
1
条命令拉起服务端，当天上岗
个人助手管生活，写代码的管 PR——企业的活，谁来管
个人 agent 替你订机票，coding agent 替你改代码。企业的活长在真实业务的机器、内网和数据里——这三道分界线，就是 MagicFrog 要接的班。
01
每一次操作，都点名自己的目标电脑
浏览器、命令行、文件——每一个操作都带明确的执行目标。目标选错、机器离线、权限不足：操作立即失败并说明原因，系统不会自行换机继续。
- 缺 ID、错配、撤销、能力不足，一律明确失败
- 资源句柄绑定原 computerId，禁跨机串用
- 操作记录标注实际执行机器
- 目标授权两层：控制面一次，设备端再一次
02
内网出口，是一道授权而不是一个环境变量
Agent 访问内网系统时，走的是你显式授权的客户端隧道。隧道断线、授权过期、权限撤销，通路立即关闭——fail-closed，绝不退回直连。
- 出口选择是显式生命周期
- 切换出口不复用旧通道
- 吊销 grant 五秒内生效
- 隧道中途断开，浏览器连接即刻失败
03
已有的设备，一条命令登记成节点
跑一条 enroll 命令，已有的电脑、VM、服务器立即登记为可操作节点。注销只收回权限，不关机、不重装、不碰原机上的任何数据。
- enroll 登记一条命令完成
- 设备凭据独立于账号登录
- unenroll 注销只撤销接入
- 不关机、不重装、不碰原机数据
04
人是事件队列的处理者，不是会话的陪坐者
任何一个任务里的 agent 需要人拍板，事件就落进同一个全局收件箱。你按队列逐个处理——回应、批准、回答——回应直接写回该任务的会话。队列清空，就没有剩余的事要做。
- 四类卡面一套骨架：批准、提问、表单、接管
- 跨全部任务聚合，不止你打开的那一个
- 处理完自动回对话页，队列空态禁入
- 每张卡片可跳回原文定位上下文
数字员工的一天
活交给数字员工，人只签关键决定；下班之后，服务器接着跑。
01
早上 · 运营
早上要昨日的报表？Agent 自己拉数、汇总，你打开控制台，成品已经在等你。
对应差异 · 显式目标路由
02
午后 · 开发
盯构建进度、抓报错日志、修好再提交 PR——人只审那些真正关键的变更。
对应差异 · 已有设备零改造
03
下午 · 行政
一批表单逐条填写、核对、提交，整条处理路径全部留痕，随时可以回溯。
对应差异 · 内网出口
04
下班 · 全员
人下班了，任务照常跑。第二天早上到工位，结果已经汇总完毕，等你审阅。
对应差异 · 已有设备零改造
真实登记录屏：CLI 打印一次性配对码，回输同一配对码完成确认，机器即刻出现在账号名下。
网页控制台的运行中会话：任务列表、事件收件箱与审计记录在同一个工作台里。
账号名下的设备列表：云电脑与已登记真机并列，每台都带状态与探测出的能力。
一个控制台，管一整支数字团队
不是功能清单，是同一台服务器上的同一套纪律：每一步有对象、有授权、有记录。
02
云电脑与真实机并存
服务端在本机创建 Linux 与 Windows 云电脑；你已有的服务器一条命令登记。两种目标，同一套授权。
03
浏览器会话隔离
每个会话是独立实例：独立进程、独立 profile、独立端口。每机并发上限四，超限显式排队或拒绝。
04
记忆五维度
账号、用户、agent、任务、设备五层记忆树，纯 Markdown 落盘，具体维度覆盖泛化维度。
05
触发器与 watcher
cron 定时跑与脚本 watcher 循环看，都绑定显式目标。错过的计划槽跳过不重放。
06
事件收件箱
批准、提问、表单、接管四类人机事件汇入一个全局队列，回应直接写回任务会话。
07
语音全自托管
听写与朗读走你自己的转写与合成端点，默认只在本机回环。第三方语音云进不了这条链路。
08
MCP 市场
官方 registry 加自定义源聚合成一份目录，网页浏览、一键把安装任务送到桌面端执行。
每一项能力都在文档里有对应章节，链接直达，不绕路。
拥有，还是按月租
同一个岗位，两种成本结构——逐项对给你看。
01
付费方式
拥有 MagicFrog
一次部署，永久使用，不按席位付费
自部署免费，没有托管套餐，也没有隐藏档位。
租用 agent 平台
按月付费，席位越多账单越高
02
数据边界
拥有 MagicFrog
数据不出你的门，全部留在你的服务器上
全部数据落在一个文件里，位于你的数据目录——备份就是备份这个卷。
租用 agent 平台
数据存在别人的服务器上，边界由别人定
03
存续
拥有 MagicFrog
免费自部署，想跑就跑
服务端是单文件可执行，你的服务器在，它就在。
租用 agent 平台
停止付费，服务立即停止
数据自有不是打包票，是部署形态本身：SQLite 文件在你的卷上，字段加密密钥由你保管。
省下的不只是钱，是你对数据的所有权。
三道分界线加一个队列，构成 MagicFrog 的骨架：机器有名字、出口有授权、设备零改造、人只管拍板。
今天就把 MagicFrog 跑起来
客户端装在你每天用的电脑上，服务端用一条命令装上你的服务器。
01
下载客户端
桌面端与 CLI，直接下载，装完即用。
02
一条命令装服务端
单文件服务端，curl 直装，你的服务器即刻成为控制面。
03
交给你的 agent
把部署 skill 发给它，它按文档一步步执行。
三条通道殊途同归：最后都停在同一台你自己的服务器上。
不想自己动手？
把这段提示词交给你的 agent，它会按部署文档把服务端装好。
Deploy a MagicFrog server for me. 1. Fetch the deploy skill document at https://www.magicfrog.ai/agent-deploy/ (raw markdown at https://www.magicfrog.ai/agent-deploy.md). 2. Follow it exactly: install the single-file magicfrog-server, export the required environment, start it on port 4096, and finish the admin bootstrap and forced password change. 3. SSH connection details for the target server are provided by me: <fill in: host, port, user, key or password> 4. Stop and report back if any step fails; never substitute an undocumented command or skip a required environment variable. 5. When you finish, report the server URL (default http://localhost:4096) and the admin identifier so I can connect my client with --server <serverUrl>.
三步，从下载到第一名数字员工上岗
已经检测到你的平台，也可以手动切换选择；每一步都可以自由来回。
检测到平台: ·手动选择:
STEP / 01
安装客户端
把 magicfrog CLI 装入 ~/.magicfrog/bin 并更新 PATH。
curl -fsSL https://www.magicfrog.ai/install | bashSTEP / 02
启动服务端
安装单文件 magicfrog-server。随后按《自部署》文档配置管理员账号并启动。
curl -fsSL https://www.magicfrog.ai/install-server | bashSTEP / 03
登记一台电脑
把一台已有电脑、VM 或服务器与账号配对，登记为可操作节点。
magicfrog enroll --server https://<host>:4096
部署前，先回答这八个问题
需要订阅或云端账号吗？
不需要。MagicFrog 是自部署软件，模型走你自己的 API key，没有托管层，也没有捆绑套餐。
我已有的电脑能接进来吗？
可以。在目标机器上跑 magicfrog enroll，配对后它就成为账号下的一台可操作电脑。
机器离线时会怎样？
发往它的调用显式失败。系统不会改投本机或另一台在线机器。
支持哪些操作系统？
Linux、macOS 与 Windows。shell、文件与浏览器按真实能力验证；桌面控制还取决于系统权限，例如 macOS 的屏幕录制授权。
数据存在哪里？
你的服务器上，一个 SQLite 文件。备份就是备份这个卷；字段加密密钥也由你保管。
能用自己的模型供应商吗？
能。Anthropic、OpenAI 与任意 OpenAI 兼容端点都是 BYOK 通道，本地推理服务器走内置预设发现。
能部署几个服务端？
一个控制面只编排它所在的主机。这是 LITE 边界，不是可调参数；登记真机不受此限。
安装包需要签名吗？
不需要。未签名产物属于合法交付，系统提示不是产品故障；每个产物都带 SHA-256 与字节大小校验。
自部署最低要求是什么？
一台能跑 Linux 的 VPS 或自己的服务器即可。服务端是 bun 编译的单文件可执行，SQLite 随数据目录落盘，不依赖外置数据库容器。
一键起站的命令从哪来？
curl -fsSL https://www.magicfrog.ai/install-server | bash 装上单文件服务端，命令与步骤见 SELFHOST.md；也可以把 /agent-deploy 的 skill 文档发给你的 agent 代你执行。
客户端下载完怎么连？
客户端无内置配置，三步即可：①在服务器上装好服务端 ②本机装好客户端 ③首次启动把服务器地址填进服务器地址栏即连。下载页输入地址会生成对应指引。
Google OAuth 登录怎么开？
在 admin 后台配置 Google client id 与 secret，并设置 redirect URI 严格校验和 email 域名白名单。缺省 OAuth 是关闭的，路由不存在零暴露；自建账号始终是主登录通道。
HTTPS 怎么配？
两条路：用 caddy 一键反代（compose profile 启用即自动 TLS 终止），或在你自己的反代上终止 TLS。走反代时设 MAGICFROG_TRUST_PROXY 让服务端信任 X-Forwarded-For/Proto。
服务器和客户端必须同一台机器吗？
不必。异机是标准场景，服务端默认监听 0.0.0.0 就是为了跨设备可达。客户端填入服务器地址即可连。
数据存在哪里，怎么备份？
服务端数据在一个 SQLite 文件里，随你指定的数据目录落盘。备份就是备份这个目录；字段加密密钥也要一起保管，丢了无法恢复。