FckSignups 的 ＜SUBMISSION＞ 标签协议：无需注册开源工具目录的前后端数据共享指南

FckSignups 的 标签协议无需注册开源工具目录的前后端数据共享指南【免费下载链接】FckSignupsA list of tools that are open-source, in-browser, and require no-signups!项目地址: https://gitcode.com/GitHub_Trending/fc/FckSignupsFckSignups现名 NoSignups是一个无需注册的开源浏览器工具目录——收录的每个工具都能在浏览器里直接用不填邮箱、不注册、不追踪。它的提交流程里藏着一个巧妙的设计一个SUBMISSION标签协议。本文带你从 0 看懂这套协议如何让前端表单、Cloudflare Worker、Python 自动化脚本三方共享同一套数据格式。为什么需要一个 标签先看整条链路用户填表 → 后端创建一个GitHub Issue正文是纯 Markdown 文本→ 维护者运行 Python 脚本自动把工具写进数据文件。这里有个关键矛盾链路的中转站是GitHub Issue 的正文——一段纯文本不是结构化接口而两端是不同语言Worker 用 TypeScript自动化脚本用 Python。也就是说前端提交的 6 个字段要穿过一段纯文本再被另一种语言的程序精确还原。于是作者设计了一个语言中立、位置固定的紧凑字符串用一对SUBMISSION.../SUBMISSION标签包裹塞进 Issue 里。机器能稳定解析人也能在旁边直接读到一份 Markdown 表格。一句话SUBMISSION标签是前端数据与后端落库之间的那座桥。这套数据格式长什么样6 个字段一次看懂标签内是一行用双分号;;分隔的 6 段内容顺序固定工具名;;描述;;工具直链;;标签关键词;;源码仓库;;分类ID例如某次提交最终会变成SUBMISSIONExcalidraw;;在线白板绘图工具;;https://excalidraw.com;;drawing,whiteboard,协作;;https://github.com/excalidraw/excalidraw;;design/SUBMISSION六个位置的对照表如下位置字段前端 JSON 键含义落库去向tools.json1namename工具名称同时生成idslug 化与name2descriptiondescription一句话描述description3urlurl工具直链url4tagstags搜索关键词逗号分隔tags5githubgithub源码仓库github并自动抓取license、stars6categorycategory分类 IDcategory两个小约定值得注意可选字段为空时用占位符—em dash填充保证段数永远是 6解析方无需判断少了一段。;;是双分号而不是单个;或,——普通描述里很少出现双分号能有效避免字段被文本中的标点切碎。前端表单如何变成一次提交前端的字段定义集中在 ModalConfigs.tsxsubmit-tool表单恰好包含上表的 6 个字段名称、描述、URL、标签、GitHub、分类下拉选择。提交动作在 useModal.tsx 的handleSubmit中完成把表单收集为FormData转成键值对象后JSON.stringify成JSON直接 POST 到部署在 Cloudflare Workers 上的提交接口。表单 6 个字段 → JSON 对象 → POST 到 Worker 的 /submit-tool关键点前端发的是带字段名的 JSON而最终标签里是不带字段名、只靠位置的字符串。字段名 → 位置的转换发生在后端。后端 Worker如何生成 标签路由在 worker.ts/submit-tool转给handleSubmitTool处理。核心逻辑在 handleSubmitTool.ts校验检查必填字段、URL 是否合法校验函数。双视图生成同时产出一份给人看的 Markdown 表格和一份给机器看的SUBMISSION标签拼进同一个 Issue 正文。创建 Issue调用 GitHub Issues 接口标题形如[Tool Submission Request] 工具名并打上tool-submission标签无仓库时追加no-repo-link方便后续筛选。生成标签的那行就是整篇文章的题眼handleSubmitTool.tsSUBMISSION${name};;${description};;${url};;${tags};;${github};;${category}/SUBMISSION同一份数据两种视图表格供维护者在页面上一眼看懂标签供脚本可靠解析。Python 自动化正则抽取 拆分 落库维护者只需把 Issue 链接交给 addToolAutomation.py脚本会接力完成剩下的活抽取githubBridge.py 用正则SUBMISSION(.*?)/SUBMISSION开启DOTALL从 Issue 正文里捞出标签内容。拆分按;;拆成字段得到 6 段。校验validate 确认恰好 6 段、且github不是占位符—否则视为非自由开源工具拒绝。组装createToolDict 用fields[0]/[2]/[4]按位置取值并通过 GitHub 接口自动补齐stars与license再把名字 slug 化成id。落库追加进 tools.json 的tools数组。注意fields[4]github既被用来判断是否有效又被用来抓取星标数和许可证——一个字段两处用途。一图看懂完整数据流┌─────────────┐ JSON(6字段) ┌─────────────────┐ 创建Issue ┌──────────────┐ │ 前端表单 │ ──────────────► │ Cloudflare Worker│ ───────────► │ GitHub Issue │ │ (React 表单)│ │ (TypeScript) │ 含SUBMISSION│ (纯文本正文) │ └─────────────┘ └─────────────────┘ └──────┬───────┘ │ 正则抽取 ┌──────────────┐ 追加tools[] ┌─────────────────┐ split(;;) ┌─────▼──────┐ │ tools.json │ ◄────────────── │ Python 自动化 │ ◄───────────── │ 解析标签 │ │ (最终数据) │ 写入 │ (addToolAutomation)│ └────────────┘ └──────────────┘ └─────────────────┘三个环节一次交接靠字段名前端↔Worker一次靠位置 分隔符Worker↔Python。SUBMISSION标签正是位置化那一步的载体。设计细节为什么是;;和—设计点做法好处分隔符双分号;;描述/标签里含逗号或单分号时也不会把字段切碎空值占位—em dash段数恒定 6解析方无需处理缺字段的边界情况定位方式靠下标 0–5而非字段名跨 TypeScript / Python 最简单、零依赖双视图Markdown 表格 标签并存人直接读表格机器读标签互不干扰这种位置化 定长段 固定分隔符的写法本质是一种极简的序列化协议没有 schema、没有字段名、没有转义却足够稳定。对于只活在纯文本里的 Issue 正文来说刚刚好。想自己跑一遍如果想本地体验提交与自动化可以克隆仓库后安装依赖、启动开发服务器git clone https://gitcode.com/GitHub_Trending/fc/FckSignups cd FckSignups npm install npm run dev提交走前端表单与 Worker维护端则运行 addToolAutomation.py 手动把某个 Issue 落库。更多背景工具字段 schema、分类列表、贡献规范见 README.md。小结SUBMISSION标签是 FckSignups 提交流程里前后端共享数据格式的桥用一行位置化的;;分隔字符串承载 6 个字段。前端发带字段名的 JSONWorker把它翻译成位置化字符串 人类可读表格写进 IssuePython再按位置拆回字段并落库到 tools.json。三个小约定;;分隔、—占位、定长 6 段让这套跨语言协议既简单又稳健——这正是无需注册的开源工具目录能低成本持续扩张的底层支撑之一。【免费下载链接】FckSignupsA list of tools that are open-source, in-browser, and require no-signups!项目地址: https://gitcode.com/GitHub_Trending/fc/FckSignups创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考