GateCrash Forms 技能

以 CLI 为先的表单构建器，践行 BYOK（Bring Your Own Keys）理念

基于 JSON Schema 生成美观、安全的 HTML 表单。邮件通知通过 YOUR SMTP 服务器发送，响应数据存储于 YOUR 基础设施之上。不依赖任何外部服务，亦无任何形式的准入限制。

✨ 已适配 Kimi Claw

专为 Kimi 的 24/7 云智能体优化：

• ✅ 原生支持在 Kimi.com 浏览器标签页中运行
• ✅ 可通过 ClawHub 超过 5,000 项技能的技能库一键安装
• ✅ 提供 40GB 云存储空间用于保存表单响应
• ✅ 兼容智能体友好的邮件服务商（agentmail.to、Resend）

您的 AI 助手现在可以为您自动生成并管理表单了！

快速上手

生成表单

./scripts/generate.sh examples/feedback.json output.html

启动服务端

./scripts/serve.sh 3000

访问 http://localhost:3000 查看所有已生成的表单。

初始化项目

./scripts/init.sh

创建 forms/ 和 responses/ 目录，并内置示例表单。

功能特性

• 🎨 支持 8+ 种字段类型：text、email、textarea、select、radio、checkbox、scale/rating、date
• 🔒 安全加固：防范 XSS 攻击、内置 CSRF Token、蜜罐反垃圾机制、请求频率限制
• 📧 BYOK 邮件支持：使用您自己的 SMTP 服务（Zoho、Gmail、SendGrid 等）
• 💾 本地化存储：响应数据可保存为 JSON 或 CSV 格式
• 🎨 精美 UI：渐变紫主题配色，响应式设计
• 🚀 完全自托管：可在任意支持 Node.js 运行的环境部署

配置说明

全局配置 SMTP 凭据：

gatecrash-forms config smtp.host smtp.example.com
gatecrash-forms config smtp.port 465
gatecrash-forms config smtp.secure true
gatecrash-forms config smtp.auth.user your-email@example.com
gatecrash-forms config smtp.auth.pass your-password

也可在 JSON Schema 中按表单单独配置。

表单 Schema 示例

{
  "title": "客户反馈",
  "description": "我们非常期待听到您的声音！",
  "fields": [
    {
      "type": "scale",
      "name": "rating",
      "label": "整体满意度",
      "min": 1,
      "max": 5,
      "required": true
    },
    {
      "type": "checkbox",
      "name": "topics",
      "label": "您最感兴趣的是什么？",
      "options": ["产品", "服务", "价格", "体验"]
    },
    {
      "type": "textarea",
      "name": "comments",
      "label": "其他意见",
      "maxLength": 500
    }
  ],
  "submit": {
    "email": "your-email@example.com",
    "storage": "responses/feedback.json"
  }
}

典型应用场景

• 客户反馈：收集产品或服务相关反馈
• 联系表单：为网站提供简洁的联系入口
• 活动注册：用于工作坊、线上/线下活动的报名表单
• 问卷调查：市场调研、用户满意度调查等
• 线索获取：无需第三方服务即可捕获销售线索

设计理念：我们撞开大门

GateCrash Forms 不是一项服务，而是一个工具制造者。

• ✅ 您的 SMTP 服务器（用于邮件通知）
• ✅ 您的存储系统（用于保存表单响应）
• ✅ 您的部署环境（可托管于任意位置）
• ✅ 您的数据主权（不经过任何外部服务器）

无需 GateCrash 账户，不依赖 GateCrash 服务器，彻底告别准入壁垒。

相关链接

• GitHub： https://github.com/Phoenix2479/gatecrash-forms
• npm： https://www.npmjs.com/package/gatecrash-forms
• 宣言文档： 查阅项目中的 MANIFESTO.md
• 完整文档： 详见 README.md

命令参考

# 基于 Schema 生成表单
gatecrash-forms generate schema.json output.html

# 启动 HTTP 服务
gatecrash-forms serve [port]

# 设置全局配置
gatecrash-forms config  

# 初始化项目
gatecrash-forms init

# 显示帮助信息
gatecrash-forms help

许可证

MIT 许可证 —— 欢迎自由使用、Fork、甚至商用。唯独请勿设置准入壁垒。

由 Dinki 与 Molty 热情打造 🔥

“我们撞开大门，从不新建一扇。”