Fillo

网站 · 文档 · Agent · 示例 · 更新日志

Fillo SDK

Fillo 是无头表单基础设施。你可以在托管编辑器中构建表单，也可以在代码中定义表单，然后使用自己的 UI 将其渲染在自己的产品中——支持 React、Vue、Svelte、Astro 或纯浏览器 JavaScript，无需嵌入 iframe。一个共享的架构为构建器、渲染器、API 验证和响应表格提供支持，让表单看起来像应用的一部分，行为也与之相符。

文件会直接从浏览器上传到你自己的存储空间（Google Drive、Box 或兼容 S3 的存储桶）；如果存储服务提供商支持断点续传，上传也会支持该功能。响应会存入一个支持架构的表格，其中包含搜索、文件下载、详情侧边栏和 CSV 导出功能，并可通过签名 Webhook、Google Sheets、Notion、Zapier 或电子邮件进行传送。

此仓库包含公开的 SDK 包和编码 Agent 技能。产品本身位于 fillo.so。

软件包

软件包	npm	说明
@usefillo/core	npm · packages/core	与框架无关的表单架构、验证、条件逻辑引擎、预填、格式化、JavaScript 客户端和浏览器直传协议。零框架依赖。
@usefillo/react	npm · packages/react	无头 React 渲染器、钩子、上传 UI，以及可选的默认样式表，你可以覆盖或替换它。
@usefillo/dom	npm · packages/dom	与框架无关的 DOM 渲染器、自定义元素，以及适用于 Vue、Svelte、Astro 和原生应用的独立浏览器包。
@usefillo/cli	npm · packages/cli	fillo — 在终端中启动工作区、暂存并发布表单，以及安装 Agent Skill。
@usefillo/mcp	npm · packages/mcp	MCP 服务 — 从编码 Agent 中创建、搭建脚手架、发布和查询表单。

规范的编码 Agent 技能（与 CLI 安装的包相同）位于 plugins/fillo/skills/build-with-fillo。 所有软件包均采用 MIT 许可证。

快速开始

安装一个渲染器，并将已发布的表单嵌入应用。@usefillo/react 和 @usefillo/dom 都会重新导出所需的 @usefillo/core 部分，因此你 很少需要直接安装 core。

// React / Next.js
import { FilloForm } from "@usefillo/react";
import "@usefillo/react/styles.css"; // optional default theme — or bring your own

<FilloForm formId="cust-feedback" onSubmitted={(responseId) => confetti()} />

// Vue, Svelte, Astro, or plain browser JavaScript
import { createClient, defineForm, renderForm } from "@usefillo/dom";
import "@usefillo/dom/styles.css";

const client = createClient({ key: "pk_live_…" });
const form = defineForm({
  id: "cust-feedback",
  pages: [{ id: "p1", blocks: [
    { id: "email", kind: "email", label: "Work email", required: true },
    { id: "message", kind: "long_text", label: "What should we know?" },
  ] }],
});

renderForm("#fillo-form", { form, client, onSubmitted: (id) => console.log(id) });

使用编码 Agent 构建

Fillo 提供了一个与提供商无关的 Agent Skill，可指导你的 Agent 构建、 嵌入、设置样式、同步和验证 Fillo 表单。将它安装到项目中：

npx @usefillo/cli@latest skill install

在 Claude Code 或 Codex 中，此仓库也是一个插件市场。该插件将此 Skill 与托管的 Fillo MCP 服务打包在一起：

/plugin marketplace add jacobfunch/usefillo
/plugin install fillo@fillo

然后让你的 Agent 按照设置流程操作。在产品中通过 Build with AI 移交时，CLI 也会输出一条单行 npx @usefillo/cli agent bootstrap … 命令，一次运行即可安装此 Skill 并连接实时工作区。完整的 Agent 流程请参阅 fillo.so/agents，参考文档请参阅 fillo.so/docs。

链接

• 网站 — fillo.so
• 文档 — fillo.so/docs
• Agents — fillo.so/agents
• 示例 — fillo.so/examples
• 更新日志 — fillo.so/changelog

关于此仓库

此仓库是公开 SDK 包的只读镜像。这些包在私有 monorepo 中开发，并在发布时镜像到这里，因此你看到的代码与发布到 npm 的代码相同。这里的历史记录不保证保留：每次发布时，自动化任务都会强制推送镜像，因此不要基于特定提交创建分支并期望它保持不变；请改为依赖 npm 包。

欢迎在此提交问题和提问 — 详见 CONTRIBUTING.md。针对包代码的拉取请求无法直接合并，因为源代码位于上游；请提交问题，我们会通过私有仓库引入修复。

关于账户名称的说明。 此镜像目前位于 github.com/jacobfunch/usefillo，同时我们正在申请 usefillo GitHub 组织。 申请完成后，仓库将转移至该组织；GitHub 会保留旧路径的重定向，因此现有链接和克隆仍可正常使用。