Freeform

在 EmDash 中使用 AI 輔助的建構器建立表單,附帶垃圾訊息評分、郵件通知、Webhook 和 CSV 匯出。

外掛

Freeform

在 EmDash 中使用 AI 輔助的建構器建立表單,附帶垃圾訊息評分、郵件通知、Webhook 和 CSV 匯出。

  • 分類: forms
  • 狀態: 可用
  • 版本: 0.1.4
  • 價格: 未知
  • 來源: 官方外掛註冊表
  • 安裝方式: 註冊表沙盒外掛
  • 核實日期: 2026-10-21

說明

Freeform for EmDash

建構表單、收集提交內容並對其採取行動——無需離開 EmDash。

表單建構器

  • 13 種欄位類型:text、email、textarea、number、phone、date、checkboxes、radio、dropdowns、multi-select、hidden 和 HTML 區塊
  • 以列為基礎的版面配置,並支援逐欄位驗證(長度、模式、最小/最大值)
  • AI 建構器,可根據一段簡單的英文描述建立和編輯表單
  • 開箱即用的聯絡和電子報訂閱入門表單

提交內容

  • 可搜尋的提交收件匣,支援分頁和完整的詳細檢視
  • AI 提交摘要:意圖、緊急程度、關鍵事實和建議的下一步動作
  • 匯出 CSV,便於用於試算表和報表

自動化與防護

  • 帶可重複使用範本的郵件通知,可發送給你或提交者
  • 帶簽章的 Webhook(HMAC-SHA256),支援自動重試和遞送記錄
  • 垃圾訊息評分,每次提交都帶有蜜罐和 CSRF 防護
  • 選用的 MCP 伺服器,讓 AI 代理可以管理表單並讀取提交內容

表單透過配套的 @solspace/freeform-astro 套件在你的網站上渲染,它提供不帶樣式的元件,供你用自己的 CSS 設計佈景主題。

安裝

安裝

1. 安裝外掛

在 EmDash 管理後台中,前往 Plugins → Registry,找到 Freeform 並 安裝。安裝後,Freeform 會出現在側邊欄中。

2. 在你的網站上渲染表單

Freeform 的管理介面位於外掛中;公開的表單由一個 小型配套 Astro 套件渲染:

pnpm add @solspace/freeform-astro
// astro.config.mjs
import { defineConfig } from "astro/config";
import emdash from "emdash/astro";
import freeformAstro from "@solspace/freeform-astro";

export default defineConfig({
  integrations: [emdash(), freeformAstro()],
});

然後透過表單的 handle 嵌入任意表單:

---
import { FreeformForm } from "@solspace/freeform-astro/components";
---

<FreeformForm formId="contact" />

3. 選用:AI 功能

AI 表單建構器、垃圾訊息評分和提交摘要需要你自己的 Anthropic API 金鑰。請在 Freeform → Settings 下加入。沒有金鑰時, 其他一切——手動建構表單、提交內容、郵件、Webhook—— 都能正常使用。

常見問題

常見問題

我需要 API 金鑰嗎? 只有 AI 功能(AI 表單建構器、AI 垃圾訊息評分、提交 摘要)才需要。請在 Freeform → Settings 中加入你自己的 Anthropic API 金鑰。表單、 提交內容、郵件通知和 Webhook 無需金鑰即可使用。

如何保護提交內容免受垃圾訊息侵擾? 每個表單都帶有蜜罐欄位和帶簽章的 CSRF 權杖。如果你加入了 Anthropic 金鑰,每次提交還會獲得一個 AI 垃圾訊息評分,並根據 你控制的閾值(依表單或全域)進行標記。

我能收到新提交的通知嗎? 可以。建立一個郵件範本,把它指派給某個表單,並選擇是發送給 提交者(使用其信箱欄位)還是發送到固定位址。你 還可以在每次提交時向任意 URL 發送帶簽章的 Webhook。

如何匯出提交內容? 在 Submissions 檢視中,你可以下載任意表單的 CSV,或產生 一個短期有效的匯出連結。

AI 代理能管理我的表單嗎? 可以。Freeform 提供選用的 MCP 伺服器(emdash-freeform-mcp), 向 Claude 和 Cursor 等用戶端開放表單和提交內容工具。

渲染出的表單帶有樣式嗎? 沒有——這是有意設計的。@solspace/freeform-astro 渲染帶有 data-freeform-* 屬性的語意化 HTML,使表單與你網站的設計系統相符。

安全性

安全性

回報漏洞

請寄送電子郵件至 [email protected]。請不要為安全問題公開提交 issue。

Freeform 如何保護你的網站

  • 提交表單帶有蜜罐欄位和 HMAC 簽章的 CSRF 權杖 (防時序攻擊的驗證,2 小時有效期)。
  • 對外發送的 Webhook 使用 HMAC-SHA256(X-Freeform-Signature)簽章, 接收方可以驗證其真實性。
  • 你提供的 API 金鑰(例如 Anthropic)儲存在你網站自己的 外掛儲存空間中——絕不會傳送給 Solspace。
  • 匯出連結是短期有效的簽章權杖;它們會自動過期。