跳过主要内容
全部文章
工程

Edaskills 如何运行在 Cloudflare Workers 上

一个 Worker 承载整个库、从 R2 流式转发安装包,并让排行榜保持新鲜。

Edaskills 以单个 Cloudflare Worker 交付:服务端渲染页面、JSON API、MCP 端点与安装包下载都跑在同一处。本篇介绍让一个 Skill 库在该运行时上成立的关键部件。

一个 Worker,整个平台

应用基于 TanStack Start + React 19。请求进入 Worker,server functions 完成数据库与存储操作,响应返回完整渲染的 HTML 与 hydration 状态。三个 binding 承载状态:D1(SQLite)存 Skill、版本、账号、安装与评分;R2 存安装包 ZIP、demo-run 产物与预览;KV 缓存排行榜 JSON。

下载经 Worker 流式转发

R2 桶保持私有。下载请求先鉴权、再校验版本已发布,然后在记录安装的同一请求内从 R2 流式回传——一个事务,按用户×版本去重。响应带 Content-Disposition 与 X-Checksum-Sha256 头,CLI 与浏览器可在解压前校验包。不用预签名 URL,也没有公开桶前缀。

发布管线保持唯一真源

管理员上传 ZIP;管线校验条目路径、链接、大小与 demo-run 报告契约,然后抽取 SKILL.md 与 references/ 写入只读派生字段。详情页与公开 skill.md 端点渲染的内容与包内文件完全一致。改内容意味着上传新版本——数据库不会与 ZIP 漂移。

排行榜保鲜,但计数器不在 KV

Trending 分数(滚动 7 天窗口内去重安装用户数)与评分聚合由定时任务重算并写入 D1;KV 只缓存结果榜单 JSON,TTL 很短。KV 最终一致且无原子自增,所以计数放在 D1 事务里。

为什么 Workers 适合这样的库

没有服务器要运维;R2 出站免费,流式下载不按字节计费;MCP 端点与 Web 应用同运行时共存。代价是纪律:不用 Node 专有 API、单请求 CPU 预算短、缓存 miss 回落 D1 而不是失败。