Engineering · · 1 分钟阅读

本地 Runtime 环境搭建

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

Python 本地开发

为什么先本地

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

三仓结构

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.txtposts.json

媒体引用

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

示例图

下一步

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