kzo.moe

kzo.moe是什么

一个静态站点生成器。输入 Markdown 文件，输出纯 HTML/CSS/JS 资源包。

站点语言为 zh_CN。默认编码 UTF-8。

构建产物不含数据库依赖。部署时只需将生成目录上传至任意静态托管服务。

kzo.moe主要功能

• Markdown 解析： 读取 .md 文件，按 CommonMark 规范解析标题、列表、表格、代码块，输出带语义标签的 HTML 片段。单文件上限 2MB。超出后解析队列会排队处理。
• 增量构建： 对比源文件与上次构建的哈希值，仅重新编译变动文件。实测 500 篇文章下，全量构建约 12 秒，增量构建降至 1.8 秒左右。
• 模板渲染： 设有变量插值语法 {{ var }}，支持条件判断与循环。模板文件后缀为 .tpl。渲染结果直接写入输出目录对应路径。
• 资源压缩： 对 CSS、JS、HTML 做去空格与注释剥离。CSS 压缩率一般在 30%–50%。不处理图片。
• 多语言路由： 按 zh_CN 等语言码生成子目录。每种语言独立输出。语言包为 JSON 格式，键值对数量不限。
• 本地预览服务： 启动后监听 127.0.0.1:8080。文件变更触发浏览器热重载。仅限本机访问。

有一点需要注意：增量构建依赖缓存文件 .kzo-cache。手动删除该文件会触发全量重建。

kzo.moe使用要求

运行环境需要 Node.js 18 或更高版本。低版本缺少 structuredClone，构建会报错。

磁盘空间方面，源文件与输出目录建议分开放。缓存文件体积约为源文件的 1.2 倍。

输入文件必须为 UTF-8 编码。GBK 编码的 Markdown 会导致中文乱码。

模板中引用未定义的变量时，渲染为空字符串。不会中断构建。

kzo.moe核心优势

构建速度是主要差异点。增量机制让二次构建接近瞬时。大站点下体感明显。

输出产物零运行时依赖。生成的 HTML 可直接用浏览器打开。不需要 Node 环境。

kzo.moe如何使用

安装：npm install -g kzo-cli。

初始化项目：kzo init my-site。生成 source/、templates/、kzo.config.json。

编写内容：在 source/ 下新建 .md 文件。文件名即路由路径。

配置模板：编辑 templates/ 下的 .tpl 文件。变量名与 kzo.config.json 中的 site 字段对应。

构建：kzo build。输出目录默认为 dist/。

预览：kzo serve。浏览器打开 http://127.0.0.1:8080。

清理缓存：kzo clean。删除 .kzo-cache 与 dist/。

kzo.moe同类竞品对比

kzo.moe应用场景

技术文档站点。Markdown 写内容，模板控制样式。增量构建适合频繁改动的文档。

个人博客。纯静态输出，托管成本低。多语言路由方便中英文切换。

产品说明页。模板变量可注入版本号、下载链接等动态字段。构建时替换。

kzo.moe适用人群

熟悉 Markdown 语法、不需要可视化编辑器的开发者。

对构建速度敏感、文章数量在 200 篇以上的站点维护者。

需要多语言输出、但不想引入重型 CMS 的团队。

不适用场景：需要在线编辑、评论系统、数据库存储的用户。

首页截图