云智论坛：功能全景与技术实现方案

一个跑在 Cloudflare 边缘网络上的社区论坛 — 从数据建模到安卓 / Windows 双端交付

私信需要「每用户每分钟 10 条」。先试内存 Map —— 跨 isolate 不共享，12 次测试全部放行。再试 Cloudflare 原生 Rate Limiting binding —— 免费计划下 limit() 恒定返回 success，等于没限。

最终落在 D1 单条原子 SQL，靠 ON CONFLICT ... RETURNING 拿到计数，天然并发安全。实测第 1-10 次通过、第 11 次 429。

Workers 上没有成熟的 Push 库可用（Node 的 web-push 依赖 crypto 原生模块）。于是按 RFC8291 手写 payload 加密（ECDH + HKDF + AES128GCM），按 RFC8292 手写 VAPID ES256 JWT 签名。

收益：用户关掉页面也能收到通知，且不依赖任何第三方推送服务。Mac Safari 与 iOS PWA 实测可用。

关注推荐原来要依次查：版块偏好 → 二度社交 → 已关注 → 候选用户 → 版块统计 → 新用户。六次 D1 往返串起来，慢网下用户看到的是十几秒的转圈。

把五个无依赖查询合并进 Promise.all，只有版块统计依赖候选列表。响应时间从 0.26-0.35s 降到 0.15-0.25s，超时率大幅下降。

首屏推荐结果用 caches.default 缓存 60 秒，key 是 https://follow-rec.internal/<uid>。只有 offset=0 走缓存，翻页不缓存，避免脏数据。

关键是反向失效：关注 / 取关接口里直接 cache.delete 该用户 key，用户操作后不会看到 60 秒前的旧状态。

侧栏渲染函数末尾原本是 catch { hideRightbar(); }。任何一个子区块超时，整个右栏就消失 —— 用户看到的是「侧栏加载失败」，毫无线索。

改成三层防护：① 外层 catch 保留框架，渲染错误卡片 + 重试按钮；② 子区块用 Promise.race 独立超时，只降级自己；③ 两个请求并行发出，超时不叫「失败」而显示「加载较慢」，数据到了自动填充。

Windows 安装包 75MB，安卓 APK 2.7MB，都不适合塞进 Static Assets。Worker 加了一条 /dl/:name 路由，直接从 R2 流式返回。

必须支持 HEAD 和 Range（206）——否则浏览器断点续传、下载器探测都会失效。还有一个坑：路由要在 run_worker_first 和 fetch 入口分发两处都声明，只改一处会被静态资源先吃掉。

「点了选图，选完没反应」排查了两个方向，两个都是真问题，缺一不可：

WebView 侧必须重写 onShowFileChooser，用 params.createIntent() 并显式加 FLAG_GRANT_READ_URI_PERMISSION；网页侧 input[type=file] 必须先挂到 DOM 再 click()（iOS Safari 会静默忽略游离节点）。

安卓端用 WebView 加载 https://yunzhi.dev，Windows 端 Electron 用 win.loadURL() 远程加载。这意味着网页改版不需要重新发版。

客户端只补网页做不到的三件事：系统级通知（轮询未读 + DownloadManager 下载 APK）、托盘常驻与未读徽标、以及在 Electron 里 serviceWorker.ready 永久 pending 时的 Web Push 降级。