02
个人助手与 enterprise agent 之间，隔着三道分界线
内网出口，是一道授权而不是一个环境变量
Agent 访问内网系统时，走的是你显式授权的客户端隧道。隧道断线、授权过期、权限撤销，通路立即关闭——fail-closed，绝不退回直连。
已有的设备，一条命令登记成节点
跑一条 enroll 命令，已有的电脑、VM、服务器立即登记为可操作节点。注销只收回权限，不关机、不重装、不碰原机上的任何数据。
03
四个时刻，看见 agent 接管的一天
活交给 Agent 去做，人只签关键决定；下班之后，服务器接着跑。
09:0001
早上要昨日的报表？Agent 自己拉数、汇总，你打开控制台，成品已经在等你。
对应差异 01 显式目标路由14:0003
盯构建进度、抓报错日志、修好再提交 PR——人只审那些真正关键的变更。
对应差异 03 已有设备零改造17:0002
一批表单逐条填写、核对、提交，整条处理路径全部留痕，随时可以回溯。
对应差异 02 内网出口22:0003
人下班了，任务照常跑。第二天早上到工位，结果已经安静地就位。
对应差异 03 已有设备零改造04
拥有 vs 租用
同一个岗位，两种不同的花法。
| 规格项 | 租用 agent 平台 | 拥有 MagicFrog |
|---|---|---|
| 按月付费，席位越多涨价越凶 | RUNS一次部署，永久使用，不按席位付费 | |
| 数据存在别人的服务器上，边界由别人定 | LOCAL数据不出你的门，全部留在你的服务器上 | |
| 停止付费，服务立即停止 | FREE免费自部署，想跑就跑 |
省下的不只是钱，是你对数据的所有权。
今天就把 MagicFrog 跑起来
客户端装在你每天用的电脑上，服务端用一条命令装上你的服务器。
下载客户端
桌面端与 CLI，直接下载，装完即用。
一条命令装服务端
单文件服务端，curl 直装，你的服务器即刻成为控制面。
交给你的 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>.
05
三步，从安装一路走到登记
已经检测到你的平台，也可以手动切换选择；每一步都可以自由来回。
检测到平台: ·手动选择:
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
06
部署前，先回答这十五个问题
需要订阅或云端账号吗？
不需要。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 文件里，随你指定的数据目录落盘。备份就是备份这个目录；字段加密密钥也要一起保管，丢了无法恢复。