站点

在 EvoX 中创建和托管网站及 Web 应用

EvoX 站点可以把自然语言需求转成可审查的网页体验。你可以在桌面应用中创建本地站点工作区，预览并持续修改，再选择导出静态 H5 文件包、使用 EvoX 托管，或发布到自己的 Linux 服务器。

站点创建和发布是两个独立阶段。你可以先完成本地版本并充分检查，再明确选择发布方式。

开始使用站点

你可以从一句需求开始，也可以选择简历、博客、产品介绍、作品集、企业介绍或空白站点模板。

1. 描述站点：说明受众、用途、页面需要完成的行为，以及必须包含的信息。
2. 生成和预览：EvoX 会创建本地工作区，并提供可检查的站点预览。
3. 持续完善：在原站点会话中继续修改文案、图片、交互和移动端布局，也可以补充现有项目文件。
4. 导出或发布：完成审查后，选择导出静态 H5、使用 EvoX 托管，或通过 SSH 发布到自有服务器。

本地预览通常运行在本机回环地址，用于在发布前检查页面内容和交互。

使用提示创建站点

下面是几类适合交给 EvoX 站点工作流的任务。

为运营团队创建一个请求看板。成员可以提交请求、更新状态并按负责人筛选。
记录需要长期保存，请为结构化数据声明 D1 绑定。

把这个现有的产品介绍站整理成可发布版本。保留原有事实和信息架构，
修复手机端布局，并先交付本地预览。

创建一个资料库站点。每条记录包含标题、标签和说明，并允许上传附件。
元数据使用 D1，附件使用 R2；缺少的真实内容标记为 [待替换]。

提示中可以同时写清受众、核心任务、必须保留的事实、持久化需求和发布方式。对于尚未提供的名称、价格、客户案例、资质或统计数据，使用 [待确认] 标记，便于发布前统一补全。

了解项目、版本和部署

EvoX 在本地工作区中创建站点项目，并通过 evox-site-manifest.json 描述运行时和托管资源。站点可以保留为本地版本，也可以在审查后由桌面端发布。

站点清单 v2 支持以下核心配置：

runtime        static | worker
bindingSchema  d1 / r2 / environment
migrations     有序且不可变的 SQL 迁移

• static 用于以页面内容和前端交互为主的站点。
• worker 用于包含服务端逻辑、构建步骤或运行入口的站点。
• D1 用于保存结构化数据，R2 用于保存文件和上传内容。
• 环境项可以声明名称、是否必需以及是否为机密值。
• 导出和发布以经过审查的明确版本为基础，便于后续更新和回滚。

不需要在线托管时，可以导出以 index.html 为入口的静态 H5 文件包。使用 EvoX 托管时，可以从桌面端发布已审查版本。需要发布到自己的服务器时，可以使用 Linux + SSH 发布路径，检查主机指纹、目标目录、上传结果和真实 URL。

选择站点类型

根据站点需要保存的数据选择对应能力。

配置数据、文件和环境

EvoX 站点可以在 evox-site-manifest.json 中统一声明运行时资源：

• 使用 D1 保存表单记录、任务状态、内容索引等结构化数据。
• 使用 R2 保存图片、附件和其他上传文件。
• 使用环境项配置 API 地址、第三方服务参数和服务端凭据。
• 使用有序且不可变的 SQL migrations 管理数据库结构变化。

配置环境项时：

1. 在 bindingSchema.environment 中声明变量名称。
2. 标记变量是否必需，以及是否属于机密值。
3. 在托管配置中提供实际运行值。
4. 更新配置后重新构建并发布，让新版本使用最新配置。

机密值由运行环境管理，不写入客户端代码或站点清单。本地 .env.example 可以保留变量名，便于项目成员了解所需配置。

分享前审查

发布或分享前，可以按最终访问者看到的效果完成一次检查。

• 确认选择的是准备发布的版本。
• 复核名称、价格、联系方式、客户案例、资质和法律文本。
• 验证桌面与手机布局，检查文字换行、按钮尺寸、重叠和横向溢出。
• 测试表单、上传和持久数据是否按预期工作。
• 确认客户端文件中没有密钥、令牌、私有地址或其他机密信息。
• 发布后通过真实地址再次检查，并记录版本和验证结果。

下线和回滚

EvoX 托管站点支持停止当前发布，并可基于已审查版本进行回滚。发布到自有服务器的站点，可以依据发布回执核对目标目录、线上版本和真实地址，再完成回滚或下线。

执行操作前，先核对站点项目、目标环境和版本；完成后再次访问真实地址，确认结果与预期一致。

当前支持的站点能力

相关文档

• 项目和聊天
• 处理文件
• 故障排除

EvoX 文档 · 功能 · 工作流