AI 整页
freeform
AI 直接生成整页 HTML/CSS
适合品牌门面、活动页与一次性展示。按描述整页产出，不套通用模板，视觉自由度高。
- 整页 HTML + CSS 一次生成
- 适合需要独特版式的页面
- 产物同样是纯静态文件
01 / 三引擎
同一个入口，三种生成方式
三种引擎最终都输出静态 HTML，托管方式完全一致。选哪种，取决于页面要表达什么。
结构化
html
用 site.json.plan 渲染
把页面拆成区块与文案，由渲染器输出 HTML。结构稳定，改文案不动样式。
- 区块顺序即 site.json 里的 plan
- 样式来自 site-kit 令牌与预设
- 适合长期维护的产品官网
多页
astro
博客、文档与多页内容站
需要持续更新的内容结构时使用。构建期生成静态页面，路由与内容组织交给 Astro。
- 适合文档、文章与多页面站点
- 与另两种引擎共用同一网关
- 构建产物统一落到 dist
02 / 流程
从一句描述，到网关上的一个地址
每一步都有产物，出问题能定位到具体环节，而不是只有一句“构建失败”。
-
01
说一句话
在控制台输入站点描述，系统推断名称、分类与风格，给出可用的初始配置。
-
02
确认 site.json
站点契约是 site.json：引擎、风格预设、页面结构都写在这里，随时可改。
-
03
生成与构建
按引擎生成页面，构建任务进入全局串行队列，日志通过 SSE 实时回传。
-
04
同步网关
产物落到 apps/<slug>/dist，由单个 nginx 网关直接服务，对外地址即刻可访问。
AI 对话与建站记录以 Markdown 保存，回看时能读到当时为什么这样定。
03 / 控制台
一个控制面，管住所有站点
Fastify 控制面 + React 控制台。建站、构建、日志、记录，都在同一处。
一句话建站
描述直接转成站点骨架，自动推断名称、分类与风格，不用从空白页开始。
串行构建队列
构建任务走全局串行队列，避免互相抢占；每个任务的日志通过 SSE 实时推送。
site.json 契约
站点配置是一份可读的 JSON，交给版本管理，改动可审查、可回看。
Markdown 记录
AI 对话与建站过程写入 Markdown，团队交接时读得懂上下文。
统一样式令牌
样式来自 site-kit 令牌与 8 套预设，tech-blue 等风格开箱可用，不引外部字体与 CDN。
网关同步
构建完成后同步产物到网关目录，一个 nginx 服务所有站点，不新增容器。
04 / 部署方式
本地打包，服务器只加载
站点 dist、控制台产物与平台镜像都在开发机构建。服务器不解压构建，只加载镜像与解压好的产物。
- 开发机完成全部构建，产物可复现
- 服务器只加载镜像，不跑构建链
- 没有每站容器、预览域名、发布版本与回滚
05 / FAQ
上线前常被问到的几件事
三种引擎应该怎么选？
要独特整页版式选 freeform；要稳定结构、长期改文案选 html；要文章、文档与多页内容选 astro。三者产物都是静态 HTML，换引擎不影响托管方式。
有预览域名或回滚吗？
没有。easy-html 有意不提供每站容器、预览域名、发布版本与回滚。构建产物直接同步到网关目录，以当前产物为准。
构建日志怎么看？
构建任务进入全局串行队列，执行日志通过 SSE 实时回传到控制台，可以边构建边看输出。
样式会不会引入外部依赖？
不会。样式统一来自 site-kit 令牌与 8 套预设，不引入外部字体、CDN 或统计脚本，页面加载只依赖站点自身产物。
服务器上需要装构建环境吗？
不需要。站点 dist、控制台产物与平台镜像都在开发机构建，服务器只加载镜像和解压产物。
适合谁用？
独立开发者、小团队与工作室的技术负责人：需要快速上线多个静态站点，又希望托管结构足够简单。