---
title: 本地 Runtime 环境搭建
slug: local-runtime-setup
description: 在本地用 uv 跑通 Engine 与 Content，完成构建、校验与预览。
date: 2026-07-20
category: Engineering
tags:
  - uv
  - Python
  - 本地开发
draft: false
featured: true
hidden: false
archived: false
---

## 为什么先本地

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

## 三仓结构

```d2
direction: down

ZXT_Blog: {
  zxt-runtime-engine: 构建引擎与主题
  zxt-runtime-content: 文章内容与媒体
  zxt-runtime-infra: 部署与基础设施
  shape: class
  style.fill: "#282840"
  style.stroke: "#CBA6F7"
  style.stroke-width: 2
  style.border-radius: 12
  width: 360
}
```

日常写作只需要进入 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/`：

![示例图](@media/posts/local-setup/sample.svg)

## 下一步

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