# 发布与完整网站

## 一个来源，两种阅读方式

GitHub Markdown 是权威来源。网站构建直接把完整文档呈现到 **proof21.xyz/docs/**。GitBook 可作为其免费域名上的可选编辑／只读镜像。网站没有代理 GitBook 的付费子目录功能。

这些文件不代表自动 Git Sync、公开网站或域名更改已完成。连接配置完成前，GitBook 更新必须明确同步。

## 构建与检查

在仓库根目录安装固定版本的网站解析器并运行生成器：

```bash
python3 -m pip install -r requirements-web.txt
python3 scripts/build_site.py
python3 scripts/check_site.py
python3 -m http.server 4173 --bind 127.0.0.1 --directory site
```

生成器读取 docs/SUMMARY.md 中的导航允许列表，把 Markdown 渲染为静态 HTML，复制版本化 SVG 图，并生成搜索、网站地图、RSS 和机器文档。绝不会把 ops/、凭证或仓库源根目录复制到公开网站。

网站没有数据库或付费运行时依赖，也不要求 Sites 订阅。预构建输出可由普通静态主机托管。

## Vercel 配置

仓库根目录的 vercel.json 明确设置构建命令及 site 输出目录。导入时使用 Other 框架预设，以仓库根目录作为构建根。部署必须**仅服务 site/**，而不是源根目录。完整仓库构建根用于让生成器读取 docs/ 和 brand/。

Vercel Hobby 不提供商业使用资格。请选择适当计划或其他静态主机；本次没有批准更改账单。预览 noindex 不是身份认证，私密审阅需要部署保护。[1]

## 免费 GitBook

GitBook Free/Basic 可在自身域名上发布公开文档，并包含 Git Sync 和机器可读文档。自定义域名及高级品牌设置要求付费计划。仅为保持草稿私密，未发布工作空间不需要购买访客认证。[2]

## 域名与社交链接

选定源站为 proof21.xyz。只有托管项目存在后，才配置项目专用 DNS；保留邮件和验证记录。.ai 域名仍属计划，未确认取得。

在所有者提供精确 URL 前，X 和 LinkedIn 地址保持空白。GitHub 仍是私有；预览链接明确标注，公开构建隐藏私有源链接。GitBook 编辑器地址绝不作为公开文档入口。

## 来源

1. [Vercel 合理使用政策](https://vercel.com/docs/limits/fair-use-guidelines)
2. [GitBook 定价](https://www.gitbook.com/pricing)