Sandbox 完整页
默认React、Vue 或 Vanilla 均可。页面运行在隔离 webview，通过 Manifest 权限与全局 wf 调宿主能力。
- 适合绝大多数第三方应用
- 显式 Hash 路由支持导航与分享
- 构建产物为
.wfapp.zip
开发者中心开发者总览
从一个想法，到可安装的小程序
WorkFly 小程序：沙箱完整页、可声明的 Agent 能力、可选宿主 Surface。先选复杂度档位，再写代码——不要一次堆满 Manifest。
创建第一个工程
交互选择框架，生成 Manifest v2、Vite 配置与本地调试环境。装进客户端前用 npm run build 出包。
npm create @workfly/app my-app
推荐路径
理念 → 阶梯选档 → 指南细读 → 案例对照。AI 助手可通过 @workfly/mcp 读取与本客户端同版本的规范主题。
- 1理解
先弄清 Tool / Skill / Surface 与 MCP 边界。
- 2创建
脚手架生成 Manifest v2 与 Vite 工程。
- 3验证
浏览器调试后，安装 .wfapp.zip 测真实沙箱。
- 4升档
按需加 query Tool、Skill，再考虑宿主卡。
三档复杂度
复杂度跟随需求出现。官方案例 CURL 偏档 0，红火台覆盖档 1–2。
先选运行形态
完整页与宿主 Surface 是两层能力，不是互斥的框架选项。详见 设计理念。
React UI Module
高信任只有会话卡或磁贴确需直接挂进宿主时才增加。完整页仍留在 Sandbox。
- 宿主 external React 19 runtime
- 依赖独立 split chunks
- Shadow DOM 隔离样式，安装前确认风险
工具链各司其职
每个包只解决一个阶段的问题；能力出口是 MCP，不是第二套业务协议。
@workfly/create-app- 创建标准工程与模板。
@workfly/vite-plugin- 注入开发态 SDK、代理请求、校验并构建。
@workfly/wf-types- 提供 Manifest、SDK 与 UI Module 公共类型。
@workfly/miniapp-kit- 复用 Manifest v2 校验与确定性打包能力。
@workfly/mcp- 外部 AI 调业务 Tool，并按主题读取同版本开发规范。
最佳实践：两个官方包
代码均在仓库 packages/miniapps，网站拆解「为什么这样拆」，而不是另造演示协议。
API 分成两套看
新应用优先使用 WF；迁移友空间现有代码时再查 MTL 兼容状态。