ZXT / Runtime

Engineering · · 1 分钟阅读

本地 Runtime 环境搭建

在本地用 uv 跑通 Engine 与 Content，完成构建、校验与预览。

uv Python 本地开发

为什么先本地

云端服务器可以并行准备，但内容与生成器应先在本地闭环：能写、能校验、能预览。

三仓结构

text
ZXT_Blog/
├── zxt-runtime-engine/
├── zxt-runtime-content/
└── zxt-runtime-infra/

日常写作只需要进入 Content 仓库：

bash
cd zxt-runtime-content
uv sync
uv run runtime-blog dev

构建产物

执行 runtime-blog build 后，静态文件输出到 dist/，包含：

  • 首页与文章详情
  • RSS / Sitemap
  • llms.txt 与 posts.json

媒体引用

本地阶段使用 @media 逻辑路径，构建时复制到 dist/media/：

示例图

下一步

服务器就绪后，再接入 Infra、HTTPS 与对象存储。