搭建多客户端应用

多客户端允许一个项目包含多个独立的 Web 客户端。各客户端面向不同用户或业务场景，但共享同一个后端。

例如，同一个电商项目可以分别搭建用户商城和运营管理后台；两个客户端拥有不同的页面和入口，但使用相同的商品、订单和用户数据。

多客户端模型

当前 Zion 可以在一个项目中添加多个 Web 客户端，不支持添加多个微信小程序客户端。

适用场景

多客户端适合需要共享业务数据、但前端体验明显不同的应用，例如：

• 用户端与运营管理端
• 面向客户的业务系统与面向员工的内部系统
• 不同品牌或业务线的独立 Web 入口
• 针对不同角色设计的专用工作台

如果只是根据用户角色显示少量不同内容，通常不需要增加客户端，可以通过权限和条件显示完成。

添加客户端

1. 在项目管理页面检查当前版本是否支持额外客户端。版本和购买方式参阅升级项目。
2. 购买或添加新的 Web 客户端。
3. 客户端添加完成后，项目会显示后端编辑器、默认客户端和新增客户端。
4. 进入新增客户端，创建页面、组件和前端交互。

编辑多客户端项目

编辑前端

在客户端编辑器中管理当前客户端独有的内容，包括：

• 页面和页面参数
• 组件和布局
• 数据绑定
• 前端行为

切换客户端前，先确认当前编辑器名称，避免将页面或前端行为配置到错误的客户端。

编辑后端

在后端编辑器中管理所有客户端共享的内容，包括：

• 数据模型和数据库
• 用户与权限
• 行为流
• 第三方 API
• AI 智能体

发布多客户端项目

多客户端项目采用前后端分离发布：

1. 在后端编辑器中点击发布，发布数据库结构、权限、行为流、第三方 API 和 AI 智能体等后端变更。
2. 进入需要更新的客户端，使用实时预览检查页面和交互。
3. 在该客户端编辑器中点击发布，生成预发布版本并完成生产发布。
4. 如果多个客户端受到影响，分别进入各客户端完成验证和发布。

后端由所有客户端共享。修改行为流入参、出参或数据结构时，应先检查所有调用它的客户端，并避免让已发布客户端调用不兼容的后端配置。完整发布流程参阅发布应用。

管理客户端

续费

项目续费时会计算需要继续使用的客户端。确认订单前，检查客户端列表和费用；不再使用的客户端应按界面提示提前处理。

降级和重新激活

项目降级到不支持多客户端的版本后，额外客户端将无法继续编辑或发布，默认客户端不受影响。重新升级时，根据项目界面选择需要恢复的历史客户端。

删除客户端

删除客户端前，确认其中的页面、组件、前端配置和线上入口已经不再需要。后端数据不会因删除客户端而自动删除。