常见问题

购买与授权

框架授权限制站点数量吗？

不限制。框架一次买断，租户数与站点数均无上限；按站点数收费的只有应用授权（名额制）。未绑定应用的站点连名额都不消耗。

不买授权能先试用吗？

可以。未激活的部署允许本地完整体验（带水印），只是不能安装商店应用、不能在线升级。什么时候想上线了，激活授权码即转正，数据无缝保留。

服务器断网会导致停摆吗？

不会。授权校验失败先进 72 小时宽限（功能不受影响），宽限超期也只是禁止新的站点绑定应用——已运行的站点与 C 端永不受影响。商店、升级、云构建等在线服务自然需要联网。

部署与运维

服务器需要装 Node 或 composer 吗？

都不需要。PHP 依赖随包分发，管理端是预编译产物，扩展安装是免编译的运行时加载。服务器上只需要 PHP 8.1+、MySQL、Redis。

支持宝塔面板吗？

支持以常规 PHP CLI 应用的方式部署（webman 是常驻进程，不走 php-fpm）：用宝塔装好 PHP / MySQL / Redis 后，以 php start.php start -d 启动并配置反向代理到 8787 端口即可。也可以直接用附带的 Docker Compose 参考配置。

MySQL 用 5.7 还是 8.0？

都可以，行为一致——双版本兼容是框架红线，所有迁移经 db:lint 静态扫描（禁 8.0-only 特性、统一 collation）。存量服务器的 5.7 与新采购的 8.0 混用也没问题。

可以改内核源码做二开吗？

技术上可以，但强烈不建议：升级会覆盖内核文件（保护路径除外）。正确姿势是走扩展点（filter / action 事件）、开发插件或应用——升级永不冲突。见扩展点手册。

经营与业务

一个站点能同时绑定多个应用吗？

能。小程序端每应用一个独立分包，首页由 DIY 装修聚合各应用组件，tabBar 与「我的」入口全部站点侧可配，主题 token 保证多应用视觉统一。云构建按绑定集合出包，未绑定的应用不占体积。

余额、库存这类并发场景安全吗？

安全。余额支付事务 + 行锁 + 流水唯一索引幂等；秒杀 / 拼团 / 核销的占量全部原子条件更新。「扣减无锁」导致资损的事故模式在机制上不可能发生，不需要运营侧做任何额外防护。

iOS 上虚拟商品怎么收款？

收银台内置 iOS 合规策略：虚拟商品交易在 iOS 微信小程序内自动隐藏微信支付。微信已对部分类目放开 iOS 内支付——如果你的小程序类目在开放范围内，可在支付设置中配置放行。完整链路见收钱：支付、流水与提现。

发布小程序必须用微信开发者工具吗？

不必。配置微信第三方平台后，站点扫码授权托管，提审、发布、灰度、回退全部在后台完成。没配第三方平台时，下载构建产物用开发者工具手动上传是兜底路径。

怎么给客户开演示环境？

开 DEMO_MODE：访客可真实体验全部业务操作，危险动作（改密码、触发外部系统、动文件与全库）被拦截，数据每日自动恢复黄金快照。见运维与故障排查。

开发者

开发应用需要什么技术栈？

后端 PHP（webman 风格 controller / service / model），管理端 React（可用官方 CLI 构建为 ESM 产物，或直接手写 .mjs），C 端 uni-app（Vue 3）。脚手架命令 ext:create 一键生成骨架，ext:gen 从表结构生成 CRUD。

扩展会不会拖垮宿主管理端？

不会。每个扩展路由独立 ErrorBoundary：版本不兼容、加载失败、运行时崩溃都只降级为一张可重试的卡片。宿主与其他扩展照常运行。

没找到答案？从产品概述开始按图索骥，或联系官方获取支持。