Web Notepad Free

轻量化在线表单管理工具，支持表单创建、提交和查询，适合个人和小团队快速搭建信息收集流程。

Install

openclaw skills install @thcjp/web-notepad-free

在线表单笔记(免费版)

一个面向个人开发者与小型团队的轻量化表单管理Skill,通过REST API和命令行工具的组合,帮助你快速搭建信息收集流程。本免费版聚焦"创建-提交-查询"主路径,适合个人或小型团队试用。

概述

本Skill封装了一组通用的表单管理接口,屏蔽了底层存储与权限细节。你只需要专注于业务字段设计,即可在数分钟内拥有一个可用的表单收集通道。免费版适合日提交量不超过200条的场景。

核心能力

能力	描述	免费版是否支持
项目管理	列出项目、获取项目ID	支持
表单CRUD	创建、查询、更新、删除表单	支持(单次≤10字段)
提交数据	创建、查询、删除单条提交	支持
批量提交	一次性导入多条提交	不支持
高级筛选	按日期范围、自定义字段筛选	部分支持
Webhook订阅	提交事件推送	不支持
自定义模板	复用表单结构	不支持
技术实现要点：核心能力基于`input_params`参数与`output_format`配置实现,支持创建/查询/修改/删除等操作模式,通过`config_options`进行运行时配置。

核心功能执行

用input_params参数进行配置。

输入: 用户提供核心功能执行所需的指令和必要参数。处理: 解析核心功能执行的输入参数,完成核心逻辑,返回结构化响应。输出: 返回核心功能执行的响应数据,包含状态码、结果和日志。

执行此能力时使用input_params参数,支持创建/查询/导出操作

参数配置与调用

用config_options参数进行配置。

输入: 用户提供参数配置与调用所需的指令和必要参数。处理: 解析参数配置与调用的输入参数,完成核心逻辑,返回结构化响应。输出: 返回参数配置与调用的响应数据,包含状态码、结果和日志。

执行此能力时使用config_options参数,支持修改/重置/导入操作

结果处理与输出

用output_format参数进行配置。

输入: 用户提供结果处理与输出所需的指令和必要参数。处理: 解析结果处理与输出的输入参数,完成核心逻辑,返回结构化响应。输出: 返回结果处理与输出的响应数据,包含状态码、结果和日志。

执行此能力时使用output_format参数,支持导出/保存/转换操作 能力覆盖范围：本skill的核心能力覆盖以下场景关键词：轻量化在线表单与、提交数据管理工具、支持表单创建、提交查询、字段配置等核心能、适合个人快速搭建、信息收集流程、在线表单笔记、是面向个人开发者、与小型团队的轻量、化表单管理、REST、API、与命令行工具的组、帮助用户在数分钟、内搭建可用的表单、收集流程等。这些关键词对应description中声明的使用场景,均已在上述能力点中提供对应的操作支持。

使用场景

场景一:个人博客联系表单

独立博主希望在博客底部放一个联系表单,访客填写后博主收到邮件通知。

bash

# 1. 获取项目ID
curl -H "Authorization: Bearer $WEB_NOTEPAD_API_KEY" \
  "https://api.web-notepad.example/v1/projects" | jq '.data[] | {projectId, name}'
# ...
# 2. 创建联系表单
curl -X POST -H "Authorization: Bearer $WEB_NOTEPAD_API_KEY" \
  -H "Content-Type: application/json" \
  "https://api.web-notepad.example/v1/forms" \
  -d '{
    "name": "博客联系表单",
    "description": "访客留言通道",
    "projectId": "proj_xxx",
    "fields": [
      {"path": "name", "label": "称呼", "type": "text", "required": true},
      {"path": "email", "label": "邮箱", "type": "email", "required": true},
      {"path": "message", "label": "留言内容", "type": "textarea"}
    ]
  }'
# ...
# 3. 发布表单
curl -X PATCH -H "Authorization: Bearer $WEB_NOTEPAD_API_KEY" \
  -H "Content-Type: application/json" \
  "https://api.web-notepad.example/v1/forms/{formId}" \
  -d '{"status": "published"}'

场景二:小型活动报名

线下读书会组织者需要快速收集参与者信息,人数预计30-50人。

bash

# 创建报名表单
curl -X POST -H "Authorization: Bearer $WEB_NOTEPAD_API_KEY" \
  -H "Content-Type: application/json" \
  "https://api.web-notepad.example/v1/forms" \
  -d '{
    "name": "读书会报名",
    "projectId": "proj_xxx",
    "fields": [
      {"path": "name", "label": "姓名", "type": "text", "required": true},
      {"path": "phone", "label": "手机号", "type": "phone", "required": true},
      {"path": "session", "label": "场次", "type": "select", "options": [
        {"value": "morning", "label": "上午场"},
        {"value": "afternoon", "label": "下午场"}
      ]}
    ]
  }'
# ...
# 查询报名情况
curl -H "Authorization: Bearer $WEB_NOTEPAD_API_KEY" \
  "https://api.web-notepad.example/v1/forms/{formId}/submissions?pageSize=50"

场景三:产品反馈收集

MVP阶段产品经理希望快速收集种子用户反馈,无需自建后端。

bash

# 提交反馈
curl -X POST -H "Authorization: Bearer $WEB_NOTEPAD_API_KEY" \
  -H "Content-Type: application/json" \
  "https://api.web-notepad.example/v1/forms/{formId}/submissions" \
  -d '{
    "data": {
      "name": "张三",
      "email": "zhangsan@example.com",
      "message": "希望增加导出PDF功能"
    }
  }'

不适用场景

以下场景在线表单笔记(免费版)不适合处理：

逆向工程闭源API
API安全渗透测试
非标准协议集成

触发条件

需要API集成、接口对接、Webhook配置、系统连接时使用。不适用于非本工具能力范围的需求。

快速开始

预计上手时间:<60秒。

Step 1:配置API Key

bash

export WEB_NOTEPAD_API_KEY="your_api_key_here"

Step 2:验证连通性

bash

curl -H "Authorization: Bearer $WEB_NOTEPAD_API_KEY" \
  "https://api.web-notepad.example/v1/projects"

返回项目列表即代表连通正常。

Step 3:创建第一个表单

参考"使用场景"中的任意一个示例,3分钟内即可上线。

示例

字段类型速查表

类型	描述	校验选项
`text`	单行文本	minLength, maxLength, pattern
`email`	邮箱	内置校验
`phone`	电话	内置校验
`number`	数字	min, max
`date`	日期	-
`select`	下拉	options: [{value, label}]
`checkbox`	复选	-
`textarea`	多行文本	minLength, maxLength
`file`	文件上传	免费版限制1MB以内

字段Schema完整示例

json

{
  "path": "fieldName",
  "label": "显示名称",
  "type": "text",
  "required": true,
  "placeholder": "提示文字",
  "helpText": "帮助说明",
  "options": [{"value": "a", "label": "选项A"}],
  "validation": {
    "minLength": 1,
    "maxLength": 500,
    "pattern": "^[A-Z].*",
    "min": 0,
    "max": 100
  }
}

最佳实践

字段命名遵循语义化:path使用小驼峰或下划线命名,避免中文或特殊字符
必填字段控制在3个以内:过多必填项会显著降低提交率
为长文本字段设置maxLength:防止恶意超大输入拖垮查询性能
按业务线划分项目:不同业务线使用独立project,便于权限隔离与数据统计
定期清理测试数据:测试完成后及时删除测试提交,避免污染统计

常见问题

Q1: 创建表单时返回403怎么办?

A: 检查API Key是否过期、是否对目标项目有写权限。免费版API Key默认仅对所属账户的项目可写。

Q2: 提交数据后无法立即查询到?

A: 系统存在最长2秒的写入延迟。建议在创建提交后等待1-2秒再发起查询。

已知限制

A: 有的。免费版限制每小时200次请求、每天2000次请求。响应头X-RateLimit-Remaining会返回剩余配额。

Q4: 表单可以设置截止时间吗?

A: 免费版不支持自动截止。可以通过status字段手动将表单状态改为draft来停止接收提交。

Q5: 删除表单后数据还能恢复吗?

A: 不能。删除表单会级联删除其下所有提交数据,操作不可逆。建议删除前先导出数据。

错误处理

错误场景(症状)	可能原因	解决方案
401 Unauthorized	API Key缺失或无效	检查环境变量是否正确设置
404 Not Found	表单ID或提交ID错误	确认ID复制完整,无多余空格
429 Too Many Requests	触发频率限制	等待60秒后执行ping命令测试网络连通性,检查防火墙和代理设置连接后重新执行命令,或升级专业版
字段类型不生效	字段type值拼写错误	对照"字段类型速查表"检查
提交数据丢失	误删表单	表单删除不可逆,需重建并重新收集

免费版限制

本免费体验版限制以下高级功能:

批量提交(单次>10条)、批量导出(>1000条)
Webhook事件订阅与第三方推送
自定义表单模板与字段复用
高级筛选(多条件组合、自定义字段过滤)
团队协作与RBAC权限管理
数据加密存储与审计日志

解锁全部功能请使用专业版:web-notepad-pro

依赖说明

运行环境

Agent平台: 支持SKILL.md的任意AI Agent(Claude Code / Cursor / Codex / Gemini CLI等)
操作系统: Windows / macOS / Linux
Shell环境: Bash或兼容Shell(用于执行curl示例)
Python: 3.8+(可选,用于辅助脚本)

依赖详情

依赖项	类型	是否必需	获取方式
LLM API	API	必需	由Agent平台内置LLM提供
curl	命令行工具	必需	操作系统自带或通过包管理器安装
jq	JSON处理工具	推荐	通过`apt install jq`或`brew install jq`安装
表单服务API	在线服务	必需	通过控制台获取API Key

API Key 配置

API Key 存储: 通过环境变量WEB_NOTEPAD_API_KEY传入,禁止硬编码在脚本中
安全建议: 在CI/CD环境中使用Secret管理服务注入,避免提交到代码仓库
轮换策略: 建议每90天轮换一次API Key,旧Key在控制台主动吊销

可用性分类

分类: MD+EXEC(纯Markdown指令,部分功能需exec命令行执行)
说明: 基于Markdown的AI Skill,通过自然语言指令驱动Agent完成操作

输出格式

json

{
  "success": true,
  "data": {
    "result": "在线表单笔记(免费版)处理结果",
    "execution_time": "0.5s",
    "metadata": {
      "version": "1.0",
      "processor": "web notepad"
    }
  },
  "execution_log": ["解析输入参数", "执行核心处理", "格式化输出结果"],
  "error": null
}