生态

模型用自己的，工具自己挑，分发自己管

密钥走你自己的账号，工具来自官方市场，产物经你的分发管道直达用户——生态的每一层都在你自己的基础设施上。

供应商三通道

MagicFrog 只有三条模型通道，且每条都是自带密钥（BYOK）：Anthropic、OpenAI 与自定义 OpenAI 兼容端点。没有可浏览的厂商目录，也没有订阅登录路径。

三条通道对应三种模型接入姿势，全都是自带密钥：

BYOK 的含义在部署里看得最清楚：服务端数据库里存的是你贴进去的那把密钥，供应商后台里看到的调用方是你的服务器 IP。中间没有任何一层属于我们。

自建推理服务器也走内置预设发现：本地起的 OpenAI 兼容端点会被自动识别，无需手写接入代码。密钥轮换是更新一次配置，不需要重启工作台。

通道越少，凭证面越小：三条通道对应三把你亲自保管的密钥。

密钥只在你的服务端与供应商端点之间流动，MagicFrog 不设任何中转。

执行 /connect 选择 Anthropic，粘贴 API key，执行 /model 选择模型。

执行 /connect 选择 OpenAI，粘贴 API key；官方端点同时接受 chat completions 与 Responses 两种请求形态。

大多数 provider 都提供 OpenAI 兼容 API：存密钥，再在 magicfrog.json 里声明 provider。

三条通道共用同一条纪律：密钥只存在你的服务端数据库里，不进客户端产物，也不进任何配置仓库。换模型是改一次配置，不是换一次供应商。

产品内直接聚合官方 registry 与你自己的自定义源。

市场不只是浏览页——它带着一条显式的安装队列协议：

市场是三族目录：MCP server、插件与技能，桌面端与网页端消费同一层数据。官方 registry 恒在且不可移除；你也可以声明说同一套 registry API 形状的自有目录端点，把内部工具并入同一份列表。

web 端浏览不需要账号，登录只在发起安装那一步出现；token 只活在页面内存，关掉标签页即消失。这套凭据纪律与你期望的浏览器行为完全一致。

安装队列显式流转：pending → claimed → executed，终态不可变，失败必带原因。重试绝不重复安装，结果未知绝不假报成功。

网页端与桌面端消费同一层数据，所以「存在什么、装了什么」两个入口永远一致。

自定义源说同一套 registry API 形状，所以内部工具目录可以无缝并入：一次配置，web 与桌面同时可见。安装任务按账号排队，不按机器——换电脑不丢队列。

队列按账号排队，不按机器——换电脑不丢任务。

安装载荷只带目录身份，具体配置由桌面端按你的实际环境生成。

market install queue

POST /v1/market/queue        → pending
desktop claims              → claimed
idempotent journal check    → executed
  ↘ cancelled | failed (reason)

一棵 Markdown 记忆树，五个维度，同一路径具体维度覆盖泛化维度。

记忆是 agent 跨会话保持判断力的方式，MagicFrog 把它做成一棵可编辑的树：

每次会话组装上下文前，作用域内各维度的生效视图被渲染进一个记忆块，按最具体优先排序。记忆变化时，下一次更新替换整块并明说——agent 不会混用新旧视图。