有界的冷渲染
无论站点有多少内容,一次冷渲染最多 4 次 D1 往返。列表页从不解析正文 Markdown,也不会逐条查询。
Features0.1 包含什么
Mallok 是一套完整的 CMS——内容、主题、后台、CLI、询盘和 SEO——以一个 npm 包发布,以一个 Worker 运行。这一页列出它做什么、怎么做,以及有意不做什么。
01内容
内容是 CommonMark + GFM,外加一段 YAML front matter。D1 保存每个文件的完整文本;图片和附件用相对路径引用,文件存放在 R2。
titanium-price-2026-08/
├── index.md # 默认语言
├── index.zh-CN.md # 其他语言,写在文件名里
├── index.de.md
├── images/ # 各语言共用
│ ├── hero.jpg
│ └── chart.png
└── files/
└── datasheet.pdf
02多语言
每条内容都带语言和翻译组。主语言的 URL 不加前缀,其他语言各自有前缀。
<url>
<loc>https://example.com/products/titanium-bar</loc>
<xhtml:link rel="alternate" hreflang="en" href="…/products/titanium-bar"/>
<xhtml:link rel="alternate" hreflang="zh-CN" href="…/zh-CN/products/titanium-bar"/>
<xhtml:link rel="alternate" hreflang="de" href="…/de/products/titanium-bar"/>
</url>
sitemap 输出的简化示意。
03主题与插件
主题是一个目录:受限的 Liquid 模板加一份 theme.json。插件是真正的 JavaScript,有自己的数据表、路由、设置和定时任务。两者都放在项目源码里,构建时打包。
{
"id": "atelier",
"kinds": {
"product": {
"layout": "layouts/product.liquid",
"listLayout": "layouts/list.liquid",
"base": "products",
"fields": {
"grade": { "type": "string", "label": "Grade" },
"specs": { "type": "keyvalue", "label": "Properties" },
"gallery": { "type": "image[]", "label": "Gallery" },
"datasheet": { "type": "file", "accept": [".pdf"] }
}
}
},
"clientScripts": [ /* 必须显式声明 */ ]
}
04询盘
官方询盘插件把产品目录变成获客渠道。在页面里写上 [[inquiry]],启用插件后表单就会出现。
进行中: 当前候选版尚未完成真实 Turnstile 与 Resend 送达的端到端验收。正式依赖之前,请先用自己掌握的邮箱测试。
05后台
React 单页后台,由同一个 Worker 提供,支持英文和简体中文。使用它的人不需要知道 Worker、D1 或缓存标签是什么。
06CLI
CLI 调用的是后台同一套管理 API,所以 CI 里发布的目录和浏览器里保存的文章,存储、渲染和清缓存的方式完全一样。
| 命令 | 作用 |
|---|---|
mallok create <dir> | 创建项目、校验,然后部署到你的 Cloudflare 账号。加 --no-deploy 则不创建任何云资源。 |
mallok publish <dir> | 发布一个或多个内容包,连同图片。 |
mallok import <dir> | 导入内容包,状态以 front matter 为准。 |
mallok export <dir> | 把整个站点导出为内容包目录。 |
mallok build <dir> | 把本地目录编译成静态网站,不碰 D1,也不联网。 |
mallok upgrade --to <version> | 把项目切换到另一个 Mallok 版本,重新部署后生效。 |
mallok preview <dir> | 在本地离线渲染内容包。 |
此外还有 media push、setup-key、repair、destroy。站点类命令都支持 --dry-run 和 --json。详见 CLI 参考(英文)。
07渲染与缓存
渲染核心不依赖任何平台 API,所以 CLI 的本地预览、后台的实时预览和线上的 Worker 跑的是同一个函数,输出同样的字节。
| 层 | 位置 | 键 | 解决什么 |
|---|---|---|---|
| 边缘缓存 | Cache API | 请求 URL | 访客请求不会走到渲染 |
| 片段缓存 | D1 render_cache | Markdown 哈希 + 管线版本 + 插件哈希 | 冷渲染不解析 Markdown |
| 模板缓存 | isolate 模块作用域 | 主题 id + 版本 | 同一个 isolate 里 Liquid 只解析一次 |
无论站点有多少内容,一次冷渲染最多 4 次 D1 往返。列表页从不解析正文 Markdown,也不会逐条查询。
每个页面都带站点、内容、类型和语言的 Cache-Tag。保存时只清除展示了该内容的页面。在 main 分支上,清除失败会被记录并显示在后台;已发布的候选版(到 rc.11)可能把失败的清除显示为成功。
页面默认在边缘缓存一小时(可调),同时要求浏览器每次重新校验,这样清除缓存不会被访客浏览器里的旧副本抵消。
30 次确认命中里最大值为 1 ms。0 是平台记录的数值,并不表示没有任何计算。
免费套餐目标:10 ms。30 次冷渲染里有 16 次超出,全部请求成功。
首页与文章页共六次测试,无障碍、最佳实践和 SEO 均为 100。
请按实际含义看待这些数字。 它们来自 0.1.0-rc.5 在自定义域名上的一次隔离部署。rc.6 到 rc.11 没有重新采样,而且这些版本给冷渲染增加了开销,所以这些数字不能代表当前候选版。冷渲染超过 10 ms CPU 是候选版已知并已接受的限制。 完整发布状态
08SEO
搜索相关的输出不交给插件,也不交给各个主题作者。每个 Mallok 站点的输出都是同一套。
有意不做:自动识别语言并跳转。访客和爬虫请求哪个 URL,就得到哪个 URL。
09静态构建
mallok build 把本地目录(与 mallok export 的导出结构相同)编译成完整的静态站点:内容类型、标签、多语言和 SEO 端点,用的是同一套渲染函数。
mallok build ./my-site \
--theme ./src/themes/atelier \
--origin https://example.com
10边界
这是产品里最重要的一条线,所以不只写在这里,界面上也画得清清楚楚。
由日常运营网站的人在后台或通过 CLI 修改。不需要构建,也不需要部署。
由技术人员在源码里修改,随代码一起发布,部署后才生效——不会伪装成一键切换。
mallok upgrade11不做什么
知道一个工具的边界在哪里,才谈得上信任它。
没有 Mallok 账号、计费或多租户控制台。你的网站只运行在你自己的 Cloudflare 账号里。
0.1 做到询盘为止:没有购物车、支付、会员和评论。电商是后续方向,以插件形式提供。
不运行 PHP,不兼容 WordPress 主题和插件,也不运行 Astro 或 Next.js 项目。WordPress 导入工具在路线图里。
需要自由编写服务端业务逻辑、权限体系或复杂表单流程的站点,并不适合用它。
0.1 没有实时多人协作编辑。
只依赖一家云厂商和一家邮件服务商,我们直说而不掩饰。对策是内容和询盘随时可以导出。
12路线图
下面这些都不在当前候选版里,也都没有排期。
来源:产品愿景(英文)第 9 节。“Deploy to Cloudflare” 按钮也在计划中,目前尚不可用。